Several ePOE tools read a small patch of the screen rather than the clipboard: the Well of Souls revealed-tier read, Rune Scout, the Ritual Loot scanner, the Expedition Rumour, Remnant and Chain readers, Map Mods, the Sales History panel scan, and the stash-open and slot-hover helpers. That reading is done with OCR, optical character recognition, and it works on Linux as well as Windows.
Three engines, chosen for you
ePOE carries three text-recognition engines behind one service and picks between them automatically. There is nothing to set up.
- Windows OCR — the recognition built into Windows. It is fast, needs no download, and is the default on Windows.
- Tesseract — a bundled engine (about 6 MB, with OpenCV) that runs inside the app on any system. It reads Thai, which Windows OCR can't, and steps in on Windows if the built-in engine can't start.
- ONNX — a modern recognition model (PP-OCRv5) for Windows and Linux on 64-bit PCs. Its models for your game's language download the first time they are needed and are checked before use.
How the choice is made:
| Your PC | What reads the screen |
|---|---|
| Windows | Windows OCR, or Tesseract for Thai |
| Linux | ONNX once its models for your game's language are downloaded; Tesseract until then, or if ONNX ever fails |
Either way the tools, their hotkeys and their pages behave the same. All three engines report where each word sits on screen, so highlights and badges line up on Linux too.
It reads your game's language
The scanners read in the language your game client is set to, not the language ePOE's interface is in. ePOE takes it from the game's own settings file (Documents\My Games\Path of Exile 2\poe2_production_Config.ini) and falls back to English when it can't find one. Change the game's language and the scanners follow on their next read.
On Windows, Windows OCR needs the Windows language pack for that language. Without it, it reads in English and ePOE tells you once per session how to add the pack. Thai always goes to Tesseract, whose Thai model downloads the first time it is needed.
Picking an engine yourself
There is no switch in Settings, and almost nobody needs one. If you are troubleshooting, the ocrBackend value in ePOE's config file can be set to auto (the default), winrt (Windows OCR), tesseract or onnx. A forced ONNX that can't run yet, for example while its models are still downloading, reads with the automatic choice until it can.
The engine choice belongs to this PC. It is one of the settings Cloud Settings Sync never carries to your other machines.
The bundled files
A normal installed build ships with Tesseract's files, so it just works. They are only ever missing in a bare development checkout. Then Windows quietly uses its built-in OCR, and on Linux the scanners use ONNX if its models are ready, or say they couldn't read the screen.
It never reads game memory
Whichever engine runs, OCR only ever looks at a bounded region of the screen that ePOE captures and reads on your own machine. It does not touch Path of Exile's memory. The captured pixels stay on your PC, unless you choose to send one misread panel with Send This Failed Read (see Telemetry and Sharing Perks).
Related
- Well of Souls, Rune Scout and Ritual Loot scanner — scanners this powers.
- Sales History — the Scan Panel reader.