# yooooomi/your_spotify

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/yooooomi-your-spotify).**

4,270 stars · 179 forks · TypeScript · gpl-3.0

## Links

- GitHub: https://github.com/Yooooomi/your_spotify
- awesome-repositories: https://awesome-repositories.com/repository/yooooomi-your-spotify.md

## Topics

`dashboard` `react` `self-hosted` `spotify` `statistics` `webapp`

## Description

your_spotify is a containerized web application and music analytics tool designed to track and visualize listening habits. It serves as a dashboard for the Spotify API, providing a statistics engine that ranks artists and analyzes playback distribution over specific time periods.

The project focuses on music data archiving and social comparison, allowing users to import historical privacy data files to populate long-term listening records. It includes a social comparison system that uses intersection and union logic to identify shared favorite songs and artists between multiple users.

The application provides capabilities for music playback control and playlist management. It handles identity and access through an OAuth authentication system for third-party music accounts and includes administrative controls for managing user registrations.

The service is deployed as a set of containerized images for the API server, database, and web client, with built-in support for exporting performance metrics.

## Tags

### Web Development

- [Self-Hosted Analytics Services](https://awesome-repositories.com/f/web-development/third-party-api-clients/spotify-client-libraries/self-hosted-analytics-services.md) — A self-hosted service deployed as Docker containers for the API, database, and web client to analyze Spotify listening habits.
- [External API Polling](https://awesome-repositories.com/f/web-development/data-polling/external-api-polling.md) — Polls the Spotify API at intervals to record listening activity and store the data for analysis.
- [Data Archiving Clients](https://awesome-repositories.com/f/web-development/third-party-api-clients/spotify-client-libraries/data-archiving-clients.md) — Imports and stores historical Spotify privacy data to build long-term listening records beyond the API's default window.

### Data & Databases

- [Playback Distribution Aggregators](https://awesome-repositories.com/f/data-databases/data-analysis-visualization/analytical-platforms-engines/advanced-analytics-functions/statistical-aggregators/playback-distribution-aggregators.md) — Aggregates stored listening records to compute artist rankings and playback distributions over time.
- [Listening Statistics Dashboards](https://awesome-repositories.com/f/data-databases/data-visualization-dashboards/listening-statistics-dashboards.md) — Provides a web dashboard that visualizes personal listening statistics and playback history.
- [Historical Data Import](https://awesome-repositories.com/f/data-databases/historical-data-import.md) — Imports historical Spotify privacy export files to backfill listening records beyond the API window.

### Development Tools & Productivity

- [Listening History Dashboards](https://awesome-repositories.com/f/development-tools-productivity/dashboard-viewing/listening-history-dashboards.md) — Provides a dashboard of charts and metrics summarizing personal listening habits over time. ([source](https://github.com/Yooooomi/your_spotify#readme))
- [Listening History Polling](https://awesome-repositories.com/f/development-tools-productivity/dashboard-viewing/listening-history-dashboards/listening-history-polling.md) — Polls the Spotify API at intervals to record listening activity and store the data for later analysis. ([source](https://github.com/Yooooomi/your_spotify#readme))
- [Spotify Analytics Dashboards](https://awesome-repositories.com/f/development-tools-productivity/dashboard-viewing/listening-history-dashboards/spotify-analytics-dashboards.md) — Provides a web dashboard that visualizes personal listening statistics and playback history by connecting to the Spotify API.

### Graphics & Multimedia

- [Listening Analytics](https://awesome-repositories.com/f/graphics-multimedia/listening-analytics.md) — Tracks and visualizes personal music listening habits over time with charts and statistics.
- [Social Music Analytics](https://awesome-repositories.com/f/graphics-multimedia/social-music-analytics.md) — Compares music tastes between users by finding shared favorite songs and artists using intersection and union logic.

### Networking & Communication

- [Third-Party Music Service Authentication](https://awesome-repositories.com/f/networking-communication/communication-platforms-services/messaging-notification-systems/messaging-automation/account-authentication-gateways/account-authentication/third-party-music-service-authentication.md) — Authenticates with Spotify accounts via OAuth to access playback data and manage playlists.

### Security & Cryptography

- [Spotify OAuth Integrations](https://awesome-repositories.com/f/security-cryptography/oauth-authentication/oauth-provider-integrations/spotify-oauth-integrations.md) — Authenticates with Spotify accounts via OAuth to access playback data and manage playlists.
- [Third-Party Authentication Providers](https://awesome-repositories.com/f/security-cryptography/third-party-authentication-providers.md) — Authenticates users via Spotify's OAuth provider for secure access to playback data.

### Scientific & Mathematical Computing

- [Preference Intersections](https://awesome-repositories.com/f/scientific-mathematical-computing/set-theory-algorithms/preference-intersections.md) — Implements set-theoretic intersection and union operations to compare user music preferences.