FREEDOM251

Freedom251 › Keyboard and Mouse Customization Software

xkeysnail

Free plan LinuxSelf-hosted

Visit xkeysnail Alternatives

xkeysnail's own site

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

Where xkeysnail stands on Freedom251

Look at these too