Installation

Installation

Step-by-step guide to install GameMapperMind on your Android device.

Prerequisites

• Android 12+ (API 31)
• Shizuku v13+ — https://shizuku.rikka.app/
• Gamepad — Bluetooth or USB (Xbox, PlayStation, 8BitDo, generic)

Step 1: Install Shizuku

1. Download Shizuku from Play Store or GitHub Releases
2. Install and open Shizuku
3. Follow the in-app instructions to start Shizuku

Start Shizuku via Wireless ADB

1. Enable Developer Options (Settings, About Phone, tap Build Number 7 times)
2. Enable Wireless Debugging (Settings, Developer Options, Wireless Debugging)
3. On your PC run: adb pair IP:PORT adb shell sh /storage/emulated/0/Android/data/moe.shizuku.privileged.api/start.sh
4. Shizuku should show Running

Note: Shizuku stops on reboot. Re-run the start command after each reboot.

Step 2: Download GameMapperMind APK

Download the latest APK from GitHub Releases page.

Step 3: Install the APK

1. Transfer APK to your device
2. Open the APK file
3. Allow Install from unknown sources if prompted
4. Tap Install

Step 4: Grant Shizuku Permission

1. Open GameMapperMind
2. Go to Orchestration Control tab
3. Tap Start Daemon
4. Tap Allow to grant Shizuku permission
5. Status should show CONNECTED

Step 5: Grant Overlay Permission

1. When prompted, tap Open Settings
2. Find GameMapperMind
3. Toggle Allow display over other apps
4. Return to the app

Step 6: Connect Your Gamepad

1. Connect gamepad via Bluetooth or USB
2. Open Sensor and Input Diagnostics tab
3. Press buttons — they should register
4. Check log for GAMEPAD-DETECT message

Step 7: Test Injection

1. Go to Orchestration Control tab
2. Tap Test Injection
3. A touch should appear at screen center
4. Log should show: Injection OK via Path A

Step 8: Select a Game

1. Go to Installed Games tab
2. Find your game
3. Tap Play — game launches with default profile

Troubleshooting

• Shizuku not running: open Shizuku app, check status, re-run start command
• Permission denied: check Shizuku authorized apps list
• APK install blocked: allow unknown apps for your file manager
• App crashes: ensure Android 12+ and Shizuku v13+