aboutsummaryrefslogtreecommitdiffstats
path: root/doc/protocol.xml
diff options
context:
space:
mode:
authorMax Kellermann <max@duempel.org>2013-10-25 19:35:40 +0200
committerMax Kellermann <max@duempel.org>2013-10-25 19:35:40 +0200
commit17dc638c18d7897ec851313df1103ded008366b0 (patch)
tree354342b73d67a9ecb3e9c5e27fbe8ddc34fae40f /doc/protocol.xml
parentd6e28c42e5c2bdab73d3553b21a09fa28dabd037 (diff)
downloadmpd-17dc638c18d7897ec851313df1103ded008366b0.tar.gz
mpd-17dc638c18d7897ec851313df1103ded008366b0.tar.xz
mpd-17dc638c18d7897ec851313df1103ded008366b0.zip
command: new command "readcomments" lists arbitrary file tags
Diffstat (limited to '')
-rw-r--r--doc/protocol.xml26
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>