aboutsummaryrefslogtreecommitdiffstats
path: root/doc/user.xml
diff options
context:
space:
mode:
Diffstat (limited to 'doc/user.xml')
-rw-r--r--doc/user.xml108
1 files changed, 106 insertions, 2 deletions
diff --git a/doc/user.xml b/doc/user.xml
index a0bd861e8..74c169c11 100644
--- a/doc/user.xml
+++ b/doc/user.xml
@@ -574,7 +574,7 @@ systemctl start mpd.socket</programlisting>
<row>
<entry>
<varname>mixer_type</varname>
- <parameter>hardware|software|none</parameter>
+ <parameter>hardware|software|null|none</parameter>
</entry>
<entry>
Specifies which mixer should be used for this audio
@@ -582,7 +582,9 @@ systemctl start mpd.socket</programlisting>
linkend="alsa_output">ALSA</link>, <link
linkend="oss_output">OSS</link> and <link
linkend="pulse_output">PulseAudio</link>), the
- software mixer or no mixer
+ software mixer, the "null" mixer
+ (<parameter>null</parameter>; allows setting the
+ volume, but with no effect) or no mixer
(<parameter>none</parameter>). By default, the
hardware mixer is used for devices which support it,
and none for the others.
@@ -2017,6 +2019,64 @@ buffer_size: 16384</programlisting>
</informaltable>
</section>
+ <section id="sidplay_decoder">
+ <title><varname>sidplay</varname></title>
+
+ <para>
+ C64 SID decoder based on
+ <application>libsidplay</application>.
+ </para>
+
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>Setting</entry>
+ <entry>Description</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>
+ <varname>songlength_database</varname>
+ <parameter>PATH</parameter>
+ </entry>
+ <entry>
+ Location of your songlengths file, as distributed
+ with the HVSC. The <varname>sidplay</varname>
+ plugin checks this for matching MD5 fingerprints.
+ See <ulink
+ url="http://www.c64.org/HVSC/DOCUMENTS/Songlengths.faq">http://www.c64.org/HVSC/DOCUMENTS/Songlengths.faq</ulink>.
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <varname>default_songlength</varname>
+ <parameter>SECONDS</parameter>
+ </entry>
+ <entry>
+ This is the default playing time in seconds for
+ songs not in the songlength database, or in case
+ you're not using a database. A value of 0 means
+ play indefinitely.
+ </entry>
+ </row>
+
+ <row>
+ <entry>
+ <varname>filter</varname>
+ <parameter>yes|no</parameter>
+ </entry>
+ <entry>
+ Turns the SID filter emulation on or off.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </section>
+
<section>
<title><varname>wildmidi</varname></title>
@@ -3031,6 +3091,50 @@ buffer_size: 16384</programlisting>
Write to this file.
</entry>
</row>
+
+ <row>
+ <entry>
+ <varname>format_path</varname>
+ <parameter>P</parameter>
+ </entry>
+ <entry>
+ <para>
+ An alternative to <varname>path</varname> which
+ provides a format string referring to tag values.
+ Every time a new song starts or a new tag gets
+ received from a radio station, a new file is
+ opened. If the format does not render a file
+ name, nothing is recorded.
+ </para>
+
+ <para>
+ A tag name enclosed in percent signs ('%') is
+ replaced with the tag value. Example:
+ <parameter>~/.mpd/recorder/%artist% -
+ %title%.ogg</parameter>
+ </para>
+
+ <para>
+ Square brackets can be used to group a substring.
+ If none of the tags referred in the group can be
+ found, the whole group is omitted. Example:
+ <parameter>[~/.mpd/recorder/[%artist% -
+ ]%title%.ogg]</parameter> (this omits the dash
+ when no artist tag exists; if title also doesn't
+ exist, no file is written)
+ </para>
+
+ <para>
+ The operators "|" (logical "or") and "&amp;"
+ (logical "and") can be used to select portions of
+ the format string depending on the existing tag
+ values. Example:
+ <parameter>~/.mpd/recorder/[%title|%name%].ogg</parameter>
+ (use the "name" tag if no title exists)
+ </para>
+ </entry>
+ </row>
+
<row>
<entry>
<varname>encoder</varname>