From Gentoo Wiki
Jump to:navigation Jump to:search

upmpdcli is a free and open source UPnP media renderer front-end for Music Player Daemon (MPD). It allows MPD to be controlled with a UPnP control point (e.g. BubbleUPnP). upmpdcli also allows a single UPnP library to be shared between UPnP control points/renderers and MPD, meaning MPD can be run without a database.


This article assumes that MPD and a UPnP media server such as Gerbera have been previously configured.


USE Flags

USE flags for media-sound/upmpdcli UPnP Media Renderer front-end for MPD, the Music Player Daemon

thirdparty Enable streaming from Qobuz and Tidal external services


root #emerge --ask media-sound/upmpdcli


Below is a snippet of the default upmpdcli configuration file. Options prefixed with # are commented out because they are set to default values. The options that need to be set are upnpiface or upnpip and mpdhost. If the UPnP or MPD ports have been changed from their defaults, then upnpport and mpdport should be set accordingly.

FILE /etc/upmpdcli.conf
# upmpdcli general parameters
#logfilename = /var/log/upmpdcli.log
#loglevel = 2
#pidfile = /var/run/upmpdcli.pid

# upnp network parameters
#upnpiface =
upnpip =
#upnpport =

# media renderer parameters
#friendlyname = UpMpd
#upnpav = 1
#openhome = 1
#lumincompat = 0
#saveohcredentials = 1
#checkcontentformat = 1
#iconpath = /usr/share/upmpdcli/icon.png
#cachedir = /var/cache/upmpdcli
#presentationhtml = /usr/share/upmpdcli/presentation.html

# mpd parameters
mpdhost =
#mpdport = 6600
#mpdpassword =
#ownqueue = 1

upmpdcli relies on MPD's curl input plugin which should be enabled by default. It can be explicitly enabled by adding the following to the MPD configuration file:

FILE /etc/mpd.conf
input {
	plugin			"curl"
	enabled			"yes"

Restart MPD for the changes to take effect:

root #rc-service mpd restart



Start upmpdcli:

root #rc-service upmpdcli start

Start upmpdcli at boot:

root #rc-update add upmpdcli default


Start upmpdcli:

root #systemctl start upmpdcli

Start upmpdcli at boot:

root #systemctl enable upmpdcli

See also

  • MPD — a flexible, server-side application for playing music.

External resources