MPD

From Gentoo Wiki
Jump to: navigation, search

MPD (Music Player Daemon) is a flexible, server-side application for playing music. Through plugins and libraries it can play a variety of sound files while being controlled by a network protocol.

Installation

Install media-sound/mpd. Following minimal USE flags set is needed to be able to play most known audio file formats, and to listen to audio streams. For more features review the USE flags.

USE flags for media-sound/mpd The Music Player Daemon (mpd)

adplug Enable the AdPlug decoder plugin
ao Use libao audio output library for sound playback
audiofile Add support for libaudiofile where applicable
bzip2 Use the bzlib compression library
cdio Use libcdio for ISO9660 parsing support
chromaprint Enable ChromaPrint / AcoustID support
cue Enable CUE sheet support
curl Support for web stream listening
dbus Enable dbus support for anything that needs it (gpsd, gnomemeeting, etc)
eventfd Use the eventfd function in MPD's event loop
expat Enable the use of dev-libs/expat for XML parsing
faad Use external faad library for AAC decoding
fifo Support writing audio to a FIFO
flac Add support for FLAC: Free Lossless Audio Codec
fluidsynth Enables Fluidsynth MIDI software synthesis (discouraged)
gme Enables support for media-libs/game-music-emu for playing various video game music formats.
id3tag Support for ID3 tags
inotify Use the Linux kernel inotify subsystem to notice changes to mpd music library
lame Support for MP3 streaming via Icecast2
libav Prefer libav over ffmpeg whenever both are supported
libmpdclient Enable support for remote mpd databases
libsoxr Enable the libsoxr resampler
mad Add support for mad (high-quality mp3 decoder library and cli frontend)
mikmod Add libmikmod support to allow playing of SoundTracker-style music files
mms Support for Microsoft Media Server (MMS) streams
modplug Add libmodplug support for playing SoundTracker-style music files
mpg123 Enable support for mp3 decoding over media-sound/mpg123
musepack Enable support for the musepack audio codec
network Enables network streaming support
nfs Enable support for the Network File System
openal Add support for the Open Audio Library
opus Enable Opus audio codec support
pipe Support writing audio to a pipe
qobuz Build plugin to access qobuz
recorder Enables output plugin for recording radio streams
sid Build with SID (Commodore 64 Audio) support
signalfd Use the signalfd function in MPD's event loop
soundcloud Build plugin to access soundcloud
sqlite Add support for sqlite - embedded sql database
systemd Enable support for systemd socket activation
tcpd Add support for TCP wrappers
tidal Build plugin to access tidal
twolame Support twolame MPEG-2 encoding
vorbis Add support for the OggVorbis audio codec
wavpack Add support for wavpack audio compression tools
webdav Enable using music from a WebDAV share
wildmidi Enable MIDI support via wildmidi

Note that a number of these flags are added by the desktop profile.

root #emerge --ask media-sound/mpd

Configuration

After finished installation MPD should be working with the Gentoo shipped default configuration.

Basic configuration

Below an example of a simple configuration:

FILE /etc/mpd.conf
music_directory      "/var/lib/mpd/music"
playlist_directory   "/var/lib/mpd/playlists"
db_file              "/var/lib/mpd/database"
log_file             "/var/lib/mpd/log"
state_file           "/var/lib/mpd/state"

user                 "mpd"

bind_to_address      "localhost"
bind_to_address      "/var/lib/mpd/socket"

input {
        plugin "curl"
}

At this point MPD should be able to run as a system daemon with its own user called mpd, which is the default setting of MPD.

Service

OpenRC

Start MPD with:

root #rc-service mpd start

To start MPD at boot time, add it the default runlevel:

root #rc-update add mpd default

PulseAudio (optional)

If MPD was build with PulseAudio support (pulseaudio USE flag), add a dedicated audio_output section to your /etc/mpd.conf:

FILE /etc/mpd.conf
audio_output {
        type            "pulse"
        name            "Pulse Output"
        mixer_control   "Master"
}
Note
It may be a good practice to run both PulseAudio and MPD under X11 user instead.

Built-in HTTP streaming server (optional)

If MPD was build with network USE flag, add a dedicated audio_output section to your /etc/mpd.conf:

FILE /etc/mpd.conf
audio_output {    
        type            "httpd"
        name            "HTTP Stream"
        encoder         "vorbis"                # optional, vorbis(OGG) or lame(MP3)
        port            "8000"
        bitrate         "192"                   # do not define if quality is defined      
        format          "44100:16:1"
}

bind_to_address "0.0.0.0"

