varospaxo / spotilytics

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.

Spotilytics: Your Spotify Streaming History Anytime

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/

2. Change your directory to spotilytics:

 cd spotilytics

3. To run Spotilytics GUI, 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

4. Once Spotilytics is running, select the zip file (for GUI) or provide the path to the zip file without quotes (for CLI).
5. The data will be extracted automatically and displayed as output.

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 10 Tracks from last year / extended history.
● Displays Top 10 Artists from last year / extended history.
● Shows Top 10 Search Queries from last year.

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