Music streaming, rethought for the music you own.
vibemusic is a player for your Navidrome library that works the way a music app should today. It has the things people actually miss from streaming services, and leaves out what only gets in the way.
Each album colours the whole interface while it plays, and the background drifts with the music. Screens show what you came for, with no maze of options, columns or settings you'll never touch.
Your whole library lives right in the browser, so search, filters and sorting answer with every keystroke, whether you have five hundred tracks or fifty thousand. Playback is gapless, and your queue follows you between devices.
Swipe on a trackpad to bring in the queue, resize the sidebar or flick a track out of the queue. On a phone, pull down to close the player and press and hold for options. Keyboard shortcuts cover the rest.
Fresh genre mixes every week, and a "This is" playlist for each artist built from their best-known tracks. The home page suggests what to play rather than listing everything you own, and any album or playlist can be shuffled, remembered for that list alone.
Messy tags become a clear genre tree, filled in with what's known about your artists, so a "Post-Punk" mix is actually post-punk.
Start music on the living-room speakers and control it from your phone.
vibemusic is a young project. Expect breaking changes, often: settings get renamed, and an update can ask you to set things up again. Read the changes before you update.
The experience isn't polished everywhere yet either. If something feels off, confusing or slow, please say so in a GitHub issue: that kind of feedback shapes what gets worked on next.
browser ──► vibemusic ──► Navidrome (your music server)
│
└──────► relay (optional: remote control, genres and popularity,
"This is" playlists, radio, shared links)
vibemusic is a static web app with a small built-in router, so the browser only ever talks to one address. The relay is an optional companion service; without it the player works and those features are missing.
Pick the page that matches what you have:
| You have | Start here |
|---|---|
| Nothing yet, or no Navidrome | New setup with its own Navidrome |
| A Navidrome you already run | Next to your Navidrome |
| One compose file for all your services | Add to your compose file |
| A domain or reverse proxy (Caddy, nginx, Cloudflare Tunnel) | Behind your own domain |
All of them use Docker Compose, and most of the work is done by ./setup.sh.
- Features in detail: how remote play, the generated playlists, the timeline, shared links, album colours, the library in your browser and internet radio work.
- Settings: every option, from genre playlists to the defaults visitors see.
- The relay: what it does, and which outside services it asks about your music.
- Tech stack: what the app and the relay are built with.
- Development: running the app and relay from source.
vibemusic was implemented entirely by AI. Claude, Anthropic's model, working in Claude Code, wrote all of the code, the tests and these docs. The person behind the project decided what to build and how it should look and feel, made the design calls, reviewed the results and uses it every day on their own server, but didn't write the code by hand.
So read it as you would any young project: the tests and checks in Development cover a lot, not everything, and bug reports are welcome.
vibemusic is free software under the GNU Affero General Public License v3.0 or later. If you run a modified version for other people, the license asks you to offer them its source. The bundled fonts, Onest and Unbounded, are under the SIL Open Font License.