https://github.com/ameobea/spotifytrack

A personal homepage showing users' top songs and artists, providing a shareable link that they can use to show it off to friends.
https://github.com/ameobea/spotifytrack

graph music rust spotify spotify-api tracking visualization

Last synced: 9 months ago
JSON representation

A personal homepage showing users' top songs and artists, providing a shareable link that they can use to show it off to friends.

• Host: GitHub
• URL: https://github.com/ameobea/spotifytrack
• Owner: Ameobea
• License: mit
• Created: 2019-04-29T08:47:58.000Z (about 7 years ago)
• Default Branch: main
• Last Pushed: 2025-08-29T20:57:27.000Z (10 months ago)
• Last Synced: 2025-08-29T22:46:55.639Z (10 months ago)
• Topics: graph, music, rust, spotify, spotify-api, tracking, visualization
• Language: Rust
• Homepage: https://spotifytrack.net/
• Size: 5.48 MB
• Stars: 111
• Watchers: 5
• Forks: 7
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Spotifytrack

**Spotifytrack** is a web application a record of your listening habits on Spotify, allowing you to see how your preferences change over time and remember when you discovered your favorite tracks and artists.

It also includes some other Spotify-related tools like the [Artist Averager](https://spotifytrack.net/artist-averager.html).

Try it yourself: 

![A screenshot of Spotifytrack showing the homepage for a user with a timeline showing recently discovered tracks and artists](https://i.ameo.link/98s.png)

## Directories

 * `frontend` contains the entire web UI for Spotifytrack.  It is built with TypeScript + React.

 * `backend` contains the backend API server that furnishes all of the data for the web frontend, handles OAuth, deals with caching, etc.

 * `research` contains Python notebooks used to generate, process, and analyze artist relationship data in order to generate artist embeddings for the artist averager.

## Building + Developing

Almost all tasks involved with building or running the code can be found in `Justfile`s throughout the project.  They can be run using the [just command runner](https://github.com/casey/just).

![A screenshot of Spotifytrack showing the artist relationship graph, an interactive visualization of the relationship between a user's top artists](https://ameo.link/u/98t.png)