From f1fd21f647b9ee734453b2b47d8bc3675dc93d98 Mon Sep 17 00:00:00 2001 From: Stein Magnus Jodal Date: Tue, 16 Dec 2014 23:00:19 +0100 Subject: [PATCH 1/3] docs: Add upmpdcli as an alternative to Rygel Based on PR #871 by @woutervanwijk. Fixes #871 --- docs/clients/upnp.rst | 52 +++++++++++++++++++++++++++++++++++++------ 1 file changed, 45 insertions(+), 7 deletions(-) diff --git a/docs/clients/upnp.rst b/docs/clients/upnp.rst index 7f21a6c6..9b24ae46 100644 --- a/docs/clients/upnp.rst +++ b/docs/clients/upnp.rst @@ -18,7 +18,7 @@ DLNA Digital Media Server (DMS) / UPnP AV MediaServer: A MediaServer provides a library of media and is capable of streaming that media to a MediaRenderer. If Mopidy was a MediaServer, you could browse and play Mopidy's music on a TV, smartphone, or tablet supporting UPnP. Mopidy - does not currently support this, but we may in the future. :issue:`52` is + does not currently support this, but we may in the future. :issue:`52` is the relevant wishlist issue. DLNA Digital Media Renderer (DMR) / UPnP AV MediaRenderer: @@ -27,13 +27,51 @@ DLNA Digital Media Renderer (DMR) / UPnP AV MediaRenderer: given media, typically served by a MediaServer. If Mopidy was a MediaRenderer, you could use e.g. your smartphone or tablet to make Mopidy play media. Mopidy *does already* have experimental support for being a - MediaRenderer with the help of Rygel, as you can read more about below. + MediaRenderer, as you can read more about below. + + +Mopidy as an UPnP MediaRenderer +=============================== + +There are two ways Mopidy can be made available as an UPnP MediaRenderer: +Using Mopidy-MPRIS and Rygel, or using Mopidy-MPD and upmpdcli. + + +.. _upmpdcli: + +upmpdcli +-------- + +`upmpdcli `_ is recommended, since it +is easier to setup, and offers `OpenHome ohMedia`_ +compatibility. upmpdcli exposes a UPnP MediaRenderer to the network, while +using the MPD protocol to control Mopidy. + +1. Install upmpdcli. On Debian/Ubuntu:: + + apt-get install upmpdcli + + Alternatively, follow the instructions from the upmpdcli website. + +2. The default settings of upmpdcli will work with the default settings of + :ref:`ext-mpd`. Edit :file:`/etc/upmpdcli.conf` if you want to use different + ports, hosts, or other settings. + +3. Start upmpdcli using the command:: + + upmpdcli + + Or, run it in the background as a service:: + + sudo service upmpdcli start + +4. A UPnP renderer should be available now. .. _rygel: -How to make Mopidy available as an UPnP MediaRenderer -===================================================== +Rygel +----- With the help of `the Rygel project `_ Mopidy can be made available as an UPnP MediaRenderer. Rygel will interface with the MPRIS @@ -41,15 +79,15 @@ interface provided by the `Mopidy-MPRIS extension `_, and make Mopidy available as a MediaRenderer on the local network. Since this depends on the MPRIS frontend, which again depends on D-Bus being available, this will only work on Linux, and -not OS X. MPRIS/D-Bus is only available to other applications on the same +not OS X. MPRIS/D-Bus is only available to other applications on the same host, so Rygel must be running on the same machine as Mopidy. -1. Start Mopidy and make sure the MPRIS frontend is working. It is activated +1. Start Mopidy and make sure the MPRIS frontend is working. It is activated by default when the Mopidy-MPRIS extension is installed, but you may miss dependencies or be using OS X, in which case it will not work. Check the console output when Mopidy is started for any errors related to the MPRIS frontend. If you're unsure it is working, there are instructions for how to - test it on in the `Mopidy-MPRIS readme + test it in the `Mopidy-MPRIS readme `_. 2. Install Rygel. On Debian/Ubuntu:: From 02489b02bec23b33895bca9889aeed5a30d1d2cf Mon Sep 17 00:00:00 2001 From: Deni Bertovic Date: Wed, 3 Dec 2014 21:30:32 +0100 Subject: [PATCH 2/3] Add appendinx about xbmc issues XBMC won't boot because a different libtag version got installed with mopidy system wide, and XBMC picks that up insted of the one it vendors in. Added info how to fix this. --- docs/installation/raspberrypi.rst | 33 +++++++++++++++++++++++++++++-- 1 file changed, 31 insertions(+), 2 deletions(-) diff --git a/docs/installation/raspberrypi.rst b/docs/installation/raspberrypi.rst index c13e3ec4..a11aec9c 100644 --- a/docs/installation/raspberrypi.rst +++ b/docs/installation/raspberrypi.rst @@ -74,12 +74,12 @@ you a lot better performance. #. Install Mopidy and its dependencies as described in :ref:`debian-install`. #. Finally, you need to set a couple of :doc:`config values `, and - then you're ready to :doc:`run Mopidy `. Alternatively you may + then you're ready to :doc:`run Mopidy `. Alternatively you may want to have Mopidy run as a :doc:`system service `, automatically starting at boot. -Appendix: Fixing audio quality issues +Appendix A: Fixing audio quality issues ===================================== As of about April 2013 the following steps should resolve any audio @@ -141,3 +141,32 @@ not determined the exact revision that fixed this:: The only remaining known issue is a slight gap in playback at track changes this is likely due to gapless playback not being implemented and is being worked on irrespective of Raspberry Pi related work. + + +Appendix B: XBMC not booting? +============================= + +A very important note for Raspbmc users. Due to a dependency version problem +you might have to make some minor configurations for XBMC to start +properly (this depends on your system’s version). + +If you notice that XBMC is not starting but gets stuck in a loop, +you need to make the following changes. +In short, what you have to do is the following:: + + sudo ln -sf /home/pi/.xbmc-current/xbmc-bin/lib/xbmc/system/libtag.so.1 \ + /usr/lib/arm-linux-gnueabihf/libtag.so.1 + +However, this will not persist the changes. +To persist the changes edit :file:`/etc/ld.so.conf.d/arm-linux-gnueabihf.conf` +and add the following at the top:: + + /home/pi/.xbmc-current/xbmc-bin/lib/xbmc/system + +It's very important to add it at the top of the file as this indicates the priority of the folder +in which to look for shared libraries. XBMC doesn't play nicely with the system wide installed +version of libtag (that got installed with Mopidy) but rather vendors in it's own version. +Hopefully this will fix the issue for you if you're running Raspbmc. +More info about this issue can be found in this `post ` _ as well. +Please note that if you're running Xbian or any other distribution that the instructions might vary. + From 217919884e7154dc6e8cd04cb7f1846bea42901d Mon Sep 17 00:00:00 2001 From: Stein Magnus Jodal Date: Tue, 16 Dec 2014 23:20:18 +0100 Subject: [PATCH 3/3] docs: Edit Raspbmc appendix a bit --- docs/installation/raspberrypi.rst | 37 +++++++++++++++++-------------- 1 file changed, 20 insertions(+), 17 deletions(-) diff --git a/docs/installation/raspberrypi.rst b/docs/installation/raspberrypi.rst index a11aec9c..3c70340c 100644 --- a/docs/installation/raspberrypi.rst +++ b/docs/installation/raspberrypi.rst @@ -80,7 +80,7 @@ you a lot better performance. Appendix A: Fixing audio quality issues -===================================== +======================================= As of about April 2013 the following steps should resolve any audio issues for HDMI and analog without the use of an external USB sound @@ -143,30 +143,33 @@ this is likely due to gapless playback not being implemented and is being worked on irrespective of Raspberry Pi related work. -Appendix B: XBMC not booting? -============================= +Appendix B: Raspbmc not booting +=============================== -A very important note for Raspbmc users. Due to a dependency version problem -you might have to make some minor configurations for XBMC to start -properly (this depends on your system’s version). +Due to a dependency version problem where XBMC uses another version of libtag +than what Debian originally ships with, you might have to make some minor +changes for Raspbmc to start properly after installing Mopidy. If you notice that XBMC is not starting but gets stuck in a loop, -you need to make the following changes. -In short, what you have to do is the following:: +you need to make the following changes:: sudo ln -sf /home/pi/.xbmc-current/xbmc-bin/lib/xbmc/system/libtag.so.1 \ /usr/lib/arm-linux-gnueabihf/libtag.so.1 -However, this will not persist the changes. -To persist the changes edit :file:`/etc/ld.so.conf.d/arm-linux-gnueabihf.conf` -and add the following at the top:: +However, this will not persist the changes. To persist the changes edit +:file:`/etc/ld.so.conf.d/arm-linux-gnueabihf.conf` and add the following at the +top:: /home/pi/.xbmc-current/xbmc-bin/lib/xbmc/system -It's very important to add it at the top of the file as this indicates the priority of the folder -in which to look for shared libraries. XBMC doesn't play nicely with the system wide installed -version of libtag (that got installed with Mopidy) but rather vendors in it's own version. -Hopefully this will fix the issue for you if you're running Raspbmc. -More info about this issue can be found in this `post ` _ as well. -Please note that if you're running Xbian or any other distribution that the instructions might vary. +It's very important to add it at the top of the file as this indicates the +priority of the folder in which to look for shared libraries. +XBMC doesn't play nicely with the system wide installed version of libtag that +got installed together with Mopidy, but rather vendors in its own version. + +More info about this issue can be found in `this post +`_. + +Please note that if you're running Xbian or another XBMC distribution these +instructions might vary for your system.