Host and stream your own music with ease using Koel, an open-source self-hosted music streaming server designed for personal audio libraries and audiophiles.

---

🚀 Overview

Koel is a modern, snappy web-based personal music streaming service that lets you host your entire music collection on your own server and access it from anywhere.

It solves the problem of clunky cloud music services or limited self-hosted alternatives by providing a feature-packed, performant player with lossless audio support, smart playlists, and seamless multi-device sync. It's built for music lovers who value privacy, control, and high-quality playback without subscriptions.

Created by Phan An (phanan), Koel started as a personal project and evolved into a beloved open-source tool embracing cutting-edge web tech for a Spotify-like experience at home.

---

✨ Key Features

• Transparent lossless playback, cross-device synchronization, favorites, smart playlists, multi-user support, equalizer, visualizers, radio/podcasts
• Robust media management: drag-and-drop uploads, metadata editing, integrations with MusicBrainz, Last.fm, Spotify, YouTube for art/videos
• Modern, themeable UI with blazing-fast performance for large libraries, AI assistant for natural language control, role-based permissions
• Official Koel Player mobile apps for iOS/Android with full features
• Optional Koel Plus (one-time purchase): S3/Dropbox storage, collaboration, SSO, custom themes, white-labeling

---

🛠 Tech Stack

• Frontend: Vue.js, TypeScript, Tailwind CSS, Vite
• Backend: Laravel (PHP), Composer
• Database: MySQL, SQLite
• Auth: Custom (roles & permissions)
• Hosting: Self-hosted (Docker images available)

---

👥 Who Is This For?

This project is useful for:

• Music enthusiasts managing large personal libraries
• Self-hosting fans seeking a private Spotify alternative
• Developers and tinkerers who appreciate modern open-source stacks

---

📸 Screenshots / Demo

• Live demo: No public demo (self-hosted nature)
• GitHub: https://github.com/koel/koel

---

🔥 Project Status

• 🟢 Actively building

Last updated: 2026-03-24

---

❓ FAQ

Is this project free?

Yes — Fully open-source under MIT license. Koel Plus premium features available as a one-time purchase. (Explain briefly.)

---

Is the source code available?

Yes — https://github.com/koel/koel

---

Can I contribute?

Yes — Follow the development guide at https://docs.koel.dev/development/, submit PRs/issues on GitHub, or sponsor the project.

---

📬 Contact & Links

• Website: https://koel.dev
• GitHub: https://github.com/koel/koel
• Documentation: https://docs.koel.dev

---

Built with ❤️ and kept warm on WarmIndex.