LinuxCommandLibrary

antimicrox

Map gamepad inputs to keyboard and mouse

TLDR

Launch the graphical interface

$ antimicrox
copy
Start with a specific profile
$ antimicrox --profile [path/to/profile.gamecontroller.amgp]
copy
Start minimized to system tray
$ antimicrox --tray
copy
Start hidden (no window or tray icon)
$ antimicrox --hidden
copy
List connected controllers
$ antimicrox --list
copy
Start in daemon mode
$ antimicrox --daemon
copy

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.

SEE ALSO

jstest(1), xdotool(1), qjoypad(1)

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community