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

Last updated: July 12, 2021 — 4 Comments

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.

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


I'm a freelance blogger who started using Ubuntu in 2007 and wishes to share my experiences and some useful tips with Ubuntu beginners and lovers. Please comment to remind me outdated tutorial! And, notify me if you find any typo/grammar/language mistakes. English is not my native language. Contact me via [email protected] Buy me a coffee:

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

  1. After having tried multiple tutorials for modifying X11 config files manually without success, key-mapper just works perfectly.

    Thanks so much, Ji m!

  2. As above – looking, tried, without any results. Thanks to you article I found it.
    Thank you so much!

  3. The only way that worked on Ubuntu 22.04! Thank you! :)

  4. After so many tries, this works perfectly with my mouse side-buttons. Thank u!

Leave a Reply

Text formatting is available via select HTML.

<a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong> 


This site uses Akismet to reduce spam. Learn how your comment data is processed.