Freedom251 › Keyboard and Mouse Customization Software
xremap

What xremap is
xremap is a free, open-source Linux key remapper under the MIT License. It can change individual keys, combinations, and sequences, with rules filtered by application, window title, input device, or mode. Tap-and-hold behavior lets one key produce different outputs when pressed or held. Mappings can trigger commands on key press or release, while the --allow-launch option controls program launching. The --watch option detects newly connected devices and reloads configuration files; --validate-config checks configuration without starting xremap or touching devices. Desktop options listed by the project include X11, GNOME, Hyprland, KDE, wlroots, Niri, COSMIC, Pantheon, and socket. Linux binaries cover multiple architectures and desktop variants, with community packages for several distributions. Configuration is JSON-compatible and can be generated with Ruby or Python. Emacs-like mappings, including mark mode, are supported. Mouse listening is optional, but trackpads, tablets, and other absolute-input devices are unsupported. Debug logging prints keyboard strokes.
Who it suits
xremap suits Linux users who need programmable keyboard mappings across devices, modes, or applications. It is useful for people working with supported X11 or Wayland desktops and JSON-compatible configuration.
What it does well
- Free MIT-licensed software
- Supports key combinations and sequences
- Tap-and-hold mappings
- Device and application filters
- Validates configuration without starting
What to know first
- Linux only
- Application remapping unavailable on GNOME Wayland and KDE Wayland
- Absolute input devices unsupported
- Debug logging exposes keystrokes
Plans
| Plan | Billed and limits | Price |
|---|---|---|
| xremap | Open-source key remapper for Linux; MIT licensed | Free |
As github.com lists them, read 12 Oct 2026. The maker's own page has the final word.
Verdict
xremap offers detailed keyboard remapping for Linux, including device rules, tap-and-hold behavior, and command triggers. Check desktop compatibility and avoid debug logging during normal use, especially when handling sensitive keystrokes.
Facts from xremap's own pages
- Application rules
- Mappings can be filtered by application, although application-specific remapping is unavailable on GNOME Wayland and KDE Wayland. · github.com, 12 Oct 2026
- Automatic handling
- The --watch option can detect newly connected devices and reload configuration files. · github.com, 11 Oct 2026
- Command execution
- Key mappings can launch programs, and the command line provides an --allow-launch option to control this behavior. · github.com, 11 Oct 2026
- Commands
- Mappings can trigger commands on key press or release events. · github.com, 12 Oct 2026
- Compatibility limit
- The README says application-specific remapping does not work on GNOME Wayland or KDE Wayland through the listed window listing method. · github.com, 11 Oct 2026
- Configuration
- Configuration is JSON-compatible and can be generated from languages such as Ruby or Python. · github.com, 12 Oct 2026
- Configuration check
- The --validate-config option checks configuration files without starting xremap or touching devices. · github.com, 11 Oct 2026
- Context filters
- Remappings can be limited by application, window title, input device, or mode. · github.com, 11 Oct 2026
- Desktop support
- The full variant includes support for all desktops and window managers, while specific variants can support one each. · github.com, 12 Oct 2026
- Device rules
- Mappings can target input devices, and the --watch option can automatically add newly connected devices. · github.com, 12 Oct 2026
- Download
- The README links to Linux release downloads and says the binary generally has no extra requirements. · github.com, 12 Oct 2026
- Downloads
- The release page provides Linux binaries for multiple architectures and desktop variants. · github.com, 11 Oct 2026
- Emacs support
- The project supports Emacs-like key remapping, including mark mode. · github.com, 12 Oct 2026
- Free plan
- Yes · github.com, 22 Sept 2026
- Hold behavior
- A key can map to different keys depending on whether it is pressed alone or held. · github.com, 12 Oct 2026
- Input limits
- Mouse listening is optional, but trackpads, tablets, and other absolute input devices are not supported. · github.com, 12 Oct 2026
- Key mappings
- It can remap individual keys, key combinations, and sequences of key combinations. · github.com, 12 Oct 2026
- License
- The project is open source under the MIT License. · github.com, 12 Oct 2026
- Macro support
- Yes · github.com, 22 Sept 2026
- Packages
- The README lists community installation options for Arch, NixOS, Fedora, Debian or Ubuntu, and Gentoo. · github.com, 12 Oct 2026
- Per-app profiles
- Yes · github.com, 22 Sept 2026
- Purpose
- xremap is a key remapper for Linux that supports app-specific remapping and Wayland. · github.com, 12 Oct 2026
- Security
- The troubleshooting guide warns that debug logging prints all keyboard strokes and should not be left on during normal use. · github.com, 11 Oct 2026
- Security control
- The --allow-launch option controls whether remappings may execute programs. · github.com, 12 Oct 2026