OpenMapper
1.4.0 · GitHub
More about this app
Free open-source gamepad keymapper using Shizuku for touch injection with sub-millisecond latency; alternative to Mantis and Panda.
🎮 OpenMapper
High-performance, standalone Android gamepad keymapper powered by Shizuku.
The 100% Free, Modern & Open-Source Alternative to Mantis Gamepad Pro, Panda Gamepad & Octopus.
Play touch-only mobile games with any physical gamepad without root and with ultra-low latency (< 0.5 ms).
Warning
⚠️ Early Development & Alpha/Beta Notice OpenMapper is actively under early development. While the core mapping engine, zero-allocation input streaming, and in-game HUD editor are fully operational, you may occasionally run into unexpected bugs or device-specific quirks across different Android ROMs (MIUI/HyperOS, OneUI, ColorOS, OxygenOS, etc.).
If you encounter any bugs, controller recognition issues, or have ideas for improvements, please feel free to Open an Issue on GitHub with your device model, controller model, and Android version!
⚡ Quick Start & Installation
Getting started takes less than 2 minutes. 100% PC-Free & No Root Required — everything is set up directly on your phone.
Step 1: Download the App
- Go to the Latest Releases page.
- Download and install
OpenMapper-vX.X.X.apkon your Android device.
Step 2: Install & Start Shizuku (Required)
OpenMapper requires Shizuku to inject touch events into games with high-speed shell privileges without requiring root.
Install Shizuku on your phone:
Start Shizuku using Option A (Phone only) or Option B (PC Cable):
📱 Option A: 100% On Phone (Android 11+ • No PC Needed)
- Go to Settings ➔ About Phone ➔ Tap Build Number 7 times to unlock Developer Options.
- In Developer Options, enable Wireless Debugging.
- Open the Shizuku app, tap Pairing (enter code from notification), then tap Start.
💻 Option B: Via Computer (USB Cable • Android 8.0+)
- Enable USB Debugging in Developer Options.
- Connect your phone to your PC with a USB cable.
- Open a terminal / command prompt on your PC and run:
adb shell sh /sdcard/Android/data/moe.shizuku.privileged.api/start.sh
💡 Once started, Shizuku remains active in the background until your phone is rebooted.
Step 3: Launch OpenMapper
- Connect your controller (Bluetooth or USB-C OTG): Xbox, PlayStation, Switch Pro, 8BitDo, Razer Kishi, etc.
- Open OpenMapper and grant:
- Shizuku Permission (Click Authorize).
- Display Over Other Apps (Overlay permission).
- Select your game profile (e.g., CoD Mobile, Warzone, PUBG, Genshin).
- Tap 🚀 LAUNCH OVERLAY & MAPPING.
Step 4: Customize Controls in Game
- Launch your game.
- Swipe the side handle 🎮 on the edge of the screen to open the fullscreen HUD Editor.
- Drag and position buttons directly over your game's touchscreen controls.
- Tap 💾 Save and enjoy full gamepad controls!
✨ Key Features & Highlights
🏎️ High-Performance Mapping Engine
- Ultra-Low Latency (< 0.5 ms): Direct Linux
/dev/input/event*binary stream parsing with zero memory allocation and zero garbage collection overhead. - 120 Hz – 240 Hz Real-Time Loop: High-priority dedicated engine thread synchronized with modern high-refresh-rate gaming screens.
- Seamless 360° Camera: Dual-pointer handoff technology eliminating screen edge locks and angle snapping during continuous 360° rotations.
- Dynamic Flick & Boost Curve: Micro-precision center deadzone combined with instant 180° turn acceleration at outer stick reach.
- Twin-Stick Right Stick Mode: Turn the right stick into a second on-screen joystick (direction × deflection × radius) instead of a swipe camera, for twin-stick and MOBA-style games.
- Hide Controller from the Game: Optionally grab the physical controller exclusively over Shizuku, so games with partial native controller support cannot fight the mapping.
🎯 Tactical Assists & Aim Enhancements
- Organic Jiggle Strafe: Automated left/right dodge patterns during weapon fire with randomized feints and humanized timing variations.
- Vertical Anti-Recoil: Smooth automated pull-down compensation with configurable speed (0.1x – 10.0x) and dedicated ADS-Only mode.
- Rotational Aim Assist (RAA) Keep-Alive: Micro-dithering ensures in-game aim assist rotational tracking remains active even when stationary.
- Controller Rumble & Recoil: Dynamic physical gamepad vibration with continuous firing recoil pulses and mechanical reload double-pulses.
- Controller Gyro Aim: Tilt a DualSense, Switch Pro or similar controller to fine-tune the camera (Android 12+), with LT-hold or always-on activation, sensitivity and smoothing.
🪟 In-Game HUD & Key Customization
- In-Game Floating HUD Editor: Retractable side-drawer to drag, scale, and test button mappings live without leaving your match — press a physical button in the editor to learn it.
- Floating Quick-Menu Bubble: Optional draggable bubble that opens the quick menu without the edge handle, handy with gesture navigation.
- Two-Button Combos: Bind a HUD action to a chord such as
R1+Xright from the editor — more on-screen actions than the controller has buttons. - Virtual Cursor Mode (
L3+R3): Drive an on-screen pointer with either stick and tap withAto use menus, shops and dialogs without placing a HUD button on every item. Speed is adjustable in game with the D-pad or from the profile editor (0.25x – 5x) and saved per profile. - Special Button Roles: One-tap assignment for Primary Fire, Reload Magazine, and ADS Scope with dedicated sensitivities.
- Multi-Profile Management: Create, duplicate, rename, backup, and export custom mappings for any game.
- Per-Profile Game Package: Tag a profile with a game's package from a built-in app picker, so it is obvious which mapping belongs to which game.
- Multi-Language UI: Full English, French, Spanish, Portuguese and Hebrew translations, switchable from the home screen.
🌐 Cloud Community & Hardware Diagnostic
- 1-Click Community Hub: Search, download, and vote on community-made game presets backed by Cloudflare D1 edge database.
- Hardware Diagnostic Suite: Real-time analog stick visualizer, 3-second automated drift test, circularity error check, and polling rate (Hz) monitor.
- In-App Auto-Updater: Direct background detection and 1-tap installation of new GitHub releases directly within the app.
- In-App Bug Report: One-tap report with app version, device/ROM, Shizuku status, connected controllers, active profile and a bounded log — built from a strict whitelist, so no device token or signing secret can leak.
🗺️ Roadmap & Planned Features
Check out our TODO.md roadmap for upcoming features and technical improvements (e-Sport Macros, MOBA-Style Controls, Radial Menus, Per-App Auto-Switching, Advanced Community Filters, Adaptive Polling, and more).
🛠️ Building from Source
# Clone the repository
git clone https://github.com/kinou-p/android-open-mapper.git
cd android-open-mapper/android
# Run unit tests
./gradlew testDebugUnitTest
# Compile debug APK
./gradlew assembleDebug
# Install on connected device via ADB
adb install -r app/build/outputs/apk/debug/app-debug.apk
⚖️ Legal Disclaimer & Trademarks
- Independent Open-Source Project: OpenMapper is a community-driven project for personal, non-commercial use. It is not affiliated with, endorsed, or sponsored by Activision, Tencent, HoYoverse, Krafton, or any other game publisher.
- Trademarks: All game titles, trademarks, and logos (Call of Duty: Mobile, PUBG, Genshin Impact, Mantis Gamepad Pro, Panda, Octopus, etc.) belong to their respective owners.
- Responsibility: Use of this tool is at the user's sole discretion and responsibility.
📄 License
This project is licensed under the PolyForm Noncommercial License 1.0.0 (Free for personal, non-commercial and educational use. Commercial exploitation and resale are strictly prohibited).
How Shizuku is used
Can map gamepad buttons and sticks to on-screen touches via `IInputManager.injectInputEvent` and read controllers via privileged input.
This is an AI-assisted analysis of Shizuku-related usages in the app's public source code. It is best effort, so it may not catch every single usage.
How this app uses Shizuku
OpenMapper uses Shizuku to turn a physical gamepad into on-screen touches for games without controller support.
- Tap with buttons: pressing a mapped controller button triggers a tap or touch at the configured on-screen position, injected as a system touchscreen event through Shizuku.
- Move with left stick: pushing the left stick produces a continuous touch drag for the virtual joystick, including movement and strafe actions.
- Aim with right stick: pushing the right stick produces a continuous touch drag for camera look and aiming, including sensitivity handling.
- Read controllers directly: the app finds connected gamepads and streams their raw button and stick events using privileged input processes through Shizuku.
Android APIs or commands used
IInputManager.injectInputEventgetevent -pcat /proc/bus/input/devicescat /dev/input/event*getevent -q
Changelog
What's new for version 1.4.0
🎮 OpenMapper v1.4.0
Welcome to OpenMapper v1.4.0!
📱 Install & get started
- Download the APK
OpenMapper-v1.4.0.apkbelow. - Install it on your Android device.
- Make sure Shizuku is running on your phone to get key mapping and touch injection at ultra-low latency (< 0.5 ms).
SHA-256: 43e32356994c515371001a3f31cfe22dba2eba92c77060fac895634cd2a75e08
📝 Release notes
chore(release): bump to 1.4.0 (versionCode 16)
📋 Detailed commit changelog
What's Changed
- test(e2e): fix flaky rapid-fire test on the CI emulator by @matannturgeman in https://github.com/kinou-p/android-open-mapper/pull/35
- fix(ui): role menu and profile title on small screens by @matannturgeman in https://github.com/kinou-p/android-open-mapper/pull/26
- feat(overlay): optional floating bubble for the quick menu by @matannturgeman in https://github.com/kinou-p/android-open-mapper/pull/32
- fix(editor): in-app HUD editor ignores gamepad input by @matannturgeman in https://github.com/kinou-p/android-open-mapper/pull/31
- feat(camera): aim with the gamepad's own gyroscope by @matannturgeman in https://github.com/kinou-p/android-open-mapper/pull/24
- feat(camera): right stick joystick mode for twin-stick games by @matannturgeman in https://github.com/kinou-p/android-open-mapper/pull/33
- feat(input): optional 'Hide controller from the game' per profile by @matannturgeman in https://github.com/kinou-p/android-open-mapper/pull/34
Full Changelog: https://github.com/kinou-p/android-open-mapper/compare/v1.3.0...v1.4.0
Permissions
12 permissions requested