Self‑hosted audio unit
Your music.
Your server.
Your rules.
Tunediver turns your local collection into a fast web player. No cloud. No subscription. No telemetry. Just your files, the way you filed them.
- License
- AGPL‑3.0
- Backend
- Rust / Rocket
- Store
- SQLite
- Formats
- 13
- Price
- 0.00
Function
Every part serves playback. Nothing is there to be noticed.
-
01
Local‑first & private
Files never leave your machine. No account, no telemetry, no recommendations. Audio over your own network.
-
02
Rich metadata
Reads ID3, Vorbis, MP4 and more. Embedded lyrics and cover art come straight out of the file.
-
03
Keyboard‑first search
Fuzzy find in two keystrokes. Arrows to browse, Enter to play. The whole library without a mouse.
-
04
Dark & light
Follows the system preference. Tuned for long sessions in either state.
-
05
Every format you own
MP3, M4A, FLAC, WAV, OGG, AAC, AIFF, ALAC, Opus. Range requests give instant seeking on large lossless files.
-
06
Open source
AGPL‑3.0. Read it, fork it, audit it, patch it. No pricing page and no upsell.
Comparison
Streaming is convenient until it isn't. Albums vanish, prices creep, the algorithm crowds out your taste.
| Property | Tunediver | Spotify | Apple Music |
|---|---|---|---|
| You own the files | Yes | No | No |
| Works fully offline | Always | Download only | Download only |
| No ads, no tracking | Yes | Paid tier | Paid tier |
| No subscription | Free forever | $11.99/mo | $10.99/mo |
| Open source | AGPL‑3.0 | No | No |
| Plays any audio format | FLAC, Opus, MP3… | Vorbis / AAC | AAC / ALAC |
| Albums can't be removed | Yes | No | No |
Operation
One clone, one make, one browser tab. Full procedure in the README.
-
1
Clone the repository
git clone https://github.com/ad-si/tunediver.git cd tunediver -
2
Point it at your music
cd server make start-with-path MUSIC_PATH=/path/to/your/music -
3
Open the player
open http://localhost:7313On macOS a LaunchAgent template is included so the server starts at login.
Service notes
Which platforms does it run on?
The server is a Rust binary and runs anywhere Rust builds — macOS, Linux, Windows. The web player works in any modern browser. A native Tauri desktop app is scaffolded and on the roadmap.
Which audio formats are supported?
MP3, M4A, FLAC, WAV, OGG, AAC, WMA, AIFF, ALAC, Opus, MP4, M4V and WebM. Metadata (ID3v2, Vorbis comments, MP4 atoms) plus embedded cover art and lyrics are read automatically.
How much disk space do I need?
Only what your collection already takes. Tunediver never duplicates or re-encodes — it streams the original files.
Can I share it with my household?
Yes. Anyone on the same local network can open the server address in a browser. Put a reverse proxy (Caddy, nginx, Tailscale) in front of it to reach beyond the LAN.
Does it phone home?
No. No analytics, no telemetry, no update pings. The server talks to your browser and your disk — that is all.
How do I keep the server running?
On macOS the included LaunchAgent template starts Tunediver at login and keeps it up. On Linux use systemd or the init system of your choice.
Open source, by design
Released under the AGPL‑3.0‑or‑later. Issues, pull requests and wild ideas are all welcome.