Skip to main content
Start an MPD-protocol server backed by your Rocksky library. Any MPD client — ncmpcpp, mpc, Cantata, mobile MPD apps — can then browse your music and control playback, with Rocksky handling the streaming and scrobbling behind the scenes.

​
Usage

​
Requirements

Playback needs an authenticated session. Log in once first:
The server still starts if you are not logged in — it just prints a note and serves an empty library until you authenticate. Unlike import and scrobble-api, mpd uses your saved login session, not ROCKSKY_IDENTIFIER / ROCKSKY_PASSWORD.

​
Options

Port and bind default to the [mpd] section of ~/.rocksky/settings.toml; the flags override those values. If the chosen port is busy, the server automatically falls back to the next free one.

​
Examples

Point a client at the server and browse your library:

​
Configuration

Persist your preferred port and bind address in ~/.rocksky/settings.toml:
Prefer a built-in interface? Run rocksky with no arguments to launch the interactive terminal UI, which browses your scrobbles and streams your music without a separate MPD client.