View your Spotify Top Tracks in a Playlist, Top Played Artists, & More !

• Generate Top Tracks Playlist that auto-updates!
• Generate List of Top Played Artists
• Generate Reccomended Tracks Playlists (Optional)
• Optional Apprise Alerts/Notifications
• Docker Support
• Google Sheets Compatiable.
• Keep_Alive Flask Server

To run this project, you will need to add the following environment variables to your .env file (see .env.example for a reference):

1. Go to Spotify Developer's Dashboard . Log in using your Spotify credentials.

2. Create a new Application. Name it as desired, add any description, and agree to the Terms of Service.

3. Click on 'Edit Settings' and add the redirect URL you've set in your .env file, then save. Examples:

   

4. Click 'Show Client Secret'.

5. Copy/paste the Client ID into CLIENT_ID and the Secret Client ID into SECRET_CLIENT_ID within your .env file.

   

1. Sign into the Google Cloud Console , create your APP, and enable Google Sheets and Google Drive APIs.
2. Go to API & Services -> Credentials -> Create Credentials -> Service Account. Follow the prompts and download the JSON file afterward.
3. Open Google Sheets and create a new file named 'Wrapped365'. Add tabs named 'short_term', 'medium_term', 'long_term', 'short_term Artists', 'medium_term Artists', and 'long_term Artists'.
4. Share the Google Sheet Document with the email of your service account, giving editor permissions. The email can be found in Google's Cloud Console Credentials or within the downloaded JSON file, resembling something like: wrapped-test@wrapped-test943892.iam.gserviceaccount.com .

This script can be used locally or using Docker.

Clone the repository & Install dependencies

  git clone https://github.com/Prem-ium/Spotify-Wrapped-365.git
  
cd
 Spotify-Wrapped-365
  pip install -r requirements.txt

Finally, you're ready to run the script!

  python main.py

1. Run script locally with Python & generate cache file.

2. Download and install Docker on your system

3. Configure your .env file (See below and example for options)

4. To build the image, cd into the repository and run:

   docker build -t spotify-wrapped 
   .
   

   Then start the bot with:

   docker run -it --env-file ./.env --restart unless-stopped --name spotify-wrapped spotify-wrapped
   

5. Let the bot log in and begin working. DO NOT PRESS CTRL-c . This will kill the container and the bot. To exit the logs view, press CTRL-p then CTRL-q . This will exit the logs view but let the bot keep running.

This repository is using the MIT license.

• GitHub Actions Support (Currently Not Working-> ISSUE: Spotipy Access token is able to be refreshed, but cannot be updated to GitHub Secrets for next run)

I've been working on this project for a few months now, and I'm really happy with how it's turned out. It's also been a helpful tool for users to view their music data. If you appreciate my work and would like to show your support, there are two convenient ways to make a donation:

1. GitHub Sponsors

   • Donate via GitHub Sponsors
   • This is the preferred donation method as you can place donations with no transaction fees & possibily receive perks for your donation.
   • 

2. Buy Me A Coffee

   • Donate via Buy Me A Coffee
   • 

Your generous donations will go a long way in helping me cover the expenses associated with developing new features and promoting the project to a wider audience. I extend my heartfelt gratitude to all those who have already contributed. Thank you for your support!