quintodrome/desktop

Quintodrome Desktop

A Tauri desktop wrapper that hosts Navidrome as its own web app.

On launch the app:

1. Checks whether a Navidrome server is already listening on 127.0.0.1:4533 (via its /ping health endpoint). If so, it reuses it as-is.
2. Otherwise it spawns the bundled navidrome binary as a separate sidecar process, pointed at the OS app-data/music directories, and waits for it to become ready.
3. Loads the Navidrome UI in the webview.
4. On exit, sends SIGTERM to the spawned server so it shuts down gracefully (falls back to a hard kill after 3s).

How to launch

From the repo root:

# 0. one-time: make sure Node >= 24 is active (already pinned in .nvmrc)
nodenv local 24.15.0        # or `nvm use` / ensure `node --version` is v24+

# 1. build the Navidrome server + stage it as the sidecar
./desktop/scripts/build.sh --skip-tauri

# 2. launch the app
cd desktop/src-tauri && cargo run

A window opens on the splash screen, the app starts Navidrome (or reuses a running one), then loads the UI. Navidrome is reachable at http://127.0.0.1:4533 for the first-run admin setup.

To build a standalone .app instead:

./desktop/scripts/build.sh
# → desktop/src-tauri/target/release/bundle/macos/Quintodrome.app

Layout

desktop/
├── src/                 # Splash screen shown while Navidrome boots
├── src-tauri/
│   ├── src/             # Rust: sidecar spawn, health-check, lifecycle
│   ├── binaries/        # navidrome-<target-triple> sidecar (built, not committed)
│   ├── icons/           # App icons
│   ├── tauri.conf.json
│   └── Cargo.toml
└── scripts/
    ├── build.sh         # Build navidrome + stage sidecar + tauri build
    └── gen_icon.go      # Regenerates the source icon (optional)

Prerequisites

• Rust (stable) with the aarch64-apple-darwin / x86_64-apple-darwin (or matching host) target.
• Node.js >= 24 (the repo already pins this in .nvmrc; via nodenv you can run nodenv local 24.15.0).
• Go >= 1.26 (for building the Navidrome binary).

Build

./desktop/scripts/build.sh

This builds the Navidrome server (make build), stages it under src-tauri/binaries/navidrome-<target-triple> (with the executable bit set), then runs npx tauri build. The packaged app lands in desktop/src-tauri/target/release/bundle/.

To build the sidecar without running the full Tauri bundle:

./desktop/scripts/build.sh --skip-tauri

Run (development)

# 1. build + stage the sidecar binary
./desktop/scripts/build.sh --skip-tauri

# 2. run the app
cd desktop/src-tauri && cargo run

The Rust build.rs copies the staged sidecar next to the dev binary (target/debug/navidrome) automatically, so plain cargo run works — no tauri dev CLI needed.

Configuration

Environment variables override the defaults:

Variable	Default	Purpose
QUINTODROME_HOST	127.0.0.1	Address the webview connects to
QUINTODROME_PORT	4533	Port for the Navidrome server
QUINTODROME_MUSIC_FOLDER	OS music dir (e.g. ~/Music)	Where your music lives

The data folder (DB, cache) is always the OS app-data directory (e.g. ~/Library/Application Support/com.quintodrome.desktop on macOS).

Note: if a Navidrome server is already running on the configured host/port, the app simply loads it and does not start a second instance.