diff --git a/docs/settings.rst b/docs/settings.rst index 68adfd55..24d9b0bd 100644 --- a/docs/settings.rst +++ b/docs/settings.rst @@ -120,6 +120,31 @@ file:: LASTFM_PASSWORD = u'mysecret' +Controlling Mopidy through the Ubuntu Sound Menu +================================================ + +If you are running Ubuntu and installed Mopidy using the Debian package from +APT you should be able to control Mopidy through the `Ubuntu Sound Menu +`_ without any changes. + +If you installed Mopidy in any other way and want to control Mopidy through the +Ubuntu Sound Menu, you must install the ``mopidy.desktop`` file which can be +found in the ``data/`` dir of the Mopidy source into the +``/usr/share/applications`` dir by hand:: + + cd /path/to/mopidy/source + sudo cp data/mopidy.desktop /usr/share/applications/ + +After you have installed the file, start Mopidy in any way, and Mopidy should +appear in the Ubuntu Sound Menu. When you quit Mopidy, it will still be listed +in the Ubuntu Sound Menu, and may be restarted by selecting it there. + +The Ubuntu Sound Menu interacts with Mopidy's MPRIS frontend. +The MPRIS frontend supports the minimum requirements of the `MPRIS +specification `_. The ``TrackList`` and the +``Playlists`` interfaces of the spec are not supported. + + Streaming audio through a SHOUTcast/Icecast server ==================================================