Your Spotify

Self-Hosted

Self-hosted dashboard for visualizing your Spotify listening stats

Overview

Your Spotify is an open-source personal dashboard that lets you explore your Spotify listening habits in depth. Track top tracks, artists, and genres over custom timeframes (weekly, monthly, all-time), visualize trends with interactive charts, and dive into historical data. It offers customizable widgets to tailor your view and connects securely to your Spotify account via OAuth. Deployment is straightforward with Docker support—pull the image, configure Spotify API credentials, and self-host on your server or local machine for private, ongoing insights into your music journey.

Self-Hosting Resources

Find Official Image on Docker Hub View Source & Docs

Below is a reference structure for docker-compose.yml. ⚠️ Do NOT run blindly. Replace placeholders with official values.

docker-compose.template.yml TEMPLATE


version: '3'
services:
  your_spotify:
    image: <OFFICIAL_IMAGE_NAME>:latest
    container_name: your-spotify
    ports:
      - "8080:<APP_INTERNAL_PORT>"
    volumes:
      - ./data:/app/data
    restart: unless-stopped

Key Features

Detailed listening stats (top tracks, artists, genres)
Customizable timeframes and dashboard widgets
Interactive data visualizations (charts, graphs)
Secure Spotify OAuth integration

Frequently Asked Questions

? Is Your Spotify hard to install?

No—Your Spotify uses Docker for simplified setup. Pull the official image, create a Spotify Developer app to get API keys, configure environment variables, and run the container. Step-by-step instructions are in the GitHub repo, making it accessible even for beginners.

? Is it a good alternative to Spotify Wrapped?

Yes—unlike Spotify Wrapped’s annual, limited summary, Your Spotify provides ongoing access to detailed stats (genre breakdowns, custom timeframes) and customizable visualizations. It’s ideal for anyone wanting regular insights into their listening habits.

? Is it completely free?

Yes—Your Spotify is open-source and free to use. You only need a Spotify account (free or Premium) and a way to self-host it (e.g., local machine or cheap server; no hosting fees unless you choose a paid provider).

Top Alternatives

Spotify Wrapped Search Google

Stats for Spotify Search Google

Tool Info

Pricing Free/Open Source

Category Personal Dashboards

Platform Self-Hosted

Pros

⊕ Privacy-focused (self-hosted, no third-party data sharing)
⊕ Easy Docker deployment for quick setup
⊕ Ongoing access to stats vs. annual summaries like Spotify Wrapped

Cons

⊖ Requires setup of a Spotify Developer app for API credentials
⊖ Web-only interface (no native mobile app)
⊖ Depends on Spotify API availability (may break if API changes)