ShizuStore

XtMapper

Xtr126

2.6.1 · GitHub

Download APK
Input methods Android 7.1+ 19 hours ago GPL-3.0
167 ShizuStore
47.3k GitHub
462 Stars
10 MB Size

More about this app

Keymapper for Android x86

XtMapper

XtMapper, a free and open source keymapper.
Play your Android games with keyboard and mouse

About and features

https://xtr126.github.io/XtMapper-docs/guides/about
Watch video on YouTube

Screenshots

Click to expand

| | | | | ------------- | ------------- | ------------- | | | | | | | | | image

Development

See the development guide for build setup and Android instrumentation. See CONTRIBUTING.md to report issues, ask questions, or contribute.

Help and support

To report any bugs to help improve XtMapper please create an issue at https://github.com/Xtr126/XtMapper/issues

To share your thoughts on XtMapper or ask any questions please create a post at https://github.com/Xtr126/XtMapper/discussions

Using on waydroid

https://xtr126.github.io/XtMapper-docs/waydroid/1-overview/

Credits

@Xtr126 Project creator and primary maintainer; core input mapping, editor, and service implementation
@SoufianoDev Secondary maintainer; Kotlin migration, codebase improvements, bug fixes, and translation updates

See CONTRIBUTORS.md for the full contributor and translator list.

See CREDITS.md for third-party code, libraries, assets, and copyright.

Get it on IzzyOnDroid

Close

How Shizuku is used

Can map keyboard and mouse to touch in games via Shizuku service using `InputManager.injectInputEvent`, `getTasks` and `am start`.

This is an AI-assisted analysis of Shizuku-related usages in the app's public source code. It is best effort, so it may not catch every single usage.

How this app uses Shizuku

XtMapper uses Shizuku to run its keymapping server with elevated privilege so physical keyboard and mouse can drive touch games.

  • Map keys to touch: keyboard input from raw device events is translated by the active keymap profile into taps, holds and multi-touch gestures injected as touchscreen events through the system input manager.
  • Move mouse and click: relative mouse motion, left, right and middle clicks and wheel movement become cursor movement and injected mouse and scroll events, with a custom cursor shown over games.
  • Show cursor overlay: the cursor window is created as a secure system overlay on the selected display so it stays visible above games while mapping is active, including granting overlay access with an appops set shell command through Shizuku.
  • Auto switch profiles: the service polls the current foreground tasks to learn the top app package and automatically starts the matching keymap profile for that game.
  • Launch games for mapping: when a profile starts, the service launches the mapped game package with the am start shell command.

Android APIs or commands used

  • android.hardware.input.InputManager.injectInputEvent
  • android.hardware.input.InputManagerGlobal.injectInputEvent
  • android.view.MotionEvent.obtain
  • android.view.MotionEvent.setDisplayId
  • android.view.MotionEvent.setActionButton
  • android.app.IActivityManager.getTasks
  • android.os.ServiceManager.getService
  • android.view.WindowManager.LayoutParams.TYPE_SECURE_SYSTEM_OVERLAY
  • android.view.WindowManager.setDefaultToken
  • android.content.Context.createDisplayContext
  • android.content.Context.createWindowContext
  • appops set ... SYSTEM_ALERT_WINDOW allow
  • am start
Close

Changelog

What's new for version 2.6.1

Other changes

Full Changelog: https://github.com/Xtr126/XtMapper/compare/v2.6.0...v2.6.1

Close

Permissions

12 permissions requested

  • android.permission.SYSTEM_ALERT_WINDOW
  • android.permission.FOREGROUND_SERVICE
  • android.permission.FOREGROUND_SERVICE_SPECIAL_USE
  • android.permission.POST_NOTIFICATIONS
  • android.permission.INTERNET
  • android.permission.MANAGE_EXTERNAL_STORAGE
  • android.permission.DIAGNOSTIC
  • android.permission.VIRTUAL_INPUT_DEVICE
  • android.permission.INTERNAL_SYSTEM_WINDOW
  • android.permission.INJECT_EVENTS
  • xtr.keymapper.DYNAMIC_RECEIVER_NOT_EXPORTED_PERMISSION
  • moe.shizuku.manager.permission.API_V23
Close