Repository navigation
OpenMapper Release v1.3.0
🎮 OpenMapper v1.3.0
Welcome to OpenMapper v1.3.0!
📱 Install & get started
- Download the APK
OpenMapper-v1.3.0.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: 16000d8d34218902a5a67d9312a17ed880ca5f431223c8761cc605d16e0be371
📝 Release notes
✨ New features
-
🎯 MOBA aim buttons (new
Aimrole) — for drag-to-aim games such as Brawl Stars:
press puts a finger on the in-game aim joystick, the right stick drags to aim (up to the
configured range), and releasing fires. Works on any button or combo, and a profile can
hold several at once (the most recently pressed one follows the stick). The left stick keeps
walking at the same time, and a profile with an aim button no longer runs the right-stick
camera (which would press the fire zone). A quick tap without moving the stick is an auto-aim
shot. Aim range and right-stick deadzone are tunable in the Move settings tab. (closes #7) -
🌍 Hebrew (עברית) — a fifth language, in the in-app picker, followed automatically from the
phone language (heand the legacyiw), and listed in Android 13+ Settings → Apps → Language
(a language chosen there is now honoured at startup). Full right-to-left mirroring, while
technical fields (JSON, package names, the bug report) stay left-to-right. -
💾 Import profiles from files — the import dialog can now read one or several exported
.jsonfiles at once through the system picker, instead of pasting text. Each file goes through
the same validation; the toast reports how many were imported, and the dialog only closes when
they all succeeded. Files are read as strict UTF-8 with a 1 MB cap. -
🎛️ HUD editor role & mode menus — the Role and Mode controls now open a popup list
to pick a value directly, instead of tapping through a cycle that walked all eight roles. An aim
button's Mode list only offersHOLD. -
🎲 Random tap jitter (opt-in) — a
RAPID_FIREbutton can now spread its taps to a random
point inside its circle instead of always hitting the exact centre, useful for games that flag
repeated taps on the same spot. It is a per-button option, off by default.
🛠️ Fixes
-
📜 Home screen is now scrollable — in landscape or on a small phone the content was taller
than the window and the "Display Over Other Apps" card, the active profile and the Launch button
were unreachable. When there is room, the launch actions stay pinned to the bottom as before. -
🌍 Localisation — removed the French leftovers from the English UI (the gamepad-test rumble
label, the default profile description), localised the HUD editor HOLD / TAP badges and the
Normalrole, and stopped the Android per-app language from being overridden by the in-app picker. -
🎯 Aim robustness — a forced cleanup (reset, controller disconnect, opening the HUD editor,
cursor mode) no longer fires a phantom shot: held aim fingers are cancelled instead of
released. Aim buttons stay on HOLD in the editor (the mode badge no longer claims TAP/RAPID),
touch order is serialised under the lock, and the aim-button set is published before the button
map so a profile switch never runs the camera for a frame. -
💾 Profile import — an import that cannot be written (storage full, unwritable file) is now
reported as a failure instead of selecting a profile that would vanish on restart. -
🎮 Controllers — read DualShock 4 pads on the kernel hid-sony / hid-playstation layout,
and the right stick of HID pads that expose it on ABS_Z / ABS_RZ. The built-in bug report now
also captures controller axes and the raw /dev/input nodes.
🔧 Under the hood
- 🧪 End-to-end test suite with simulated games — the real engine runs against full-screen
simulated FPS / MOBA / tap games on a physical device or an emulator (no Shizuku, no gamepad).
It now also drives the real app screens (navigation, language, profile manager, HUD editor,
file import) through Compose UI tests, and the emulator setup was made reliable. - 248 Android unit tests + 45 backend + 84 instrumented (device/emulator) tests, all green.
🙏 Credits
This release was built together with @matannturgeman — thank you! 🎉
- 🎯 MOBA aim buttons — PR #9 (feature request #7)
- 🧪 End-to-end suite with simulated games — PR #11
- 🌍 Hebrew, per-app language and RTL — PR #13, PR #8, PR #14
- 💾 Import from files — PR #12
- 📜 Scrollable Home screen — PR #10
He also tested the features on a Galaxy S25 Ultra with an Xbox controller.
📋 Detailed commit changelog
What's Changed
- fix(i18n): remove French leftovers from English UI, declare app locales by @matannturgeman in #8
- feat(moba): aim_joystick button role for drag-to-aim games (#7) by @matannturgeman in #9
- fix(home): make the Home screen scrollable by @matannturgeman in #10
- test(e2e): end-to-end suite with simulated games (device or emulator) by @matannturgeman in #11
- feat(profiles): import profiles from .json files, not only pasted text by @matannturgeman in #12
- feat(i18n): add Hebrew by @matannturgeman in #13
- fix(i18n): translate the button mode and role names in the HUD editor by @matannturgeman in #14
- test(e2e): make the suite pass on a fresh emulator by @matannturgeman in #16
- test(e2e): smoke suite of the most basic flows by @matannturgeman in #17
- test(e2e): scenarios for movement, camera, fire modes, safety and every input by @matannturgeman in #18
- test(e2e): drive the real app screens with Compose UI tests by @matannturgeman in #19
- test(e2e): HUD editor and profile import from files by @matannturgeman in #20
- feat(rapid-fire): optional random tap jitter inside the button circle by @matannturgeman in #21
Full Changelog: v1.2.5...v1.3.0