Search, Filter & Select
Search across tracks, artists, and albums. Range selection with Shift, multi-select with Ctrl / ⌘, and quick context actions.
SELF-HOSTED MUSIC STREAMING · OPEN SOURCENo ads. No telemetry. Your files.
Your music.
Your rules.
Transform your audio collection into a fast, private streaming service
you truly own.
Lightweight web player, time-synced lyrics, clean queue management, and OpenSubsonic API compatibility on your own server.
personal music serverTUNECLOUD / WEB PLAYER
Interactive web player interface
Your entire collection in one clean interface.Albums, artists, and favorites cleanly organized without cluttered folders.
ORIGINAL AUDIO BITSTREAM
FLACMP3OGGOPUSM4AWAV
+ Subsonic-compatible apps 01 — WHY TUNECLOUD
Your library.
Built to last.
Stop relying on commercial streaming services that remove albums without notice. TuneCloud turns your local files into a modern streaming experience.
Data Stays on Your Hardware
Audio files live on your own storage. TuneCloud indexes metadata and delivers fast playback without altering your directory structure.
Precision Playback Controls
Build queues, batch-select tracks with Shift/Ctrl, edit tags, and manage playlists. Everything is responsive and right where you expect.
100% Free & Open Source
Clean codebase, containerized Docker deployments, and GitOps configurations. Inspect, audit, and modify any component.
02 — TIME-SYNCED LYRICS
Don't just listen.
Follow every line.
Real-time synchronized scrolling lyrics with active line focus and direct seek to any verse with a single click.
UI RECORDING
«Выдох» · OG Buda, 163ONMYNECK, YanixCAPTURED IN TUNECLOUD
Embedded & local .lrc lyrics lrc.red & LRCLIB providers Seek by line click Cover-matched ambient colors
03 — QUEUE & PLAYBACK
Clean queue.
Zero clutter.
Queue tracks next, drag items to reorder, or clear the list with one click. The queue adapts to your flow, not the other way around.
- Drag & drop reordering and keyboard navigation
- Double-click to play, right-click menu, quick artist jump
- Save current active queue into a playlist
Ctrl+ShiftFewer clicks. More music.
04 — CAPABILITIES
Everything you need.
Nothing in your way.
Your Listening History
Favorites, custom playlists, and full listening history — even if one track was on repeat all evening.
Smart Library Rescan
New and updated files sync smoothly. Artwork refreshes and moved tracks maintain their playlist relations.
Bit-Perfect Sound
Direct streaming of source audio files. Native support for FLAC, MP3, OGG, Opus, M4A, and WAV.
Thoughtful Controls
Sleep timer, queue state recovery, playback position resume, shuffle, and repeat modes.
Multi-User Support
Separate accounts with independent favorites and history. Administrator role for library scans and tag edits.
05 — BEYOND THE DESKTOP
The same vibe.
On any screen.
A responsive mobile web player with full artwork, synchronized lyrics, and smooth touch controls. Prefer a native mobile app? Connect your favorite Subsonic client.
Single server address and account credentials. Feature support may vary by client.
06 — INFRASTRUCTURE & GITOPS
Engineered for
real-world self-hosting.
TuneCloud is built with production-grade DevOps practices: automated CI/CD pipelines, containerization, GitOps workflows, and full observability.
01
GitHub Actions
Checks & automated builds
02
Docker + GHCR
App container images
03
Kubernetes
k3s, Helm, Argo CD
04
Observability
Prometheus + Grafana
07 — QUICKSTART SETUP
Your server.
Up in minutes.
All you need is Docker Compose and your music directory. Fully open source — host at home on a NAS or on any cloud VPS.
QUICKSTART
01 / GET THE SOURCE CODE
Complete documentation & configuration guide git clone https://github.com/skippingclass/TuneCloud.git
cd TuneCloud
cp .env.example .envFREQUENTLY ASKED QUESTIONS
Questions & Answers.
Is this a music service with a pre-loaded catalog?
TuneCloud is designed for your own audio files. It indexes your collection on your server and turns it into a fast, private streaming web app and Subsonic API endpoint. A pre-loaded commercial catalog is not included.
Is Kubernetes required to get started?
No. Docker Compose is all you need for home servers, NAS, or simple VPS hosting. Kubernetes, Helm, and Argo CD are optional components for those interested in cluster GitOps.
What about audio streaming quality?
TuneCloud streams your original audio files bit-for-bit with HTTP Range support for instant seeking. There is no lossy server transcoding, so playback quality is identical to your source files.
Where do lyrics come from?
From local .lrc files alongside your tracks, embedded audio tags, and external lyric APIs like lrc.red and LRCLIB. Synchronized lyrics include active verse highlighting and seek-on-click.
Can I customize or contribute to the project?
Yes. Source code for both frontend and backend is publicly available on GitHub. You can inspect the code, suggest improvements, or build your own custom setup under the project license.
Take control of
your music library.
Self-host TuneCloud in minutes and stream your collection on your terms.