🎵 EchoStats

Self-hosted Spotify analytics dashboard with 40+ pages of deep insights into your listening habits.

Get Started View on GitHub

Features

40+ Dashboard Pages

Charts, patterns, listening habits, music DNA, taste profile, mood analysis, year-in-review, and more.

Auto-Sync Engine

Background worker syncs your Spotify data every 15 minutes and refreshes analytics automatically.

6 Themes + Custom Accents

Dark, Light, Dim, Ocean, Midnight, Forest — plus 8 solid accents, 4 gradient accents, and a custom color picker.

Self-Hosted & Private

Deploy with Docker Compose or Helm. Your data never leaves your server.

Quick Start

# Clone and start in under 5 minutes
git clone https://github.com/spotify-devs/echostats.git
cd echostats && cp .env.example .env
# Edit .env with your Spotify credentials
docker compose up -d

Visit http://localhost:3000 and connect your Spotify account. Data syncs automatically every 15 minutes.

Tech Stack

Layer	Technology
Frontend	Next.js 16 · React 19 · TypeScript · Tailwind · Framer Motion
Backend	Python 3.12 · FastAPI · Pydantic
Database	MongoDB 7 · Beanie ODM
Cache	Redis 7 · ARQ (background worker)
Deploy	Docker · Helm 3 · Kubernetes