scrobble-api - Rocksky

Start a local API server that accepts scrobbles from Last.fm, ListenBrainz, and Web Scrobbler clients, and forwards them to Rocksky. Useful for testing or running on a home server.

Usage

rocksky scrobble-api [options]

Required environment variables

ROCKSKY_API_KEY=...
ROCKSKY_SHARED_SECRET=...
ROCKSKY_SESSION_KEY=...
ROCKSKY_WEBSCROBBLER_KEY=...

ROCKSKY_IDENTIFIER=alice.bsky.social
ROCKSKY_PASSWORD=...

Endpoint summary

Client family	Base URL
ListenBrainz	`http://localhost:8778`
Last.fm (API 2.0)	`http://localhost:8778/2.0`
Web Scrobbler	`http://localhost:8778/webscrobbler/<ROCKSKY_WEBSCROBBLER_KEY>`

See Local scrobble API for the end-to-end setup, including how to obtain each credential.