Rocksky

Other Uses

• To scrobble to Rocksky, create a Rocksky (Client)

Rocksky is music tracking and discovery platform built on the AT Protocol (Bluesky).

This Source monitors the Rocksky scrobbles in your PDS and then re-scrobbles discovered tracks to configured clients.

Learn more about how Rocksky scrobbles work in the Rocksky (Client) docs.

Setup

Follow the Setup instructions in the Rocksky (Client) docs to get access to your Bluesky PDS repository and scrobble data.

Configuration

See the Rocksky (Client) configuration for general setup. The only difference for Source configuration:

• File/AIO config must include "configureAs": "source"

ENV

Configuration Type

This is configuration for the ENV Config Type.

Environmental Variable	Required?	Default	Description
SOURCE_ROCKSKY_HANDLE	Yes		Your full ATProto handle. For Bluesky account this is like myUser.bsky.social
SOURCE_ROCKSKY_KEY	Yes		API Key obtained from Rocksky developer dashboard

File

Config Structure

This displays the structure of the File Configuration for a rocksky type Source with all possible properties, their shape, and descriptions/types. Use this to understand how to write a valid config.

Loading ...

Config Example

This displays an example config file of a rocksky Source File Configuration that adheres to the shown Config Structure.

• text mode lets you edit the JSON directly.
• tree mode gives you a guided point-and-click editing experience that always keeps the JSON syntax valid.

Both modes validate that the configuraion is correct. Any errors show up as squiggly lines.

After you finish editing, switch to text and then copy all text to get a completed config.

Config Example Mobile Experience

This displays an example config file of a rocksky Source File Configuration that adheres to the shown Config Structure.

The example config file editor is meant for a larger screen experience so only the read-only example is shown. Please use this site on a tablet/laptop/desktop to enable file editor features.

CONFIG/rocksky.json

[
  {
    "name": "myRockskySource",
    "configureAs": "source",
    "data": {
      "key": "e4xwktm7jxm607x8el1fcda30eu14dzb64h3j",
      "handle": "alice.bsky.social"
    }
  }
]

AIO

Config Structure

This displays the structure of the all-in-one (config.json) configuration with all possible properties, their shape, and descriptions/types. Use this to understand how to write a valid config.

Select the rocksky type from the respective sources node below, then expand it.

Loading ...

Config Example

This displays an example config file of a all-in-one (config.json) configuration that includes a rocksky Source that adheres to the shown Config Structure.

• text mode lets you edit the JSON directly.
• tree mode gives you a guided point-and-click editing experience that always keeps the JSON syntax valid.

Both modes validate that the configuraion is correct. Any errors show up as squiggly lines.

After you finish editing, switch to text and then copy all text to get a completed config.

Config Example Mobile Experience

This displays an example config file of a all-in-one (config.json) configuration that includes a rocksky Source that adheres to the shown Config Structure.

The example config file editor is meant for a larger screen experience so only the read-only example is shown. Please use this site on a tablet/laptop/desktop to enable file editor features.

CONFIG/config.json

{
  "sources": [
    {
      "name": "myRockskySource",
      "configureAs": "source",
      "data": {
        "key": "e4xwktm7jxm607x8el1fcda30eu14dzb64h3j",
        "handle": "alice.bsky.social"
      },
      "type": "rocksky"
    }
  ]
}