Skip to content
Python bindings for libspotify
Python C
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci ci: Switch from Travis CI to CircleCI Nov 17, 2019
.github github: Add sponsor button Jan 2, 2020
docs Release v2.1.3 Dec 29, 2019
examples Format with Black Nov 16, 2019
spotify Emit warning if broken playlists API is used Dec 29, 2019
.gitignore Update .gitignore Nov 16, 2019
.mailmap docs: Update authors Jan 26, 2015
.readthedocs.yml Revert "docs: Use docs deps from setup.cfg" Dec 29, 2019
AUTHORS Update authors list Jul 7, 2019
LICENSE Working cffi integration with libspotify May 3, 2013 docs: Add Read the Docs config Nov 17, 2019
README.rst Update project URLs Dec 27, 2019
pyproject.toml setup: Move project setup to setup.cfg Nov 17, 2019
setup.cfg Release v2.1.3 Dec 29, 2019 setup: Move project setup to setup.cfg Nov 17, 2019 Format with Black Nov 16, 2019
tox.ini setup: Move project setup to setup.cfg Nov 17, 2019



pyspotify provides a Python interface to Spotify's online music streaming service.

With pyspotify you can access music metadata, search in Spotify's library of 20+ million tracks, manage your Spotify playlists, and play music from Spotify. All from your own Python applications.

pyspotify uses CFFI to make a pure Python wrapper around the official libspotify library. It works on CPython 2.7 and 3.5+, as well as PyPy 2.7 and 3.5+. It is known to work on Linux and macOS. Windows support should be possible, but is awaiting a contributor with the interest and knowledge to maintain it.

libspotify's deprecation

Note that as of May 2015 libspotify is officially deprecated by Spotify and is no longer actively maintained.

Spotify has published newer libraries intended for Android and iOS development, as well as web APIs to access track metadata and manage playlists. Though, for making apps with Spotify playback capabilities, on any other platform than Android and iOS, there is currently no alternative to libspotify.

libspotify has been the main way of integrating with Spotify since 2009, and is today a part of numerous open source projects and commercial applications, including many receivers and even cars. There's no guarantees, but one can hope that the large deployment of libspotify means that the library will continue to work with the Spotify service for a long time into the future.

Project resources

Latest PyPI version CircleCI build status Test coverage
You can’t perform that action at this time.