Skip to content

Music Assistant has support for devices running Music Player Daemon (MPD). Contributed and maintained by Gavin

  • Stream music from Music Assistant to any device running MPD
  • Pause, seek, and volume control supported

MPD players are not auto-discovered. Each MPD server must be added in the provider settings. Entry is done by adding either IP or IP:PORT into the MPD SERVERS field. If no port is added then 6600 is assumed. As each server is added click outside of the entry box to cause the entry to be accepted.

If the MPD server requires a password then the player will be setup but will be inactive until the password is set on the individual player

MPD is available for Linux, Windows, and macOS. See the MPD download page for installation instructions.

Music Assistant sends the audio to MPD, but MPD still needs to know where to send it next. That means an output has to be configured in mpd.conf, usually ALSA. Without one, MPD will accept the music and play it nowhere. A minimal example:

audio_output {
type "alsa"
name "My Output"
mixer_type "software"
}

For full configuration options refer to the MPD audio output documentation.

MPD players use the standard Individual Player Settings, including the settings shared by most protocols. These differ on MPD:

  • FLAC cannot be used here. MPD needs to look through the whole file before it will play FLAC, which it cannot do with a continuous stream
  • Flow mode is always on for MPD players and cannot be turned off. It is the only way Music Assistant can feed audio to MPD
  • Volume control only appears if a mixer has been set up in MPD. Without one, there is nothing for Music Assistant to control
  • MPD passes on whatever it is given without limiting the quality, so what you get depends on your sound hardware and on the Output Codec chosen above. WAV sounds best but uses far more of your network

This website uses privacy-first analytics to help us improve the site. You can view all data in our public dashboard.