Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.rocksky.app/llms.txt

Use this file to discover all available pages before exploring further.

Rocksky exposes a Subsonic / Navidrome-compatible API. Upload your music to your private Rocksky library and stream it from any Subsonic client — phone, desktop, car head unit — without running your own server.

​
Step 1: Upload music

Open My Library in Rocksky’s sidebar:
Rocksky sidebar with 'My Library (experimental)' link and the Scrobble Stats chart
Drag and drop your audio files (MP3, FLAC, M4A, OGG, WAV, AIFF) into the upload page. Required tags: title, artist, album, album artist, duration, album art. Need to tag your files first? MusicBrainz Picard auto-fills metadata from the MusicBrainz database.
Rocksky Upload Music page with a track successfully uploaded
Your uploaded music is private — only you can access and stream your files.

​
Step 2: Get an API key

Visit the API Keys page and generate a new key. You’ll use it as the password in your Subsonic client.

​
Step 3: Configure your client

In any Subsonic / Navidrome-compatible app, add a new server with these details:
FieldValue
Server URLhttps://navidrome.rocksky.app
UsernameYour ATProto handle (e.g. alice.bsky.social)
PasswordYour Rocksky API key
Cassette desktop app configured against navidrome.rocksky.app

​
Compatible apps

  • Symfonium (Android)
  • Substreamer (Android, iOS)
  • Cassette (iOS)
  • play:Sub (iOS)
  • Amperfy (iOS, macOS)
  • Tempo (iOS, macOS)
  • …and many other Navidrome / Subsonic clients.

​
Scrobbling

Plays from any of these clients are scrobbled automatically — there’s nothing extra to wire up.
Rocksky currently stores uploads on Cloudflare R2. Support for user-connected S3-compatible providers (bring-your-own bucket) is on the roadmap.