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.

Rocksky exposes a ListenBrainz-compatible API for the core scrobbling endpoints. Most ListenBrainz clients can be moved over by changing the base URL and the API token.

​
Prerequisites

​
Step 1: Change the base URL

ListenBrainzRocksky
https://api.listenbrainz.orghttps://audioscrobbler.rocksky.app

​
Step 2: Use your Rocksky API key

Update the Authorization header your client sends: 
Authorization: Token <your_rocksky_api_key>

​
Step 3: Test it

Submit a sample scrobble to /submit-listens with valid metadata, then check your Rocksky profile to confirm it landed.

​
Supported endpoints

The Rocksky audioscrobbler implements the core ListenBrainz endpoints, including:
  • POST /1/submit-listens
  • GET /1/validate-token

​
Metadata normalization

Rocksky tries to normalize incoming track metadata against its catalog. If a match cannot be found, the scrobble may be skipped instead of stored.

​
Per-client setup

If you use one of these clients, the per-client guide already covers the URL swap: