OpenSource-Hub
Y

YourSpotify

4.4k stars·Privacy Protection·SHA-256 checksum verified

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)

Troubleshooting
Why 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.

GitHub Issue #582
Troubleshooting
Why 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.

GitHub Issue #591

Tags

spotifyself-hostedmusic-statsdashboardprivacy

Getting Started

1

Download installer

Click the button above to download the installer for your system

2

Install the software

Double-click the downloaded installer and follow the prompts

3

Step 1: Create a Spotify app on developer.spotify.com, get Client ID & Secret

4

Step 2: Copy docker-compose-example.yml, set environment vars (API endpoint, Spotify credentials)

5

Step 3: Run 'docker-compose up -d', visit http://localhost:3000

Install Guide
  1. Step 1: Create a Spotify app on developer.spotify.com, get Client ID & Secret
  2. Step 2: Copy docker-compose-example.yml, set environment vars (API endpoint, Spotify credentials)
  3. Step 3: Run 'docker-compose up -d', visit http://localhost:3000
File Integrity

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 Source
Environment Guide

Uninstall 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.

Project Info
LicenseMIT
Last Updated2026-06-25 23:45:20
GitHub RepositoryOfficial Website

Having issues? Check the FAQ below

2 FAQs

Similar Projects