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.6.3.tar.gz is still there.

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-20210627.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 the Buster one also has arm64 packages.

Streaming services: the streaming services plugins are provided by separate packages (upmpdcli-spotify, upmpdcli-qobuz, upmpdcli-tidal), and you need to install them separately.

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-get update
sudo apt-get install upmpdcli
# Optional streaming services
sudo apt-get install upmpdcli-qobuz
sudo apt-get install upmpdcli-spotify
# Optional Songcast gateway
sudo apt-get install sc2mpd
# Optional Songcast Receiver control web interface
sudo apt-get install scweb


PPA for production packages:

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

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

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

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. Use E-Mail if you run into trouble, I’ll be glad to help.

comments powered by Disqus