koel 
Intro
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 – 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.
Development
Since Koel makes use of git submodules, you'll want to make sure the submodule is up-to-date:
git pull
git submodule update --init --recursive --remote
# install the submodule dependencies
cd resources/assets
yarn install
To start the PHP dev server, which serves as the API of the application, run the following command from the root directory. By default, the server will listen at port 8000.
php artisan serve
For the client application itself, run this command:
yarn hot
A development version of Koel should now be available at http://localhost:8080 with full support for hot module reloading.
Alternatively, you can start both the PHP server and the client application in one go with yarn dev, which uses start-server-and-test under the hood.
Testing, Linting, Static Analysis and Stuff
# PHP-related code quality tasks
# Basically, take a look at the "scripts" section in composer.json
composer test # Run the PHP test suite
composer cs # Run code style checker
composer cs:fix # Run code style fixer
composer analyze # Run PHP static analysis
yarn build # Build a production version of the client application
# Client/E2E code quality tasks
# You may want to run `yarn build` first.
yarn test:e2e # Run the Cypress test suite interactively
yarn test:e2e:ci # Run the Cypress test suite non-interactively (CI mode)
# These commands need to be run from within the submodule (resources/assets)
yarn lint # Lint
yarn type-check # TypeScript type checking
yarn test # Unit testing
Note: If you're already running
yarn test:e2e, there's no need to start a dev server.yarn test:e2ecallsyarn devinternally and will eliminate the existingyarn devprocess, if any.
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.
Backers
Support me on OpenCollective with a monthly donation and help me continue building Koel.
Sponsors
GitHub Sponsors
OpenCollective
Become a sponsor on OpenCollective and get your logo on our README on Github with a link to your site.
1 Oct 14, 2021
![#[A]ref](https://avatars.githubusercontent.com/u/93086624?v=4&s=60)
1 Jul 21, 2022
1 Dec 8, 2021
392 Dec 31, 2022
2 Apr 3, 2022
1.6k Jan 4, 2023
3 Dec 15, 2022
10 Oct 9, 2022
201 Nov 24, 2022
118 Dec 14, 2022
53 Sep 3, 2022
11 May 10, 2022
21 Nov 19, 2021
4 Dec 20, 2022
9 Dec 17, 2021
1 Dec 3, 2021
2 Dec 17, 2022
687 Jan 4, 2023
53 Dec 26, 2022
14.3k Jan 8, 2023
3.2k Jan 5, 2023
2 Jun 18, 2022
640 Dec 29, 2022
31.1k Jan 8, 2023
1 Jul 6, 2022
11 May 22, 2022