pw-metadata(1)

📦
version 1.6.11 · 13 versions
, in fedora 44

✨ pw-metadata(1) ✨

so bestie, welcome to pw-metadata — it's a General Commands Manual page, and it's literally all about The PipeWire metadata. it's giving "tiny command, huge power" energy and i am obsessed. 💖

🌸 NAME 🌸

pw-metadata — The PipeWire metadata 👑

🎀 SYNOPSIS 🎀

pw-metadata [options] [id [key [value [type ] ] ] ]
okay so like, those brackets are nesting besties. every layer inside is optional, and they all stack. 🪆

🦋 DESCRIPTION 🦋

Monitor, set and delete metadata on PipeWire objects. that's the whole vibe. 🫶

Metadata are key/type/value triplets attached to objects identified by id. and here's the tea: the metadata is shared between all applications binding to the same metadata object. so like, everybody sees the same thing, no cap. and when an object is destroyed, all its metadata is automatically removed — it takes itself out, iconic behaviour honestly. 💅

When no value is given, pw-metadata will query and log the metadata matching the optional arguments id and key. Without any arguments, all metadata is displayed. the whole entire list. a full reveal. ✨

When value is given, pw-metadata will set the metadata for id and key to value and an optional type. so yeah you can write stuff too, not just peek. 👑

💅 OPTIONS 💅

  • -r | --remote=NAME — the name of the remote instance to use. if you leave it unspecified, a connection is made to the default PipeWire instance. (so like, no name = you get the default one, easy.) 🌈
  • -h | --help — Show help. bestie behaviour, always there for you. 🫶
  • --version — Show version information. 📌
  • -l | --list — List available metadata objects. window shopping but make it metadata. 🛍️
  • -m | --monitor — Keeps running and log the changes to the metadata. it just... stays. watching. forever. main character energy honestly. 👀
  • -d | --delete — Delete all metadata for id or for the specified key of object id. Without any option, all metadata is removed. > ⚠️ bestie this one is permanent, there's no undo button, so like... be sure. 😭
  • -n | --name — Metadata name (Default: "default"). 🏷️

🌟 EXAMPLES 🌟

pw-metadata

Show metadata in default name. simple. clean. iconic. ✨

pw-metadata

pw-metadata -n settings 0

Display settings. 👑

pw-metadata -n settings 0

pw-metadata -n settings 0 clock.quantum 1024

Change clock.quantum to 1024. look at you, setting values like a legend. 🔥

pw-metadata -n settings 0 clock.quantum 1024

💜 AUTHORS 💜

The PipeWire Developers <https://gitlab.freedesktop.org/pipewire/pipewire/issues>; PipeWire is available from <https://pipewire.org>

(yeah, the whole dev team, they ate. 💖)

🧚 SEE ALSO 🧚

iykyk, go read those next bestie 🦋

and that's the page!! this one ships as PipeWire 1.6.11, page pw-metadata(1) — so like, that's the version, that's the source, that's the date stamp, we love a documented queen. slay, go touch some metadata, periodt 💅✨🎀

📦 where this page comes from