Homarr
Your Spotify logo

Your Spotify

Music

A self-hosted Spotify listening history tracker.

Widgets & Capabilities

StatisticsCombine selected statistics from multiple integrations in cards, compact rows, or grouped tables.
View guide

The Stats widget reads Your Spotify's songs_per, time_per, and different_artists_per endpoints and displays songs listened, listening time, and distinct artists. Homarr requests the fixed all-time range used by the upstream widget (start=2006-04-23T00:00:00.000Z and timeSplit=all).

Adding the integration

Create the connection under Management → Integrations. See Managing integrations.

Point the integration at the Your Spotify API service, which listens on port 8080 by default. The API endpoints use the public token generated under Settings > Account > Public token; add that token as the integration's API key.

Secrets

On this page