In this guide, we'll show you how to generate an iCalendar file with the release dates for all albums & EPs for every artist in the artists list.

Generating the release data

First, make sure that you have the correct configuration as listed here.

Next, run the generate-release-date-data.py <path to artist-data.csv file> script.

Authentication and generating the calendar

To authenticate with the API, do the following:

  1. Open the hosted URL, in this case: http://localhost:5000
  2. Log in with your Spotify account
  3. You should be redirected to a loading page.

The page should be loading for around 15-20 minutes if your artists file is big, as we're adding sleeps to minimise the chance of getting rate-limited by the Spotify API.

Once the operation has finished, save the returned JSON data from your browser as artists.json in the top-level repository directory.

Finally, run the generate-calendar-from-data.py script. This script will generate a releases.ics file that you can then use to import events into any calendar application.