Skip to main content

Mopidy extension for playing music from Spotify

Project description

Latest PyPI version Number of PyPI downloads Travis CI build status 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 >= 1.9, < 2. The libspotify python wrapper. The package is available as python-spotify from or pyspotify on PyPI.

  • Mopidy >= 0.18. 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.

  • spotify/username: Your Spotify Premium username.

  • spotify/password: Your Spotify Premium password.

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

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

  • spotify/cache_dir: The dir where the Spotify extension caches data. Defaults to $XDG_CACHE_DIR/mopidy/spotify, which usually means ~/.cache/mopidy/spotify. If set to an empty string, caching is disabled.

  • spotify/settings_dir: The dir where the Spotify extension stores libspotify settings. Defaults to $XDG_CONFIG_DIR/mopidy/spotify, which usually means ~/.config/mopidy/spotify.

  • spotify/toplist_countries: Comma separated list of two letter country domains to get toplists for.

Project resources


v1.4.0 (2015-05-19)

  • Update to not use deprecated Mopidy audio APIs.

  • Use strings and not ints for the model’s date field. This is required for compatibility with the model validation added in Mopidy 1.1. (Fixes: #52)

  • Fix error causing the image of every 50th URI in a library.get_images() call to not be looked up and returned.

  • Fix handling of empty search queries. This was still using the removed playlists.playlists to fetch all your tracks.

  • Update the SpotifyTrack proxy model to work with Mopidy 1.1 model changes.

  • Updated to work with the renaming of mopidy.utils to mopidy.internal in Mopidy 1.1.

v1.3.0 (2015-03-25)

  • Require Mopidy >= 1.0.

  • Update to work with new playback API in Mopidy 1.0.

  • Update to work with new playlists API in Mopidy 1.0.

  • Update to work with new search API in Mopidy 1.0.

  • Add library.get_images() support for cover art.

v1.2.0 (2014-07-21)

  • Add support for browsing playlists and albums. Needed to allow music discovery extensions expose these in a clean way.

  • Fix loss of audio when resuming from paused, when caused by another Spotify client starting playback. (Fixes: #2, PR: #19)

v1.1.3 (2014-02-18)

  • Switch to new backend API locations, required by the upcoming Mopidy 0.19 release.

v1.1.2 (2014-02-18)

  • Wait for track to be loaded before playing it. This fixes playback of tracks looked up directly by URI, and not through a playlist or search. (Fixes: mopidy/mopidy#675)

v1.1.1 (2014-02-16)

  • Change requirement on pyspotify from >= 1.9, < 2 to >= 1.9, < 1.999, so that it is parsed correctly and pyspotify 1.x is installed instead of 2.x.

v1.1.0 (2014-01-20)

  • Require Mopidy >= 0.18.

  • Change library.lookup() to return tracks even if they are unplayable. There’s no harm in letting them be added to the tracklist, as Mopidy will simply skip to the next track when failing to play the track. (Fixes: mopidy/mopidy#606)

  • Added basic library browsing support that exposes user, global and country toplists.

v1.0.3 (2013-12-15)

  • Change search field track to track_name for compatibility with Mopidy 0.17. (Fixes: mopidy/mopidy#610)

v1.0.2 (2013-11-19)

  • Add spotify/settings_dir config value so that libspotify settings can be stored to another location than the libspotify cache. This also allows spotify/cache_dir to be unset, since settings are now using it’s own config value.

  • Make the spotify/cache_dir config value optional, so that it can be set to an empty string to disable caching.

v1.0.1 (2013-10-28)

  • Support searches from Mopidy that are using the albumartist field type, added in Mopidy 0.16.

  • Ignore the track_no field in search queries, added in Mopidy 0.16.

  • Abort Spotify searches immediately if the search query is empty instead of waiting for the 10s timeout before returning an empty search result.

v1.0.0 (2013-10-08)

  • Moved extension out of the main Mopidy project.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Mopidy-Spotify-1.4.0.tar.gz (22.9 kB view hashes)

Uploaded Source

Built Distribution

Mopidy_Spotify-1.4.0-py2.py3-none-any.whl (21.8 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page