# koel [![GitHub Actions](https://github.com/koel/koel/workflows/main/badge.svg)](https://github.com/koel/koel/actions) ![Code Quality](https://scrutinizer-ci.com/g/phanan/koel/badges/quality-score.png?b=master) [![codecov](https://codecov.io/gh/koel/koel/branch/master/graph/badge.svg)](https://codecov.io/gh/koel/koel) [![OpenCollective](https://opencollective.com/koel/backers/badge.svg)](#backers) [![OpenCollective](https://opencollective.com/koel/sponsors/badge.svg)](#sponsors) ![Showcase](https://koel.dev/img/showcase.png) ## Intro **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. ## Install and Upgrade Guide For system requirements, installation/upgrade guides, troubleshooting etc., head over to the [Official Documentation](https://docs.koel.dev). ## API Docs If you're interested in the development of a client, Koel's offical API documentation is available [here](https://api-docs.koel.dev). ## Contribute All contributions, big or small, are warm-heartedly 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. 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/koel/koel) ## Backers [Support me on OpenCollective](https://opencollective.com/koel#backer) with a monthly donation and help me continue building Koel. ## Sponsors #### GitHub Sponsors * Eduardo San Martin Morote ([@posva](https://github.com/posva)) * Nina Reynolds ([@cutecycle](https://github.com/cutecycle)) * [You](https://github.com/users/phanan/sponsorship)? #### OpenCollective [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.