75955822b7
Maintaining multiple copies of instructions for how to install specific extensions doesn't scale well.
90 lines
3.2 KiB
ReStructuredText
90 lines
3.2 KiB
ReStructuredText
.. _source-install:
|
|
|
|
*******************
|
|
Install from source
|
|
*******************
|
|
|
|
If you are on Linux, but can't install :ref:`from the APT archive
|
|
<debian-install>` or :ref:`from AUR <arch-install>`, you can install Mopidy
|
|
from PyPI using the ``pip`` installer.
|
|
|
|
If you are looking to contribute or wish to install from source using ``git``
|
|
please follow the directions :ref:`here <contributing>`.
|
|
|
|
#. First of all, you need Python 2.7. Check if you have Python and what
|
|
version by running::
|
|
|
|
python --version
|
|
|
|
#. You need to make sure you have ``pip``, the Python package installer. You'll
|
|
also need a C compiler and the Python development headers to build pyspotify
|
|
later.
|
|
|
|
This is how you install it on Debian/Ubuntu::
|
|
|
|
sudo apt-get install build-essential python-dev python-pip
|
|
|
|
And on Arch Linux from the official repository::
|
|
|
|
sudo pacman -S base-devel python2-pip
|
|
|
|
And on Fedora Linux from the official repositories::
|
|
|
|
sudo yum install -y gcc python-devel python-pip
|
|
|
|
.. note::
|
|
|
|
On Fedora Linux, you must replace ``pip`` with ``pip-python`` in the
|
|
following steps.
|
|
|
|
#. Then you'll need to install GStreamer 0.10 (>= 0.10.31, < 0.11), with Python
|
|
bindings. 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 gstreamer0.10-tools
|
|
|
|
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
|
|
|
|
If you use Fedora you can install GStreamer like this::
|
|
|
|
sudo yum install -y python-gst0.10 gstreamer0.10-plugins-good \
|
|
gstreamer0.10-plugins-ugly gstreamer0.10-tools
|
|
|
|
If you use Gentoo you need to be careful because GStreamer 0.10 is in a
|
|
different lower slot than 1.0, the default. Your emerge commands will need
|
|
to include the slot::
|
|
|
|
emerge -av gst-python gst-plugins-bad:0.10 gst-plugins-good:0.10 \
|
|
gst-plugins-ugly:0.10 gst-plugins-meta:0.10
|
|
|
|
``gst-plugins-meta:0.10`` is the one that actually pulls in the plugins you
|
|
want, so pay attention to the use flags, e.g. ``alsa``, ``mp3``, etc.
|
|
|
|
#. Install the latest release of Mopidy::
|
|
|
|
sudo pip install -U mopidy
|
|
|
|
This will use ``pip`` to install the latest release of `Mopidy from PyPI
|
|
<https://pypi.python.org/pypi/Mopidy>`_. To upgrade Mopidy to future
|
|
releases, just rerun this command.
|
|
|
|
Alternatively, if you want to track Mopidy development closer, you may
|
|
install a snapshot of Mopidy's ``develop`` Git branch using pip::
|
|
|
|
sudo pip install --allow-unverified=mopidy mopidy==dev
|
|
|
|
#. Optional: For Spotify support, Last.fm scrobbling, or many other extra
|
|
features, install the required Mopidy extensions. For a full list of
|
|
available Mopidy extensions, see :ref:`ext`.
|
|
|
|
#. Finally, you need to set a couple of :doc:`config values </config>`, and
|
|
then you're ready to :doc:`run Mopidy </running>`.
|