qol-plugin-keyremap

macOS key remapping is automated by applying character, key, mouse, and scroll rules in real time through a CGEventTap daemon. The daemon architecture supports hot-reloading via a dedicated socket, applying configuration changes instantly without restarting.

Yes, per-app exclusions are supported for macOS input remapping rules. You can configure character, key, mouse, and scroll mappings to apply only to targeted applications while leaving others unaffected using the qol-config.toml file.

The best way to edit and test macOS key remapping configurations is using the built-in Preact-based rule editor UI. It allows you to directly edit mappings and test them alongside the daemon's hot-reload workflow for immediate feedback.

Yes, macOS input remapping requires loading a qol-config.toml file to satisfy the runtime contract. This configuration file defines the four rule kinds—character, key, mouse, and scroll—and manages the CGEventTap daemon's reload behavior.

Your macOS remapping daemon may not be applying changes if the configuration reload fails through its dedicated socket. Ensure the qol-config.toml file is valid and that the CGEventTap daemon is actively running to receive hot-reload updates.