Activation

On a rooted device, simply click on start button to activate.

Activation using command

Open a root shell in termux and run the script:

sh /sdcard/Android/data/xtr.keymapper/files/xtMapper.sh

Use start button to start/stop service. When service is running, drag down notification panel and click on the notification to launch editor.

Alternate method

/system/bin/app_process -Djava.library.path=$(echo /data/app/*/xtr.keymapper*/lib/x86_64) -Djava.class.path=$(echo /data/app/*/xtr.keymapper*/base.apk) / xtr.keymapper.server.RemoteServiceShell

Use the above command if your OS has storage issues and XtMapper can’t write the script to storage.
Add --no-auto-launch to override the default behavior of launching the app.
Add --no-logcat to disable logcat output.

Non-rooted devices

Since v2.1.2 XtMapper supports non-rooted devices. Install Shizuku and authorize XtMapper from Shizuku app. https://shizuku.rikka.app
Enable Use Shizuku in XtMapper Settings > Advanced.

Why activate?

In Android, for security reasons user apps are not allowed to access system APIs required for injecting motion (touch) events. Or to read raw input events from the kernel’s evdev.
The script executes Xtmapper remote service with higher privileges (adb shell / root).
The user app (XtMapper) communicates with remote service through Android binder/AIDL interface for IPC.