From Snakeoil OS Reference
Jump to navigation Jump to search

Upmpdcli is primarily a UPnP Renderer front-end to the MPD music player. It is available in the Activated version of Snakeoil and can be installed by selecting upmpdcli in Music Software.

Upmpdcli select2.jpg

It can be used in a UPnP setup with a UPnP Server (e.g. MinimServer running on a NAS) and a UPnP controller app (e.g. BubbleUPnP on Android, mConnect on iOS). This may provide the best of both worlds, mpd playback sound quality with the better library & tags configuration of MinimServer plus a good UI with BubbleUPnP App.

Another option is to combine it with Logitech Media Server (LMS) with the DLNA/UPnP Bridge plugin installed. Upmpdcli can then be used as a player for LMS, providing mpd playback sound quality, but retaining the features of LMS and continue using the LMS phone app.

SnakeOil Music Player options

  1. Upmpdcli should be enabled with any available version of MPD in SnakeOil. It will not work if MPD is not running. With this setup, upmpdcli will work as a UPnP renderer end point.
  2. Alternately, enable upmpdcli with MPD as a music player and use either MinimServer or LMS as the music server.

Using upmpdcli with LMS as music server

Select LMS as server and upmpdcli and any version of MPD as client.

SnakeOil Player tab

Set up the MPD output and Save.

Mpd output.jpg

Using the LMS Web page, go into Settings.

LMS Plugin tab

Enable UpnP/DLNA bridge, restart LMS.  Go into the bridge settings

Bridge settings page

If this is a new setup, you will need to Generate configuration file; it will take 30 seconds or more.

Generate configuration

You will now have a list of UPnP players (renderers), including UpMpd-UpnP/AVE, for use with LMS

Choose player

Select the UpMPD player.  Please note that upmpdcli can take 30 seconds or more to start up.


Upmpdcli documentation: https://www.lesbonscomptes.com/upmpdcli/upmpdcli-manual.html

Configuration File


This file is the base file used to run your instance. Put any of your customisations in there.

TODO: Your changes will disappear after a firmware update. So need to develop a workaround on this.

Security Risks of using UPnP

A major problem with UPnP is that it doesn’t require any authentication or authorization. Although this adds a lot of convenience for us, it’s also very risky. It allows hackers to find backdoors into your network and get remote access to your devices with ease. Please do a search of "UPnP security vulnerability" to understand the security risks of using UPnP.