Replace localhost with 0.0.0.0 or a specific interface IP. Bind to address 0.0.0.0 means here: stream on all local found IP interfaces. You could change it to a specific interface IP address like e.g. 192.168.1.2 then the streaming server is bound to that interface IP only.

Note
Some players require to specify the file format in the URL to be able to connect to the stream. Example: http://192.168.1.2:8000/mpd.ogg

Running as a specific user (optional)

Sometimes it may be handy to run MPD as a specific user.

Start with copying /etc/mpd.conf to ~/.mpdconf. There are some changes that you will have to change in order to run MPD as a user, most importantly user and group, also make sure the various path settings are correct:

FILE ~/.mpdconfuser definition
user    "YOUR_USER"
group   "YOUR_USER"

Make sure your user has read access to the directory you specify in music_directory.

Note
If your cron program supports @reboot you can create a cronjob that has /usr/bin/mpd start at boot in place of the init script.

Bluetooth headset (optional)

Setup a Bluetooth headset first, according to the Bluetooth Headset article.

ALSA (non-PulseAudio) setup with BlueZ 5

Put a user level ~/.asoundrc file in MPD's $HOME directory, which is /var/lib/mpd by default. MPD will be able to control the volume of the headset.

FILE /var/lib/mpd/.asoundrc
# Specify the parameters of the Bluetooth connection
defaults.bluealsa {
     interface "hci0"            # host Bluetooth adapter
     device "XX:XX:XX:XX:XX:XX"  # Bluetooth headset MAC address
     profile "a2dp"
}

To be able to switch between the Bluetooth headset and the default sound card, add these lines to the audio_output section in /etc/mpd.conf:

FILE /etc/mpd.conf
audio_output {
        type            "alsa"
        name            "My ALSA Device"
}

audio_output {
        type            "alsa"
        name            "ALSA Bluetooth Headset"
        device          "bluealsa"
        mixer_type    "software"
}

MPD might crash when switching output _while_ playing (if so, pause before switching).

If you experience some issues while trying to play AAC or other files, like:

user $mpd --no-daemon --stderr
...
alsa_output: Failed to open "My ALSA Device" [alsa]: Error opening ALSA device "bluealsa" (snd_pcm_hw_params): Invalid argument
...

Then add this line to your audio_output:

FILE /etc/mpd.conf
        format          "44100:16:2"

ALSA (non-PulseAudio) setup with BlueZ 4 (deprecated)

Put a user level ~/.asoundrc file in MPD's $HOME directory, which is /var/lib/mpd by default. The following example creates an extra "Bluetooth" slider in any mixer application, and enables MPD to control the volume of the headset:

FILE /var/lib/mpd/.asoundrc
# Change device to the MAC address of your headset
pcm.btheadset {
   type plug
   slave {
      pcm {
         type bluetooth
         device "XX:XX:XX:XX:XX:XX"
         profile "auto"
      }
   }
   hint {
      show on
      description "Bluetooth Headset"
   }
}

ctl.btheadset {
   type bluetooth
}

pcm.btheadset_softvol {
   type softvol
   slave.pcm "btheadset"
   control.name "Bluetooth"
   control.card 0
}

# Using bluetooth as default:
#pcm.!default {
#   type plug
#   slave.pcm "btheadset_softvol"
#}

To be able to switch between the Bluetooth headset and the default sound card, add these lines to the audio_output section in /etc/mpd.conf:

FILE /etc/mpd.conf
audio_output {
        type            "alsa"
        name            "My ALSA Device"
}

audio_output {
        type            "alsa"
        name            "ALSA Bluetooth Headset"
        device          "btheadset_softvol"
        mixer_type      "software"
}

MPD might go crazy when switching output _while_ playing, and fill its log (if so, pause before switching).

If you experience some issues while trying to play AAC or other files, like:

user $mpd --no-daemon --stderr
...
alsa_output: Failed to open "My ALSA Device" [alsa]: Error opening ALSA device "bluealsa" (snd_pcm_hw_params): Invalid argument
...

Then add this line to your audio_output:

FILE /etc/mpd.conf
        format          "44100:16:2"

Clients

Commandline/Console

Graphical (GTK+)

Graphical (Qt)

Web

  • ympd — MPD Web GUI - written in C, utilizing Websockets and Bootstrap/JS

Scrobblers

Scrobblers are clients that submit to Audioscrobbler — compatible services (eg. libre.fm or last.fm)

Troubleshooting

For general troubleshooting refer to the MPD user manual troubleshooting section

See also

  • Upmpdcli — a free and open source UPnP media renderer front-end for Music Player Daemon (MPD).

External resources