Source code

The Source repository is on

See the following for documentation about building, configuration and the Release notes.

Current version (tar files):

upmpdcli-1.7.9.tar.gz is still there.

Cutting edge: the Source repository is on framagit. You will also need the one for libupnpp and libnpupnp.

For building sc2mpd, it is possible to extract the OpenHome libraries code from github during the build, but it is simpler to use a prepared tar file: openhome-sc2-20230424.tar.gz.

The new libnpupnp library, has a rationale document here, with pointers to a pupnp porting guide and full documentation.


Various levels of installation help exist for Debian, Ubuntu, and Gentoo. If no package exists for your system, see the link to building instructions above.

If upmpdcli works well for you, you may help with the maintenance and show your appreciation by following the links on the donations page: btn donate LG


All the binary upmpdcli packages listed below install an appropriate systemd or init script to automatically start the daemon. For trying things out, just installing the package on the host where MPD is running will get you a usable system.

If MPD is not running on the same host, you need need to edit the configuration file, /etc/upmpdcli.conf to set the MPD host name or address.

You may also want to edit the configuration file to set the UPnP renderer friendly name, for ease of use if you have several upmpdcli instances on the network.


You will find Debian packages for different releases and hardware architectures. If your configuration is not covered, you can build your own using the source packages, which is not hard. See a sample build sequence here.

The Raspbian repositories for stretch and buster also work for regular ARM Debian (e.g. armbian), and some also have arm64 packages.

Media Server plugins: they are provided by separate packages (e.g. upmpdcli-qobuz, upmpdcli-radio-browser, upmpdcli-subsonic), and you need to install them separately. Have a look at the documentation to see what you may like to have.

December 2020: updating the expired key. Because the format of the sources list file slightly changed to conform to newer Debian practises (using a signed-by attribute), you need both to import the repository keyring, and update your sources file.


sudo apt update
sudo apt install upmpdcli
# Optional Songcast gateway
sudo apt install sc2mpd

Media Server plugins: The packages are named upmpdcli-xxx where xxx is the plugin name. The following plugins are available:

sudo apt install upmpdcli-bbc                # BBC radio plugin.
sudo apt install upmpdcli-deezer             # Deezer plugin.
sudo apt install upmpdcli-hra                # highresaudio plugin
sudo apt install upmpdcli-mother-earth-radio # Mother Earth Radio plugin
sudo apt install upmpdcli-qobuz              # Qobuz plugin
sudo apt install upmpdcli-radio-browser      # plugin
sudo apt install upmpdcli-radio-paradise     # Radio Paradise plugin
sudo apt install upmpdcli-radios             # radio list export plugin (exports the local
                                             # OpenHome radio list)
sudo apt install upmpdcli-subsonic           # Subsonic plugin
sudo apt install upmpdcli-tidal              # Tidal plugin. You will need to install the
                                             # tidalapi Python3 module with pip3.
sudo apt install upmpdcli-uprcl              # local Media Server plugin

Configuration file editor GUI:

sudo apt install upmpdcli-config


upmpdcli PPA:

sudo add-apt-repository ppa:jean-francois-dockes/upnpp1

Once the PPA is installed, see the Debian section above for the installation instructions and package names.

If you need to build for a platform not supported by the PPA, you can use the sample Debian build sequence.

Docker images

Giovanni Fulco maintains up to date and complete Docker images for mpd and upmpdcli on Github (in additions to his many contributions to the Upmpdcli Media Server plugins).

Comments and support

Please use the Disqus comments for praise, insults, or for tips which may help others. Use the issue tracker for problem reports and enhancement suggestions. You can create an issue without a framagit account by sending an E-mail. You can also use E-Mail if you run into trouble, I’ll be glad to help.

comments powered by Disqus