Skip to content

Remote Controller

Koel has a built-in remote controller that lets you control a desktop instance.

Configuration

In order for the remote controller to work, register for a Pusher account and create an app. Then, populate the app's credentials into .env:

PUSHER_APP_ID=
PUSHER_APP_KEY=
PUSHER_APP_SECRET=
PUSHER_APP_CLUSTER=

Finally, reload your Koel instance to apply the changes.

Usage

You can access the remote controller by visiting https://<your-koel-domain>/remote.

TIP

You can pin the remote controller to your phone's home screen for quick access.

The remote controller will scan for an active Koel instance. If found, it will connect to it and allow you to control the playback as well as like/unlike the current song and adjust the volume.

Remote controller