Repository files navigation

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.

1. Go toSpotify 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.

1. Clone the repository - Spotilytics GitHub Repository:

 git clone https://github.com/varospaxo/spotilytics/

2. Change your directory tospotilytics:

cd spotilytics

3. Change your directory tospotilytics:

 pip install -r requirements.txt

4. To runSpotilytics GUI, use the command:

 python spotilytics.py

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

 python Interface.py

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

 python Extended.py

OR To runSpotilytics CLI, use the command:

 python Grand.py

OR To runSpotilytics CLI with HTML output, use the command:

 python Flask.py

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

● 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!