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.
I still have a good 40GB of mp3 stored in my external hard drive.
But I have a server.
So I started looking out for an open source, or at least free, music streaming server that I can make use of.
I found a few. Alas, none was good enough!
In my desperation I asked myself this zero-dollar question:
"Heck, why not build one?"
And so koel was born.

And why "koel?" Because it’s the name of a freaking bird who sings non-stop near my place. 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 5.4.

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 newest 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 https://github.com/phanan/koel

cd koel

composer install

vi .env # Fill in database info and initial admin account

php artisan koel:init

Server started on http://localhost:8000/

Afterwards, from the web interface, go to Settings and enter the path to your songs. Click “Save,” and that’s it.
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!