How to Remap Keyboard / Gamepad in Ubuntu Easily with This Tool

Want to remap your keyboard or gamepad keys in Ubuntu Linux? It’s easy to do this via Key Mapper.

Key Mapper is a free and open-source tool written in Python 3. With it, you can change the mapping for input devices, including mouse, keyboard, and gamepad.

It works on both X11 and Wayland, and supports for mapping to combined buttons (e.g., Control+A) and programmable macros.

The software has an easy to use interface. Simply choose your device from the drop-down box, you can then:

  • Add, remove, copy preset via left part buttons.
  • Apply current preset.
  • Choose or rename current preset.
  • Autoload – apply current preset automatically at login.
  • Add as many key mappings as you prefer in the right part for current preset.

Presets are saved in user’s .config/key-mapper/presets folder. You can use them in another machine that can read these “.json” files.

How to Install Key Mapper in Ubuntu:

The software offers official .deb package for Ubuntu / Debian based systems.

Download Key Mapper (.deb)

Grab the deb package, then open terminal and run command to install it:

sudo apt install ./Downloads/key-mapper*.deb

It should work on all current Ubuntu releases since it requires only a few python modules.

Once installed, open it from system app launcher and enjoy!

(Optional) For choice, there’s command to remove the tool from Ubuntu:

sudo apt remove --autoremove key-mapper