A Tauri desktop player for Rocksky, built on the official Rust SDK (rocksky-sdk) and the rockbox-playback engine (Rockbox codecs + DSP: gapless, crossfade, ReplayGain, 10-band EQ).

Install #

macOS #

brew install --cask tsirysndr/tap/rocksky

The app is ad-hoc signed and not notarized — there is no Apple Developer account behind it yet, so Gatekeeper blocks the first launch with “Rocksky cannot be opened because Apple cannot check it for malicious software.”

To allow it: open Rocksky once, dismiss the dialog, then go to System Settings → Privacy & Security, scroll to the Security section, and click Open Anyway next to the Rocksky message. Confirm on the next prompt — macOS remembers the choice, so this is a one-time step per version.

Equivalently, from the terminal:

xattr -dr com.apple.quarantine /Applications/Rocksky.app

Linux #

Download the .deb, .rpm, or .AppImage from the latest desktop-v* release.

The Linux release targets x86_64 with glibc 2.35 or newer (Ubuntu 22.04 or a compatible newer distribution). The AppImage bundles FriBidi and HarfBuzz, while glibc remains supplied by the operating system. It does not support older glibc versions just because it is an AppImage.

What it does #

Remote control — registers as a remotely controllable Rocksky player (shown as “<name> (Desktop)” in the miniplayer device picker; the name is configurable in Settings). Controllers can play/pause/seek, jump the queue, and enqueue uploaded tracks, which stream through the uploads endpoint.
Media cache — remote tracks are cached on disk (same scheme as the rocksky CLI: keyed by upload id, oldest-evicted past the cap). Enable/disable, size limit, usage, and clearing are all in the Settings panel.
AppView reads — the sidebar shows the live global scrobble feed via rocksky-sdk's AppView client.

Development #

bun install        # from the repo root (workspace) or this directory
bun run tauri dev  # run the app with hot reload
bun run tauri build  # produce installers/bundles

The Rust crate lives in src-tauri/ as a standalone cargo workspace (the Tauri dependency tree conflicts with the repo root workspace's pgrx pins) and depends on crates/rocksky-sdk by path (same version as crates.io).

The frontend mirrors the web app's stack: React + TanStack react-query, jotai, Base Web (baseui + styletron), and Emotion styled components.

Releases #

.github/workflows/desktop-release.yml builds macOS (aarch64, x64) and Linux (x86_64) bundles and uploads them to a GitHub release. It runs on desktop-v* tags and can also be dispatched manually — with no tag input it derives desktop-v<version> from src-tauri/tauri.conf.json and creates the tag itself.

The frontend is built with --mode prod (.env.prod); a VITE_KLIPY_API_KEY repo secret overrides the committed KLIPY key when set. macOS bundles are ad-hoc signed (codesign --sign -) — there is no Apple Developer identity, so they are not notarized.

Before Linux bundling, scripts/prepare-appimage.sh installs Tauri's verified AppRun launcher with mode 0755 and supplies the extra AppImage libraries. The release workflow extracts the resulting image, checks permissions for other users and the glibc baseline, then requires a visible Rocksky window and at least 20 seconds of startup under Xvfb before uploading artifacts.

Remote registration #

Paste a Rocksky access token (Settings → Access tokens on rocksky.app) into the Settings panel and hit Register as remote player. The player name defaults to “Rocksky” and always registers with a “(Desktop)” suffix.