← Directory

YourSpotify

YourSpotify is a self-hosted Spotify statistics dashboard that tracks what you listen to and lets you explore your listening history in a web interface.

  • Databases
  • Home Automation
  • Media Applications
  • Media Servers
  • Tools & Utilities
YourSpotify is a self-hosted Spotify statistics dashboard that tracks what you listen to and lets you explore your listening history in a web interface. A small server polls the Spotify API on a schedule and stores your playback data on your own hardware, making it useful for anyone who wants private, self-hosted insights into their listening habits.

Platform availability

Available on 3 of 9 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS
  • Proxmox
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

70/100 Good

Maintained
75last commit 97 days ago
Popular
734,595 GitHub stars
Easy to install
553 install platforms, install notes, Docker image
Light to run
No data

Based on 3 of 4 factors.

Availability: platform listings confirmed today, links checked 10 days ago

GitHub stars
4,595
Open issues
144
Last commit
2026-07-10
Latest release
1.20.0
License
GPL-3.0
Activity
stale

Checked 6 days ago - source: GitHub (Yooooomi/your_spotify)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is supported.

Checked 17 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Install it on Mac or Linux Open your terminal and run the install command shown in the README to set up the app on Mac or Linux. Without this step, the app is not installed and you cannot start a backup. source
  • Check the Gmail service account Before backing up mail, run the service-account check using your workspace admin email. A service account is the Gmail identity that proves the app is allowed to access workspace mail, and if it is not set up Gmail will block the backup. source
  • Keep the backup database safe Your backup data is stored in a local database file such as backup.db, so keep that file safe. If you delete or lose it, you lose the backup copy the app created. source
  • Creating the Spotify application Create and configure a Spotify developer application before first use. source

Fetched 6 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

What should I check if my YourSpotify API redirect fails with a 502 or invalid redirect URI error?

If you use NPM for API redirects, make sure the your_spotify containers are on the same network as the NPM container. Otherwise it can show errors such as 502 or invalid redirect URI.

How does YourSpotify collect my Spotify listening data?

A web server polls the Spotify API every now and then. The web application then lets you explore statistics about your listening.

Can I choose the time period used for the activity summary?

Yes, it provides a summary of activity for a given period that you can choose or customize.

Answers sourced from github.com, www.reddit.com, www.reddit.com

Community

Collected 16 days ago - public community threads