🐧 Linux Downloads & Setup Guide


Wayland & X11 Native


Steam Deck (SteamOS) Ready

Download & Install AntiMicroX on Linux (Arch, Ubuntu, Flatpak & AppImage)

AntiMicroX is the premier open-source controller-to-keyboard/mouse mapping utility on Linux. Featuring full SDL2, Wayland, X11, and Linux uinput kernel support. Choose your distribution package below.

Installation by Linux Distribution

Arch / AUR
Always Latest

Arch Linux & Manjaro

AntiMicroX is available directly via the Arch User Repository (AUR). Install using your preferred AUR helper:

Arch Linux Terminal
Bash
yay -S antimicrox

Includes automated desktop entry and udev input rules.

Flathub / Steam Deck
Sandboxed & Safe

Steam Deck (SteamOS) & Flatpak

The recommended installation method for immutable systems like SteamOS, Fedora Silverblue, and openSUSE MicroOS:

Flatpak Terminal
Bash
flatpak install flathub io.github.antimicrox.antimicrox
flatpak run io.github.antimicrox.antimicrox

On Steam Deck, install in Desktop Mode via the Discover store.

Debian / Ubuntu
Native APT

Ubuntu, Debian & Pop!_OS

AntiMicroX is included in official Debian and Ubuntu repositories:

Ubuntu / Debian Terminal
Bash
sudo apt update
sudo apt install antimicrox

For the absolute latest upstream release, you can also download the official .deb package from GitHub.

AppImage
Portable

Universal Portable AppImage

Download and run without root permissions on any modern Linux distribution:

AppImage Terminal
Bash
chmod +x Antimicrox*.AppImage
./Antimicrox*.AppImage

Self-contained with all required Qt6 and SDL2 libraries.

Essential Linux Configuration: Enabling uinput Permissions

On Linux, simulated keystrokes and mouse movements pass through the Linux kernel uinput subsystem. If AntiMicroX opens but cannot move the mouse or send keys, your non-root user account needs access to /dev/uinput.

Step 1: Add User to the Input Group

Terminal: Group Permission
Bash
sudo usermod -aG input $USER

Step 2: Create a udev Rule for /dev/uinput

Terminal: udev Rule
Bash
echo 'KERNEL=="uinput", MODE="0660", GROUP="input"' | sudo tee /etc/udev/rules.d/99-uinput.rules
sudo udevadm control --reload-rules && sudo udevadm trigger

Step 3: Ensure uinput Kernel Module is Loaded on Boot

Terminal: Kernel Module
Bash
sudo modprobe uinput
echo "uinput" | sudo tee /etc/modules-load.d/uinput.conf

Log out and log back in (or reboot) for group permissions to take full effect.

Wayland vs. X11 Compatibility

AntiMicroX v3.4+ natively supports Wayland via kernel uinput device creation. Unlike older mappers that depended strictly on X11 XTestFakeKeyEvent calls, AntiMicroX registers as a genuine hardware input device at the kernel level, ensuring seamless compatibility across GNOME Wayland, KDE Plasma 6 Wayland, and Hyprland.

Need Tested Linux Controller Profiles?

Browse ready-to-import .amgp files for desktop mouse navigation, FPS shooters, and emulator layouts.


Browse Profiles Library →