diff options
Diffstat (limited to 'doc/user.xml')
| -rw-r--r-- | doc/user.xml | 215 |
1 files changed, 212 insertions, 3 deletions
diff --git a/doc/user.xml b/doc/user.xml index 22da500b1..6e039ebde 100644 --- a/doc/user.xml +++ b/doc/user.xml @@ -11,6 +11,30 @@ This document is work in progress. Most of it may be incomplete yet. Please help! </para> + + <para> + MPD (Music Player Daemon) is, as the name suggests, a server + software allowing you to remotely play your music, handle + playlists, deliver music (HTTP STREAMS with various + sub-protocols) and organizze playlists. + </para> + + <para> + It has been written with minimal resource usage and stability in + mind! Infact, it runs fine on a Pentium 75, allowing you to use + your cheap old PC to create a stereo system! + </para> + + <para> + MPD supports also Gapless playback, buffered audio output, and + crossfading! + </para> + + <para> + The separate client and server design allows users to choose a + user interface that best suites their tastes independently of + the underlying daemon, which actually plays music! + </para> </chapter> <chapter> @@ -26,10 +50,16 @@ <title>Installing on Debian/Ubuntu</title> <para> - Install the package <filename>mpd</filename>: + Install the package <filename>mpd</filename> via APT: </para> <programlisting>apt-get install mpd</programlisting> + + <para> + When installed this way, MPD by default looks for music in + /var/lib/mpd/music/; this may not be correct. Look at your + /etc/mpd.conf file... + </para> </section> <section> @@ -41,8 +71,8 @@ page</ulink> and unpack it: </para> - <programlisting>tar xjf mpd-0.14.2.tar.bz -cd mpd-0.14.2</programlisting> + <programlisting>tar xjf mpd-version.tar.bz +cd mpd-version</programlisting> <para> Make sure that all the required libraries and build tools are @@ -737,6 +767,28 @@ cd mpd-0.14.2</programlisting> The <varname>pipe</varname> plugin starts a program and writes raw PCM data into its standard input. </para> + + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>Setting</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry> + <varname>command</varname> + <parameter>CMD</parameter> + </entry> + <entry> + This command is invoked with the shell. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> </section> <section> @@ -746,6 +798,40 @@ cd mpd-0.14.2</programlisting> The <varname>pulse</varname> plugin connects to a PulseAudio server. </para> + + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>Setting</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry> + <varname>server</varname> + <parameter>HOSTNAME</parameter> + </entry> + <entry> + Sets the host name of the PulseAudio server. By + default, MPD connects to the local PulseAudio + server. + </entry> + </row> + <row> + <entry> + <varname>sink</varname> + <parameter>NAME</parameter> + </entry> + <entry> + Specifies the name of the PulseAudio sink MPD should + play on. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> </section> <section> @@ -755,6 +841,129 @@ cd mpd-0.14.2</programlisting> The <varname>shout</varname> plugin connects to a ShoutCast or IceCast server. It forwards tags to this server. </para> + + <para> + You must set a <varname>format</varname>. + </para> + + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>Setting</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry> + <varname>host</varname> + <parameter>HOSTNAME</parameter> + </entry> + <entry> + Sets the host name of the Shoutcast/Icecast server. + </entry> + </row> + <row> + <entry> + <varname>port</varname> + <parameter>PORTNUMBER</parameter> + </entry> + <entry> + Connect to this port number on the specified host. + </entry> + </row> + <row> + <entry> + <varname>timeout</varname> + <parameter>SECONDS</parameter> + </entry> + <entry> + Set the timeout for the shout connection in seconds. + Defaults to 2 seconds. + </entry> + </row> + <row> + <entry> + <varname>mount</varname> + <parameter>URI</parameter> + </entry> + <entry> + Mounts the MPD stream in the specified URI. + </entry> + </row> + <row> + <entry> + <varname>user</varname> + <parameter>USERNAME</parameter> + </entry> + <entry> + Sets the user name for submitting the stream to the + server. Default is "source". + </entry> + </row> + <row> + <entry> + <varname>password</varname> + <parameter>PWD</parameter> + </entry> + <entry> + Sets the password for submitting the stream to the + server. + </entry> + </row> + <row> + <entry> + <varname>name</varname> + <parameter>NAME</parameter> + </entry> + <entry> + Sets the name of the stream. + </entry> + </row> + <row> + <entry> + <varname>genre</varname> + <parameter>GENRE</parameter> + </entry> + <entry> + Sets the genre of the stream (optional). + </entry> + </row> + <row> + <entry> + <varname>description</varname> + <parameter>DESCRIPTION</parameter> + </entry> + <entry> + Sets a short description of the stream (optional). + </entry> + </row> + <row> + <entry> + <varname>public</varname> + <parameter>yes|no</parameter> + </entry> + <entry> + Specifies whether the stream should be "public". + Default is "no". + </entry> + </row> + <row> + <entry> + <varname>encoder</varname> + <parameter>PLUGIN</parameter> + </entry> + <entry> + Sets the name of the encoder plugin. Default is + "vorbis". "vorbis" and "lame" are valid encoder + plugins (provided that you enabled them at compile + time). + </entry> + </row> + </tbody> + </tgroup> + </informaltable> </section> <section> |