@phanan phanan released this Jan 28, 2018 · 28 commits to master since this release

This is to bump the version, which I forgot to do in the previous release :(. To update:

git fetch
git checkout v3.7.2


@phanan phanan released this Jan 28, 2018 · 29 commits to master since this release

This release upgrades Koel's equalizer to work with some new implementations and deprecations of WebAudio in Google Chrome. To upgrade:

git fetch
git checkout v3.7.1
php artisan koel:init


@phanan phanan released this Dec 3, 2017 · 130 commits to master since this release

Alright folks, time for a new version! v3.7.0 comes with quite a few fixes and new features. Here they come in no particular order:


  • Album compilation status handling got a total rewrite and should work more properly now
  • A remote controller is added, so you can lie on your bed and control the Koel instance on your desktop. Note: this feature is still experimental and has several limitations.
  • Multi disc support is added (@fieteboerner). Note that you'll need to resync with php artisan koel:sync --force --tags=disc for Koel to record the disc number.
  • Support for non-root installations is added (@fieteboerner)
  • Database port can now be configured (@leowmjw)
  • The command koel:init got a massive revamp – it can now ask for database credentials, create the admin account, and set the media path. You don't have to touch .env file during installation anymore!
  • Following the change to koel:init the admin account is NOT set in .env file and created during initial database seeding anymore.
  • The command koel:sync can now set the media path, too, so you can run it right after installation without having to set a media path via the web interface (I don't know why I didn't think about this earlier)
  • Playlist content is now populated on demand i.e. data is only downloaded when the playlist is accessed. This should speed up Koel's boot time.
  • Mockery is updated to v1 (@carusogabriel)
  • A LOT of refactoring (I'm counting 20 commits with the keyword "refactor") and tests added


  1. As usual, back up everything!
  2. From the command line, run
git fetch
git checkout v3.7.0
composer install
php artisan koel:init

If things go south

  1. Restore the backup
  2. Let me know what went wrong

Remote controller

Again, this feature is still basic and experimental, with several limitations.

Koel v3.7.0 comes with a remote controller which allows you to control a desktop instance remotely via a mobile interface.

This can come in handy in several circumstances, e.g. when you leave your Koel playing at night and want to pause or turn the volume down from your comfy bed. Granted, this is not super super useful, but it works for me at least, so why not?

In order to use this feature, first sign up for a Pusher account (the free layer should be more than enough) and create a new app. Then, populate these values into your .env file:


Save the file, refresh Koel, and that's about it. Now go to http://<your-koel-host>/remote on a mobile device and start controlling Koel remotely. You may also want to add the page to home screen for faster access later.

That's it for now. See you in another update in the hopefully near future, with more exciting features!


@phanan phanan released this Apr 19, 2017 · 321 commits to master since this release

This version fixes an issue with database migration on new installations. Happy existing users don't need to upgrade, as it doesn't provide any other fixes or changes. If you insist, though:

git fetch
git checkout v3.6.2
php artisan koel:init


@phanan phanan released this Apr 15, 2017 · 325 commits to master since this release

This version fixes a bug where the covers folder is not generated, causing scanning to fail on a fresh installation. To get it:

git fetch
git checkout v3.6.1
yarn build


@phanan phanan released this Apr 2, 2017 · 328 commits to master since this release

Here it is, version 3.6.0. Let's take a look at the shiny new things:


  • Laravel (the PHP framework powering Koel's backend and API, in case you didn't know) has been upgraded to version 5.4
  • The official wiki has been moved to https://koel.phanan.net/docs. Be sure to check it out – I promise you'll love it!
  • A new "Convert and play media at 128kbps on mobile" option (unchecked by default) has been added to Profile. This instructs Koel to convert the songs into 128kbps mp3's (if ffmpeg is configured and detected) when stream on a mobile device for more optimized speed and bandwidth. IMPORTANT: This feature is experimental and may cause playback issues, in such a case you may want to keep it disabled.
  • On Android and with Chrome 57 and newer, playback can now be controlled via the notification center and lock screen, like this.
  • Next song is now preloaded much sooner instead of 10 seconds to the end of the current song.
  • You can now search specifically for song titles, albums, or artists using the in: operator, for example searching for keeper in:title will only return the song "Keeper of the Seven Keys" and not the whole album with the same name. Similarly, you have in:artist and in:album.
  • Various bug fixes and improvements.


  1. Make a backup of everything: Koel, its server, its server's server, the load balancer, the DNS zone file, the CDN settings, maybe the whole AWS even. You can never be too careful these days, hey.
  2. From the installation folder:
git fetch
git checkout v3.6.0
composer install
php artisan koel:init


  1. Restore your backup
  2. Let me know what went wrong

That's it for now!


@phanan phanan released this Feb 9, 2017 · 367 commits to master since this release

This version includes several bug fixes and an API change.

"But… but… API changes require a major version bump!" I hear you say.

Uhm… no, not this time. I'm sorry. I just don't feel like it.


  • Fixed a bug in the equalizer that'd prevent Koel from starting in certain cases (by @X-Ryl669)
  • Authentication API now returns more proper HTTP codes (by @X-Ryl669)
  • Added predis into composer.json so Laravel folks can use Redis for its session and cache drivers if they want too (by @MelonSmasher)
  • Bumped the version (by me, because I want some credits with this new version too!)

On Upgrading

As usual:

git fetch
git checkout v3.5.5
composer install
php artisan koel:init

On Downgrading

git fetch
git checkout v3.5.4
composer install
php artisan koel:init


@phanan phanan released this Jan 22, 2017 · 373 commits to master since this release

This release fixes the shuffle bug in Artist and Album views. To upgrade:

git fetch
git checkout v3.5.4
php artisan koel:init


@phanan phanan released this Jan 20, 2017 · 378 commits to master since this release

This release fixes the bug with "Edit Songs" form not opening and add a minor enhancement for track number field. To upgrade:

git fetch
git checkout v3.5.3
php artisan koel:init


@phanan phanan released this Jan 19, 2017 · 382 commits to master since this release

This release fixes the bug with YouTube/Download, and removes Sentry. To upgrade, simply

git fetch
git checkout v3.5.2
composer install
php artisan koel:init