Rocksky
  1. How-Tos
Rocksky
  • Overview
  • Introduction
  • FAQ
  • How-Tos
    • Migrating to Rocksky Scrobble API
    • Migrating from ListenBrainz to Rocksky
    • How to Use Rocksky with Jellyfin
    • How to Use Rocksky with Navidrome
    • How to Use Rocksky with Pano Scrobbler on Android
    • How to Use Rocksky with Kodi
    • Use Rocksky with Claude Desktop
  • CLI
    • Overview
    • Commands
      • login
      • mcp
      • whoami
      • nowplaying
      • scrobbles
      • search
      • stats
      • artists
      • albums
      • tracks
      • scrobble
      • create apikey
      • help
  • API Reference
    • albums
      • Get User's Albums
      • Get Album
      • Get Several Albums
    • artists
      • Get User's Artists
      • Get Artist
      • Get Several Artists
    • charts
      • Get Scrobbles Per Day
    • playlists
      • Get User's Playlists
      • Get Playlist
    • scrobbles
      • Get Scrobbles
      • Get User's Scrobbles
    • users
      • Find User Profile
    • tracks
      • Get User's Tracks
      • Get Track
      • Get Several Tracks
    • search
      • Search for Item
    • likes
      • Get User's Liked Songs
  1. How-Tos

Migrating to Rocksky Scrobble API

Rocksky offers a fully compatible implementation of the Last.fm Audioscrobbler API ā€” so you can seamlessly migrate your scrobbling apps or integrations to Rocksky by simply changing the API endpoint and credentials.

Base URL#

Replace the Last.fm endpoint:
https://ws.audioscrobbler.com/2.0
With the Rocksky scrobble endpoint:
https://audioscrobbler.rocksky.app/2.0

Authentication#

api_key: Your Rocksky API key (obtainable from your Rocksky developer dashboard).
sk: Your Rocksky session key (obtained after user authentication rocksky login)

Legacy Last.fm API Compatibility#

Rocksky also supports older Last.fm clients using the legacy Audioscrobbler protocol (pre-2.0). You can use these legacy configurations in clients such as Deadbeef or older music players:

Legacy API Config:#

FieldValue
UsernameYour Rocksky API key (obtainable from your Rocksky developer dashboard)
PasswordYour Rocksky shared secret (obtainable from your Rocksky developer dashboard)
Scrobble URLhttps://audioscrobbler.rocksky.app
ā„¹ļø Note: Rocksky will also try to normalize songs metadata. If it cannot find a matching track, it will skip the scrobble.

Example Scrobble Request#

Method: POST
URL: https://audioscrobbler.rocksky.app/2.0
Headers: Content-Type: application/x-www-form-urlencoded
Body (as x-www-form-urlencoded):
ParameterExample Value
methodtrack.scrobble
api_keyYOUR_API_KEY
skYOUR_SESSION_KEY
artist[0]Radiohead
track[0]Karma Police
timestamp[0]1744579159
api_sig532b7492411fdfcd79639b548b5ee8a8
formatjson

Generating api_sig#

To compute the signature:
1.
Sort all parameters (excluding api_sig and format) by key.
2.
Concatenate key-value pairs (key1value1key2value2...).
3.
Append your shared secret to the concatenated string.
4.
MD5 hash the result.
Example in pseudo-code:

Migrating Your App#

To switch from Last.fm to Rocksky:
1.
Change the API base URL.
2.
Update your API key and session key (from rocksky login).
3.
Use the same payload format and signature method.
4.
Done!

Why Switch to Rocksky?#

šŸ”„ Open Scrobble Infrastructure
šŸ“Š Modern analytics and detailed stats
šŸ” Built on top of AT Protocol for portability
šŸ”§ Compatible with existing Last.fm tools
Modified atĀ 2025-05-23 23:00:14
Previous
FAQ
Next
Migrating from ListenBrainz to Rocksky
Built with