Skip to content

Spotilytics is a tool that allows you to view your downloaded Spotify streaming history throughout the year, without the need to wait for Spotify Wrapped. It works on Windows with Python 3.10+ installed.

Notifications You must be signed in to change notification settings

varospaxo/spotilytics

Repository files navigation

Spotilytics: Your Spotify Streaming History Anytime

Spotilytics

Why wait for Spotify Wrapped when you can download your own data anytime and view your streaming history all year round using Spotilytics. Spotilytics provides you with multiple interfaces to extract data from your Spotify account. Currently works only on Windows OS with Python 3.10+ installed.

You might wonder, why not use the Spotify API? Well, the Spotify API requires user login and can be a privacy concern for some individuals. Therefore, downloading your entire data offline and analyzing it with this open-source tool makes more sense.

Steps to Get the Data

  1. Go to Spotify Account Privacy Settings.
  2. Select 'Account Data' (Preparation time: 5 days). #Extended streaming history also supported!
  3. Click on the link in the confirmation email sent to your inbox.
  4. Wait for 5 days to receive your Spotify data.
  5. Once the data is received, download the zip file and save it.

Steps to Run Spotilytics

  1. Clone the repository - Spotilytics GitHub Repository:
 git clone https://github.com/varospaxo/spotilytics/
  1. Change your directory to spotilytics:
 cd spotilytics
  1. Change your directory to spotilytics:
 pip install -r requirements.txt
  1. To run Spotilytics GUI, use the command:
 python spotilytics.py

OR To run Spotilytics GUI (Yearly Streaming History), use the command:

 python Interface.py

OR To run Spotilytics GUI (Extended Streaming History), use the command:

 python Extended.py

OR To run Spotilytics CLI, use the command:

 python Grand.py

OR To run Spotilytics CLI with HTML output, use the command:

 python Flask.py
  1. Once Spotilytics is running, enter the number of results required.
  2. Then, select the zip file (for GUI) or provide the path to the zip file without quotes (for CLI).
  3. The data will be extracted automatically and displayed as output.
  4. Optionally, you can export the data as pdf (spotilytics.py)

Features of Spotilytics

● Extracts Account Identity Data.
● Extracts Personal User Data.
● Shows total playtime for last year / extended history.
● Shows Most Active Hour.
● Displays Top Tracks from last year / extended history.
● Displays Top Artists from last year / extended history.
● Shows Top Search Queries from last year.
● Data can be exported as pdf.

Enjoy exploring your Spotify streaming history throughout the year with Spotilytics!

About

Spotilytics is a tool that allows you to view your downloaded Spotify streaming history throughout the year, without the need to wait for Spotify Wrapped. It works on Windows with Python 3.10+ installed.

Topics

Resources

Stars

Watchers

Forks

Languages