https://github.com/zackelia/spotifyapi

A Python wrapper to interact with the Spotify web API
https://github.com/zackelia/spotifyapi

python spotify

Last synced: 2 months ago
JSON representation

A Python wrapper to interact with the Spotify web API

• Host: GitHub
• URL: https://github.com/zackelia/spotifyapi
• Owner: zackelia
• License: mit
• Created: 2019-04-01T23:05:45.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2020-06-30T00:39:37.000Z (about 5 years ago)
• Last Synced: 2025-04-22T12:12:53.947Z (2 months ago)
• Topics: python, spotify
• Language: Python
• Size: 87.9 KB
• Stars: 2
• Watchers: 2
• Forks: 1
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# spotifyapi

[![PyPI](https://img.shields.io/pypi/v/spotifyapi.svg)](https://pypi.python.org/pypi/spotifyapi/)

[![PyPI](https://img.shields.io/pypi/pyversions/spotifyapi.svg)](https://pypi.python.org/pypi/spotifyapi/)

[![Black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)

*spotifyapi* is a modern Python wrapper to interact with the Spotify web API. *spotifyapi* attempts to stay as close as possible to

the original API calls while implementing more Pythonic features.

## Installation

*spotifyapi* supports Python 3.6 and higher and can be installed through Pip.

```pip install spotifyapi```

## Example

The easiest way to use *spotifyapi* is using the SpotifyEndpoint which implements all methods of the package. However, it

is still possible to use the individual endpoints such as AlbumEndpoint, PlayerEndpoint, etc.

```python

from spotifyapi import SpotifyEndpoint

spotify = SpotifyEndpoint(oauth)

# Get the currently playing track

playing = spotify.get_currently_playing().item

# Get the track's features using Spotify's machine learning

features = spotify.get_audio_features(playing)

# Time to party!

if features.danceability > 0.75:

    spotify.volume(100)

```

## Contributing

*spotifyapi* is open to contributions! Either take a look at the list of issues or submit your own. In order to develop on *spotifyapi*, follow this guide:

1. Fork and clone the repository locally

2. Setup a virtual environment

    - `python3.6 -m venv venv`

    - `source venv/bin/activate`

    - `pip install -r requirements-dev.txt`

    - `pre-commit install`

3. Develop following the [Spotify API guide](https://developer.spotify.com/documentation/web-api/reference/)

4. Commit changes and submit a pull request