INSTALL

   1                        Music Player Daemon (MPD) - INSTALL
   2
   3 Optional Output Dependencies
   4 ----------------------------
   5
   6 You will need at least one of these to compile MPD.
   7
   8 Most of these are available as packages on major distributions.  Be sure to
   9 install both the library package as well as the development package.
  10
  11 AO - http://www.xiph.org/ao/
  12 A portable library that abstracts many audio output types as one API.  Should
  13 be used only if there is no native plugin available or if the native plugin
  14 doesn't work.  You will need libao.
  15
  16 ALSA - http://www.alsa-project.org/
  17 The Advanced Linux Sound Architecture.  Recommended audio output if you use
  18 Linux.  You will need libasound.
  19
  20 PulseAudio - http://www.pulseaudio.org/
  21 An advanced sound daemon.  You will need libpulse.
  22
  23 JACK - http://www.jackaudio.org/
  24 A low-latency sound daemon.
  25
  26 libshout - http://www.icecast.org/
  27 For streaming to an Icecast or Shoutcast server.
  28
  29 Optional Input Dependencies
  30 ---------------------------
  31
  32 You will need at least one of these to compile MPD.
  33
  34 Most of these are available as packages on major distributions.  Be sure to
  35 install both the library package as well as the development package.
  36
  37 MAD - http://www.underbit.com/products/mad/
  38 For MP3 support.  You will need libmad, and optionally libid3tag if you want
  39 ID3 tag support.
  40
  41 Ogg Vorbis - http://www.xiph.org/ogg/vorbis/
  42 For Ogg Vorbis support.  You will need libogg and libvorbis.
  43
  44 FLAC - http://flac.sourceforge.net/
  45 For FLAC support.  You will need version 1.1.0 or higher of libflac.
  46
  47 OggFLAC - http://www.xiph.org/ogg/vorbis/ and http://flac.sourceforge.net/
  48 For OggFLAC support.  You will need liboggflac, which can be built from the
  49 FLAC sources if libogg is already installed.  Versions of flac 1.1.3 and
  50 greater will automatically detect and use OggFLAC if it's available.
  51
  52 Audio File - http://www.68k.org/~michael/audiofile/
  53 For WAVE, AIFF, and AU support.  You will need libaudiofile.
  54
  55 FAAD2 - http://www.audiocoding.com/
  56 For MP4/AAC support.  You will need libmp4ff.
  57
  58 libmpcdec - http://www.musepack.net/
  59 For Musepack support.
  60
  61 MikMod - http://mikmod.raphnet.net/
  62 For MOD support.  You will need libmikmod.
  63
  64 Optional Miscellaneous Dependencies
  65 -----------------------------------
  66
  67 Avahi - http://www.avahi.org/
  68 For Zeroconf support.
  69
  70 libsamplerate - http://www.mega-nerd.com/SRC/
  71 For advanced samplerate conversions.
  72
  73 Download
  74 --------
  75
  76 Get the latest release from of MPD from <http://www.musicpd.org/>.
  77
  78 Compile
  79 -------
  80
  81 1) unzip and untar the archive
  82
  83 $ tar zxvf mpd-x.x.x.tar.gz
  84
  85 or
  86
  87 $ tar jxvf mpd-x.x.x.tar.bz2
  88
  89 2) change to directory created
  90
  91 $ cd mpd-x.x.x
  92
  93 3) Run configure script (this will determine what dependencies you have)
  94
  95 $ ./configure
  96
  97 4) Compile
  98
  99 $ make
 100
 101 Install (Optional)
 102 -------
 103
 104 (as root)
 105 $ make install
 106
 107 Run
 108 ---
 109
 110 1) run mpd:
 111
 112 $ mpd <config file>
 113
 114 (if no config file is specified, mpd's looks for ~/.mpdconf then /etc/mpd.conf)
 115
 116 an example would be:
 117
 118 $ mpd playlists/.mpdconf
 119
 120 A sample config file is included with the source of MPD, mpdconf.example .
 121
 122 Note: The first time you run mpd, it will "explore" your mp3 directory for
 123 mp3's.
 124
 125 Using MPD
 126 ---------
 127
 128 You can download many different interfaces for MPD at
 129         <http://mpd.wikia.com/wiki/Clients>
 130
 131 MPD can be interfaced directly using telnet (see COMMANDS, if you are brave).