Repository navigation
OpenMapper Release v1.2.5
🎮 OpenMapper v1.2.5
Welcome to OpenMapper v1.2.5!
📱 Install & get started
- Download the APK
OpenMapper-v1.2.5.apkbelow. - Install it on your Android device.
- Make sure Shizuku is running on your phone to get key mapping and touch injection at ultra-low latency (< 0.5 ms).
SHA-256: 6c71ee7bdfd40a1bb722bea89ec58d1e5621ce8a342fea646ce14f6af8a58d74
📝 Release notes
✨ New features
-
🖱️ Virtual cursor mode (
L3+R3) — an on-screen pointer to use menus, shops and dialogs without placing a HUD button on every item:- either stick moves it (quadratic curve: precise near the centre, fast at full tilt),
Ataps (hold to drag),Bexits,- speed adjustable in game with the D-pad (0.25x → 5x) and from the profile editor (new slider),
- saved per profile; while the mode is active, button mappings, camera and movement stick are paused so a tap on a menu cannot fire a skill.
-
🧩 Two-button combos (
R1+X) — assignable straight from the HUD editor (holdR1, pressX, release):- the modifier keeps its own action, the combo replaces the trigger's one,
- user-assigned combos take precedence over the profile-switch shortcut (
SELECT+ D-pad), - the editor refuses two combos bound to the same trigger, so there is no silent ambiguity.
-
🐞 Built-in bug report — app version, device and ROM, Shizuku status, connected controllers, active profile and a bounded log, ready to copy. Built from a strict whitelist: no device token and no signing secret can leak.
-
💾 Reworked profile screens — browsing and editing are now separate, and only saving the active profile pushes a live update to the engine.
-
🌍 Multi-language UI — English (default), French, Spanish and Portuguese, with a language picker on the home screen.
🛠️ Fixes
- 📐 HUD editor toolbars on portrait / narrow screens — both the top and the bottom bar now wrap onto as many rows as needed instead of leaving buttons off screen: at the bottom,
Role,ModeandAssignwere invisible and untappable; at the top, the first button was clipped by the screen edge.➕/➖pairs stay side by side. - 🔋 Controller battery — read off the main thread (no more ANRs when a controller connects), result ignored if the controller was removed in the meantime, last known value kept on a transient failure, and requests queued instead of dropped (a controller connected mid-game shows its percentage right away).
- 🧩 Combos — a combo left active across a reset (controller disconnect, Shizuku restart, entering cursor mode) no longer swallows the release of a plain press, so a button cannot remain stuck on screen (ghost touch); malformed combo keys from imported profiles are normalised or ignored.
- 🖱️ Cursor — the tap is no longer lost when
Ais pressed within the first milliseconds of the mode; the speed setting no longer writes the profile to disk on every D-pad step (debounced, on an immutable copy); the mode closes cleanly if the overlay cannot be shown. - ⚡ Samsung One UI 8.5 ANR — controller hotplug callbacks moved to a dedicated thread (already shipped in the 1.2.4-beta prerelease).
- 🤖 CI — actions bumped to Node 24 versions.
🔧 Under the hood
- 193 automated tests (155 Android + 38 backend), all green.
- Documentation updated; the roadmap gained a MOBA-Style Controls axis (issue #7).
🙏 Credits
This release was built together with @matannturgeman — thank you! 🎉
- 🖱️ Virtual cursor mode (
L3+R3) — PR #6 - 🧩 Two-button combos (
R1+X) — PR #5 - 🔋 Controller battery handling and the battery ANR fix (battery read moved off the main thread) — PR #4
He also tested the features on a Galaxy S25 Ultra with an Xbox controller, which is what made the hardening in this release possible.
📋 Detailed commit changelog
What's Changed
- fix(detector): stop reading gamepad battery on the main thread (fixes ANR, #1) by @matannturgeman in #4
- feat: button combos (e.g. R1+X) assignable from the HUD editor by @matannturgeman in #5
- feat: virtual cursor mode (L3+R3) with runtime speed control by @matannturgeman in #6
New Contributors
- @matannturgeman made their first contribution in #4
Full Changelog: v1.2.3...v1.2.5