Players/upmpdcli: Difference between revisions

From Snakeoil OS Reference
Jump to navigation Jump to search
m (Added security risks)
 
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{DISPLAYTITLE: upmpdcli}}{{abox|Work in progress}}Upmpdcli is primarily a UPnP Renderer front-end to the MPD music player. 
{{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 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.
 
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.




Line 9: Line 12:
==SnakeOil Music Player options==
==SnakeOil Music Player options==


#Upmpdcli can be selected as a music server in SnakeOil. With this setup, upmpdcli will work as a UPnP renderer end point.
#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, select upmpdcli as a music player and use either [[Players/minimserver|MinimServer]]  or [[Players/LMS-Squeezelite|LMS]] as the music server.
#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===
===Using upmpdcli with LMS as music server===
[[File:Upmpdcli player.jpg|left|thumb|900x900px|SnakeOil Player tab]]
Select LMS as server and upmpdcli and any version of MPD as client.   
 
[[File:Upmpdcli setup2.jpg|alt=|center|thumb|900x900px|SnakeOil Player tab]]
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
Select LMS as server and upmpdcli as client.  Using the LMS Web page, go into Settings.
[[File:UPnP plugin.jpg|left|frame|LMS Plugin 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
Enable UpnP/DLNA bridge, restart LMS.  Go into the bridge settings
[[File:Bridge setup.jpg|left|thumb|900x900px|Bridge settings page]]


[[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.
If this is a new setup, you will need to Generate configuration file; it will take 30 seconds or more.
[[File:Generate config.jpg|left|thumb|900x900px|Generate configuration]]


[[File:Generate config.jpg|thumb|900x900px|Generate configuration|alt=|center]]


You will now have a list of UPnP players (renderers), including UpMpd-UpnP/AVE, for use with LMS
You will now have a list of UPnP players (renderers), including UpMpd-UpnP/AVE, for use with LMS
[[File:Select Player.jpg|left|thumb|600x600px|Choose player]]


[[File:Select Player.jpg|thumb|600x600px|Choose player|alt=|center]]


Select the UpMPD player.  Please note that upmpdcli can take 30 seconds or more to start up.
Select the UpMPD player.  Please note that upmpdcli can take 30 seconds or more to start up.
==Upmpdcli tweaks==
Upmpdcli can be tweaked to provide simultaneous dual outputs.  The method to do this is similar to the MPD process
[[Players/musicpd#Dual outputs]]
==Links==
==Links==
Upmpdcli documentation: https://www.lesbonscomptes.com/upmpdcli/upmpdcli-manual.html
Upmpdcli documentation: https://www.lesbonscomptes.com/upmpdcli/upmpdcli-manual.html
Line 140: 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.