Your Spotify

Your Spotify is a self-hosted application that tracks listening habits and provides a dashboard to explore personal music statistics. It consists of a web server that polls the Spotify API at regular intervals and a web application that allows users to visualize and explore the collected data. The software is designed to create a permanent record of music consumption that persists independently of the source platform.

Users typically deploy the software using Docker Compose, which orchestrates the server, the web client, and a MongoDB database. To function, the application requires a Spotify application ID and secret key, which are created through the Spotify developer dashboard. This setup allows the server to authenticate and retrieve streaming data for registered users.

Key features

• Automated polling of the Spotify API to track listening history
• Visual dashboard for exploring personal music statistics
• Support for importing privacy data for the previous year
• Support for importing full privacy data for entire account history
• User-specific timezone settings for computed statistics
• Ability to disable new registrations via admin settings
• Duplicate detection during data import processes
• Configurable log levels for debugging and system monitoring

The application architecture separates the data collection server from the frontend client. Because the Spotify API has technical limitations regarding historical data, the software includes specific import methods for JSON files obtained through privacy requests. These imports can range from a single year of history to the entire lifespan of an account. The server handles data in UTC time, while the web application applies the user's preferred timezone for read requests and computed statistics.

This software serves as a personal tracking tool for music listeners who prefer self-hosting their data and visualizing their long-term listening trends.