2018-11-11 11:20:09 +00:00
# koel [![Build Status](https://travis-ci.org/phanan/koel.svg?branch=master)](https://travis-ci.org/phanan/koel) ![Code Quality](https://scrutinizer-ci.com/g/phanan/koel/badges/quality-score.png?b=master) [![codecov](https://codecov.io/gh/phanan/koel/branch/master/graph/badge.svg)](https://codecov.io/gh/phanan/koel) [![OpenCollective](https://opencollective.com/koel/backers/badge.svg)](#backers) [![OpenCollective](https://opencollective.com/koel/sponsors/badge.svg)](#sponsors)
2015-12-14 09:13:29 +00:00
2016-01-31 13:59:05 +00:00
![Showcase ](http://koel.phanan.net/dist/img/showcase.png?2 )
2015-12-13 02:19:46 +00:00
2016-03-20 14:37:13 +00:00
## Intro
2019-07-17 18:29:05 +00:00
**Koel** (also stylized as **koel** , with a lowercase k) is a simple web-based personal audio streaming service written in [Vue ](http://vuejs.org/ ) on the client side and [Laravel ](http://laravel.com/ ) on the server side. Targeting web developers, Koel embraces some of the more modern web technologies – CSS grid, audio, and drag-and-drop API to name a few – to do its job.
2015-12-13 02:19:46 +00:00
2016-03-20 14:37:13 +00:00
## Install and Upgrade Guide
2017-03-01 07:54:57 +00:00
For system requirements, installation/upgrade guides, troubleshooting etc., head over to the [Official Documentation ](http://koel.phanan.net/docs ).
2016-03-14 13:37:19 +00:00
2019-09-09 20:49:08 +00:00
## API Docs
If you're interested in the development of a client, Koel's offical API documentation is available [here ](https://koel.phanan.net/api-docs/ ).
2018-10-06 11:01:18 +00:00
## Contribute
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.
2019-05-21 09:52:35 +00:00
A quick and easy way to start hacking on koel is to open and run this repo in Gitpod, an online IDE with full Laravel support.
[![Open in Gitpod ](https://gitpod.io/button/open-in-gitpod.svg )](https://gitpod.io/#https://github.com/phanan/koel)
2016-06-13 09:08:12 +00:00
## Backers
2019-07-17 18:29:05 +00:00
[Support me on OpenCollective ](https://opencollective.com/koel#backer ) with a monthly donation and help me continue building Koel.
2016-06-13 09:08:12 +00:00
< a href = "https://opencollective.com/koel/backer/0/website" target = "_blank" > < img src = "https://opencollective.com/koel/backer/0/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/backer/1/website" target = "_blank" > < img src = "https://opencollective.com/koel/backer/1/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/backer/2/website" target = "_blank" > < img src = "https://opencollective.com/koel/backer/2/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/backer/3/website" target = "_blank" > < img src = "https://opencollective.com/koel/backer/3/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/backer/4/website" target = "_blank" > < img src = "https://opencollective.com/koel/backer/4/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/backer/5/website" target = "_blank" > < img src = "https://opencollective.com/koel/backer/5/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/backer/6/website" target = "_blank" > < img src = "https://opencollective.com/koel/backer/6/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/backer/7/website" target = "_blank" > < img src = "https://opencollective.com/koel/backer/7/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/backer/8/website" target = "_blank" > < img src = "https://opencollective.com/koel/backer/8/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/backer/9/website" target = "_blank" > < img src = "https://opencollective.com/koel/backer/9/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/backer/10/website" target = "_blank" > < img src = "https://opencollective.com/koel/backer/10/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/backer/11/website" target = "_blank" > < img src = "https://opencollective.com/koel/backer/11/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/backer/12/website" target = "_blank" > < img src = "https://opencollective.com/koel/backer/12/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/backer/13/website" target = "_blank" > < img src = "https://opencollective.com/koel/backer/13/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/backer/14/website" target = "_blank" > < img src = "https://opencollective.com/koel/backer/14/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/backer/15/website" target = "_blank" > < img src = "https://opencollective.com/koel/backer/15/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/backer/16/website" target = "_blank" > < img src = "https://opencollective.com/koel/backer/16/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/backer/17/website" target = "_blank" > < img src = "https://opencollective.com/koel/backer/17/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/backer/18/website" target = "_blank" > < img src = "https://opencollective.com/koel/backer/18/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/backer/19/website" target = "_blank" > < img src = "https://opencollective.com/koel/backer/19/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/backer/20/website" target = "_blank" > < img src = "https://opencollective.com/koel/backer/20/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/backer/21/website" target = "_blank" > < img src = "https://opencollective.com/koel/backer/21/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/backer/22/website" target = "_blank" > < img src = "https://opencollective.com/koel/backer/22/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/backer/23/website" target = "_blank" > < img src = "https://opencollective.com/koel/backer/23/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/backer/24/website" target = "_blank" > < img src = "https://opencollective.com/koel/backer/24/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/backer/25/website" target = "_blank" > < img src = "https://opencollective.com/koel/backer/25/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/backer/26/website" target = "_blank" > < img src = "https://opencollective.com/koel/backer/26/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/backer/27/website" target = "_blank" > < img src = "https://opencollective.com/koel/backer/27/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/backer/28/website" target = "_blank" > < img src = "https://opencollective.com/koel/backer/28/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/backer/29/website" target = "_blank" > < img src = "https://opencollective.com/koel/backer/29/avatar.svg" > < / a >
## Sponsors
2019-07-09 21:27:21 +00:00
#### GitHub Sponsors
* Eduardo San Martin Morote ([@posva](https://github.com/posva))
2019-07-17 18:24:54 +00:00
* Nina Reynolds ([@cutecycle](https://github.com/cutecycle))
2019-07-17 18:29:05 +00:00
* [You ](https://github.com/users/phanan/sponsorship )?
2019-07-09 21:27:21 +00:00
#### OpenCollective
2019-07-17 18:29:05 +00:00
[Become a sponsor on OpenCollective ](https://opencollective.com/koel#sponsor ) and get your logo on our README on Github with a link to your site.
2016-06-13 09:08:12 +00:00
< a href = "https://opencollective.com/koel/sponsor/0/website" target = "_blank" > < img src = "https://opencollective.com/koel/sponsor/0/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/sponsor/1/website" target = "_blank" > < img src = "https://opencollective.com/koel/sponsor/1/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/sponsor/2/website" target = "_blank" > < img src = "https://opencollective.com/koel/sponsor/2/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/sponsor/3/website" target = "_blank" > < img src = "https://opencollective.com/koel/sponsor/3/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/sponsor/4/website" target = "_blank" > < img src = "https://opencollective.com/koel/sponsor/4/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/sponsor/5/website" target = "_blank" > < img src = "https://opencollective.com/koel/sponsor/5/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/sponsor/6/website" target = "_blank" > < img src = "https://opencollective.com/koel/sponsor/6/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/sponsor/7/website" target = "_blank" > < img src = "https://opencollective.com/koel/sponsor/7/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/sponsor/8/website" target = "_blank" > < img src = "https://opencollective.com/koel/sponsor/8/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/sponsor/9/website" target = "_blank" > < img src = "https://opencollective.com/koel/sponsor/9/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/sponsor/10/website" target = "_blank" > < img src = "https://opencollective.com/koel/sponsor/10/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/sponsor/11/website" target = "_blank" > < img src = "https://opencollective.com/koel/sponsor/11/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/sponsor/12/website" target = "_blank" > < img src = "https://opencollective.com/koel/sponsor/12/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/sponsor/13/website" target = "_blank" > < img src = "https://opencollective.com/koel/sponsor/13/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/sponsor/14/website" target = "_blank" > < img src = "https://opencollective.com/koel/sponsor/14/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/sponsor/15/website" target = "_blank" > < img src = "https://opencollective.com/koel/sponsor/15/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/sponsor/16/website" target = "_blank" > < img src = "https://opencollective.com/koel/sponsor/16/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/sponsor/17/website" target = "_blank" > < img src = "https://opencollective.com/koel/sponsor/17/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/sponsor/18/website" target = "_blank" > < img src = "https://opencollective.com/koel/sponsor/18/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/sponsor/19/website" target = "_blank" > < img src = "https://opencollective.com/koel/sponsor/19/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/sponsor/20/website" target = "_blank" > < img src = "https://opencollective.com/koel/sponsor/20/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/sponsor/21/website" target = "_blank" > < img src = "https://opencollective.com/koel/sponsor/21/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/sponsor/22/website" target = "_blank" > < img src = "https://opencollective.com/koel/sponsor/22/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/sponsor/23/website" target = "_blank" > < img src = "https://opencollective.com/koel/sponsor/23/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/sponsor/24/website" target = "_blank" > < img src = "https://opencollective.com/koel/sponsor/24/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/sponsor/25/website" target = "_blank" > < img src = "https://opencollective.com/koel/sponsor/25/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/sponsor/26/website" target = "_blank" > < img src = "https://opencollective.com/koel/sponsor/26/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/sponsor/27/website" target = "_blank" > < img src = "https://opencollective.com/koel/sponsor/27/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/sponsor/28/website" target = "_blank" > < img src = "https://opencollective.com/koel/sponsor/28/avatar.svg" > < / a >
< a href = "https://opencollective.com/koel/sponsor/29/website" target = "_blank" > < img src = "https://opencollective.com/koel/sponsor/29/avatar.svg" > < / a >