175 lines
5.2 KiB
ReStructuredText
175 lines
5.2 KiB
ReStructuredText
************
|
|
Installation
|
|
************
|
|
|
|
There are several ways to install Mopidy. What way is best depends upon your
|
|
setup and whether you want to use stable releases or less stable development
|
|
versions.
|
|
|
|
|
|
Install dependencies
|
|
====================
|
|
|
|
.. toctree::
|
|
:hidden:
|
|
|
|
gstreamer
|
|
libspotify
|
|
|
|
If you install Mopidy from the APT archive, as described below, you can skip
|
|
the dependency installation part.
|
|
|
|
Otherwise, make sure you got the required dependencies installed.
|
|
|
|
- Python >= 2.6, < 3
|
|
|
|
- GStreamer >= 0.10, with Python bindings. See :doc:`gstreamer`.
|
|
|
|
- Mixer dependencies: The default mixer does not require any additional
|
|
dependencies. If you use another mixer, see the mixer's docs for any
|
|
additional requirements.
|
|
|
|
- Dependencies for at least one Mopidy backend:
|
|
|
|
- The default backend, :mod:`mopidy.backends.libspotify`, requires libspotify
|
|
and pyspotify. See :doc:`libspotify`.
|
|
|
|
- The local backend, :mod:`mopidy.backends.local`, requires no additional
|
|
dependencies.
|
|
|
|
- Optional dependencies:
|
|
|
|
- To use the Last.FM scrobbler, see :mod:`mopidy.frontends.lastfm` for
|
|
additional requirements.
|
|
|
|
|
|
Install latest stable release
|
|
=============================
|
|
|
|
|
|
From APT archive
|
|
----------------
|
|
|
|
If you run a Debian based Linux distribution, like Ubuntu, the easiest way to
|
|
install Mopidy is from the Mopidy APT archive. When installing from the APT
|
|
archive, you will automatically get updates to Mopidy in the same way as you
|
|
get updates to the rest of your distribution.
|
|
|
|
#. Add the archive's GPG key::
|
|
|
|
wget -q -O - http://apt.mopidy.com/mopidy.gpg | sudo apt-key add -
|
|
|
|
#. Add the following to ``/etc/apt/sources.list``, or if you have the directory
|
|
``/etc/apt/sources.list.d/``, add it to a file called ``mopidy.list`` in
|
|
that directory::
|
|
|
|
# Mopidy APT archive
|
|
deb http://apt.mopidy.com/ stable main contrib non-free
|
|
deb-src http://apt.mopidy.com/ stable main contrib non-free
|
|
|
|
#. Install Mopidy and all dependencies::
|
|
|
|
sudo apt-get update
|
|
sudo apt-get install mopidy
|
|
|
|
#. Next, you need to set a couple of :doc:`settings </settings>`, and then
|
|
you're ready to :doc:`run Mopidy </running>`.
|
|
|
|
When a new release is out, and you can't wait for you system to figure it out
|
|
for itself, run the following to force an upgrade::
|
|
|
|
sudo apt-get update
|
|
sudo apt-get dist-upgrade
|
|
|
|
|
|
From PyPI using Pip
|
|
-------------------
|
|
|
|
If you are on OS X or on Linux, but can't install from the APT archive, you can
|
|
install Mopidy from PyPI using Pip.
|
|
|
|
#. When you install using Pip, you first need to ensure that all of Mopidy's
|
|
dependencies have been installed. See the section on dependencies above.
|
|
|
|
#. Then, you need to install Pip::
|
|
|
|
sudo aptitude install python-setuptools python-pip # On Ubuntu/Debian
|
|
sudo brew install pip # On OS X
|
|
|
|
#. To install the currently latest stable release of Mopidy::
|
|
|
|
sudo pip install -U Mopidy
|
|
|
|
To upgrade Mopidy to future releases, just rerun this command.
|
|
|
|
#. Next, you need to set a couple of :doc:`settings </settings>`, and then
|
|
you're ready to :doc:`run Mopidy </running>`.
|
|
|
|
If you for some reason can't use Pip, try ``easy_install`` instead.
|
|
|
|
|
|
Install development version
|
|
===========================
|
|
|
|
If you want to follow the development of Mopidy closer, you may install a
|
|
development version of Mopidy. These are not as stable as the releases, but
|
|
you'll get access to new features earlier and may help us by reporting issues.
|
|
|
|
|
|
From snapshot
|
|
-------------
|
|
|
|
If you want to follow Mopidy development closer, you may install a snapshot of
|
|
Mopidy's ``develop`` branch.
|
|
|
|
#. When you install using Pip, you first need to ensure that all of Mopidy's
|
|
dependencies have been installed. See the section on dependencies above.
|
|
|
|
#. Then, you need to install Pip::
|
|
|
|
sudo aptitude install python-setuptools python-pip # On Ubuntu/Debian
|
|
sudo brew install pip # On OS X
|
|
|
|
#. To install the latest snapshot of Mopidy, run::
|
|
|
|
sudo pip install mopidy==dev
|
|
|
|
To upgrade Mopidy to future releases, just rerun this command.
|
|
|
|
#. Next, you need to set a couple of :doc:`settings </settings>`, and then
|
|
you're ready to :doc:`run Mopidy </running>`.
|
|
|
|
|
|
From Git
|
|
--------
|
|
|
|
If you want to contribute to Mopidy, you should install Mopidy using Git.
|
|
|
|
#. When you install from Git, you first need to ensure that all of Mopidy's
|
|
dependencies have been installed. See the section on dependencies above.
|
|
|
|
#. Then install Git, if haven't already::
|
|
|
|
sudo aptitude install git-core # On Ubuntu/Debian
|
|
sudo brew install git # On OS X
|
|
|
|
#. Clone the official Mopidy repository, or your own fork of it::
|
|
|
|
git clone git://github.com/mopidy/mopidy.git
|
|
|
|
#. Next, you need to set a couple of :doc:`settings </settings>`.
|
|
|
|
#. You can then run Mopidy directly from the Git repository::
|
|
|
|
cd mopidy/ # Move into the Git repo dir
|
|
python mopidy # Run python on the mopidy source code dir
|
|
|
|
#. Later, to get the latest changes to Mopidy::
|
|
|
|
cd mopidy/
|
|
git pull
|
|
|
|
For an introduction to ``git``, please visit `git-scm.com
|
|
<http://git-scm.com/>`_. Also, please read our :doc:`developer documentation
|
|
</development/index>`.
|