Rocksky
    • Introduction
    • Quickstart
    • FAQ
    • How-Tos
      • Migrating to Rocksky Scrobble API
      • Migrating from ListenBrainz to Rocksky
      • Use Rocksky as Your Personal Navidrome Server
      • How to Use Rocksky with Jellyfin
      • How to Use Rocksky with Navidrome
      • How to Use Rocksky with Pano Scrobbler on Android
      • How to Use Rocksky with Kodi
      • Run a local ListenBrainz / Last.fm / Web Scrobbler compatible API (Rocksky CLI)
      • Use Rocksky with Claude Desktop
    • CLI
      • Overview
      • Commands
        • login
        • mcp
        • whoami
        • nowplaying
        • scrobbles
        • scrobble-api
        • search
        • stats
        • artists
        • albums
        • tracks
        • scrobble
        • create apikey
        • help
        • sync
    • 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
      • feed
        • Get all feed generators
        • Get feed generator
        • Get feed
      • graph
        • Get User Followers
        • Get User Follows
      • likes
        • Get User's Liked Songs
      • playlists
        • Get User's Playlists
        • Get Playlist
      • scrobbles
        • Get Scrobbles
        • Get User's Scrobbles
      • users
        • Find User Profile
      • tracks
        • Get User's Tracks
        • Get Track
        • Get Several Tracks
        • Matches a song
      • search
        • Search for Item
    • Schemas
      • User
      • Album
      • Artist
      • Track
      • Scrobble

    FAQ

    General Questions#

    What is Rocksky?#

    Rocksky is a decentralized, open-source alternative to Last.fm built on the AT Protocol (Bluesky). It automatically tracks ("scrobbles") your music listening from many sources and publishes it to your own decentralized identity, giving you full ownership of your data.

    Why should I use Rocksky instead of Last.fm or ListenBrainz?#

    You own your data on the AT Protocol (you can move it or self-host)
    Real-time Stories feed to see what your friends are listening to
    Strong compatibility with existing scrobblers
    Full open source and self-hostable
    No corporate control or data lock-in

    Do I need a Bluesky account?#

    Yes for the hosted version (rocksky.app). You can use any AT Protocol identity, including one from a self-hosted PDS.

    Technical & Privacy#

    Where is my data stored?#

    Your scrobbles are stored on an AT Protocol Personal Data Server (PDS).
    You control your data and can export or migrate it anytime.

    Can I delete my data?#

    Yes. You can delete individual scrobbles or your entire history at any time.

    Scrobbling & Integrations#

    What does "scrobble" mean?#

    Scrobbling is automatically recording the songs you play (artist, track, album, timestamp, duration, etc.).

    Which players and services work with Rocksky?#

    Spotify
    Jellyfin
    Navidrome
    Pano Scrobbler (Android, Windows, Linux)
    WebScrobbler (Chrome/Firefox)
    Kodi
    Any player that supports Last.fm or ListenBrainz API

    Does it support real-time "Now Playing"?#

    Yes ā€” especially with Spotify and supported native clients.

    Self-Hosting#

    Can I run my own instance?#

    Absolutely. Rocksky is designed to be fully self-hostable.

    Is self-hosting difficult?#

    It requires Docker, some technical knowledge, and maintenance. We provide detailed guides and Docker Compose files. A simpler one-click setup is planned.

    Can I use Rocksky with my own custom domain / PDS?#

    Yes.

    Social & Features#

    What is the Stories feed?#

    A real-time decentralized feed showing what your Bluesky friends (and other Rocksky users) are listening to right now.

    Can I like or comment on scrobbles?#

    Yes ā€” we support likes and a shoutbox-style commenting system.

    Will Rocksky have personalized recommendations?#

    This is on the roadmap (high priority).

    Troubleshooting#

    My scrobbles aren't appearing. What should I do?#

    1.
    Check that the scrobbler is pointing to the correct Rocksky endpoint
    2.
    Verify your API key (if using manual setup)
    3.
    Make sure your player is sending the required metadata

    The app feels slow. Is that normal?#

    The hosted version is still in active development. Performance will improve rapidly. Self-hosting close to you usually feels faster.

    Development & Future#

    How can I contribute?#

    Join the Discord
    Open issues or PRs on Tangled
    Help improve documentation
    Build integrations

    Is Rocksky open source?#

    Yes! šŸŽ‰
    Rocksky is now open source and available on Tangled.
    You can explore the source code, self-host Rocksky, build integrations, and contribute to its development here:
    šŸ‘‰ https://tangled.org/@rocksky.app/rocksky
    Community contributions, experiments, and feedback are very welcome.

    Are you affiliated with Bluesky?#

    No. Rocksky is an independent project built on top of the AT Protocol, the same protocol that powers Bluesky. We are not affiliated with or endorsed by Bluesky.
    Still have questions?
    Join our Discord community
    Open an issue on Tangled
    Send us a message on Bluesky
    Modified atĀ 2026-05-17 05:41:23
    Previous
    Quickstart
    Next
    Migrating to Rocksky Scrobble API
    Built with