Overview

rocksky is a command-line interface for the Rocksky API. Use it to scrobble plays, inspect listening stats, manage API keys, and run the MCP / local scrobble servers.

Install

npm install -g @rocksky/cli

npx @rocksky/cli --help

Common workflow

rocksky login alice.bsky.social     # one-time auth
rocksky whoami                       # confirm session
rocksky nowplaying                   # what's playing right now
rocksky scrobbles --limit 20         # your recent history
rocksky stats                        # listening stats

Commands

Command	Description
`login`	Authenticate with your Bluesky handle
`whoami`	Show the currently authenticated user
`nowplaying`	Show the currently playing track
`scrobbles`	List recent scrobbles
`scrobble`	Record a track to your profile
`search`	Search tracks, albums, and accounts
`stats`	Listening stats for a user
`artists`	Top artists for a user
`albums`	Top albums for a user
`tracks`	Top tracks for a user
`create apikey`	Generate a new API key
`import`	Import history from a Spotify or Last.fm export
`sync`	Sync local data from the AT Protocol
`mcp`	Start the MCP server for Claude and other LLMs
`scrobble-api`	Run a local Last.fm / ListenBrainz-compatible server
`mpd`	Serve your library over the MPD protocol
`help`	Show help for any command

Remote control

Whenever the CLI player is running (the interactive TUI, or the mpd daemon), it connects to Rocksky over a WebSocket and appears as a controllable device in the Rocksky web and mobile miniplayers — just like the Rockbox companion. What you play on the CLI shows up there in real time, and play / pause / next / previous / seek from the miniplayer drive the CLI, with elapsed time kept in sync both ways. It authenticates with the same session token from rocksky login, so no extra setup is needed. The name shown in the miniplayer’s source selector is configurable in ~/.rocksky/settings.toml:

[remote]
name = "Living Room"

Set ROCKSKY_NO_REMOTE=1 to disable the connection entirely.

Getting started

Integrations

Remote players

Mirroring

Migrating

Rocksky CLI

Install

Common workflow

Commands

Remote control

​Install

​Common workflow

​Commands

​Remote control

Install

Common workflow

Commands

Remote control