diff options
Diffstat (limited to 'INSTALL')
| -rw-r--r-- | INSTALL | 99 |
1 files changed, 99 insertions, 0 deletions
diff --git a/INSTALL b/INSTALL new file mode 100644 index 000000000..75d8fc7d9 --- /dev/null +++ b/INSTALL @@ -0,0 +1,99 @@ + Music Player Daemon (MPD) - INSTALL + +Requirements +------------ + +libao - http://www.vorbis.com/download_unix.psp +(This comes with most/all distributions. Make sure you have both +the ao libs and development packages for your distribution installed. +For Red Hat 8.0, the necessary packages are: libao and libao-devel) + +zlib - http://www.gzip.org/zlib +(This comes with all distributions. Make sure you have bot the zlib libs +and development packages for your distribution installed. For Red hat, +the necessary packages are: zlib and zlib-devel) + +Optional +-------- + +Ogg Vorbis - http://www.xiph.org/ogg/vorbis/ +(This comes with most/all distributions. Make sure you have both the +ogg and vorbis libs as well as the development packages for your +distribution installed. For Red Hat 8.0, the necessary packages are: +libogg, libogg-devel, libvorbis, and libvorbis-devel). + +Flac - http://flac.sf.net +For Flac support, you need Flac 1.1.0 or greater. + +Download +-------- + +Get the latest release from of MPD from http://www.musicpd.org + +Compile +------- + +1) unzip and untar the archive + +$ tar zxvf mpd-x.x.x.tar.gz + +2) change to directory created + +$ cd mpd-x.x.x + +3) Run configure script (this will determine what dependencies you have) + +$ ./configure + +4) Compile + +$ make + +Install (Optional) +------- + +(as root) +$ make install + +Run +--- + +1) run mpd: +<port>: port number daemon listens on (if running as a user, this should be + greater than 1024) +<mp3 directory>: directory containing mp3's +<playlist directory>: directory where playlists will be stored (and .mpddb will + be placed) +<mpd log>: log file for mpd +<mpd err>: error log file for mpd + +$ mpd <port> <mp3 directory> <playlist directory> <mpd log> <mpd err> + +example where mpd executable is in mpd-x.x.x directory: +$ mpd-x.x.x/mpd 2100 mp3 playlists mpd.log mpd.err + +Note: The first time you run mpd, it will "explore" your mp3 directory for +mp3's. + +Also, mpd can alternatively use config file. In this case, +run mpd like this: + +$ mpd <config file> + +(if no config file is specified, mpd's looks for ~/.mpdconf then /etc/mpd.conf) + +an example would be: + +$ mpd playlists/.mpdconf + +A sample config file is included with the source of MPD, mpdconf.example . + +Using MPD +--------- + +You can download a web interface (phpMp) to MPD at +http://www.musicpd.org . + +Also, several other clients can be found for MPD at http://www.musicpd.org . + +MPD can be interfaced directly using telnet (see COMMANDS, if you are brave). |