Freedom251 › Keyboard and Mouse Customization Software
map2

What map2 is
map2 is a free, open-source Linux utility for remapping input devices such as keyboards, mice, controllers, and pedals. It is written in Rust, while mappings are configured with Python scripts. You can assign single keys with modifiers, sequences, and special keys, then use Python functions for custom conditions or more complex input sequences. Input events move through reader, mapper, and writer nodes, and multiple mapping layers are supported. The project describes an installation size of around 5 MB with almost no dependencies. Its public repository uses the MIT license. Documentation covers installation with pip, through the Arch User Repository, or by building from source, with instructions aimed at Linux systems including Arch Linux and Manjaro. Intercepting input events usually needs superuser permissions. The documentation describes a dedicated system user and device-specific udev rules to limit device access. Bug reports, suggestions, and contributions are directed to Discord and GitHub issues.
Who it suits
map2 suits Linux users who need scriptable remapping for keyboards, mice, controllers, or pedals. It is also relevant to users comfortable with Python configuration and Linux permissions.
What it does well
- Free and open-source under the MIT license
- Supports keyboards, mice, controllers, and pedals
- Python scripts enable custom mapping conditions
- Multiple mapping layers are supported
- Around 5 MB with almost no dependencies
What to know first
- Linux-only compatibility
- Input interception usually requires superuser permissions
- Superuser scripts can access system data and files
Plans
| Plan | Billed and limits | Price |
|---|---|---|
| map2 | Open source · Linux input remapping | Free |
As github.com lists them, read 11 Oct 2026. The maker's own page has the final word.
Verdict
map2 provides detailed, script-driven input remapping for Linux devices. Its small footprint and flexible routing suit technical users, while permission requirements call for careful setup.
Facts from map2's own pages
- Compatibility limit
- The documented installation options and input-device instructions target Linux, including Arch Linux and Manjaro examples. · shiro.github.io, 11 Oct 2026
- Configuration
- Mappings are configurable with Python scripts and the software is written in Rust. · github.com, 11 Oct 2026
- Custom behavior
- Python functions can be used to define custom conditions and complex input sequences. · shiro.github.io, 11 Oct 2026
- Free plan
- Yes · github.com, 22 Sept 2026
- Install methods
- The documentation describes installing with pip, installing from the Arch User Repository, or building from source. · shiro.github.io, 11 Oct 2026
- Install size
- The project describes its install size as around 5 MB with almost no dependencies. · github.com, 11 Oct 2026
- Macro support
- Yes · github.com, 22 Sept 2026
- Maker
- The GitHub profile identifies the maker as Matt, username shiro. · github.com, 11 Oct 2026
- Mappings
- The documentation supports single keys with modifiers, key sequences, and special keys. · shiro.github.io, 11 Oct 2026
- Open source
- The repository is public and licensed under MIT. · github.com, 11 Oct 2026
- Permissions
- Intercepting input events usually requires superuser permissions, and the documentation warns that running scripts as superuser gives them broad access to system data and files. · shiro.github.io, 11 Oct 2026
- Purpose
- map2 remaps Linux input devices such as keyboards, mice, controllers, and pedals. · github.com, 11 Oct 2026
- Routing
- Input events can be routed through reader, mapper, and writer nodes, with multiple mapping layers supported. · shiro.github.io, 11 Oct 2026
- Security setup
- The documentation describes using a dedicated system user and device-specific udev rules to restrict access to input devices. · shiro.github.io, 11 Oct 2026
- Support
- The repository directs bug reports, suggestions, and contributions to its Discord channel and GitHub issues page. · github.com, 11 Oct 2026
- Supported operating systems
- linux · github.com, 22 Sept 2026