https://github.com/davidski/spotify-lambda

λ🎵AWS Lambda functions for Spotify tracking
https://github.com/davidski/spotify-lambda

aws lambda spotify

Last synced: 27 days ago
JSON representation

λ🎵AWS Lambda functions for Spotify tracking

• Host: GitHub
• URL: https://github.com/davidski/spotify-lambda
• Owner: davidski
• License: mit
• Created: 2017-07-30T02:31:44.000Z (over 7 years ago)
• Default Branch: main
• Last Pushed: 2023-07-25T22:07:06.000Z (over 1 year ago)
• Last Synced: 2024-10-12T21:27:53.253Z (about 1 month ago)
• Topics: aws, lambda, spotify
• Language: Python
• Homepage:
• Size: 60.5 KB
• Stars: 16
• Watchers: 3
• Forks: 4
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
Spotify-History

================

**NOTE**

> I no longer use Spotify due to their support for [blatant, socially-harmfull, misinformation](https://www.nytimes.com/2022/01/31/technology/joe-rogan-spotify-controversy.html). 

> 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](./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](./CODE_OF_CONDUCT.md). By 

participating in this project you agree to abide by these terms.

License

=======

The [MIT License](LICENSE) applies.