Migrating from ListenBrainz

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

A Rocksky account
An API key from the API Applications page
A ListenBrainz-compatible scrobbler

Step 1: Change the base URL

ListenBrainz	Rocksky
`https://api.listenbrainz.org`	`https://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:

Migrating from Last.fm Overview

​Prerequisites

​Step 1: Change the base URL

​Step 2: Use your Rocksky API key

​Step 3: Test it

​Supported endpoints

​Metadata normalization

​Per-client setup