Need help with antimicrox?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

442 Stars 31 Forks GNU General Public License v3.0 2.4K Commits 38 Opened issues


Graphical program used to map keyboard buttons and mouse controls to a gamepad. Useful for playing games with no gamepad support.

Services available


Need anything else?

Contributors list

Icon AntiMicroX

  1. Description
  2. License
  3. Installation
  4. Wiki
  5. Command Line
  6. Testing Under Linux
  7. AntiMicroX Profiles
  8. Support
  9. Bugs
  10. Shoutout
  11. Credits
  12. Participation in the translation of AntiMicroX


AntiMicroX is a graphical program used to map gamepad keys to keyboard, mouse, scripts and macros. You can use this program to control any desktop application with a gamepad on Linux. It can be also used for generating SDL2 configuration (useful for mapping atypical gamepads to generic ones like xbox360).

We support and Wayland.

It allows mapping of gamepads/joystick buttons to: - keyboard buttons - mouse buttons and moves - scripts and executables - macros consisting of elements mentioned above

This program is currently supported under various Linux distributions.

This application is continuation of project called

, which was later abandoned and revived by juliagoda.

Legacy repositories: - First AntiMicroX repository: - Second, maintained by organization: - First, original AntiMicro repository:

Disclaimer: Theme may depend on your system configuration.

Main Window Mapping
Calibration Advanced settings


This program is licensed under the GPL v.3. Please read the LICENSE text document included with the source code if you would like to read the terms of the license. The license can also be found online at



The flatpak version is distributed on Flathub, and runs on most major Linux distributions. See instructions here: Flathub application page

If you have Flathub set up already:

flatpak install flathub io.github.antimicrox.antimicrox

❕ Flatpak package may not work correctly with wayland (Fix available here)


Download from the release site.

It is recommended to use AppImageLauncher with this package.

Debian/Ubuntu-based distributions

Download from the release site and install



dnf install antimicrox


A package is available.

zypper install antimicrox

Arch Linux or Arch Linux based distributions:

trizen -S antimicrox


pre-built version can de downloaded from unofficial repository called chaotic-aur.

Append (one of listed mirrors) to

: ```bash


Server =$repo/$arch


Server =$repo/$arch

USA (Cloudflare cached)

Server =$arch


Server =$arch

To check signature, add keys:
bash sudo pacman-key --keyserver hkp:// -r 3056513887B78AEB 8A9E14A07010F7E3 sudo pacman-key --lsign-key 3056513887B78AEB sudo pacman-key --lsign-key 8A9E14A07010F7E3
Install package
bash pacman -S antimicrox ```

Building Yourself

List of required dependencies and build instructions can be found here.

Packages status

Status of package

Packaging status


(in cases when it contains AntiMicroX)
Debian 12 package
Debian Stable package
Ubuntu 21.04 package

Command Line


antimicrox --help
or read
man antimicrox
for command-line parameters.
Commandline for flatpak In case of flatpak package AntiMicroX can be launched with command:
flatpak run io.github.antimicrox.antimicrox instead of just antimicrox
In some cases it may be good to add alias
alias antimicrox='flatpak run io.github.antimicrox.antimicrox'
fo file ~/.bashrc


Look here

Testing Under Linux

If you are having problems with antimicrox detecting a controller or detecting all axes and buttons, you should test the controller outside of antimicrox to check if the problem is with antimicrox or not. The two endorsed programs for testing gamepads outside of antimicrox are sdl-jstest (sdl2-jstest) and evtest. SDL2 utilizes evdev on Linux so performing testing with older programs that use joydev won't be as helpful since some devices behave a bit differently between the two systems. Another method also exist, which can be found here.

AntiMicroX Profiles

If you would like to send the profile you are using for your application or find something for yourself, here is the forked repository. If you want to report a bug, ask a question or share a suggestion, you can do that on the antimicrox page or on the antimicrox-profiles page.


In order to obtain support, you can post an issue here.


Application's bugs will be fixed. There are created tests for detecting bugs. Of course, I'm open to proposals or questions from users.


A big, original inspiration for this program was the program QJoyPad.



Full list is available here

Package Maintainers

| Distro | Maintainer | Package | | :----------- | :------------------------------------ | :-------------------------------------------------------------------------------------------------- | | Arch Linux | frealgagu | antimicrox AUR | | Arch Linux | FabioLolix | antimicrox-git AUR | | Fedora Linux | gombosg | antimicrox | | Flatpak | gombosg | io.github.antimicrox.antimicrox |


VaGNaroK [email protected] - Brazilian Portuguese
zzpxyx - Chinese
Belleguic Terence [email protected] - French
Leonard Koenig [email protected] - German
phob - German
tou omiya - Japanese
Dmitriy Koshel [email protected] - Russian
Jay Alexander Fleming [email protected] - Serbian
burunduk - Ukrainian
Flavio HR [email protected] - Spanish
WAZAAAAA - [email protected] - Italian
juliagoda [email protected] - Polish

Participation in the translation of AntiMicroX

If you want to participate in the translation of the program, but your language is not yet on the support list. Please contact us.

However, if your language is already supported in the program, you must have the Qt Linguist program installed, which is usually included in the qt5-tools package, to conveniently translate the application. However, before you do that, make sure that you don't already have this program installed. All you have to do is open it, and then use it to open a file with the ts extension.

If a red exclamation mark appears in the translation field, it means that your translation does not end with the same sign as the original content. Try to place commas or dots in appropriate places and often save your progress.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.