Players/upmpdcli: Difference between revisions

From Snakeoil OS Reference
Jump to navigation Jump to search
(Added links, why use)
m (Added security risks)
 
(13 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{DISPLAYTITLE: upmpdcli}}{{abox|Work in progress}}Upmpdcli takes the [[Players/musicpd|MPD]] music player and adds music file management plus streaming services (e.g. Tidal, Qobuz). It provides a wrapper around MPD to make it a UPnP renderer and thus can be used in an UPNP setup. Requires an UPnP Server (e.g. [[Players/minimserver|MinimServer]] running on a NAS) and a UPnP controller app (e.g. BubbleUPnP on Android, mConnect on iOS).
{{DISPLAYTITLE: upmpdcli}}


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. 
[[File:Upmpdcli select2.jpg|center|thumb|900x900px]]


It can be installed as a music server in SnakeOil and thus work only as a renderer end point. Another option is install [[Players/minimserver|MinimServer]] as the music server and upmpdcli as the music player to provide an all-in-one solution.


== Links ==
It can be used in a UPnP setup with a UPnP Server (e.g. [[Players/minimserver|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. 
Upmpdcli documentation: https://www.lesbonscomptes.com/upmpdcli/upmpdcli-manual.html
 
 
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==
 
#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.
#Alternately, enable upmpdcli with MPD as a music player and use either [[Players/minimserver|MinimServer]]  or [[Players/LMS-Squeezelite|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. 
[[File:Upmpdcli setup2.jpg|alt=|center|thumb|900x900px|SnakeOil Player tab]]
 
 
Set up the MPD output and Save.
[[File:Mpd output.jpg|center|thumb|900x900px]]
 
 
 
Using the LMS Web page, go into Settings.
 
[[File:UPnP plugin.jpg|frame|LMS Plugin tab|alt=|center]]
 
Enable UpnP/DLNA bridge, restart LMS.  Go into the bridge settings
 
[[File:Bridge setup.jpg|thumb|900x900px|Bridge settings page|alt=|center]]
 
 
If this is a new setup, you will need to Generate configuration file; it will take 30 seconds or more.
 
[[File:Generate config.jpg|thumb|900x900px|Generate configuration|alt=|center]]


Upmpdcli and control points: https://www.lesbonscomptes.com/upmpdcli/upmpdcli-manual.html
You will now have a list of UPnP players (renderers), including UpMpd-UpnP/AVE, for use with LMS
<br />


== Why Upmpdcli, MinimServer and BubbleUPnP? ==
[[File:Select Player.jpg|thumb|600x600px|Choose player|alt=|center]]
The following are Snoopy8's motivations for using Upmpdcli. 


Select the UpMPD player.  Please note that upmpdcli can take 30 seconds or more to start up.
==Links==
Upmpdcli documentation: https://www.lesbonscomptes.com/upmpdcli/upmpdcli-manual.html


Why this combination?  I like mpd as a player but let down by its Android client e.g. MPDroid has a basic UI and limited ability to configure the library, tags. I have been using UPnP for a while.  So, by using upmpdcli, it gave me the best of both worlds, good mpd playback with a better UPnP server, MinimServer with its library, tags configuration and a good UI with BubbleUPnP App.
<br />{{TopicPlayers|float:right;}}
<br />{{TopicPlayers|float:right;}}


Line 21: Line 52:
This file is the base file used to run your instance. Put any of your customisations in there.  
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.{{ManualNavigation|[[Players|Music Players]]
 
|[[Players/qmmp|qmmp]]
 
|[[Players/minimserver|minimserver]]
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.

Latest revision as of 17:31, 29 November 2023


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.

Links

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



Configuration File

/var/www/players/upmpdcli/upmpdcli.conf.template

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.