85 lines
2.6 KiB
ReStructuredText
85 lines
2.6 KiB
ReStructuredText
**********************
|
|
GStreamer installation
|
|
**********************
|
|
|
|
To use the Mopidy, you first need to install GStreamer and its Python bindings.
|
|
|
|
|
|
Installing GStreamer
|
|
====================
|
|
|
|
On Linux
|
|
--------
|
|
|
|
GStreamer is packaged for most popular Linux distributions. Search for
|
|
GStreamer in your package manager, and make sure to install the Python
|
|
bindings, and the "good" and "ugly" plugin sets.
|
|
|
|
If you use Debian/Ubuntu you can install GStreamer like this::
|
|
|
|
sudo apt-get install python-gst0.10 gstreamer0.10-plugins-good \
|
|
gstreamer0.10-plugins-ugly
|
|
|
|
If you install Mopidy from our APT archive, you don't need to install GStreamer
|
|
yourself. The Mopidy Debian package will handle it for you.
|
|
|
|
|
|
On OS X from Homebrew
|
|
---------------------
|
|
|
|
.. note::
|
|
|
|
We have created GStreamer formulas for Homebrew to make the GStreamer
|
|
installation easy for you, but not all our formulas have been merged into
|
|
Homebrew's master branch yet. You should either fetch the formula files
|
|
from `Homebrew's issue #1612
|
|
<http://github.com/mxcl/homebrew/issues/issue/1612>`_ yourself, or fall
|
|
back to using MacPorts.
|
|
|
|
To install GStreamer on OS X using Homebrew::
|
|
|
|
brew install gst-python gst-plugins-good gst-plugins-ugly
|
|
|
|
|
|
On OS X from MacPorts
|
|
---------------------
|
|
|
|
To install GStreamer on OS X using MacPorts::
|
|
|
|
sudo port install py26-gst-python gstreamer-plugins-good \
|
|
gstreamer-plugins-ugly
|
|
|
|
|
|
Testing the installation
|
|
========================
|
|
|
|
If you now run the ``gst-inspect-0.10`` command (the version number may vary),
|
|
you should see a long listing of installed plugins, ending in a summary line::
|
|
|
|
$ gst-inspect-0.10
|
|
... long list of installed plugins ...
|
|
Total count: 218 plugins (1 blacklist entry not shown), 1031 features
|
|
|
|
You should be able to produce a audible tone by running::
|
|
|
|
gst-launch-0.10 audiotestsrc ! autoaudiosink
|
|
|
|
If you cannot hear any sound when running this command, you won't hear any
|
|
sound from Mopidy either, as Mopidy uses GStreamer's ``autoaudiosink`` to play
|
|
audio. Thus, make this work before you continue installing Mopidy.
|
|
|
|
|
|
Using a custom audio sink
|
|
=========================
|
|
|
|
If you for some reason want to use some other GStreamer audio sink than
|
|
``autoaudiosink``, you can add ``mopidy.outputs.custom.CustomOutput`` to the
|
|
:attr:`mopidy.settings.OUTPUTS` setting, and set the
|
|
:attr:`mopidy.settings.CUSTOM_OUTPUT` setting to a partial GStreamer pipeline
|
|
description describing the GStreamer sink you want to use.
|
|
|
|
Example of ``settings.py`` for OSS4::
|
|
|
|
OUTPUTS = (u'mopidy.outputs.custom.CustomOutput',)
|
|
CUSTOM_OUTPUT = u'oss4sink'
|