# OmniSight Android User Guide

> The current Android build requires root / su permission. A non-root clone-app version will be handled separately.

## Required Files

Place these 5 files in `/data/local/tmp/` on the phone:

```text
libomnisight_android.so
omnisight_ptrace_loader
inject_omnisight.sh
omnisight_android.cfg
set_omnisight_input_mode.sh
```

## Injection

1. Open the game first and enter the lobby or a match.
2. Run:

```sh
su -c sh /data/local/tmp/inject_omnisight.sh
```

3. If injection succeeds, the OmniSight menu will appear in game.
4. On first use, enter your license key to log in.

## Touch Input Mode

Normally you do not need to change this.

If the menu appears but cannot be touched, run:

```sh
su -c "sh /data/local/tmp/set_omnisight_input_mode.sh consume"
```

Then restart the game and inject again.

To restore the default mode:

```sh
su -c "sh /data/local/tmp/set_omnisight_input_mode.sh auto"
```

## Uninstall / Re-inject

Use `Uninstall` in the OmniSight menu first.

If the menu cannot be operated, restart the game and inject again.

## Log Files

If there is no UI, the game crashes, or touch input does not work, send the log file:

```text
/sdcard/Download/omnisight_android.log
/data/local/tmp/omnisight_android.log
```

Prefer `/sdcard/Download/omnisight_android.log` if it exists.

## FAQ

`No UI`

Make sure the game is already running and the injection command has been executed. If there is still no UI, check whether the log contains `overlay initialized` and `data bridge ready`.

`Menu appears but cannot be touched`

Switch input mode:

```sh
su -c "sh /data/local/tmp/set_omnisight_input_mode.sh consume"
```

`Crash after re-injection`

Restart the game first, then inject again. Do not repeatedly run the injection command without restarting.

`Target not running`

Open the game manually first, then run:

```sh
su -c sh /data/local/tmp/inject_omnisight.sh
```

