koel

a personal music streaming server

that works

The story of koel

My laptop went out of disk space – thank you, Parallels.
My phone has only 16GB of storage.
And I still have a good 40GB of mp3 stored in my external hard drive.
So I started looking out for an open source, or at least free, music streaming application that I can make use of.
I found a few. Alas, none was good enough!
In my desperation I asked myself this question:
"Heck, why not build one?"
And so koel was born.

And why "koel"?
It’s the name of a bird who sings non-stop near my place back in Singapore. He looks like this:

The technologies of koel

koel's technologies

The requirements of koel

The server part of koel requires a server (duh) that can run Laravel.

For the client part, koel does’t aim to work for everyone.

In order to do what it’s created to do and do it best, koel embraces some of the newer web technologies
– those only supported in modern browsers.

koel's supported browsers

"How to check if my browser is, uh, modern enough?" you ask.
Well, if you’re not using a modern browser, you wouldn’t be here at first place
this website doesn’t look broken to you, chances are it is.

The installation and documentation of koel

git clone --recurse-submodules https://github.com/koel/koel

cd koel

composer install

php artisan koel:init

php artisan serve

Server started on http://localhost:8000/

Demonstration purpose only. Visit documentation for detailed instructions.

For more installation guides, documentation, and troubleshooting, head over to the repo’s Documentation and Releases.
While you’re there, make sure to fork and contribute!