diff --git a/docs/config.rst b/docs/config.rst index 82957b92..69971d69 100644 --- a/docs/config.rst +++ b/docs/config.rst @@ -221,7 +221,7 @@ Streaming through SHOUTcast/Icecast Currently, Mopidy does not handle end-of-track vs end-of-stream signalling in GStreamer correctly. This causes the SHOUTcast stream to be disconnected at the end of each track, rendering it quite useless. For further details, - see :issue:`492`. + see :issue:`492`. You can also try the workaround_ mentioned below. If you want to play the audio on another computer than the one running Mopidy, you can stream the audio from Mopidy through an SHOUTcast or Icecast audio @@ -237,17 +237,37 @@ server simultaneously. To use the SHOUTcast output, do the following: #. You might also need to change the ``shout2send`` default settings, run ``gst-inspect-0.10 shout2send`` to see the available settings. Most likely you want to change ``ip``, ``username``, ``password``, and ``mount``. For - example, to set the username and password, use: + example: .. code-block:: ini [audio] - output = lame ! shout2send username="alice" password="secret" + output = lame ! shout2send username="alice" password="secret" mount="mopidy" Other advanced setups are also possible for outputs. Basically, anything you can use with the ``gst-launch-0.10`` command can be plugged into :confval:`audio/output`. +.. _workaround: + +**Workaround for end-of-track issues - fallback streams** + +By using a *fallback stream* playing silence, you can somewhat mitigate the +signalling issues. + +Example Icecast configuration: + +.. code-block:: xml + + + /mopidy + /silence.mp3 + 1 + + +The ``silence.mp3`` file needs to be placed in the directory defined by +``...``. + New configuration values ------------------------