🐧 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
Always Latest
Arch Linux & Manjaro
AntiMicroX is available directly via the Arch User Repository (AUR). Install using your preferred AUR helper:
Includes automated desktop entry and udev input rules.
Sandboxed & Safe
Steam Deck (SteamOS) & Flatpak
The recommended installation method for immutable systems like SteamOS, Fedora Silverblue, and openSUSE MicroOS:
On Steam Deck, install in Desktop Mode via the Discover store.
Native APT
Ubuntu, Debian & Pop!_OS
AntiMicroX is included in official Debian and Ubuntu repositories:
For the absolute latest upstream release, you can also download the official .deb package from GitHub.
Portable
Universal Portable AppImage
Download and run without root permissions on any modern Linux distribution:
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
Step 2: Create a udev Rule for /dev/uinput
Step 3: Ensure uinput Kernel Module is Loaded on Boot
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.
