# Rocksky

## Docs

- [Get albums for an actor](https://docs.rocksky.app/api-reference/approckskyactor/get-albums-for-an-actor.md)
- [Get artists for an actor](https://docs.rocksky.app/api-reference/approckskyactor/get-artists-for-an-actor.md)
- [Get compatibility for an actor](https://docs.rocksky.app/api-reference/approckskyactor/get-compatibility-for-an-actor.md)
- [Get loved songs for an actor](https://docs.rocksky.app/api-reference/approckskyactor/get-loved-songs-for-an-actor.md)
- [Get neighbours for an actor](https://docs.rocksky.app/api-reference/approckskyactor/get-neighbours-for-an-actor.md)
- [Get playlists for an actor](https://docs.rocksky.app/api-reference/approckskyactor/get-playlists-for-an-actor.md)
- [Get scrobbles for an actor](https://docs.rocksky.app/api-reference/approckskyactor/get-scrobbles-for-an-actor.md)
- [Get songs for an actor](https://docs.rocksky.app/api-reference/approckskyactor/get-songs-for-an-actor.md)
- [Get the profile of an actor](https://docs.rocksky.app/api-reference/approckskyactor/get-the-profile-of-an-actor.md)
- [Get albums](https://docs.rocksky.app/api-reference/approckskyalbum/get-albums.md)
- [Get detailed album view](https://docs.rocksky.app/api-reference/approckskyalbum/get-detailed-album-view.md)
- [Get tracks for an album](https://docs.rocksky.app/api-reference/approckskyalbum/get-tracks-for-an-album.md)
- [Create a new API key for the authenticated user](https://docs.rocksky.app/api-reference/approckskyapikey/create-a-new-api-key-for-the-authenticated-user.md)
- [Get a list of API keys for the authenticated user](https://docs.rocksky.app/api-reference/approckskyapikey/get-a-list-of-api-keys-for-the-authenticated-user.md)
- [Remove an API key for the authenticated user](https://docs.rocksky.app/api-reference/approckskyapikey/remove-an-api-key-for-the-authenticated-user.md)
- [Update an existing API key for the authenticated user](https://docs.rocksky.app/api-reference/approckskyapikey/update-an-existing-api-key-for-the-authenticated-user.md)
- [Get artist details](https://docs.rocksky.app/api-reference/approckskyartist/get-artist-details.md)
- [Get artist listeners](https://docs.rocksky.app/api-reference/approckskyartist/get-artist-listeners.md)
- [Get artist recent listeners ordered by most recent scrobble](https://docs.rocksky.app/api-reference/approckskyartist/get-artist-recent-listeners-ordered-by-most-recent-scrobble.md)
- [Get artists](https://docs.rocksky.app/api-reference/approckskyartist/get-artists.md)
- [Get artist's albums](https://docs.rocksky.app/api-reference/approckskyartist/get-artists-albums.md)
- [Get artist's tracks](https://docs.rocksky.app/api-reference/approckskyartist/get-artists-tracks.md)
- [Get the scrobbles chart](https://docs.rocksky.app/api-reference/approckskycharts/get-the-scrobbles-chart.md)
- [Get top artists](https://docs.rocksky.app/api-reference/approckskycharts/get-top-artists.md)
- [Get top tracks](https://docs.rocksky.app/api-reference/approckskycharts/get-top-tracks.md)
- [Get all currently playing tracks by users](https://docs.rocksky.app/api-reference/approckskyfeed/get-all-currently-playing-tracks-by-users.md)
- [Get all feed generators](https://docs.rocksky.app/api-reference/approckskyfeed/get-all-feed-generators.md)
- [Get information about a feed generator](https://docs.rocksky.app/api-reference/approckskyfeed/get-information-about-a-feed-generator.md)
- [Get information about a feed generator](https://docs.rocksky.app/api-reference/approckskyfeed/get-information-about-a-feed-generator-1.md)
- [Get personalised album recommendations for a user](https://docs.rocksky.app/api-reference/approckskyfeed/get-personalised-album-recommendations-for-a-user.md)
- [Get personalised artist recommendations for a user](https://docs.rocksky.app/api-reference/approckskyfeed/get-personalised-artist-recommendations-for-a-user.md)
- [Get personalised track recommendations for a user](https://docs.rocksky.app/api-reference/approckskyfeed/get-personalised-track-recommendations-for-a-user.md)
- [Get the feed by uri](https://docs.rocksky.app/api-reference/approckskyfeed/get-the-feed-by-uri.md)
- [Get the feed by uri](https://docs.rocksky.app/api-reference/approckskyfeed/get-the-feed-by-uri-1.md)
- [Search for content in the feed](https://docs.rocksky.app/api-reference/approckskyfeed/search-for-content-in-the-feed.md)
- [Creates a 'follow' relationship from the authenticated account to a specified account.](https://docs.rocksky.app/api-reference/approckskygraph/creates-a-follow-relationship-from-the-authenticated-account-to-a-specified-account.md)
- [Enumerates accounts which a specified account (actor) follows.](https://docs.rocksky.app/api-reference/approckskygraph/enumerates-accounts-which-a-specified-account-actor-follows.md)
- [Enumerates accounts which follow a specified account (actor).](https://docs.rocksky.app/api-reference/approckskygraph/enumerates-accounts-which-follow-a-specified-account-actor.md)
- [Enumerates accounts which follow a specified account (actor) and are followed by the viewer.](https://docs.rocksky.app/api-reference/approckskygraph/enumerates-accounts-which-follow-a-specified-account-actor-and-are-followed-by-the-viewer.md)
- [Removes a 'follow' relationship from the authenticated account to a specified account.](https://docs.rocksky.app/api-reference/approckskygraph/removes-a-follow-relationship-from-the-authenticated-account-to-a-specified-account.md)
- [Dislike a shout](https://docs.rocksky.app/api-reference/approckskylike/dislike-a-shout.md)
- [Dislike a song](https://docs.rocksky.app/api-reference/approckskylike/dislike-a-song.md)
- [Like a shout](https://docs.rocksky.app/api-reference/approckskylike/like-a-shout.md)
- [Like a song](https://docs.rocksky.app/api-reference/approckskylike/like-a-song.md)
- [Get the authenticated user's scrobble mirror sources (Last.fm, ListenBrainz, Teal.fm).](https://docs.rocksky.app/api-reference/approckskymirror/get-the-authenticated-users-scrobble-mirror-sources-lastfm-listenbrainz-tealfm.md)
- [Upsert a mirror source for the authenticated user. Toggling `enabled` notifies the mirror process over NATS so it can start/stop the per-user task without a restart.](https://docs.rocksky.app/api-reference/approckskymirror/upsert-a-mirror-source-for-the-authenticated-user-toggling-`enabled`-notifies-the-mirror-process-over-nats-so-it-can-startstop-the-per-user-task-without-a-restart.md)
- [Add directory to the player's queue](https://docs.rocksky.app/api-reference/approckskyplayer/add-directory-to-the-players-queue.md)
- [Add items to the player's queue](https://docs.rocksky.app/api-reference/approckskyplayer/add-items-to-the-players-queue.md)
- [Get the currently playing track](https://docs.rocksky.app/api-reference/approckskyplayer/get-the-currently-playing-track.md)
- [Pause the currently playing track](https://docs.rocksky.app/api-reference/approckskyplayer/pause-the-currently-playing-track.md)
- [Play a specific audio file](https://docs.rocksky.app/api-reference/approckskyplayer/play-a-specific-audio-file.md)
- [Play all tracks in a directory](https://docs.rocksky.app/api-reference/approckskyplayer/play-all-tracks-in-a-directory.md)
- [Play the next track in the queue](https://docs.rocksky.app/api-reference/approckskyplayer/play-the-next-track-in-the-queue.md)
- [Play the previous track in the queue](https://docs.rocksky.app/api-reference/approckskyplayer/play-the-previous-track-in-the-queue.md)
- [Resume playback of the currently paused track](https://docs.rocksky.app/api-reference/approckskyplayer/resume-playback-of-the-currently-paused-track.md)
- [Retrieve the current playback queue](https://docs.rocksky.app/api-reference/approckskyplayer/retrieve-the-current-playback-queue.md)
- [Seek to a specific position in the currently playing track](https://docs.rocksky.app/api-reference/approckskyplayer/seek-to-a-specific-position-in-the-currently-playing-track.md)
- [Create a new playlist](https://docs.rocksky.app/api-reference/approckskyplaylist/create-a-new-playlist.md)
- [Insert a directory into a playlist](https://docs.rocksky.app/api-reference/approckskyplaylist/insert-a-directory-into-a-playlist.md)
- [Insert files into a playlist](https://docs.rocksky.app/api-reference/approckskyplaylist/insert-files-into-a-playlist.md)
- [Remove a playlist](https://docs.rocksky.app/api-reference/approckskyplaylist/remove-a-playlist.md)
- [Remove a track from a playlist](https://docs.rocksky.app/api-reference/approckskyplaylist/remove-a-track-from-a-playlist.md)
- [Retrieve a list of playlists](https://docs.rocksky.app/api-reference/approckskyplaylist/retrieve-a-list-of-playlists.md)
- [Retrieve a playlist by its ID](https://docs.rocksky.app/api-reference/approckskyplaylist/retrieve-a-playlist-by-its-id.md)
- [Start a playlist](https://docs.rocksky.app/api-reference/approckskyplaylist/start-a-playlist.md)
- [Create a new scrobble](https://docs.rocksky.app/api-reference/approckskyscrobble/create-a-new-scrobble.md)
- [Get a scrobble by its unique identifier](https://docs.rocksky.app/api-reference/approckskyscrobble/get-a-scrobble-by-its-unique-identifier.md)
- [Get scrobbles all scrobbles](https://docs.rocksky.app/api-reference/approckskyscrobble/get-scrobbles-all-scrobbles.md)
- [Create a new shout](https://docs.rocksky.app/api-reference/approckskyshout/create-a-new-shout.md)
- [Get all shouts for a specific track](https://docs.rocksky.app/api-reference/approckskyshout/get-all-shouts-for-a-specific-track.md)
- [Get replies to a shout](https://docs.rocksky.app/api-reference/approckskyshout/get-replies-to-a-shout.md)
- [Get shouts for an album](https://docs.rocksky.app/api-reference/approckskyshout/get-shouts-for-an-album.md)
- [Get shouts for an artist](https://docs.rocksky.app/api-reference/approckskyshout/get-shouts-for-an-artist.md)
- [Get the shouts of an actor's profile](https://docs.rocksky.app/api-reference/approckskyshout/get-the-shouts-of-an-actors-profile.md)
- [Remove a shout by its ID](https://docs.rocksky.app/api-reference/approckskyshout/remove-a-shout-by-its-id.md)
- [Reply to a shout](https://docs.rocksky.app/api-reference/approckskyshout/reply-to-a-shout.md)
- [Report a shout for moderation](https://docs.rocksky.app/api-reference/approckskyshout/report-a-shout-for-moderation.md)
- [Create a new song](https://docs.rocksky.app/api-reference/approckskysong/create-a-new-song.md)
- [Get a song by its uri, MusicBrainz ID, or ISRC](https://docs.rocksky.app/api-reference/approckskysong/get-a-song-by-its-uri-musicbrainz-id-or-isrc.md)
- [Get song recent listeners ordered by most recent scrobble](https://docs.rocksky.app/api-reference/approckskysong/get-song-recent-listeners-ordered-by-most-recent-scrobble.md)
- [Get songs](https://docs.rocksky.app/api-reference/approckskysong/get-songs.md)
- [Matches a song against Rocksky’s music database and external metadata providers to resolve the best canonical track, artist, and album](https://docs.rocksky.app/api-reference/approckskysong/matches-a-song-against-rocksky’s-music-database-and-external-metadata-providers-to-resolve-the-best-canonical-track-artist-and-album.md)
- [Get the currently playing track](https://docs.rocksky.app/api-reference/approckskyspotify/get-the-currently-playing-track.md)
- [Pause the currently playing track](https://docs.rocksky.app/api-reference/approckskyspotify/pause-the-currently-playing-track.md)
- [Play the next track in the queue](https://docs.rocksky.app/api-reference/approckskyspotify/play-the-next-track-in-the-queue.md)
- [Play the previous track in the queue](https://docs.rocksky.app/api-reference/approckskyspotify/play-the-previous-track-in-the-queue.md)
- [Resume playback of the currently paused track](https://docs.rocksky.app/api-reference/approckskyspotify/resume-playback-of-the-currently-paused-track.md)
- [Seek to a specific position in the currently playing track](https://docs.rocksky.app/api-reference/approckskyspotify/seek-to-a-specific-position-in-the-currently-playing-track.md)
- [Get a user's year-in-review Wrapped stats](https://docs.rocksky.app/api-reference/approckskystats/get-a-users-year-in-review-wrapped-stats.md)
- [Get approckskystatsgetstats](https://docs.rocksky.app/api-reference/approckskystats/get-approckskystatsgetstats.md)
- [Introduction](https://docs.rocksky.app/api-reference/introduction.md): The Rocksky HTTP API, built on AT Protocol XRPC.
- [albums](https://docs.rocksky.app/cli/albums.md): Show top albums for a user.
- [artists](https://docs.rocksky.app/cli/artists.md): Show top artists for a user.
- [create apikey](https://docs.rocksky.app/cli/create-apikey.md): Generate a new API key for an application or integration.
- [help](https://docs.rocksky.app/cli/help.md): Show help for any rocksky command.
- [login](https://docs.rocksky.app/cli/login.md): Authenticate the CLI with your Bluesky account.
- [mcp](https://docs.rocksky.app/cli/mcp.md): Start an MCP server so Claude and other LLMs can read your Rocksky data.
- [nowplaying](https://docs.rocksky.app/cli/nowplaying.md): Show the currently playing track for yourself or any user.
- [Overview](https://docs.rocksky.app/cli/overview.md): Scrobble tracks, view stats, and manage your listening history from the terminal.
- [scrobble](https://docs.rocksky.app/cli/scrobble.md): Record a play to your Rocksky profile.
- [scrobble-api](https://docs.rocksky.app/cli/scrobble-api.md): Run a local Last.fm / ListenBrainz / Web Scrobbler-compatible server.
- [scrobbles](https://docs.rocksky.app/cli/scrobbles.md): List recent scrobbles for yourself or another user.
- [search](https://docs.rocksky.app/cli/search.md): Search Rocksky for tracks, albums, and accounts.
- [stats](https://docs.rocksky.app/cli/stats.md): Show listening statistics for a user.
- [sync](https://docs.rocksky.app/cli/sync.md): Sync local Rocksky data from the AT Protocol.
- [tracks](https://docs.rocksky.app/cli/tracks.md): Show top tracks for a user.
- [whoami](https://docs.rocksky.app/cli/whoami.md): Show the currently authenticated user.
- [FAQ](https://docs.rocksky.app/faq.md): Common questions about Rocksky, scrobbling, self-hosting, and privacy.
- [Introduction](https://docs.rocksky.app/index.md): Rocksky is a decentralized, open-source music scrobbling network built on the AT Protocol.
- [Claude Desktop (MCP)](https://docs.rocksky.app/integrations/claude-desktop.md): Query your scrobble history from Claude Desktop using the Rocksky MCP server.
- [Jellyfin](https://docs.rocksky.app/integrations/jellyfin.md): Scrobble plays from your Jellyfin server to Rocksky.
- [Kodi](https://docs.rocksky.app/integrations/kodi.md): Scrobble plays from Kodi to Rocksky using the official ListenBrainz add-on.
- [Navidrome](https://docs.rocksky.app/integrations/navidrome.md): Scrobble from a Navidrome server to Rocksky using the ListenBrainz-compatible API.
- [Rocksky as a personal Navidrome server](https://docs.rocksky.app/integrations/navidrome-server.md): Stream your uploaded library through any Navidrome / Subsonic-compatible client, using Rocksky as the backend.
- [Pano Scrobbler (Android)](https://docs.rocksky.app/integrations/pano-scrobbler.md): Scrobble from any Android music player using Pano Scrobbler.
- [Local scrobble API](https://docs.rocksky.app/integrations/scrobble-api-local.md): Run a local ListenBrainz / Last.fm / Web Scrobbler-compatible server backed by Rocksky.
- [Web Scrobbler](https://docs.rocksky.app/integrations/web-scrobbler.md): Scrobble plays from YouTube, SoundCloud, Spotify Web, and 100+ other sites with the Web Scrobbler browser extension.
- [Migrating from Last.fm](https://docs.rocksky.app/migrations/from-lastfm.md): Repoint any Last.fm Audioscrobbler-compatible client at Rocksky.
- [Migrating from ListenBrainz](https://docs.rocksky.app/migrations/from-listenbrainz.md): Switch any ListenBrainz client over to Rocksky in two steps.
- [Mirror from Last.fm](https://docs.rocksky.app/mirroring/lastfm.md): Pull plays from a Last.fm account into Rocksky on a 30-second poll.
- [Mirror from ListenBrainz](https://docs.rocksky.app/mirroring/listenbrainz.md): Pull listens from a ListenBrainz account into Rocksky on a 30-second poll.
- [Scrobble mirroring](https://docs.rocksky.app/mirroring/overview.md): Keep using Last.fm, ListenBrainz, or Teal.fm — and have those plays mirror into Rocksky automatically.
- [Mirror from Teal.fm](https://docs.rocksky.app/mirroring/tealfm.md): Subscribe to Teal.fm play events in real time over AT Protocol Jetstream.
- [Quick start](https://docs.rocksky.app/quickstart.md): Get up and running with Rocksky in under 5 minutes.
- [Clojure](https://docs.rocksky.app/sdks/clojure.md): Idiomatic, pipe-friendly Clojure client for the Rocksky XRPC API.
- [Elixir](https://docs.rocksky.app/sdks/elixir.md): Pipe-friendly Elixir client for the Rocksky XRPC API.
- [Gleam](https://docs.rocksky.app/sdks/gleam.md): Pipe-friendly Gleam SDK for the Rocksky XRPC API.
- [Go](https://docs.rocksky.app/sdks/go.md): Idiomatic Go SDK for the Rocksky XRPC API.
- [Kotlin](https://docs.rocksky.app/sdks/kotlin.md): Coroutine-based Kotlin-first SDK for the Rocksky XRPC API.
- [SDKs](https://docs.rocksky.app/sdks/overview.md): Official Rocksky SDKs across nine languages — one for every flavor of XRPC client.
- [Python](https://docs.rocksky.app/sdks/python.md): Async Python SDK for the Rocksky XRPC API with Pydantic v2 models.
- [Ruby](https://docs.rocksky.app/sdks/ruby.md): Idiomatic Ruby client for the Rocksky XRPC API.
- [Rust](https://docs.rocksky.app/sdks/rust.md): Async Rust SDK for the Rocksky XRPC API — tokio + reqwest, builder-friendly.
- [TypeScript](https://docs.rocksky.app/sdks/typescript.md): Type-safe Rocksky SDK for Bun, Node 18+, Deno, browsers, and Cloudflare Workers.

## OpenAPI Specs

- [openapi](https://docs.rocksky.app/api-reference/openapi.json)

## Optional

- [rocksky.app](https://rocksky.app)
- [Source](https://tangled.org/@rocksky.app/rocksky)
- [Discord](https://discord.gg/EVcBy2fVa3)