ShizuStore

OpenMapper

kinou-p

1.4.0 · GitHub

Download APK
Input methods Android 8.0+ 2 weeks ago PolyForm-Noncommercial-1.0.0
308 ShizuStore
5.3k GitHub
33 Stars
2 MB Size

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).

Latest Release Early Development License Android 8.0+ No Root Required No Ads / No Paywall


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

  1. Go to the Latest Releases page.
  2. Download and install OpenMapper-vX.X.X.apk on 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.

  1. Install Shizuku on your phone:

  2. Start Shizuku using Option A (Phone only) or Option B (PC Cable):

📱 Option A: 100% On Phone (Android 11+ • No PC Needed)

  1. Go to Settings ➔ About Phone ➔ Tap Build Number 7 times to unlock Developer Options.
  2. In Developer Options, enable Wireless Debugging.
  3. Open the Shizuku app, tap Pairing (enter code from notification), then tap Start.

💻 Option B: Via Computer (USB Cable • Android 8.0+)

  1. Enable USB Debugging in Developer Options.
  2. Connect your phone to your PC with a USB cable.
  3. 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

  1. Connect your controller (Bluetooth or USB-C OTG): Xbox, PlayStation, Switch Pro, 8BitDo, Razer Kishi, etc.
  2. Open OpenMapper and grant:
    • Shizuku Permission (Click Authorize).
    • Display Over Other Apps (Overlay permission).
  3. Select your game profile (e.g., CoD Mobile, Warzone, PUBG, Genshin).
  4. Tap 🚀 LAUNCH OVERLAY & MAPPING.

Step 4: Customize Controls in Game

  1. Launch your game.
  2. Swipe the side handle 🎮 on the edge of the screen to open the fullscreen HUD Editor.
  3. Drag and position buttons directly over your game's touchscreen controls.
  4. 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+X right 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 with A to 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).

Close

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.injectInputEvent
  • getevent -p
  • cat /proc/bus/input/devices
  • cat /dev/input/event*
  • getevent -q
Close

Changelog

What's new for version 1.4.0

🎮 OpenMapper v1.4.0

Welcome to OpenMapper v1.4.0!

📱 Install & get started

  1. Download the APK OpenMapper-v1.4.0.apk below.
  2. Install it on your Android device.
  3. 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

Full Changelog: https://github.com/kinou-p/android-open-mapper/compare/v1.3.0...v1.4.0

Close

Permissions

12 permissions requested

  • android.permission.SYSTEM_ALERT_WINDOW
  • android.permission.FOREGROUND_SERVICE
  • android.permission.FOREGROUND_SERVICE_SPECIAL_USE
  • android.permission.POST_NOTIFICATIONS
  • android.permission.VIBRATE
  • android.permission.BLUETOOTH
  • android.permission.BLUETOOTH_CONNECT
  • android.permission.INTERNET
  • android.permission.ACCESS_NETWORK_STATE
  • android.permission.REQUEST_INSTALL_PACKAGES
  • com.kinou.gameassist.DYNAMIC_RECEIVER_NOT_EXPORTED_PERMISSION
  • moe.shizuku.manager.permission.API_V23
Close