Install from source

If you are on Linux, but can’t install from the APT archive or from the Arch Linux repository, 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 here.

  1. First of all, you need Python 2.7. Check if you have Python and what version by running:

    python --version
  2. 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


    On Fedora Linux, you must replace pip with pip-python in the following steps.

  3. 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 \

    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.

  4. Install the latest release of Mopidy:

    sudo pip install -U mopidy

    This will use pip to install the latest release of Mopidy from PyPI. 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
  5. Finally, you need to set a couple of config values, and then you’re ready to run Mopidy.

Installing extensions

If you want to use any Mopidy extensions, like Spotify support or scrobbling, you need to install additional Mopidy extensions.

You can install any Mopidy extension directly from PyPI with pip. To list all the extensions available from PyPI, run:

pip search mopidy

Note that extensions installed from PyPI will only automatically install Python dependencies. Please refer to the extension’s documentation for information about any other requirements needed for the extension to work properly.

For a full list of available Mopidy extensions see Extensions.