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.