FREEDOM251

Freedom251 › Keyboard and Mouse Customization Software

xremap

Free plan Linux

Visit xremap Alternatives Pricing

xremap's own site

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

PlanBilled and limitsPrice
xremapOpen-source key remapper for Linux; MIT licensedFree

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

Where xremap stands on Freedom251

Look at these too