.\" Man page generated from reStructuredText. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "PW-METADATA" 1 "" "" "General Commands Manual" .SH NAME pw-metadata \- The PipeWire metadata .SH SYNOPSIS .nf \fBpw\-metadata\fP [\fIoptions\fP] [\fIid\fP [\fIkey\fP [\fIvalue\fP [\fItype\fP ] ] ] ] .fi .sp .SH DESCRIPTION .sp Monitor, set and delete metadata on PipeWire objects. .sp Metadata are key/type/value triplets attached to objects identified by \fIid\fP\&. The metadata is shared between all applications binding to the same metadata object. When an object is destroyed, all its metadata is automatically removed. .sp When no \fIvalue\fP is given, \fBpw\-metadata\fP will query and log the metadata matching the optional arguments \fIid\fP and \fIkey\fP\&. Without any arguments, all metadata is displayed. .sp When \fIvalue\fP is given, \fBpw\-metadata\fP will set the metadata for \fIid\fP and \fIkey\fP to \fIvalue\fP and an optional \fItype\fP\&. .SH OPTIONS .INDENT 0.0 .TP .B \-r | \-\-remote=NAME The name the remote instance to use. If left unspecified, a connection is made to the default PipeWire instance. .TP .B \-h | \-\-help Show help. .UNINDENT .INDENT 0.0 .TP .B \-\-version Show version information. .UNINDENT .INDENT 0.0 .TP .B \-m | \-\-monitor Keeps running and log the changes to the metadata. .UNINDENT .sp \-d | \-\-delete .INDENT 0.0 .INDENT 3.5 Delete all metadata for \fIid\fP or for the specified \fIkey\fP of object \fIid\fP .sp Without any option, all metadata is removed .UNINDENT .UNINDENT .SH AUTHORS .sp The PipeWire Developers <\fI\%https://gitlab.freedesktop.org/pipewire/pipewire/issues\fP>; PipeWire is available from \fI\%https://pipewire.org\fP .SH SEE ALSO .sp \fBpipewire(1)\fP, \fBpw\-mon(1)\fP, \fBpw\-cli(1)\fP, .\" Generated by docutils manpage writer. .