antimicrox
Map gamepad inputs to keyboard and mouse
TLDR
Launch the graphical interface
SYNOPSIS
antimicrox [options] [profile]
DESCRIPTION
AntiMicroX is a graphical program for mapping gamepad buttons and joystick axes to keyboard keys, mouse movements, and mouse buttons. It enables using game controllers with applications that lack native controller support, including games, productivity software, and media players.
The application provides a visual editor for creating profiles that define how each controller input translates to keyboard/mouse actions. Profiles can include complex mappings with modifiers, turbo modes, macros, and set switching for different control schemes within a single profile.
AntiMicroX supports multiple simultaneous controllers, each with independent profiles. It runs on Linux using uinput or XTest for input injection, working with both X11 and Wayland (with limitations).
PARAMETERS
--profile file
Load a specific controller profile at startup.--profile-dir directory
Set the directory for profile storage.--tray
Start minimized to the system tray.--hidden
Start without any visible window or tray icon.--daemon
Run in daemon mode for background operation.--list
List all connected game controllers.--map device:profile
Map a specific device to a profile.--no-tray
Disable system tray icon entirely.--log-level level
Set logging verbosity: debug, info, warn, error.--eventgen backend
Select event generation backend (uinput, xtest).
CONFIGURATION
~/.local/share/antimicrox/
Default directory for controller profiles and application data.
CAVEATS
Wayland support is limited; some features require XWayland. The user must have access to /dev/uinput for virtual device creation; this typically requires adding the user to the input group. Some games with anti-cheat software may block synthetic input. Profile format changed from the original AntiMicro project.
HISTORY
AntiMicroX is a fork of AntiMicro, which was itself inspired by QJoyPad. The original AntiMicro was created by Travis Nickles around 2013. When development stalled, the AntiMicroX fork was created in 2019 to continue maintenance and add new features. It is now the actively maintained successor, supporting modern Linux distributions and additional controller types.
