163 lines
4 KiB
Markdown
163 lines
4 KiB
Markdown
# Anti Prestige Tool
|
|
|
|
Queue-position reader for Arma Reforger on Linux.
|
|
|
|
The tool captures the Reforger queue screen, crops the queue-number region, and reads the orange UI digits with bundled real-game digit templates. It does not use Tesseract, OpenCV, or Pillow.
|
|
|
|
## Install
|
|
|
|
Install system dependencies:
|
|
|
|
```bash
|
|
# Arch example
|
|
sudo pacman -S --needed base-devel uv qt6-base gstreamer gst-plugins-base gst-plugin-pipewire imagemagick xdg-desktop-portal
|
|
```
|
|
|
|
You also need a portal backend for your desktop:
|
|
|
|
```text
|
|
KDE: xdg-desktop-portal-kde
|
|
GNOME: xdg-desktop-portal-gnome
|
|
wlr: xdg-desktop-portal-wlr
|
|
```
|
|
|
|
Build the local helpers:
|
|
|
|
```bash
|
|
make
|
|
```
|
|
|
|
No sudo install is required for the default Portal/PipeWire capture path. No specific font package is required for normal use.
|
|
|
|
## Use
|
|
|
|
Preferred command:
|
|
|
|
```bash
|
|
uv run reforger_queue_read.py --portal-window --show-crop --debug
|
|
```
|
|
|
|
On first run, your desktop should show a window-sharing picker. Select the Arma Reforger window. If the portal grants persistence, the tool stores a restore token here:
|
|
|
|
```text
|
|
~/.local/state/anti-prestige-tool/portal-window-restore-token
|
|
```
|
|
|
|
Later runs reuse that token:
|
|
|
|
```bash
|
|
uv run reforger_queue_read.py --portal-window --show-crop --debug
|
|
```
|
|
|
|
If the saved window selection is wrong or stale:
|
|
|
|
```bash
|
|
uv run reforger_queue_read.py --portal-window --portal-reselect --show-crop --debug
|
|
```
|
|
|
|
Save the captured input image while debugging:
|
|
|
|
```bash
|
|
uv run reforger_queue_read.py --portal-window --save-input /tmp/apt-portal-window.png --show-crop --debug
|
|
```
|
|
|
|
The default matcher uses `templates/reforger_digits.json`. Font mode is only for debugging:
|
|
|
|
```bash
|
|
uv run reforger_queue_read.py --portal-window --font Roboto-Condensed --show-crop --debug
|
|
```
|
|
|
|
## Optional KDE/KWin Mode
|
|
|
|
KWin mode can automatically find the Arma window by KWin metadata and can rebind after the game restarts. It is KDE-specific and requires installing an authorized helper.
|
|
|
|
Install the helper:
|
|
|
|
```bash
|
|
sudo make install-kwin-auth
|
|
kbuildsycoca6
|
|
```
|
|
|
|
Run:
|
|
|
|
```bash
|
|
uv run reforger_queue_read.py --kwin-window auto --show-crop --debug
|
|
```
|
|
|
|
If auto matching is ambiguous, list windows and pass the PID or internal id:
|
|
|
|
```bash
|
|
uv run reforger_queue_read.py --list-kwin-windows
|
|
uv run reforger_queue_read.py --kwin-window 53561 --show-crop --debug
|
|
uv run reforger_queue_read.py --kwin-window-id '{77a38955-a827-479c-971b-af8de226ac7b}' --show-crop --debug
|
|
```
|
|
|
|
The auth install places:
|
|
|
|
```text
|
|
/usr/local/bin/reforger-kwin-capture
|
|
/usr/local/share/applications/org.codex.reforger-kwin-capture.desktop
|
|
```
|
|
|
|
The desktop file must be in a root-owned application directory because KWin does not trust user-writable desktop entries for restricted screenshot interfaces.
|
|
|
|
## Other Inputs
|
|
|
|
Read an existing screenshot:
|
|
|
|
```bash
|
|
uv run reforger_queue_read.py --image /path/to/screenshot.png --show-crop --debug
|
|
```
|
|
|
|
Use Spectacle/KDE screen capture:
|
|
|
|
```bash
|
|
uv run reforger_queue_read.py --capture --screen DP-3 --show-crop --debug
|
|
```
|
|
|
|
Use an OBS scene screenshot:
|
|
|
|
```bash
|
|
uv run reforger_queue_read.py --obs-scene APT --show-crop --debug
|
|
```
|
|
|
|
Validate the regression set:
|
|
|
|
```bash
|
|
uv run reforger_queue_read.py --dataset datasets/regression-test-set --expect-filenames
|
|
```
|
|
|
|
Expected current result:
|
|
|
|
```text
|
|
summary: 21 passed, 0 failed
|
|
```
|
|
|
|
Validate the smaller included dataset:
|
|
|
|
```bash
|
|
uv run reforger_queue_read.py --dataset datasets/scootz-dataset --show-crop
|
|
```
|
|
|
|
Expected current output:
|
|
|
|
```text
|
|
datasets/scootz-dataset/1920x1080.png crop=788,465,75,45
|
|
datasets/scootz-dataset/1920x1080.png 22
|
|
datasets/scootz-dataset/2160x1440.png crop=1050,620,100,60
|
|
datasets/scootz-dataset/2160x1440.png 24
|
|
```
|
|
|
|
## Notes
|
|
|
|
Default crop reference:
|
|
|
|
```text
|
|
reference-size: 2560x1440
|
|
reference-crop: 1050,620,100,60
|
|
scale-mode: width
|
|
```
|
|
|
|
Portal/PipeWire is easiest to install, but restore behavior depends on the desktop portal. If the selected window disappears after an Arma restart, the portal may show the picker again.
|
|
|
|
KWin mode is the best KDE automation path, but it has the extra authorization install step.
|