The ultimate system-level driver to transform your Gamepad into a precision Virtual Mouse on Android. No third-party overlay apps, no input lag, 100% Kernel-level injection.
| Feature | Basic (Free) | PRO Hybrid (v7.1) |
|---|---|---|
| Auto-Detect & Config | ✅ Yes | ✅ Universal Profile |
| Smooth Mouse Pointer | ✅ Yes | ✅ Yes |
| Left Click (RB) | ✅ Yes | ✅ Yes |
| Hybrid Toggle (START + LB) | ❌ No | ✅ Switch Instantly |
| Exclusive Control (Grab) | ❌ No | ✅ Anti-Ghosting |
| Speed Modifier (LT/RT) | ❌ No | ✅ Sniper & Turbo |
| Turbo Scrolling | ❌ No | ✅ LT/RT Boosted |
| Volume Control (Left Analog Stick) | ❌ No | ✅ Remote Mode |
| Full Navigation (A,B,X,Y) | ❌ No | ✅ Enter/Back/Home |
| D-Pad Navigation | ❌ No | ✅ Arrow Keys Mode |
| System Shortcuts (L3/R3) | ❌ No | ✅ Recents / Notif |
We understand your concern regarding Root access. We guarantee that GPad2Mouse is 100% CLEAN from any malware, miners, or trackers.
- Full Transparency: The source code for the Basic version is available for audit in this repository.
- Scan It Yourself: You can verify our files (.py, .sh, or .zip) using:
- VirusTotal (Online): virustotal.com
- Local Scan: Use Malwarebytes Mobile or Sophos Intercept X. Note: Some antivirus may flag "Root-Tools" as a risk simply because they require Superuser access to function.
- Processors: Fully supports 32-bit (ARM) and 64-bit (ARM64) Android systems.
- Controllers: Optimized for X-Input (Original Xbox 360 / Xbox One / Xbox Series Controllers, Cheap Gamepad X3/T3 with Xbox Mode enabled) and PlayStation (PS3/PS4/PS5).
- With this update (Pro v7.1 and Free v3.1) it is guaranteed to support all types of Gamepads/Controllers that have Analog Sticks by using gpad2mouse_mapper.py.
GPad2Mouse has been rigorously tested and confirmed working on:
- Realme 8i (Android 11 - 64-bit / Magisk)
- STB HG680P (Android 6.0 - 32-bit / SuperSU)
- Samsung Galaxy Note 3 (HA3G) (Custom ROM Android 7.1.2 - 32-bit / Magisk)
- (Should work on almost all Rooted Android devices running Android 5.0 up to Android 14+).
- Root Access: SuperSU, Magisk, KernelSU, or APatch.
- Python Environment for 64-bit devices: You MUST install Py2Droid (Python for Magisk). 👉 Download Py2Droid Here
- Python Environment for 32-bit devices: If you are using a non-Magisk device (SuperSU) or an old STB, please follow our Python Transplantation Guide here.
Inside the ZIP file, you will find this exact structure:
GPad2Mouse_Free_v3.1.zip
├── GPad2Mouse/
│ ├── config.json
│ ├── gpad2mouse_mapper.py
│ └── gpad2mouse_free_v3.1.py
├── README.md
└── service.d/
└── mouse_boot.sh
- Install Python: You can use Py2Droid (Magisk Module) for 64-bit devices or use the Transplant Method for 32-bit devices.
- Extract the ZIP: Extract the downloaded GPad2Mouse ZIP file to your internal storage.
- Copy the Core Folder:
Move the entire
GPad2Mousefolder into your internal storage root: 👉/sdcard/GPad2Mouse/ - Copy the Boot Script:
Move the
mouse_boot.shfile into the Magisk service directory: 👉/data/adb/service.d/ - Set Permissions & Run:
Open your Terminal App (e.g., Terminal Emulator), grant Root access, and run the boot script. This will automatically deploy the files and start the engine:
su chmod +x /data/adb/service.d/mouse_boot.sh sh /data/adb/service.d/mouse_boot.sh
- Wait & Test: Wait about 10 seconds. Connect your Gamepad and move the Right Analog stick. The cursor should appear!
⚙️ FOR NON-MAGISK USERS (SuperSU / Legacy Root)
If you are not using Magisk, the
mouse_boot.sh script will not run automatically on boot. You need to inject it into your system's recovery script.
Open your Terminal App, grant su, and run these commands exactly:
su
mount -o rw,remount /system
echo "sh /data/adb/service.d/mouse_boot.sh &" >> /system/etc/install-recovery.sh
chmod 755 /system/etc/install-recovery.shNow your GPad2Mouse engine will survive reboots even without Magisk!
(Note: Once installed, the script will automatically run in the background every time you reboot your device).
(Click the image below to watch the full tutorial, including Python Transplantation on 32-bit devices and how to use the Mapper!)
If you have run the mouse_boot.sh script but your gamepad does not move the cursor, it means your gamepad's Vendor/Product ID is not in our default database.
Don't worry! We included a Universal Configurator (Mapper) to fix this instantly:
- Connect your Gamepad to your device.
- Open your Terminal App (su) and run:
su python3 /data/adb/gpad2mouse/gpad2mouse_mapper.py
- Follow the on-screen interactive instructions. It will ask you to press buttons and move the analog sticks.
- Once completed, the Mapper will automatically save your gamepad profile to
config.jsonand restart the GPad2Mouse engine! - Enjoy your fully supported Gamepad! 🎮🖱️
- MOVEMENT: Right Analog Stick.
- LEFT CLICK: RB (Right Bumper).
(From here it is only available in the Pro version) (All Controls & Gestures below are only active when Mouse Mode is ON)
- TOGGLE MODE: Press START + LB simultaneously to switch between Gamepad Mode and Mouse Mode.
- MOVEMENT: Right Analog Stick.
- LEFT CLICK: RB (Right Bumper).
- RIGHT CLICK: LB (Left Bumper).
- FAST MOVEMENT (Turbo): Hold RT while moving the cursor.
- SLOW MOVEMENT (Sniper): Hold LT while moving the cursor.
- SCROLLING: Left Analog Stick (Up/Down).
- FAST SCROLLING: Hold RT while scrolling with Left Analog Stick (Up/Down)
- NOTIFICATIONS: Click Right Analog (R3).
- RECENT APPS: Click Left Analog (L3).
- ARROW KEY: DPAD Button.
- ENTER/CONFIRM: A Button.
- BACK: B button.
- BACKSPACE: X Button.
- HOME: Y Button.
(Below are the new updates v7.1)
- VOLUME CONTROL: Move the Left Analog to the left or right.
- MENU: SELECT Button.
GPad2Mouse Pro is also FREE. We do not ask for money. However, the Pro version is hosted separately as a way to support the development team. By completing a quick verification task (Survey/App Install), you help us maintain this project and get the premium features instantly!
- Huge thanks to Mrakorez for creating Py2Droid, the incredible Magisk module that makes running system-level Python on Android possible without Termux.
- Script developed and optimized by ZHStore Tech-Lab © 2026.