Download Latest Version koel-v8.1.0.tar.gz (35.4 MB)
Email in envelope

Get an email when there's a new version of koel

Home / v8.0.0
Name Modified Size InfoDownloads / Week
Parent folder
koel-v8.0.0.tar.gz 2025-10-23 35.4 MB
koel-v8.0.0.zip 2025-10-23 44.0 MB
README.md 2025-10-23 5.4 kB
v8.0.0 Tchaikovsky source code.tar.gz 2025-10-23 10.8 MB
v8.0.0 Tchaikovsky source code.zip 2025-10-23 11.7 MB
Totals: 5 Items   101.9 MB 0

Welcome to Koel v8 (code named Tchaikovsky). This version brings a set of major changes, most notably:

Embeds

You can now embed songs, playlists, artists, albums… hosted by Koel. Embedding allows you to share your music with others without having to create an account for them, making it super useful for music creators.

For more information on embedding, refer to the documentation.

Custom themes

Koel Plus users can now create and use custom themes, which is simply a combination of a color pallette (foreground, background, and highlight colors), an optional background image, font family, and font size.

image

Check the documentation for more details.

White labeling

Koel Plus users (or, to be precise, admins) can now customize the branding elements of Koel i.e. name, logo, and cover image.

Command to fetch missing artist and album artworks

A new artisan command, koel:fetch-artwork has been added by popular demand. This command will attempt to fetch artist and album artworks from available sources (Spotify, Wikipedia, etc.). To "play nice" with these services, the fetching will be done at the rate of maximum 1 operation per second.

Better koel:init script

A composer koel:init command has been added, which triggers php artisan koel:init under the hood. The core difference between the two commands is that composer koel:init works at the Composer level and will install the dependencies beforehands, ensuring php artisan koel:init can run.

Laravel 12

Koel is now powered by Laravel 12. That's it, that't the memo.

As usual, a bunch of bug fixes and improvements have also been added under the hood.

Upgrade

  1. Make a backup of your database
  2. Depending on your installation method, either check out the tag by running git pull && git checkout v8.0.0 or downloading and extracting the release archive
  3. If building from source, run composer koel:init as your webserver user
  4. Enjoy!

Change List

New Contributors

Full Changelog: https://github.com/koel/koel/compare/v7.15.1...v8.0.0

Source: README.md, updated 2025-10-23