Something went wrong. Try again.
A decentralized music tracking and discovery platform built on AT Protocol 🎵 rocksky.app
spotify atproto lastfm musicbrainz scrobbling listenbrainz
Something went wrong. Try again.
1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374---title: "Overview"description: "Scrobble tracks, view stats, and manage your listening history from the terminal."icon: "terminal"---
`rocksky` is a command-line interface for the Rocksky API. Use it to scrobbleplays, inspect listening stats, manage API keys, and run the MCP / localscrobble servers.
## Install
<CodeGroup>```bash Globalnpm install -g @rocksky/cli```
```bash One-offnpx @rocksky/cli --help```</CodeGroup>
## Common workflow
```bashrocksky login alice.bsky.social # one-time authrocksky whoami # confirm sessionrocksky nowplaying # what's playing right nowrocksky scrobbles --limit 20 # your recent historyrocksky stats # listening stats```
## Commands
| Command | Description || ----------------------------------------------- | ---------------------------------------------------------- || [`login`](/cli/login) | Authenticate with your Bluesky handle || [`whoami`](/cli/whoami) | Show the currently authenticated user || [`nowplaying`](/cli/nowplaying) | Show the currently playing track || [`scrobbles`](/cli/scrobbles) | List recent scrobbles || [`scrobble`](/cli/scrobble) | Record a track to your profile || [`search`](/cli/search) | Search tracks, albums, and accounts || [`stats`](/cli/stats) | Listening stats for a user || [`artists`](/cli/artists) | Top artists for a user || [`albums`](/cli/albums) | Top albums for a user || [`tracks`](/cli/tracks) | Top tracks for a user || [`create apikey`](/cli/create-apikey) | Generate a new API key || [`import`](/cli/import) | Import history from a Spotify or Last.fm export || [`sync`](/cli/sync) | Sync local data from the AT Protocol || [`mcp`](/cli/mcp) | Start the MCP server for Claude and other LLMs || [`scrobble-api`](/cli/scrobble-api) | Run a local Last.fm / ListenBrainz-compatible server || [`mpd`](/cli/mpd) | Serve your library over the MPD protocol || [`help`](/cli/help) | Show help for any command |
## Remote control
Whenever the CLI player is running (the interactive TUI, or the[`mpd`](/cli/mpd) daemon), it connects to Rocksky over a WebSocket and appearsas a controllable device in the Rocksky web and mobile miniplayers — just likethe Rockbox companion. What you play on the CLI shows up there in real time, andplay / pause / next / previous / seek from the miniplayer drive the CLI, withelapsed time kept in sync both ways. It authenticates with the same sessiontoken from `rocksky login`, so no extra setup is needed.
The name shown in the miniplayer's source selector is configurable in`~/.rocksky/settings.toml`:
```toml[remote]name = "Living Room"```
Set `ROCKSKY_NO_REMOTE=1` to disable the connection entirely.