Yooooomi/your_spotify
Your Spotify
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.
Features
- Self-Hosted Analytics Services - A self-hosted service deployed as Docker containers for the API, database, and web client to analyze Spotify listening habits.
- Playback Distribution Aggregators - Aggregates stored listening records to compute artist rankings and playback distributions over time.
- Listening Statistics Dashboards - Provides a web dashboard that visualizes personal listening statistics and playback history.
- Listening History Dashboards - Provides a dashboard of charts and metrics summarizing personal listening habits over time.
- Listening History Polling - Polls the Spotify API at intervals to record listening activity and store the data for later analysis.
- Spotify Analytics Dashboards - Provides a web dashboard that visualizes personal listening statistics and playback history by connecting to the Spotify API.
- Listening Analytics - Tracks and visualizes personal music listening habits over time with charts and statistics.
- Third-Party Music Service Authentication - Authenticates with Spotify accounts via OAuth to access playback data and manage playlists.
- Spotify OAuth Integrations - Authenticates with Spotify accounts via OAuth to access playback data and manage playlists.
- Third-Party Authentication Providers - Authenticates users via Spotify's OAuth provider for secure access to playback data.
- External API Polling - Polls the Spotify API at intervals to record listening activity and store the data for analysis.
- Historical Data Import - Imports historical Spotify privacy export files to backfill listening records beyond the API window.
- Social Music Analytics - Compares music tastes between users by finding shared favorite songs and artists using intersection and union logic.
- Preference Intersections - Implements set-theoretic intersection and union operations to compare user music preferences.
- Data Archiving Clients - Imports and stores historical Spotify privacy data to build long-term listening records beyond the API's default window.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
