Music Hub Documentation

Music Hub is a local-first music system built around one desktop hub and one companion phone app.

Today, the public product is:

What Music Hub Does

Music Hub adds a streaming layer over the library you already maintain.

That means:

Desktop hub: current access is handled from music-hub.gordo.design (opens in a new tab)
iPhone companion: currently distributed through TestFlight
Windows / Linux desktop hub: source-build territory for now
Android companion: not publicly distributed yet

Music Hub supports zero-cost local usage, but it is not open source right now as a shipped product.

Your files stay yours — there is no subscription to a third-party music catalog.
Zero-cost local mode: hub + same Wi‑Fi playback is available without a paid remote license (good for setup and testing the companion on your LAN).
Remote streaming (phone away from home / off the hub’s usual LAN) is gated by a paid desktop license on the hub, sold through the landing site (opens in a new tab).
The shipped Mac and iPhone apps are proprietary; they are not licensed as OSS you can repackage or resell. Technical docs and some repository layout may be public for transparency and builds — that does not change the app license.

For the exact legal wording, use the product site: Terms of Service (opens in a new tab).

Getting Started — the current public onboarding path
Features — what each surface does today
Pairing & Remote — how Wi-Fi, Tailscale, public remote, and licensing fit together
FAQ — current public questions and constraints
Architecture — how the four project surfaces relate
Building — source build and release commands
Troubleshooting — common failure modes
API Reference — desktop hub API surface