🎶A personal music streaming server that works.
Clone or download
Latest commit e7ad687 Nov 19, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Fix links in issue template Apr 20, 2017
app Revise the smart playlist rule Nov 18, 2018
bootstrap Upgraded to Laravel 5.4 Feb 15, 2017
config Apply fixes from StyleCI (#791) Aug 29, 2018
database Add "Smart Playlist" backend logics (#849) Nov 3, 2018
public Amend manifest with more content Dec 10, 2016
resources Sync with core Nov 19, 2018
routes Add "Recently Played" playlist (#839) Oct 20, 2018
storage Upgrade to Larave 5.5 and PHP 7 Aug 29, 2018
tests Apply fixes from StyleCI (#856) Nov 18, 2018
.editorconfig A change of heart re:indent size Jun 25, 2016
.env.example Fix the doc URL for streaming in .env.example Dec 3, 2017
.eslintignore Lint everything Nov 26, 2016
.gitattributes Big Bang Dec 13, 2015
.gitignore Add codecov Nov 11, 2018
.gitmodules Adding submodule again Feb 4, 2018
.htaccess Better .htaccess cache (fixes 706) Apr 14, 2018
.travis.yml Add badge and config codecov Nov 11, 2018
LICENSE.md The most important commit of all Dec 31, 2017
README.md Add badge and config codecov Nov 11, 2018
artisan Big Bang Dec 13, 2015
composer.json Add badge and config codecov Nov 11, 2018
composer.lock Bump symfony/dom-crawler from 3.4.17 to 3.4.18 (#851) Nov 13, 2018
index.php Applied fixes from StyleCI Dec 14, 2015
nginx.conf.example Refactor the remote controller into its own page Aug 27, 2017
nitpick.json Make Nitpick CI ignore certain paths Nov 8, 2017
package.json Add env preset Nov 19, 2018
phpunit.xml Refactor tests Aug 5, 2017
server.php Applied fixes from StyleCI Dec 14, 2015
webpack.config.js Extract core to submodule Feb 2, 2018
webpack.mix.js Use webpack codesplitting Sep 4, 2018
yarn.lock Add env preset Nov 19, 2018


koel Build Status Code Quality codecov OpenCollective OpenCollective



Koel (also stylized as koel, with a lowercase k) is a simple web-based personal audio streaming service written in Vue on the client side and Laravel on the server side. Targeting web developers, Koel embraces some of the more modern web technologies – flexbox, audio, and drag-and-drop API to name a few – to do its job.

Install and Upgrade Guide

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


All contributions, big or small, are warmheartedly welcome! Please note, however, that if you want to work on a new feature, first open an issue to make sure it's something desired – doing this will greatly save time for all of us.


Support us with a monthly donation and help us continue our activities. [Become a backer]


Become a sponsor and get your logo on our README on Github with a link to your site. [Become a sponsor]