YourSpotify
YourSpotify is a self-hosted application that tracks what you listen to on Spotify and offers you a dashboard to explore statistics about it. It polls the Spotify API periodically and stores data in MongoDB.
Smart Download
Visit Project Homepage
No installer available yet — head to the source repository
Self-hosted Spotify listening stats dashboard for privacy-conscious music lovers.
Core Features
- Automatically tracks your Spotify listening history (polled every 24h)
- Web dashboard with charts: top tracks, artists, genres, and time trends
- Import past history from Spotify's privacy data export (up to 1 year)
- Full data ownership - no third-party analytics
- Easy Docker Compose deployment
What It Can't Do
- •Requires a Spotify Premium account for full history; only data after setup is recorded automatically - import old data manually via privacy export; use MongoDB 4.4 on ARM devices; default timezone is Europe/Paris, adjust TIMEZONE env var.
Use Cases
- Deep dive into your music habits
- Privacy-first alternative to third-party analytics tools
- Community managers needing shareable music stats
Detailed Introduction
YourSpotify is a self-hosted application that continuously polls the Spotify API to record your listening history. It provides a web dashboard showing detailed statistics about your music consumption, including top tracks, artists, genres, and listening trends over time. The app uses MongoDB for data storage and supports importing past history from Spotify privacy data exports. It is designed for privacy-conscious users who want full control over their data without relying on third-party services.
Troubleshooting & FAQ (2)
TroubleshootingWhy does Spotify Full Privacy import fail with 'expected string, received null' for podcast and audiobook entries?
The import validation expects non-null 'master_metadata_track_name' and 'spotify_track_uri', but Spotify's extended streaming history export includes podcast/audiobook entries where these fields are null. As a workaround, pre-process your files to filter out those records:
python
import json
with open('Streaming_History_Audio_2024-2025_0.json') as f:
data = json.load(f)
cleaned = [r for r in data if r.get('master_metadata_track_name') is not None]
with open('cleaned.json', 'w') as f:
json.dump(cleaned, f)
Then import 'cleaned.json'. Alternatively, upgrade to Your Spotify v1.18.0 or later, which may include a fix.
TroubleshootingWhy does the server get a 403 Forbidden error when requesting the Spotify tracks API?
The 403 error suggests an authentication or authorization problem, often due to an invalid access token or insufficient scopes. This specific issue was resolved in a later release of the server. Update to the latest version available. If the error persists after updating, double-check your Spotify app credentials and required permissions, then open a new issue for further assistance.
Tags
Getting Started
Download installer
Click the button above to download the installer for your system
Install the software
Double-click the downloaded installer and follow the prompts
Step 1: Create a Spotify app on developer.spotify.com, get Client ID & Secret
Step 2: Copy docker-compose-example.yml, set environment vars (API endpoint, Spotify credentials)
Step 3: Run 'docker-compose up -d', visit http://localhost:3000
- Step 1: Create a Spotify app on developer.spotify.com, get Client ID & Secret
- Step 2: Copy docker-compose-example.yml, set environment vars (API endpoint, Spotify credentials)
- Step 3: Run 'docker-compose up -d', visit http://localhost:3000
Checksum not available
This project has not published a SHA-256 checksum on its GitHub Release page
SHA256 Checksum
No checksum available
Download directly from GitHub Releases and verify file integrity yourself
All SHA-256 checksums on this platform are extracted from the project's official GitHub Release page, without any modification. You can independently verify them on the GitHub Releases page.
Open Source Transparency
View GitHub SourceUninstall Info
Remove Docker containers and volumes: docker-compose down -v, then delete the your_spotify_db data directory.
No Extra Dependencies
Ready to use after download. No additional runtime required.
Having issues? Check the FAQ below
2 FAQs
Similar Projects
Umami
Umami is a simple, fast, privacy-focused web analytics tool that gives you full control over your data.
AdGuardHome
Network-wide DNS server that blocks ads and trackers across all home devices without needing client software.
SearXNG
SearXNG is a free metasearch engine that combines results from over 70 search services while respecting your privacy. Self-host it to keep your data under your control.