Rocksky CLI#

🎧 The official command-line interface for Rocksky — a modern, decentralized music tracking and discovery platform built on the AT Protocol.

Features#

• 🔐 Authenticate with your Rocksky account using OAuth
• 🎵 View your currently playing track
• 📈 See your recent scrobbles
• 📤 Manually scrobble tracks
• 🛠️ Useful developer tools for integrating Rocksky into your workflows

Run in development#

To run the CLI in development mode, install the dependencies:

bun install

Then, run the CLI with:

bun run dev --help

Usage#

rocksky <command> [options]

Available Commands#

login - Initiates a browser-based OAuth login flow and saves your access token securely on your machine.

rocksky login

nowplaying - Displays the currently playing track on your/other Rocksky account.

rocksky nowplaying

scrobbles - Lists all recently scrobbled tracks.

rocksky scrobbles

search - Searches for tracks, albums, artists or Rocksky users.

rocksky search <query>

stats - Displays your Rocksky account statistics.

rocksky stats [did]

artists - Lists the user's top artists.

rocksky artists [did]

albums - Lists the user's top albums.

rocksky albums [did]

tracks - Lists the user's top tracks.

rocksky tracks [did]

scrobble - Manually scrobbles a track.

rocksky scrobble "Karma Police" "Radiohead"