Self‑hosted music streaming, built for huge libraries.
Server • Android Auto • Desktop
| App | What it is | Highlights |
|---|---|---|
| Melodee (server) | Industrial‑grade music server with web UI and APIs | .NET 9 + Blazor UI · OpenSubsonic‑compatible API · Docker/Podman deploy · PostgreSQL · Job engine (scheduled scans) · Inbound → Staging → Production pipeline |
| Melodee Player (Android Auto) | Native Android app for in‑car and phone playback | Jetpack Compose UI · Android Auto (Media3) with voice commands · Playlist & search · Persistent now‑playing |
| MeloAmp (desktop) | Cross‑platform Electron desktop client | React + Material UI · Theming · Queue & playlists · Equalizer · Cross‑platform packaging |
Repos: melodee · melodee-player · meloamp
Goal: get the server running, then connect a client.
- Run the Melodee server
Use Docker/Podman with the provided compose file. See the server’s Quick Start for env vars and commands:
- 👉 Server setup: https://github.com/melodee-project/melodee#quick-start
- Pick a client
- Android (with Android Auto): Install and point the app at your server URL → https://github.com/melodee-project/melodee-player
- Desktop (Linux/Windows/macOS): Build/run the Electron app → https://github.com/melodee-project/meloamp
- Open the Web UI
Once the container is up, visit the web interface (default port from your compose.env). Create the first user (auto‑admin) and start scanning your library.
Server · Melodee
- Web UI built with Blazor (Radzen components)
- APIs: OpenSubsonic‑compatible + native REST API
- Media pipeline: inbound → staging (manual edits) → production
- Jobs engine: cron‑like scheduled scans/updates
- Containers: first‑class Docker/Podman; PostgreSQL included
Android · Melodee Player
- Android Auto optimized UI with Media3 & voice commands
- Jetpack Compose + Material Design 3
- Search, playlists, persistent now‑playing bar
Desktop · MeloAmp
- Electron + React client with Material UI
- Queue management, favorites, theming, equalizer
- Cross‑platform builds (AppImage, DEB, RPM, Snap, etc.)
- Server repo: https://github.com/melodee-project/melodee
- Run locally:
dotnet run --project src/Melodee.Blazor(see repo for details) - Contributing: check the server’s Contributing Guide and open issues/PRs
- Website: https://www.melodee.org
- Server docs & Discussion: see the melodee repo
- Issues: open issues in the relevant repo
Everything in the Melodee Github Organization is released under the MIT License. See the LICENSE file in each repo.
Made with ❤️ by the Melodee community