phanan/koel
Audio streaming solution that works.
Maintainers
Requires
- php: >=8.3
- ext-exif: *
- ext-fileinfo: *
- ext-gd: *
- ext-json: *
- ext-simplexml: *
- algolia/algoliasearch-client-php: ^3.3
- daverandom/resume: ^0.0.3
- enshrined/svg-sanitize: ^0.22.0
- ezyang/htmlpurifier: ^4.18
- fakerphp/faker: ^1.24
- fileeye/mimemap: ^2.2
- guzzlehttp/guzzle: ^7.2
- http-interop/http-factory-guzzle: ^1.2
- intervention/image-laravel: ^1.5
- james-heinrich/getid3: ^1.9
- jaybizzle/crawler-detect: ^1.3
- jwilsson/spotify-web-api-php: ^5.2
- laravel/ai: ^0.7.0
- laravel/framework: ^13.0
- laravel/helpers: ^1.7
- laravel/nightwatch: ^1.13
- laravel/prompts: ^0.3.6
- laravel/sanctum: ^4.0
- laravel/scout: ^11.0
- laravel/socialite: ^5.12
- laravel/tinker: ^3.0
- laravel/ui: ^4.5
- league/flysystem-aws-s3-v3: ^3.0
- league/flysystem-sftp-v3: ^3.0
- league/flysystem-webdav: ^3.0
- meilisearch/meilisearch-php: ^0.24.0
- mlocati/ip-lib: ^1.22
- nunomaduro/collision: ^v8.8
- owen-it/laravel-auditing: ^14.0
- phanan/poddle: ^1.2.4
- predis/predis: ~1.0
- pusher/pusher-php-server: ^7.2
- robthree/twofactorauth: ^3.0
- saloonphp/laravel-plugin: ^4.0
- saloonphp/saloon: ^4.0
- spatie/flysystem-dropbox: ^3.0
- spatie/laravel-permission: ^6.21
- spatie/laravel-ray: ^1.36
- teamtnt/laravel-scout-tntsearch-driver: ^15.1.0
- tiben/crontab-manager: *
- webmozart/assert: ^1.10
Requires (Dev)
- carthage-software/mago: ^1.8.0
- larastan/larastan: ^3.7
- laravel/boost: ^2.0
- mockery/mockery: ~1.0
- opcodesio/log-viewer: ^3.19
- phlak/semver: ^5.0
- php-mock/php-mock-mockery: ^1.3
- phpunit/phpunit: ^11.0
- roave/security-advisories: dev-latest
Suggests
- ext-zip: Allow downloading multiple songs as Zip archives
Provides
None
Conflicts
None
Replaces
None
This package is auto-updated.
Last update: 2026-06-16 22:19:12 UTC
README
Intro
Koel (also stylized as koel, with a lowercase k) is a free, open-source music streaming solution that turns your personal collection into a sleek, web-based listening experience.
Built on Laravel and Vue, it scans your music library and serves it back through a fast, modern interface that works in any browser. Beyond playback, Koel handles playlists, smart playlists, scrobbling, podcasts, radio, Last.fm/Spotify/MusicBrainz integrations, and an AI assistant that responds to natural-language commands.
The premium Koel Plus adds multi-user libraries, collaboration, SSO, cloud storage drivers, custom themes, and white-labeling for organizations that want to host their own Spotify-style experience without paying anyone else.
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
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.
Sponsors and Backers
👁 What The Diff — AI assistant for your pull requests
👁 DigitalOcean
👁 Understand and fix bugs faster using Ray
👁 CodeSpect - AI Code Review Tool
Support me on OpenCollective with a monthly donation and help me continue building Koel.
👁 Image
👁 Image
👁 Image
👁 Image
👁 Image
👁 Image
👁 Image
👁 Image
👁 Image
👁 Image
👁 Image
GitHub Sponsors
- You?
OpenCollective
Become a sponsor on OpenCollective and get your logo on this README on Github with a link to your site.
👁 Image
👁 Image
👁 Image
👁 Image
👁 Image
👁 Image
👁 Image
👁 Image
👁 Image
👁 Image
👁 Image