Python Endsong Parser

for me

• use make clean && make html after cd docs to build docs
• Windows requires \\ instead of / for paths
• in interactive shell, autocomplete works for functions, Aspect.T etc.
• conda environemnt endsong with
  • Python 3.9.7
  • requirements.txt

Description

Parser for Spotify endsong.json files made with Python

Required libaries:

• matplotlib
• numpy

This project uses Black for Python, Prettier for Markdown formatting and Markdownlint for linting markdown. The disabled rules are specified in .markdownlint.json

Internal links

• Problems and Ideas

Why

Lukas didn't want to use the Spotistats app to make the endsong.json files usable. So, in order extract the data and do something with it he wrote this script. At first it could only display the top artist/tracks, later you could search for specific tracks and now you can even view graphs showing the changes over time. I decided to modify this script to my own liking and here we are.

Usage guide

1. Install the required libraries in requirements.txt

   python3 -m pip install -r requirements.txt

2. Download the endsong_parser.py file

3. Open it in a text editor and at the end change the path array to match your paths

4. Open the script in an interactive python shell

   python3 -i endsong_parser.py

5. Wait for the script to parse the data

6. Use the many commands available! If you ever need help, use help(d.<method>) where <method> is the name of the method you need help with.

aspect can be either "artist", "album" or "title"

name is the name of the artist, album or track

Getting endsong.json

Follow the Spotistats guide (backup link) to get the files.

How to use it

See usage guide