XtMapper

XtMapper is an open-source keymapper that lets users play Android games using a hardware keyboard and mouse. It leverages Shizuku or Root access to inject inputs directly into the system, providing native peripheral support on physical Android devices and Waydroid without relying on emulators.

Technical Overview of XtMapper

The application interfaces with low-level Android system APIs by injecting touch, swipe, and multi-touch events through a local RootService or Shizuku's Wireless ADB capabilities. By utilizing scrcpy-based multi-touch logic, it translates physical peripheral movements into native touchscreen inputs without modifying system partitions.

Core Features of XtMapper

• Direct Injection: Maps hardware keyboard and mouse inputs directly to screen interactions using system-level privileges.
• Multi-Touch Logic: Adapts advanced multi-touch processing from the scrcpy project to handle complex in-game mechanics and gestures.
• Waydroid Compatibility: Functions perfectly within Waydroid environments to bridge desktop peripherals directly into Android containers.
• Open-Source Codebase: Delivers complete transparency through a GPLv3-licensed architecture, guaranteeing privacy without hidden background telemetry.
• Advanced Controls: Features granular configurations for mouse walk zones, macros, custom overlays, and individual axis sensitivity scaling.

Compatibility & Permissions

Requires Android 8.0 (Oreo) or higher. XtMapper operates through Shizuku via Wireless ADB for a secure, rootless experience, or via Direct Root using libsu. Recent updates introduced native support for middle-mouse aiming and a dynamic mouse walk radial zone for precise positional control.

How to Setup XtMapper

• Install the latest XtMapper APK file.
• Open the application and grant system-level permissions through either the Shizuku app or your preferred Root manager.
• Launch the keymap editor overlay to bind your hardware keys, mouse clicks, and specific touch zones over your target game.

Why Choose XtMapper?

XtMapper provides a native, hardware-level mapping solution that operates independently of heavy emulators or virtual spaces. It securely utilizes advanced privileges to map complex control schemes cleanly while leaving your base system files entirely untouched.