koel /koel

Music streaming solution that works.

★ 17,351⑂ 2,118👁 300⑃ 1,861● 1,173▤ 176
PHPMITCreated 2015-12-06koel.dev
Download: v9.15.0v9.15.0 ↓9.15.02026-09-28
+1
Daily
17,351
stars
2,118
forks
300
watchers
1,861
prs
1,173
issues
176
releases

README

koel  !Code Quality  

!Showcase

 Intro

Koel (also stylized as koel, with a lowercase k) is a free, open-source music streaming solution
that turns your personal collection into a sleek, web-based listening experience.

Built on Laravel and Vue, it scans your music library and 
serves it back through a fast, modern interface that works in any browser. Beyond playback, Koel handles 
playlists, smart playlists, scrobbling, podcasts, radio, Last.fm/Spotify/MusicBrainz integrations, and 
an AI assistant that responds to natural-language commands. 

The premium Koel Plus adds multi-user libraries, collaboration, SSO, cloud storage drivers, custom themes, 
and white-labeling for organizations that want to host their own Spotify-style experience without paying
anyone else.

 Install and Upgrade Guide

For system requirements, installation/upgrade guides, troubleshooting etc., head over to
the Official Documentation.

 Development

See the Development Guide.

 Koel Player

!Koel Player screenshots

Koel Player is the official mobile app for Koel, which supports both iOS and Android
without the limitations of the mobile web version. For more information on the project,
visit its repository.

 Sponsors and Backers




Support me on OpenCollective with a monthly donation and help me continue
building Koel.













 GitHub Sponsors

 You?

 OpenCollective

Become a sponsor on OpenCollective and get your logo on this README on Github
with a link to your site.

Top issues

Latest release

v9.15.0 v9.15.0 2026-09-28
What's Changed
 feat: tell an open tab when a newer build of Koel is live by @phanan in https://github.com/koel/koel/pull/2731
 feat: show offline storage usage with a color-graded meter by @phanan in https://github.com/koel/koel/pull/2733
 chore(deps): bump zbateson/mail-mime-parser from 4.0.1 to 4.0.5 by @dependabot[bot] in https://github.com/koel/koel/pull/2728
 fix: refuse presigned uploads bigger than the declared file size by @phanan in https://github.com/koel/koel/pull/2734
 fix: save equalizer presets only through their own endpoints by @phanan in https://github.com/koel/koel/pull

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON