andpp/mopidy
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Add detailed GStreamer installation instructions for OS X

Browse Source
This commit is contained in:
Stein Magnus Jodal 2012-02-07 00:46:38 +01:00
parent 0d16bb0048
commit a679d0c2ee
1 changed files with 56 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

70
docs/installation/gstreamer.rst
View File

@ -2,7 +2,8 @@
GStreamer installation GStreamer installation
********************** **********************
To use the Mopidy, you first need to install GStreamer and its Python bindings. To use the Mopidy, you first need to install GStreamer and the GStreamer Python
bindings.
Installing GStreamer Installing GStreamer
@ -15,6 +16,10 @@ GStreamer is packaged for most popular Linux distributions. Search for
GStreamer in your package manager, and make sure to install the Python GStreamer in your package manager, and make sure to install the Python
bindings, and the "good" and "ugly" plugin sets. bindings, and the "good" and "ugly" plugin sets.
On Debian/Ubuntu
^^^^^^^^^^^^^^^^
If you use Debian/Ubuntu you can install GStreamer like this:: If you use Debian/Ubuntu you can install GStreamer like this::
sudo apt-get install python-gst0.10 gstreamer0.10-plugins-good \ sudo apt-get install python-gst0.10 gstreamer0.10-plugins-good \
@ -24,30 +29,67 @@ 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. yourself. The Mopidy Debian package will handle it for you.
On Arch Linux
^^^^^^^^^^^^^
If you use Arch Linux, install the following packages from the official
repository::
sudo pacman -S gstreamer0.10-python gstreamer0.10-good-plugins \
gstreamer0.10-ugly-plugins
On OS X from Homebrew On OS X from Homebrew
--------------------- ---------------------
.. note:: .. note::
We have created GStreamer formulas for Homebrew to make the GStreamer We have been working with `Homebrew <https://github.com/mxcl/homebrew>`_ to
installation easy for you, but not all our formulas have been merged into make all the GStreamer packages easily installable on OS X using Homebrew.
Homebrew's master branch yet. You should either fetch the formula files We've gotten most of our packages included, but the Homebrew guys aren't
from `Homebrew's issue #1612 very happy to include Python specific packages into Homebrew, even though
<http://github.com/mxcl/homebrew/issues/issue/1612>`_ yourself, or fall they are not installable by pip. If you're interested, see the discussion
back to using MacPorts. in `Homebrew's issue #1612
<http://github.com/mxcl/homebrew/issues/issue/1612>`_ for details.
To install GStreamer on OS X using Homebrew:: The following is currently the shortest path to installing GStreamer with
Python bindings on OS X using Homebrew.
brew install gst-python gst-plugins-good gst-plugins-ugly #. Install `Homebrew <https://github.com/mxcl/homebrew>`_.
#. Download our Homebrew formulas for `pycairo`, `pygobject`, `pygtk`, and
`gst-python`::
On OS X from MacPorts wget -O/usr/local/Library/Formula/pycairo.rb \
--------------------- https://github.com/jodal/homebrew/raw/gst-python/Library/Formula/pycairo.rb
wget -O/usr/local/Library/Formula/pygobject.rb \
https://github.com/jodal/homebrew/raw/gst-python/Library/Formula/pygobject.rb
wget -O/usr/local/Library/Formula/pygtk.rb \
https://github.com/jodal/homebrew/raw/gst-python/Library/Formula/pygtk.rb
wget -O/usr/local/Library/Formula/gst-python.rb \
https://github.com/jodal/homebrew/raw/gst-python/Library/Formula/gst-python.rb
To install GStreamer on OS X using MacPorts:: #. Install the required packages::
sudo port install py26-gst-python gstreamer-plugins-good \ brew install gst-python gst-plugins-good gst-plugins-ugly
gstreamer-plugins-ugly
#. Make sure to include Homebrew's Python ``site-packages`` directory in your
``PYTHONPATH``. If you don't include this, Mopidy will not find GStreamer
and crash.
You can either amend your ``PYTHONPATH`` permanently, by adding the
following statement to your shell's init file, e.g. ``~/.bashrc``::
export PYTHONPATH=$(brew --prefix)/lib/python2.6/site-packages:$PYTHONPATH
Or, you can prefix the Mopidy command every time you run it::
PYTHONPATH=$(brew --prefix)/lib/python2.6/site-packages mopidy
Note that you need to replace ``python2.6`` with ``python2.7`` if that's
the Python version you are using. To find your Python version, run::
python --version
Testing the installation Testing the installation