mopidy-spotify travis-ci python

Mopidy extension for playing music from Spotify


.. image:: :target: :alt: Latest PyPI version

.. image:: :target: :alt: Number of PyPI downloads

.. image:: :target: :alt: Travis CI build status

.. image:: :target: :alt: Test coverage

Mopidy <>_ extension for playing music from Spotify <>_.


  • A Spotify Premium subscription. Mopidy-Spotify will not work with Spotify Free, just Spotify Premium.

  • A non-Facebook Spotify username and password. If you created your account through Facebook you’ll need to create a “device password” to be able to use Mopidy-Spotify. Go to, login with your Facebook account, and follow the instructions.

  • libspotify >= 12, < 13. The official C library from the Spotify developer site <>_. The package is available as libspotify12 from <>__.

  • pyspotify >= 2.0. The libspotify Python wrapper. The package is available as python-spotify from or pyspotify on PyPI. See for how to install it and its dependencies on most platforms.

  • Mopidy >= 1.1. The music server that Mopidy-Spotify extends.

If you install Mopidy-Spotify from, AUR, or Homebrew, these dependencies are installed automatically.


Debian/Ubuntu/Raspbian: Install the mopidy-spotify package from <>_::

sudo apt-get install mopidy-spotify

Arch Linux: Install the mopidy-spotify package from AUR <>_::

yaourt -S mopidy-spotify

OS X: Install the mopidy-spotify package from the mopidy/mopidy <>_ Homebrew tap::

brew install mopidy-spotify

Else: Install the dependencies listed above yourself, and then install the package from PyPI::

pip install Mopidy-Spotify


Before starting Mopidy, you must add your Spotify Premium username and password to your Mopidy configuration file::

username = alice
password = secret

The following configuration values are available:

  • spotify/enabled: If the Spotify extension should be enabled or not. Defaults to true.

  • spotify/username: Your Spotify Premium username. You must provide this.

  • spotify/password: Your Spotify Premium password. You must provide this.

  • spotify/bitrate: Audio bitrate in kbps. 96, 160, or 320. Defaults to 160.

  • spotify/volume_normalization: Whether volume normalization is active or not. Defaults to true.

  • spotify/timeout: Seconds before giving up waiting for search results, etc. Defaults to 10.

  • spotify/allow_cache: Whether to allow caching. The cache is stored in a “spotify” directory within Mopidy’s core/cache_dir. Defaults to true.

  • spotify/allow_network: Whether to allow network access or not. Defaults to true.

  • spotify/allow_playlists: Whether or not playlists should be exposed. Defaults to true.

  • spotify/search_album_count: Maximum number of albums returned in search results. Number between 0 and 50. Defaults to 20.

  • spotify/search_artist_count: Maximum number of artists returned in search results. Number between 0 and 50. Defaults to 10.

  • spotify/search_track_count: Maximum number of tracks returned in search results. Number between 0 and 50. Defaults to 50.

  • spotify/toplist_countries: Comma separated list of two letter ISO country codes to get toplists for. Defaults to blank, which is interpreted as all countries that Spotify is available in.

  • spotify/private_session: Whether to use a private Spotify session. Turn on private session to disable sharing of played tracks with friends through the Spotify activity feed, scrobbling, and Facebook. This only affects social sharing done by Spotify, not by other Mopidy extensions. Defaults to false.

Project resources

  • Source code <>_
  • Issue tracker <>_


  • Original author: Stein Magnus Jodal <>__
  • Current maintainer: Stein Magnus Jodal <>__
  • Contributors <>_

Related Repositories



Mopidy is an extensible music server that plays music from local disk, Spotify, SoundCloud, Google Play Music, and more. You edit the playlist from any phone, tablet, or computer using a range of MPD and web clients. ...



Mopidy extension for playing music from Spotify ...



Add Spotify music from Vim to your Mopidy playlist with fzf-powered fuzzy-finding ...



Slack bot which connects with Mopidy and Spotify ...



Music server with support for MPD clients and Spotify streaming ...

Top Contributors

jodal adamcik trygveaa chigley kingosticks


-   v3.0.0 zip tar
-   v2.3.1 zip tar
-   v2.3.0 zip tar
-   v2.2.0 zip tar
-   v2.1.0 zip tar
-   v2.0.1 zip tar
-   v2.0.0 zip tar
-   v1.4.0 zip tar
-   v1.3.0 zip tar
-   v1.2.0 zip tar
-   v1.1.3 zip tar
-   v1.1.2 zip tar
-   v1.1.1 zip tar
-   v1.1.0 zip tar
-   v1.0.3 zip tar
-   v1.0.2 zip tar
-   v1.0.1 zip tar
-   v1.0.0 zip tar
-   debian/3.0.0-0mopidy zip tar
-   debian/2.3.1-0mopidy zip tar
-   debian/2.3.0-0mopidy zip tar
-   debian/2.2.0-0mopidy zip tar
-   debian/2.1.0-0mopidy zip tar
-   debian/2.0.1-0mopidy zip tar
-   debian/2.0.0-0mopidy zip tar
-   debian/1.4.0-0mopidy zip tar
-   debian/1.3.0-0mopidy zip tar
-   debian/1.3.0-0mopidy zip tar
-   debian/1.2.0-0mopidy zip tar
-   debian/1.2.0-0mopidy zip tar