---
title: Rocksky
description: Rocksky (Source)
toc_min_heading_level: 2
toc_max_heading_level: 5
---

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
import CodeBlock from '@theme/CodeBlock';
import JsonConfig from '!!raw-loader!@site/../config/rocksky.json.example';

:::tip[Other Uses]

* To **scrobble to** Rocksky, create a [Rocksky (Client)](/configuration/clients/rocksky)

:::

[**Rocksky**](https://rocksky.app/) 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)](/configuration/clients/rocksky) docs. 

## Setup

Follow the **Setup** instructions in the [Rocksky (Client)](/configuration/clients/rocksky#setup) docs to get access to your Bluesky PDS repository and scrobble data.

## Configuration

See the [Rocksky (Client)](/configuration/clients/rocksky#setup) configuration for general setup. The only difference for **Source** configuration:

* [File/AIO config](/configuration?configType=file#configuration-types) must include `"configureAs": "source"`

<Config config="RockskySourceConfig" fileContent={JsonConfig} name="rocksky">
        | Environmental Variable  | Required? | Default | Description                                                                         |
        | :---------------------- | --------- | ------- | ----------------------------------------------------------------------------------- |
        | `SOURCE_ROCKSKY_ID`     | Yes       |         | A unique ID                                                                         |
        | `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                                   |
        | `SOURCE_ROCKSKY_NAME`   | No        |         | A vanity name different than ID                                                     |
</Config>