map2

Linux input remapping
Remap your keyboard, mouse, controller and more!

Want to remap your input devices like keyboards, mice, controllers and more?
There's nothing you can't remap with map2!

• 🖱️ Remap keys, mouse events, controllers, pedals, and more!
• 🔧 Highly configurable, using Python
• 🚀 Blazingly fast, written in Rust
• 📦 Tiny install size (around 5Mb), almost no dependencies
• ❤️ Open source, made with love

Visit our official documentation for the full feature list and API.

---

If you like open source, consider supporting

Install

The easiest way is to use pip:

pip install map2

For more, check out the Install documentation.

After installing, please read the Getting started documentation.

Example

importmap2# readers intercept all keyboard inputs and forward themreader=map2.Reader(patterns=["/dev/input/by-id/my-keyboard"])
# mappers change inputs, you can also chain multiple mappers!mapper=map2.Mapper()
# writers create new virtual devices we can write intowriter=map2.Writer(clone_from="/dev/input/by-id/my-keyboard")
# finally, link nodes to control the event flowmap2.link([reader, mapper, writer])
# map the "a" key to "B"mapper.map("a", "B")
# map "CTRL + ALT + u" to "META + SHIFT + w"mapper.map("^!u", "#+w")
# key sequences are also supportedmapper.map("s", "hello world!")
# use the full power of Python using functionsdefcustom_function(key, state):
print("called custom function")
# custom conditions and complex sequencesifkey=="d":
return"{ctrl down}a{ctrl up}"returnTruemapper.map("d", custom_function)

Build from source

To build from source, make sure python and rust are installed.

# create a python virtual environment
python -m venv .env
source .env/bin/activate
# build the library
maturin develop

While the virtual environment is activated, all scripts ran from this terminal will use the newly built version of map2.

Contributing

If you want to report bugs, add suggestions or help out with development please check the Discord channel and the issues page and open an issue if it doesn't exist yet.

License

MIT

Authors

• shiro shiro@usagi.io