Freedom251 › Keyboard and Mouse Customization Software
xkeysnail

What xkeysnail is
xkeysnail is a free Python keyboard-remapping tool for Linux’s X environment. It uses the low-level evdev and uinput layers and can apply keymaps globally or per application. Application-specific maps can activate according to an application’s WM_CLASS, allowing different bindings in programs such as Firefox, Chrome, and Zeal. Nested keymaps support multi-stroke shortcuts, and keys can call Python functions, including functions that invoke Unix commands. Configuration is written as a Python script. Users can select keyboard devices with --devices and enable hot-plugging with --watch. Installation guidance covers Ubuntu, Fedora, Manjaro or Arch, Solus, and source installation; Python 3 is required. xkeysnail runs with sudo or root privileges. It is distributed under the GNU General Public License version 3 or later. The GitHub repository has an Issues section, while its releases page lists no releases. The README provides pip and source installation instructions.
Who it suits
It suits Linux users who want programmable global or per-application keyboard mappings in the X environment. Users should be comfortable with Python configuration and sudo or root privileges.
What it does well
- Free Linux keyboard remapping
- Per-application WM_CLASS keymaps
- Multi-stroke shortcuts
- Python functions can invoke Unix commands
- Keyboard hot-plugging via --watch
What to know first
- Requires sudo or root privileges
- Python 3 is required
- Linux X environment only
- GitHub releases page lists no releases
Verdict
xkeysnail provides highly configurable keyboard remapping through Python scripts and low-level input layers. Its root requirement and Linux-only scope matter when deciding whether it fits your system.
Facts from xkeysnail's own pages
- Application-specific maps
- It can define keybindings for individual applications. · github.com, 11 Oct 2026
- Configuration
- Its configuration is a Python script containing keymaps that activate based on an application's WM_CLASS or globally. · github.com, 11 Oct 2026
- Downloads
- The GitHub releases page says there are no releases; the README instead provides pip and source installation instructions. · github.com, 12 Oct 2026
- Free plan
- Yes · github.com, 22 Sept 2026
- Hot-plugging
- The --watch option is available for systems with hot-plugging keyboards. · github.com, 11 Oct 2026
- Input layer
- It uses the low-level evdev and uinput layer for remapping. · github.com, 11 Oct 2026
- Installation
- The README documents installation using pip or from the GitHub source repository. · github.com, 12 Oct 2026
- Intended use
- The README includes an example configuration with Emacs-like keybindings and per-application mappings for Firefox, Chrome, and Zeal. · github.com, 12 Oct 2026
- Keyboard devices
- Users can specify keyboard devices with the --devices option and enable hot plugging with --watch. · github.com, 12 Oct 2026
- License
- The project states that it is distributed under the GNU General Public License, version 3 or (at the user's option) any later version. · github.com, 12 Oct 2026
- Low level input
- The tool uses evdev and uinput so remappings work in almost all places, according to the README. · github.com, 12 Oct 2026
- Macro support
- Yes · github.com, 22 Sept 2026
- Maker
- The repository credits Masafumi Oyamada with the 2018 copyright. · github.com, 11 Oct 2026
- Multi stroke shortcuts
- Nested keymaps can define multi stroke shortcuts such as Ctrl+x followed by Ctrl+c. · github.com, 12 Oct 2026
- Per application mappings
- Keymaps can be activated according to an application's WM_CLASS. · github.com, 12 Oct 2026
- Per-app profiles
- Yes · github.com, 22 Sept 2026
- Platforms
- The README gives installation instructions for Ubuntu, Fedora, Manjaro/Arch, and Solus Linux distributions. · github.com, 12 Oct 2026
- Privilege requirement
- The README says xkeysnail runs in root mode and requires sudo; installation also requires root privilege and Python 3. · github.com, 12 Oct 2026
- Purpose
- xkeysnail is a Python keyboard remapping tool for the X environment, offering more flexible remappings than xmodmap. · github.com, 12 Oct 2026
- Python commands
- A key mapping can execute arbitrary Python functions, including functions that invoke UNIX commands. · github.com, 12 Oct 2026
- Security
- The README states that xkeysnail runs with root privileges, but the opened project pages provide no security or compliance certification claims. · github.com, 12 Oct 2026
- Security information
- The README states that the software is provided without warranty, including implied warranties of merchantability or fitness for a particular purpose. · github.com, 11 Oct 2026
- Support
- The repository has an Issues section for reporting and discussing project issues. · github.com, 12 Oct 2026
- Supported operating systems
- linux · github.com, 22 Sept 2026