pw-metadata(1) General Commands Manual pw-metadata(1)

# [NAME](#NAME)

pw-metadata - The PipeWire metadata

# [SYNOPSIS](#SYNOPSIS)

**pw-metadata** \[*options*] \[*id* \[*key* \[*value* \[*type* ] ] ] ]

# [DESCRIPTION](#DESCRIPTION)

Monitor, set and delete metadata on PipeWire objects.

Metadata are key/type/value triplets attached to objects identified by *id*. The metadata is shared between all applications binding to the same metadata object. When an object is destroyed, all its metadata is automatically removed.

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.

When *value* is given, **pw-metadata** will set the metadata for *id* and *key* to *value* and an optional *type*.

# [OPTIONS](#OPTIONS)

**-r | --remote=NAME**

The name the remote instance to use. If left unspecified, a connection is made to the default PipeWire instance.

**-h | --help**

Show help.

**--version**

Show version information.

**-l | --list**

List available metadata objects

**-m | --monitor**

Keeps running and log the changes to the metadata.

**-d | --delete**

Delete all metadata for *id* or for the specified *key* of object *id*. Without any option, all metadata is removed.

**-n | --name**

Metadata name (Default: "default").

# [EXAMPLES](#EXAMPLES)

**pw-metadata**

Show metadata in default name.

**pw-metadata** -n settings 0

Display settings.

**pw-metadata** -n settings 0 clock.quantum 1024

Change clock.quantum to 1024.

# [AUTHORS](#AUTHORS)

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

# [SEE ALSO](#SEE_ALSO)

[**pipewire(1)**](/man/os/pipewire/pipewire.1), [**pw-mon(1)**](/man/os/pipewire/pw-mon.1), [**pw-cli(1)**](/man/os/pipewire/pw-cli.1),

1.6.11 PipeWire

---

Document: pw-metadata(1) from pipewire 1.6.11-r2 (Chainguard OS)
Source: https://gitlab.freedesktop.org/pipewire/pipewire