koel是一款网页版的开源个人音乐流媒体播放器,前端基于vue , 后端基于laravel Framework。采用了现代Web技术,例如CSS网格、音频和拖放API等等。遵守MIT开源协议。安装PHP环境后,可采用MYSQL数据库,搭建在服务器上,也可部署到Docker上。遵守MIT开源协议。
功能特色:
支持搜索、排序,通过艺术家或专辑查看、播放列表、喜欢/不喜欢歌曲、以及创建用户用于分享歌曲等功能,此外还支持以下快捷键操作:
F:设置全局搜索框焦点
回车:播放一首歌曲,如果选中多首歌曲,回车将会将它们添加到队列底部。Shift+Enter 会将选中歌曲放到队列顶部
空格:切换播放
J:播放队列中下一首歌曲
K:播放队列中前一首歌曲
[repo owner=”phanan” name=”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 to do its job.
Install and Upgrade Guide
For system requirements, installation/upgrade guides, troubleshooting etc., head over to the Official Documentation.
Development
See the Development Guide.
Koel Player is the official mobile app for Koel, which supports both iOS and Android without the limitations of the mobile web version. For more information on the project, visit its repository.
from
---------------------------------
Installation
Building from Source
From your console, run the following commands:
cd <KOEL_ROOT_DIR>
git clone https://github.com/koel/koel.git .
git checkout latest # Check out the latest version at https://github.com/koel/koel/releases
composer install
php artisan koel:init # Populate necessary configurations during the process
php artisan serve
In both cases, you should now be able to visit http://localhost:8000
in your browser and start using Koel.
Use a proper webserver
http://localhost:8000 is only the development server for Koel (or rather, Laravel). For optimal performance, you'll want to set up the production version, the configuration of which varies depending on your webserver of choice (Apache, nginx, Caddy etc.) and is outside of this document's scope, but shouldn't be any different from that of a standard PHP application.
If you want more control, edit .env
file. There's quite a few settings there to tweak Koel to your needs.
from
https://docs.koel.dev/#building-from-source
---------------------------------------------------
Local Development
# Running the Local Webserver
Start both the PHP server and the client application in one go with yarn dev
, which uses start-server-and-test
to manage both vite
and Laravel:
$ yarn dev
vite v2.9.13 dev server running at:
> Local: http://localhost:3000/
> Network: use `--host` to expose
ready in 761ms.
Laravel v9.22.1
> APP_URL: http://localhost:8000
A development version of Koel should now be available at http://localhost:8000
with full HMR support.
from