Rocksky
  1. How-Tos
Rocksky
  • Overview
  • Introduction
  • FAQ
  • How-Tos
    • Migrating to Rocksky Scrobble API
    • 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
      • Save 'Now Playing' Song
      • Get 'Now Playing' Song
    • 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)

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-04-19 12:26:08
Previous
FAQ
Next
Use Rocksky with Claude Desktop
Built with