+
-# Navidrome Music Server [](https://twitter.com/intent/tweet?text=Tired%20of%20paying%20for%20music%20subscriptions%2C%20and%20not%20finding%20what%20you%20really%20like%3F%20Roll%20your%20own%20streaming%20service%21&url=https://navidrome.org&via=navidrome)
+# Quintodrome
-[](https://github.com/navidrome/navidrome/releases)
-[](https://nightly.link/navidrome/navidrome/workflows/pipeline/master)
-[](https://github.com/navidrome/navidrome/releases/latest)
-[](https://hub.docker.com/r/deluan/navidrome)
-[](https://discord.gg/xh7j7yF)
-[](https://www.reddit.com/r/navidrome/)
-[](CODE_OF_CONDUCT.md)
-[](https://gurubase.io/g/navidrome)
+A [Tauri](https://tauri.app) desktop app that wraps
+[Navidrome](https://www.navidrome.org) — your self-hosted music server — into a
+native macOS/Windows application.
-Navidrome is an open source web-based music collection server and streamer. It gives you freedom to listen to your
-music collection from any browser or mobile device. It's like your personal Spotify!
+The server is bundled as a sidecar binary and managed automatically, so there's
+nothing to install, configure, or keep running: launch the app and it starts
+(and later shuts down) its own Navidrome instance for you.
+> This repository is a fork of [Navidrome](https://github.com/navidrome/navidrome).
+> Everything outside `desktop/` is the upstream server + web UI; `desktop/` is
+> the Quintodrome wrapper around it.
-**Note**: The `master` branch may be in an unstable or even broken state during development.
-Please use [releases](https://github.com/navidrome/navidrome/releases) instead of
-the `master` branch in order to get a stable set of binaries.
+## What it does
-## [Check out our Live Demo!](https://www.navidrome.org/demo/)
+On launch the app:
-__Any feedback is welcome!__ If you need/want a new feature, find a bug or think of any way to improve Navidrome,
-please file a [GitHub issue](https://github.com/navidrome/navidrome/issues) or join the discussion in our
-[Subreddit](https://www.reddit.com/r/navidrome/). If you want to contribute to the project in any other way
-([ui/backend dev](https://www.navidrome.org/docs/developers/),
-[translations](https://www.navidrome.org/docs/developers/translations/),
-[themes](https://www.navidrome.org/docs/developers/creating-themes)), please join the chat in our
-[Discord server](https://discord.gg/xh7j7yF).
+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 content webview, below a thin toolbar with
+ back/forward/reload buttons and an address bar.
+4. On exit, sends `SIGTERM` to the spawned server so it shuts down gracefully
+ (falls back to a hard kill after 3s).
-## Installation
+Batteries included:
-See instructions on the [project's website](https://www.navidrome.org/docs/installation/)
+- **Auto-provisioning** — on a fresh install the app creates the initial admin
+ user (`admin` / `admin`) and logs in as it automatically, skipping both the
+ "create an admin user" and login screens.
+- **Opted-out telemetry** — Navidrome's insights collector is disabled by
+ default.
+- **Masked address bar** — the internal `127.0.0.1:4533` origin is shown as
+ `http://quintodrome`.
+- **External links** (Last.fm, artist pages, …) open in your default browser.
+- **Native editing shortcuts** — Cmd+X/C/V/A/Z work in the web UI.
+- **Swipe navigation** — two-finger swipe back/forward on macOS.
-## Cloud Hosting
+## Quick start
-[PikaPods](https://www.pikapods.com) has partnered with us to offer you an
-[officially supported, cloud-hosted solution](https://www.navidrome.org/docs/installation/managed/#pikapods).
-A share of the revenue helps fund the development of Navidrome at no additional cost for you.
+```sh
+# one-time: Node >= 24 (see .nvmrc), Go >= 1.26, Rust
+just run
+```
-[](https://www.pikapods.com/pods?run=navidrome)
+`just run` builds the Navidrome sidecar and launches the app. No `just`? See
+the [desktop README](desktop/README.md) for the plain commands, or install it
+with `brew install just`.
-## Features
-
- - Handles very **large music collections**
- - Streams virtually **any audio format** available
- - Reads and uses all your beautifully curated **metadata**
- - Great support for **compilations** (Various Artists albums) and **box sets** (multi-disc albums)
- - **Multi-user**, each user has their own play counts, playlists, favourites, etc...
- - Very **low resource usage**
- - **Multi-platform**, runs on macOS, Linux and Windows. **Docker** images are also provided
- - Ready to use binaries for all major platforms, including **Raspberry Pi**
- - Automatically **monitors your library** for changes, importing new files and reloading new metadata
- - **Themeable**, modern and responsive **Web interface** based on [Material UI](https://material-ui.com)
- - **Compatible** with all Subsonic/Madsonic/Airsonic [clients](https://www.navidrome.org/docs/overview/#apps)
- - **Transcoding** on the fly. Can be set per user/player. **Opus encoding is supported**
- - Translated to **various languages**
+To wipe Navidrome's persistent state (database, cache) and start fresh:
-## Translations
+```sh
+just clean-state
+```
-Navidrome uses [POEditor](https://poeditor.com/) for translations, and we are always looking
-for [more contributors](https://www.navidrome.org/docs/developers/translations/)
+## Building a distributable
-
-
- 
- 
- 
- 
-