Troubleshooting
The status area at the bottom of the KeyLayers window says what KeyLayers is doing. Here is what each message means and what to do.
Remapping active
Everything works. Nothing to do.


Remapper not running
The helper is approved but isn't running, for example because you quit it from its menu. Click Start Helper. It also starts at your next login.


Remapper not running: the helper isn't enabled
KeyLayers hasn't asked macOS to run the helper yet, or the request was undone. Click Enable Helper, then follow Login Items.
Remapper not running: the helper needs approval in System Settings
macOS is waiting for your approval. Click Open Login Items… and turn on KeyLayers, as in Login Items.


Remapper not running: the helper is missing from the app
The app is incomplete. Download it again and replace the copy in Applications.
Remapper waiting: approve “KeyLayers” in Login Items
The helper runs, but the input service still waits for approval. Click Open Login Items… and check that KeyLayers' switch is on.


Remapper waiting for permissions
The helper doesn't have Accessibility. Click Open System Settings… next to Accessibility and turn on KeyLayersHelper, as in Accessibility. If KeyLayersHelper is on and the message stays, turn it off and on again.


Remapper waiting: the input service needs Input Monitoring
Add the input service to Input Monitoring by hand, as in Input Monitoring. Show in Finder shows the file you need.


Input service not connected
The helper runs but can't reach the input service. Right after setup or an update, wait about 10 seconds. If it stays, check KeyLayers' switch in Login Items; if the status area offers Enable Input Service, click it.
Remapping paused
You (or the emergency stop) paused remapping. Click Resume Remapping. See Pause and emergency stop.


“The configuration file is damaged and can't be read.”
KeyLayers can't read your keymaps. The helper keeps running with what it last had. Recreate your keymaps in the app, or bring back an exported copy with File → Import Configuration….
A macOS Modifier Keys remap doesn't work
macOS' per-keyboard Modifier Keys settings don't apply while KeyLayers remaps that keyboard. Set those remaps in your keymap instead.