MPD

From Gentoo Wiki
Jump to: navigation, search
External resources

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 its network protocol. For more information, read about what mpd is and is not.

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.

→ Information about USE flags
USE flag Default Recommended Description
alsa Yes Yes Adds support for media-libs/alsa-lib (Advanced Linux Sound Architecture)
curl Yes Yes Support for web stream listening
flac No Yes Adds support for FLAC: Free Lossless Audio Codec
id3tag Yes Yes Support for ID3 tags
mad Yes Yes Adds support for mad (high-quality mp3 decoder library and cli frontend)
ogg No Yes Adds support for the Ogg container format (commonly used by Vorbis, Theora and flac)
unicode No Yes Adds support for Unicode
vorbis No Yes Adds support for the OggVorbis audio codec
wavpack No Yes Add support for wavpack audio compression tools

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

root # emerge --ask 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

You can now start MPD:

root # /etc/init.d/mpd start

To start MPD at boot time, add it your 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

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 f.e. 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 your Bluetooth headset first, according to this wiki. Put a user level ~/.asoundrc file in MPD's $HOME directory, which is /var/lib/mpd by default.

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		"bluetooth"
 }

Clients

Commandline/Console

Graphical (GTK+)

Graphical (Qt)

Scrobblers

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

Troubleshooting

For general troubleshooting refer to the excellent MPD troubleshooting section.

External resources