Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.rocksky.app/llms.txt

Use this file to discover all available pages before exploring further.

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 familyBase URL
ListenBrainzhttp://localhost:8778
Last.fm (API 2.0)http://localhost:8778/2.0
Web Scrobblerhttp://localhost:8778/webscrobbler/<ROCKSKY_WEBSCROBBLER_KEY>
See Local scrobble API for the end-to-end setup, including how to obtain each credential.