phanan/koel

Audio streaming solution that works.

v9.7.1 2026-06-04 15:18 UTC

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
• 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

MIT

• stream
• audio
• mp3

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

Support me on OpenCollective with a monthly donation and help me continue building Koel.

GitHub Sponsors

• You?

OpenCollective

Become a sponsor on OpenCollective and get your logo on this README on Github with a link to your site.