Spotify-History
NOTE
I no longer use Spotify due to their support for blatant, socially-harmfull, misinformation. This project is in hibernation mode as of February 2022 and is not likely to receive further updates.
Python based AWS Lambda function for building an offline list of played tracks from Spotify.
When triggered, this function polls the Spotify API for all tracks played
on the current date. As the Spotify API returns no more than 50 tracks,
this function is intended to be ran several times a day. It first looks for an
existing day's history file in S3. Any found history file is merged with the
results from the API, using the played_at key to deduplicate.
Expected Environment Variables
- SPOTIFY_BUCKET_NAME - Name of S3 bucket to store data and token files.
- SPOTIFY_BUCKET_KEY - Optional key under which to store data and token files. Must not have a leading slash.
- SPOTIFY_CLIENT_ID - Application OAuth client ID.
- SPOTIFY_CLIENT_NAME - Application OAuth client secret.
Deployment
The included Makefile will build a ZIP file which can be deployed to AWS Lambda. This ZIP file will include all dependencies.
The Spotify API uses OAuth authentication. The initial setup of tokens
requires user interaction to authorize this application. To carry out first
time setup, run the authorize.py script in an interactive window. This will
prompt the user to visit a Spotify URL and authorize the application. Upon
authorization, the user's browser will be redirected to a non-resolving URL.
Copy that full URL and paste into the python console. The authorize.py script
will take that response URL, obtain a OAuth token from Spotify, and save it in a
token.json file in the S3 bucket configured in the environment variables. Future
runs of the main.py process do not require authorization as long as the function
can auto-renew the token. If this function is run at least every 12 hours, that
should not be a problem (renew token lengths are approximately 15 hours).
Contributing
This project is governed by a Code of Conduct. By participating in this project you agree to abide by these terms.
License
The MIT License applies.