# Your Spotify — Self-Hosted Spotify Listening Dashboard

> Track and visualize your Spotify listening habits with a beautiful self-hosted dashboard that provides detailed statistics and historical insights.

## Install

Save as a script file and run:

# Your Spotify — Self-Hosted Spotify Listening Dashboard

## Quick Use
```bash
git clone https://github.com/Yooooomi/your_spotify.git
cd your_spotify
cp .env.example .env
# Edit .env with your Spotify API credentials
docker compose up -d
```

## Introduction
Your Spotify is a self-hosted web application that connects to the Spotify API to collect and display your listening history over time. Unlike Spotify Wrapped, which gives you a yearly summary, Your Spotify tracks your habits continuously and presents them through an interactive dashboard with charts and statistics.

## What Your Spotify Does
- Continuously tracks your listening history via the Spotify API
- Displays top artists, tracks, and albums over configurable time ranges
- Provides listening time statistics broken down by day, week, or month
- Shows a timeline of your listening sessions with detailed metadata
- Supports multiple user accounts on a single instance

## Architecture Overview
Your Spotify uses a Node.js backend that periodically polls the Spotify Web API for recent plays and stores them in MongoDB. The frontend is built with React and presents the data through interactive charts using Recharts. Authentication is handled via Spotify OAuth, and the entire stack runs in Docker containers.

## Self-Hosting & Configuration
- Requires a Spotify Developer application for API credentials (Client ID and Secret)
- Runs via Docker Compose with three containers: server, client, and MongoDB
- Configure the callback URL in your Spotify Developer dashboard to match your instance
- Set environment variables for API keys, MongoDB URI, and public URL
- Data persists in a MongoDB volume; back up the volume for data safety

## Key Features
- Beautiful dashboard with multiple chart types for visualizing trends
- Configurable time ranges: last week, month, 6 months, year, or all time
- Per-song and per-artist listening duration tracking
- Collaborative mode allowing friends to share a single instance
- Lightweight resource footprint suitable for Raspberry Pi deployments

## Comparison with Similar Tools
- **Spotify Wrapped** — annual-only summary with no self-hosting; Your Spotify tracks continuously
- **Last.fm** — third-party scrobbling service; Your Spotify keeps data on your own server
- **stats.fm** — freemium SaaS with limited history; Your Spotify is free and unlimited
- **Receiptify** — generates one-off receipt-style summaries; no ongoing tracking

## FAQ
**Q: Do I need a Spotify Premium account?**
A: No. Your Spotify works with both free and premium Spotify accounts via the Web API.

**Q: How far back can it import history?**
A: The Spotify API provides approximately the last 50 recently played tracks. Over time, continuous polling builds a complete history from the moment you start using it.

**Q: Can multiple people use one instance?**
A: Yes. Each user authenticates with their own Spotify account and gets a separate dashboard view.

**Q: Does it work with Apple Music or other services?**
A: No. Your Spotify is designed exclusively for the Spotify platform.

## Sources
- https://github.com/Yooooomi/your_spotify
- https://your-spotify-music.com

---
Source: https://tokrepo.com/en/workflows/asset-cacad1e0
Author: Script Depot