XtMapper

https://xtr126.github.io/XtMapper-docs
Admin
XtMapper is an open-source keymapper for Android and Android-x86 that enables playing Android games...
Tokens:2,216
Snippets:42
Trust Score:9.7
Update:1 month ago
Show doc for...
Tokens:
Raw
### Print Display Output Information

Source: https://xtr126.github.io/XtMapper-docs/waydroid/2-fps

Execute this command to retrieve current display resolution and refresh rate settings.

```bash
~ ❯❯❯ cage_xtmapper.sh --print-output-info
== Output mode ==
Width: 1366
Height: 768
Refresh: 60000 mHz (60.0 Hz)
Flags: CURRENT (0x1)
== Output mode ==
Width: 1920
Height: 1080
Refresh: 60000 mHz (60.0 Hz)
Flags: CURRENT (0x1)
```

--------------------------------

### Manual service execution command

Source: https://xtr126.github.io/XtMapper-docs/guides/activation

Use this command if the app cannot write the activation script to storage. Optional flags include --no-auto-launch and --no-logcat.

```shell
/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
```

--------------------------------

### Activate via shell script

Source: https://xtr126.github.io/XtMapper-docs/guides/activation

Run this script in a root shell to activate the service on rooted devices.

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

--------------------------------

### Enable window title bar

Source: https://xtr126.github.io/XtMapper-docs/waydroid/4-window-customization

Add this flag to display the title bar, which is hidden by default to provide a borderless experience.

```bash
cage_xtmapper.sh ... --window-show-title-bar
```

--------------------------------

### Remap Touchpad to Touchscreen via udev

Source: https://xtr126.github.io/XtMapper-docs/waydroid/3-touchpad

Use this command to modify the udev database and enable touchpad support in Waydroid.

```bash
sudo find /run/udev -type f -exec sed -i 's/ID_INPUT_TOUCHPAD/ID_INPUT_TOUCHSCREEN/g' {} \;
```

--------------------------------

### Set custom window dimensions

Source: https://xtr126.github.io/XtMapper-docs/waydroid/4-window-customization

Use these flags to override the default fullscreen resolution with specific width and height values.

```bash
cage_xtmapper.sh ... --window-width 1280 --window-height 720
```

--------------------------------

### Override Waydroid Refresh Rate

Source: https://xtr126.github.io/XtMapper-docs/waydroid/2-fps

Use the --refresh-mhz flag to force a specific refresh rate in mHz.

```bash
cage_xtmapper.sh ... --refresh-mhz 30000
```

--------------------------------

### Revert Touchpad udev Changes

Source: https://xtr126.github.io/XtMapper-docs/waydroid/3-touchpad

Use this command to undo the udev database modifications and restore original touchpad settings.

```bash
sudo find /run/udev -type f -exec sed -i 's/ID_INPUT_TOUCHSCREEN/ID_INPUT_TOUCHPAD/g' {} \;
```

--------------------------------

### Disable logcat output in cage_xtmapper.sh

Source: https://xtr126.github.io/XtMapper-docs/waydroid/6-disable-logging

Append the --xtmapper-args --no-logcat flags to the command to disable colored logcat output.

```bash
cage_xtmapper.sh ... --xtmapper-args --no-logcat
```
Tokens:
Raw