diff options
| author | Max Kellermann <max@duempel.org> | 2013-10-25 19:35:40 +0200 |
|---|---|---|
| committer | Max Kellermann <max@duempel.org> | 2013-10-25 19:35:40 +0200 |
| commit | 17dc638c18d7897ec851313df1103ded008366b0 (patch) | |
| tree | 354342b73d67a9ecb3e9c5e27fbe8ddc34fae40f /doc | |
| parent | d6e28c42e5c2bdab73d3553b21a09fa28dabd037 (diff) | |
| download | mpd-17dc638c18d7897ec851313df1103ded008366b0.tar.gz mpd-17dc638c18d7897ec851313df1103ded008366b0.tar.xz mpd-17dc638c18d7897ec851313df1103ded008366b0.zip | |
command: new command "readcomments" lists arbitrary file tags
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/protocol.xml | 26 |
1 files changed, 26 insertions, 0 deletions
diff --git a/doc/protocol.xml b/doc/protocol.xml index d40d6586d..234db46db 100644 --- a/doc/protocol.xml +++ b/doc/protocol.xml @@ -1582,6 +1582,32 @@ OK </para> </listitem> </varlistentry> + <varlistentry id="command_readcomments"> + <term> + <cmdsynopsis> + <command>readcomments</command> + <arg><replaceable>URI</replaceable></arg> + </cmdsynopsis> + </term> + <listitem> + <para> + Read "comments" (i.e. key-value pairs) from the file + specified by "URI". This "URI" can be a path relative + to the music directory or a URL in the form + "file:///foo/bar.ogg". + </para> + <para> + The response consists of lines in the form "KEY: VALUE". + Comments with suspicious characters (e.g. newlines) are + ignored silently. + </para> + <para> + The meaning of these depends on the codec, and not all + decoder plugins support it. For example, on Ogg files, + this lists the Vorbis comments. + </para> + </listitem> + </varlistentry> <varlistentry id="command_search"> <term> <cmdsynopsis> |