Installation

Windows

Download the latest release

Go to Releases and download the latest version installer.

Install AutoHotKey

Download AHK v2 from the official website.

Start the AHK shortcut

Run UniqueMatcher.exe, which generates a script for AHK and then use File > Start AHK script. The default shortcut is Win+S to make a screenshot in-game, you can change it using Edit > Change screenshot shortcut.

Linux

You need Python 3.11+ and Poetry.

1. Install poetry: pip3 install --user poetry (or any other way depending on your system)
2. Install project dependencies: poetry install --no-root
3. Enter Poetry shell: poetry shell or run the app: poetry run python3 main.py

Tesseract

This program requires tesseract to be available at your system. Refer to the official installation guide to install it.

On Fedora, just run sudo dnf install tesseract.

Setup screenshotting

This is very individual, but generally: add a global shortcut (most desktop environments should allow you to do this) that will take a screenshot and save it into the Unique Matcher's data/queue folder. This can be done using gnome-screenshot, scrot or any tool you use.

You can optionally use the Rust tool included in the project. Go into screen folder and run:

• cargo build --release
• cp target/release/screen ../ (the binary must be where pyproject.toml and the data folder is)

and then setup your shortcut to (cd ~/path/to/unique-matcher && ./screen).

Note

On Gnome/Wayland you'll have to endure the constant flash effect during screenshotting until this is fixed.