Freedom251 › Keyboard and Mouse Customization Software
evremap

What evremap is
evremap is a free keyboard input remapper for Linux systems, including Wayland, X11, and the Linux console. It works at the evdev layer, taking exclusive access to a selected input device and sending changed input through a virtual output device. A TOML configuration selects a device by name and can add its physical identifier when names overlap. Rules support dual-role keys, allowing a tap and a hold to produce different outputs, such as Escape on tap and Ctrl while held. Combination mappings can turn Alt plus an arrow into Page Up, Page Down, Home, or End, and can emit one or more output keys. Dual-role rules run first, followed by remaps in file order. The command-line tool lists devices and keys. The project includes service guidance for systemd, runit, and OpenRC, plus a pointer to Evremap-GUI. Building uses libevdev development packages, pkg-config, and cargo build --release. Running requires root or suitable evdev and uinput permissions.
Who it suits
evremap suits Linux users who need system-wide keyboard changes under Wayland, X11, or the console. It is aimed at people comfortable with TOML configuration, device permissions, and command-line setup.
What it does well
- Works across Wayland, X11, and Linux console
- Supports tap-versus-hold dual-role keys
- Maps combinations to one or more output keys
- Lists devices and keys from the command line
- Includes systemd, runit, and OpenRC guidance
What to know first
- Requires exclusive access to an input device
- Needs root or evdev and uinput permissions
- Building requires development packages and Cargo
- Keypress command execution is not implemented
Verdict
evremap provides detailed, system-wide Linux remapping with dual-role and combination rules. Its permission, build, and configuration requirements make it better suited to technically experienced users.
Facts from evremap's own pages
- Access requirements
- Running evremap as root lets it grab exclusive device access; the README also describes granting an unprivileged user access to evdev and uinput. · github.com, 12 Oct 2026
- Build requirements
- The README lists libevdev development packages and pkg-config for building, followed by cargo build --release. · github.com, 12 Oct 2026
- Configuration
- The README demonstrates configuring remaps in a TOML file and choosing a device by name, with an optional physical-device identifier. · github.com, 12 Oct 2026
- Device and key listing
- The command-line tool provides `list-devices` and `list-keys` subcommands. · github.com, 12 Oct 2026
- Device selection
- The configuration selects a device by name and can optionally specify its phys value when multiple devices share a name. · github.com, 12 Oct 2026
- Dual-role keys
- A key can produce one output when tapped and another when held, such as Caps Lock producing Escape on tap and Ctrl when held. · github.com, 12 Oct 2026
- Free plan
- Yes · github.com, 22 Sept 2026
- GUI
- The README points users to Evremap-GUI for editing the configuration file. · github.com, 12 Oct 2026
- GUI integration
- The README points users to Evremap-GUI for editing configuration files. · github.com, 12 Oct 2026
- Input handling
- evremap grabs exclusive access to an input device and emits changes to a virtual output device based on its remapping configuration. · github.com, 12 Oct 2026
- Key combinations
- Remap rules can map combinations such as Alt plus an arrow key to Page Up, Page Down, Home, or End. · github.com, 12 Oct 2026
- Multi-key remaps
- Remap rules can map combinations of input keys to one or more output keys. · github.com, 12 Oct 2026
- Notable limit
- Executing a command when a key is pressed is not implemented. · github.com, 12 Oct 2026
- Notable limitation
- Executing a command when a key is pressed is not implemented, according to the README. · github.com, 12 Oct 2026
- Permissions
- Running evremap requires root access to grab exclusive access to an input device, or user access to evdev and uinput. · github.com, 12 Oct 2026
- Purpose
- evremap is a keyboard input remapper for Linux/Wayland systems. · github.com, 12 Oct 2026
- Release downloads
- The GitHub releases page states that there are no releases listed. · github.com, 12 Oct 2026
- Rule ordering
- Dual-role rules are processed first, and remap rules are applied in the order they appear in the configuration file. · github.com, 12 Oct 2026
- Service integration
- The repository includes a sample systemd service unit and instructions for using Runit or OpenRC. · github.com, 12 Oct 2026
- Service setup
- The repository README includes instructions for running evremap with systemd, runit, or OpenRC. · github.com, 12 Oct 2026
- Supported operating systems
- linux · github.com, 22 Sept 2026
- System-wide remapping
- It targets the evdev layer and works system-wide in Wayland, X11, and the Linux console. · github.com, 12 Oct 2026