spotiminder 0.1.9

A Python package to help keep your Spotify playlist metadata up-to-date when it is modified without your approval.

spotiminder

A Python package to help keep your Spotify playlist metadata up-to-date when it is modified without your approval.

• Free software: MIT license

• Documentation: https://spotiminder.readthedocs.io.

Features

• Store your playlist ids, names and descriptions in a JSON file. See playlistMetadataExample.json for an example.

• The program will run continuously, checking your playlist names and descriptions against the metadata. If any discrepancies are found, both the name and description will be updated.

• If an image folder is specified and contains a JPEG cover image for a playlist, it will get uploaded too (max 256KB size). Image files must be named <playlistId>.jpg, replacing <playlistId> with your playlist’s 22-character id.

• Checks are performed every 60 seconds by default. This is configurable, but don’t set it too low or you’ll run into API rate limits.

Prerequisites

• You’ll need to create your own app on the ‘Spotify for Developers’ portal. Once created, you’ll need your app’s ‘Client ID’ and ‘Client Secret’ in order to run the program. You will also need to set your app’s ‘Redirect URI’ to ‘http://localhost:8080’. This is the default used by spotiminder. If you would like to set this to something else, feel free to do so. You’ll just need to specify the new URI at the command-line when you run the program.

• Python 3. You can get it here. On a Mac it’s highly recommended to follow these instructions.

Installation

1. Clone or download the repo.

2. Change directory into the root of the repo.

3. Recommended but not required: use virtualenv to create a virtual Python environment:

   pip install virtualenv
   virtualenv venv

   On Mac/Linux:

   source venv/bin/activate

   On Windows:

   venv\Scripts\activate.bat

4. Install spotiminder:

   python setup.py install

Usage

spotiminder -h is your friend. The simplest usage is:

spotiminder <client id> <client secret> <path to json metadata>

Credits

This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.

History

0.1.0 (2021-05-17)

• First release on PyPI.