/spotify-codegen

Python CLI for stitching Spotify Album / Artist / Track cover with Spotify Code

Primary LanguagePythonMIT LicenseMIT

spotify-codegen

PyPI Status Python Version License

Read the documentation at https://spotify-codegen.readthedocs.io/ Tests Codecov

pre-commit Black

Features

Spotify stopped giving users an easy way to grab the song, artist or album artwork with the respective Spotify Code - spotify-codegen to the rescue!

You can stitch the album | track | artist artwork with the Spotify Code by supplying:

  • URL(s)
  • URI(s)
  • a search query

It's also possible to use create stitches for:

  • all of your saved albums
  • 50 followed artists (limit imposed by Spotify API)

Requirements

To use the Spotify API, you'll have to login using your credentials and create an app. That apps ID and secret need to be specified as environment variables:

$ export SPOTIPY_CLIENT_ID="your_client_id"
$ export SPOTIPY_CLIENT_SECRET="your_client_secret"

You can now use both the CLI and the Python API!

Installation

You can install spotify-codegen via pip from PyPI:

$ pip install spotify-codegen

Usage

Please see the Command-line Reference for details.

Contributing

Contributions are very welcome. To learn more, see the Contributor Guide.

License

Distributed under the terms of the MIT license, spotify-codegen is free and open source software.

Issues

If you encounter any problems, please file an issue along with a detailed description.

Credits

This project was generated from @cjolowicz's Hypermodern Python Cookiecutter template.