106 lines
2.5 KiB
Plaintext
106 lines
2.5 KiB
Plaintext
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.
|
|
|
|
FAAD2 - http://faac.sf.net
|
|
For MP4/AAC support.
|
|
|
|
Audiofile - http://www.68k.org/~michael/audiofile/
|
|
For wave support.
|
|
|
|
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).
|