keymapper

Spec sheet

Purpose

Keymapper is a cross-platform, context-aware key remapper.Read 12 Oct 2026 · github.com

Automation

Mappings can launch terminal commands, and the separate keymapperctl utility can control a running keymapper process from external applications.Read 12 Oct 2026 · github.com

Commands

Shortcuts can launch terminal commands, and the companion keymapperctl can control the running process from external applications.Read 12 Oct 2026 · github.com

Configuration

Keyboard shortcuts can be managed in a single configuration file and shared across systems.Read 12 Oct 2026 · github.com

Context filters

Mappings can be restricted by system, focused window title or class, process path, input device, or modifier state.Read 12 Oct 2026 · github.com

Device-filter limitation

On Windows, device context filters require a virtual device driver; the README warns that the described freely available Interception driver has a disconnection bug.Read 12 Oct 2026 · github.com

Input and output

Mappings support key sequences, simultaneous keys, held modifiers, typed characters, timeouts, virtual keys, and mouse buttons or wheel events.Read 12 Oct 2026 · github.com

Installation options

The README describes release packages for Linux and installer or portable builds for Windows, plus Homebrew installation instructions for macOS.Read 12 Oct 2026 · github.com

Key and mouse mappings

Mappings can use keys, typed characters, mouse buttons, and wheel events as input or output.Read 12 Oct 2026 · github.com

License and warranty

The software is released under GNU GPLv3 and comes with no warranty.Read 12 Oct 2026 · github.com

Limitations

Window title context is unavailable on macOS; process path may be unavailable on Wayland and for elevated processes; Windows device filters require a virtual device driver.Read 12 Oct 2026 · github.com

Linux support

Linux instructions cover prebuilt packages, Arch Linux packages, X11, Wayland, and compositor-specific context awareness.Read 12 Oct 2026 · github.com

macOS dependency

The macOS build depends on Karabiner-Element’s virtual device driver.Read 12 Oct 2026 · github.com

macOS requirement

The macOS build depends on Karabiner-Elements' virtual device driver or the standalone Karabiner DriverKit VirtualHIDDevice.Read 12 Oct 2026 · github.com

Macro support

YesRead 22 Sep 2026 · github.com

Per-app profiles

YesRead 22 Sep 2026 · github.com

Remapping

It can redefine keyboard layouts and shortcuts systemwide or per application.Read 12 Oct 2026 · github.com

Security design

The project says communication between its privileged device service and the user-facing process is kept minimal for security and efficiency.Read 12 Oct 2026 · github.com

Shared configuration

Keyboard shortcuts can be managed in one configuration file and shared across GNU/Linux, Windows, MacOS, and FreeBSD systems.Read 12 Oct 2026 · github.com

Supported operating systems

cross-platformRead 22 Sep 2026 · github.com

Systemwide remapping

It can redefine keyboard layouts and shortcuts systemwide or per application.Read 12 Oct 2026 · github.com

Wayland integration

For Wayland context awareness, the compositor must provide focused-window information; the project provides a GNOME Shell extension and a KWin script, while wlroots-based compositors work out of the box.Read 12 Oct 2026 · github.com

Windows limitation

Without elevated privileges, the Windows key may not map reliably and administrator-run applications may resist mappings.Read 12 Oct 2026 · github.com

Windows support

Windows offers installer and portable builds, with winget and Chocolatey installation instructions.Read 12 Oct 2026 · github.com

Plans and prices

Every keymapper plan and price →

Where Specifiction places it

• Keyboard and Mouse Customization Software#17 of 1058.5