Home

GameMapperMind Wiki

Welcome to the GameMapperMind wiki! This is the technical documentation hub for the Android gamepad keymapper app.

Demo

Game Test Demo Video: https://youtu.be/OtdO_hg2ZdI

Table of Contents

Getting Started

• Home — This page
• Installation — Step-by-step install guide (Shizuku setup, APK install)
• Quick-Start-Guide — Get playing in 5 minutes
• First-Time-Setup — Daemon, Test Injection, profile selection

Architecture

• Injection-Architecture — 3-path touch injection (AIDL, Reflection, Shell)
• Multi-Pointer-MotionEvent — How v3 implements correct Android multi-touch semantics
• Dual-AIDL-Dispatch-Thread — Why stick and button use separate threads + coalescing
• Gamepad-Detection — How the app auto-detects controller layout via getevent
• Pointer-Allocation — How pointer IDs are allocated per gamepad (0-63 range)

Gamepad Compatibility

• Supported-Controllers — Tested controllers and their evdev codes
• Evdev-Code-Mapping — Full mapping table (BTN_GAMEPAD, BTN_TL2, ABS_HAT0X, etc.)
• Trigger-Normalization — How analog triggers are normalized across different ranges
• Troubleshooting-Gamepad — Diagnosing "button X doesn't work"

Configuration

• Interaction-Types — Hold, Tap, Turbo, Toggle, Charge, Gesture, Macro
• Trigger-System — Learn Single, Learn Chord, axis triggers
• Stick-Modes — Joystick vs Drag mode
• Sensitivity-Curves — Linear, Exponential, Parabolic, Concave
• Profile-Format — JSON schema for profiles
• Screen-Calibration — screenInsetTop/Bottom/Left/Right for non-edge-to-edge games

Diagnostics

• On-Screen-Log — Understanding diagnostic messages
• Test-Injection — How to verify injection works
• Path-A-B-C — Understanding injection path failover

Development

• Build-from-Source — Build APK locally
• Project-Structure — Codebase overview
• Contributing — How to contribute
• Changelog — Version history

Bug Reports

Found a bug? Please open an Issue with:

1. Controller name and model
2. Game you're playing
3. On-screen log output (especially GAMEPAD-DETECT and GAMEPAD-KEY lines)
4. Steps to reproduce

License

Apache-2.0