Skip to content

Installation

NanoMindExplores edited this page Jul 14, 2026 · 1 revision

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+

Clone this wiki locally