https://github.com/pedromarquetti/spotify-analyser

Data analyser for Spotify account usage
https://github.com/pedromarquetti/spotify-analyser

data-visualization python spotify

Last synced: 3 months ago
JSON representation

Data analyser for Spotify account usage

• Host: GitHub
• URL: https://github.com/pedromarquetti/spotify-analyser
• Owner: pedromarquetti
• Created: 2024-12-26T12:42:39.000Z (over 1 year ago)
• Default Branch: master
• Last Pushed: 2025-06-05T23:48:37.000Z (about 1 year ago)
• Last Synced: 2025-06-06T00:31:59.795Z (about 1 year ago)
• Topics: data-visualization, python, spotify
• Language: Python
• Homepage:
• Size: 347 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Welcome to my Spotify data analyser

This script analyses all JSON data provided by Spotify and display the

information based on supplied flags

## Dependencies

All deps are in requirements.txt and can be installed with

`pip3 install -r requirements.txt`

## Running

> [!NOTE]

> install the requirements with pip3 install -r requirements.txt

### Running locally

run `main.py -h` to see all options

### Running with Docker

```bash

docker build --tag spotify-analyser .

docker run spotify-analyser

```

> [!NOTE]

> top_genres mode requires a valid [Spotify for developer](https://developer.spotify.com/) CLIENT_ID and CLIENT_SECRET.

## Screenshots

Example of yearly minutes played by year

![mins played by year](screenshots/mins_by_year.png)

Examples of top_artists graph plot

![top artists by year](screenshots/top_artists_by_year.png)