command: new command "readcomments" lists arbitrary file tags

This commit is contained in:
Max Kellermann
2013-10-25 19:35:40 +02:00
parent d6e28c42e5
commit 17dc638c18
6 changed files with 182 additions and 0 deletions

View File

@@ -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>