Skip to main content is an asynchronous API wrapper for Spotify written in Python.

Project description

![Version info](
[![GitHub stars](](

An API library for the spotify client and the Spotify Web API written in Python. is 100% asyncronous meaning everything down to the HTTP library is designed to work with asyncio.<br>The library covers every endpoint in the Spotify web API and offers control over the local Spotify app.<br><br>As of v0.1.5 it is possible to use in a syncronous manner. No await/async syntax required! To do this simply use

from spotify.sync import spotify # and now no methods require the async/await syntax.

## Examples

Web API example
client = spotify.Client('someid', 'sometoken')

async def example():
drake = await client.get_artist('3TVXtAsR1Inumwj472S9r4')

for track in await drake.top_tracks():

Local client example
async with spotify.LocalClient() as local:

## Resources

For resources look at the [examples]( or ask in the [discord](

## Installing

To install the library simply clone it and run
- `git clone`
- `python3 install`

or use pypi

- `pip3 install spotify`
- `pip3 install -U git+`

## Contributing
To contribute you must:
- have a presence in the [discord]( server
- fork and open a PR with changes.

> is in beta, there may be bugs.

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

spotify-0.1.6.tar.gz (16.1 kB view hashes)

Uploaded Source

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