spinget

Download show audio from Spinitron's ARK player.

Note

Audio is only available for two weeks from the original air date! This is a Spinitron imposed limitation necessary for compliance with certain copyright law.

How to run

1. Make sure you have ffmpeg and Python installed on your machine. You can download them easily using Homebrew in your command line:

   brew install ffmpeg python

2. Initialize a virtual environment and install Python pre-requisites:

   python3 -m venv venv
   source venv/bin/activate

   pip install -r requirements.txt

3. Get show audio:

   ./spinget.py 11/04/2021 00:00 1

   The above invocation gets 1 hour of audio starting at midnight (00:00) on October 4th, 2024 (10/04/2024).

   Note on station configuration: By default, the script uses the 'default' station configuration from stations.json. To use a different station, pass the station code using the --station option. For example:

   ./spinget.py --station wxyz 11/04/2021 00:00 1

   Make sure your stations.json file is updated with the details for your station (if not WBOR).

   Warning: this script generates intermediate files in the working directory (though they are purged upon completion).

4. Optionally, provided a .csv containing the dates, times, and durations of multiple shows you'd like to download, you can run:

   ./bulk_download.py shows-example.csv

   where shows-example.csv follows the same format as in the orignal command, outlined in the file included in thsi repository.