+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
#3040[Bug]: 500 Server Error After Upgrading 9.14.1 => 9.15.06 comments · 2026-10-28#2614[FR]: Improvements regarding transcoding flexibility and performance roadmap3 comments · 2026-07-14#1765Add more than a single library3 comments · 2024-05-15#2641[Bug]: Webui on iOS doesn't play songs unless "Request Desktop Website" is checked.2 comments · 2026-08-10#2050[FR]: expand koel init to cover more configs2 comments · 2025-08-15#3099[Bug]: M4A files with embedded cover art fail to scan due to missing image_mime1 comments · 2026-11-08#2836[Bug]: Multiple sessions on different devices1 comments · 2026-10-10#1821[FR]: Sort artists' songs by most listened to1 comments · 2024-09-17
Latest release
v9.15.0 v9.15.0 2026-09-28What'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