Your music, your server, beautifully played.
An app for Android, a player for the browser (on iPhone too), and Musonic Server to host your library yourself. Also works with Navidrome and any Subsonic-compatible server.
- What's inside
- Install
- Connect your server
- Privacy
- Screenshots
- Repository layout
- Development
- Releases and CI
- Known limitations
- Contributing · License
A calm, fast music app: full-screen player with synced lyrics, a queue you can reorder, Shuffle Magic, Magic Mixes by genre, a home built from what you play, offline downloads (Wi-Fi first), separate streaming quality on Wi-Fi and mobile data, Android Auto (beta), English and French.
→ apps/mobile · changelog
The complete Musonic in a desktop browser: home, search, library, synced lyrics, full-screen player, floating mini player, keyboard and media keys. Import a Spotify or Deezer playlist from its address (with Musonic Server). Use it online, nothing to install, or host it yourself.
→ apps/web · changelog
One server for your music: scans your folders, serves the Musonic apps and any Subsonic client, adds an online catalogue next to your library (like or add an online song to a playlist, it is imported as a file), imports playlists from Spotify and Deezer, keeps every device of an account in sync in real time, backs itself up every day. Written in Rust: fast, and light on memory.
→ apps/server · changelog
Served by Musonic Server at its own address: accounts by invitation link (the administrator never sees a password), rights and quotas, live dashboard and data usage, imports and providers, library checks (missing files, duplicates), devices and security, settings, backups, logs and an activity journal.
→ apps/admin
| What | How |
|---|---|
| Android 7.0+ | Download Musonic.apk and open it. The app tells you when a new version is out. |
| iPhone and iPad | Use the web player and add it to the Home Screen: see Use Musonic on iPhone. There is no iOS app any more (last IPA: mobile 2.4.0). |
| Web | Online at musonic.doodz.dev/app, or self-hosted: Musonic-Web.zip from the latest web-v release, see SELF-HOSTING.md. Musonic Server can also install it for you at /app. |
| Server | Docker or a single binary: see Musonic Server, build and run. Coming from Navidrome? Your playlists, likes and plays come along. |
No Musonic account, no cloud, no API key: the apps only talk to your own server, plus a few public services described in Privacy.
On first launch, enter your server's address, username and password. Musonic tells you clearly what went wrong (wrong password, server not found, not a music server…), and more accounts can be added later from your profile.
| Server | What you get |
|---|---|
| Musonic Server (recommended) | Everything: online catalogue, imports, playlist imports, real-time sync between devices. |
| Navidrome or another Subsonic server | Your library, playlists, likes, lyrics and recommendations. |
- Your server address and password stay on your devices and are only sent to your own server. Use an
https://address so they are encrypted on the way. - For artist photos, recommendations and lyrics, the apps send artist and track names only to the public Deezer API and LRCLIB. No account, no identifier, no listening history.
- No analytics, no crash reporting, no ads. The only other request is a check of this repository's releases for updates.
| Home | Player | Synced lyrics |
|---|---|---|
| Search | Library | Magic Mix |
|---|---|---|
More on the website.
One repository for every part of Musonic:
apps/
├── mobile/ React Native app (Android)
├── web/ Web client (Vite + React)
├── server/ Musonic Server (Rust)
└── admin/ Administration console, served by the server (Vite + React)
packages/
├── core/ Shared TypeScript: Subsonic client, playback engine, home feed, server types
└── icons/ One icon set for every app, generated from the mobile one
docs/ The website (GitHub Pages), not the web client
| Part | Requirements | Start | Checks |
|---|---|---|---|
Mobile (apps/mobile) |
Node 22.13+, JDK 17 and 21, Android SDK 36 / NDK 27.1 | npm ci, npm start, adb reverse tcp:8081 tcp:8081, npm run android |
npx tsc --noEmit, npx eslint . --max-warnings 0, npm test |
| Web, console, core (repository root) | Node 24 (.nvmrc) |
npm ci, npm run web (http://localhost:5173) |
npm run test:core, npm run lint and npm run build in each app |
Server (apps/server) |
Rust (stable) | cargo run (see its README) |
cargo test, cargo clippy --all-targets -- -D warnings, cargo fmt --check |
Each app is released on its own, from main:
| Tag | Release |
|---|---|
mobile-vX.Y.Z |
Musonic Mobile: signed APK (android-release.yml; releases up to 2.4.0 also have an unsigned IPA) |
web-vX.Y.Z |
Musonic Web: Musonic-Web.zip to self-host, Musonic-Web-app.zip for Musonic Server (web-release.yml); the online version is published by pages.yml on every push |
The in-app update prompt only looks at its own app's tags. Every push and pull request runs the checks of the parts it touches: ci.yml (mobile and core), ci-web.yml (web, console and core), server-ci.yml (server).
| Topic | Status |
|---|---|
| iPhone | No app: the web player, which is not yet laid out for phone screens (coming). |
| Android Auto | Beta: playlists, playback, Shuffle / Repeat / Like. Not on the Play Store, so turn on Unknown sources in Android Auto's developer settings. |
| Web client | Chromium browsers recommended (the floating mini player needs them). The online version reaches servers that allow CORS over HTTPS. |
| Playlist imports | Spotify playlists are read up to their first 100 songs; the rest is added with a second playlist. About 9 classical pieces in 10 are found (details). |
Bug reports and ideas are welcome: open an issue. For code, read CONTRIBUTING.md first: branches, commit style and checks.
- Apps, web client, console and shared packages: CC BY-NC 4.0.
- Musonic Server: PolyForm Noncommercial 1.0.0.
Free to use and adapt for personal, non-commercial purposes. Commercial use is prohibited.
DoodzDev: designed, built, and shipped from scratch.
Built with passion. Debugged with patience. Shipped with pride.