Repository navigation
Releases
1.0.10
🚀 Improvements
- Added an auto-restart on crash setting. When the app crashes, a hidden PowerShell watchdog now restarts it automatically.
- OCR, window detection, and overlay services no longer run at the same time, reducing the chance of crashes happening.
- Added a native crash handler that captures crash details with register dumps and callstacks to a
*-native-crash.txtfile in the logs folder. - Debug overlay no longer stays visible when tabbing out of the game.
- OCR now pauses when PoE2 isn't the active window and resumes again when the PoE2 window is active.
- Switching OCR backends no longer leaves behind stale engine handles - the engines are now properly cleaned up and re-created when toggling between backends.
🐛 Bug Fixes
- Fixed #18: consolidated
Bitmap.LockBitscalls in the capture pipeline from 3 down to 1, which prevents theACCESS_VIOLATIONcrash. Also replaced allProcess.GetProcessescalls with Win32 APIs, which is faster and safer.
Full Changelog: 1.0.9...1.0.10
1.0.9
🚀 Improvements
- The "Some items can't be priced" message now renders at a smaller font size so all three banner messages fit inside the banner box, if they're all displayed at the same time (the map settings previously would get cut off if rendered alongside that message). The low trade volume warning is now displayed in yellow (matching the pricing overlay) instead of orange.
- Trade volume related settings are now disabled and dimmed when
poe.ninjais selected as the pricing source, with a red warning, indicating thatpoe.ninjadoesn't support them.
🐛 Bug Fixes
- Fixed #9: The "No personal information is collected" message on the bug report panel now notes that your Windows profile username may appear in some debug log entries. The username has also been removed from some log entries where its not needed.
- Fixed #10: The black pixel detection threshold in OCR processing is now stricter at resolutions of 1440p and above, reducing the frequency that runes are detected as text. In the case that runes are detected on the left side of the interface, they're now correctly rejected during the OCR step, so only real item text gets matched with prices.
- The update button now looks smoother around the edges and no longer overlaps the bug report icon. The updating x% text also no longer overlaps the bug report icon.
Full Changelog: 1.0.8...1.0.9
1.0.8
✨ What's New
- Trade volume warnings — Items with low trade volume are now highlighted with an orange warning icon and items with very low trade volume are highlighted with a red warning icon. You can turn the warnings on or off in settings, choose whether the price text color matches the warning color, and decide whether a map shows up for low-volume items. This only works with poe2scout. poe.ninja does not provide item volume information.
🚀 Improvements
- Pricing source display — The warning banner now shows which pricing source is being used (
poe.ninjaorpoe2scout).
🐛 Bug Fixes
- Fixed #9: the app now reads the correct Path of Exile 2 config file currently being used by the game, even if you have other config files under different user directories.
- Fixed #10: item row detection now correctly starts from the right position and no longer picks up rune icons as rows on higher resolutions. Orange boxes on the debug overlay indicate rows that have been picked up, but have been rejected because they're not at the right position.
- Fixed banner message scaling to match the pricing overlay font and icon sizing. Also added an orange box indicating where the banner message renders on the debug overlay.
- Removed redundant right and horizontal yellow dashed lines from the debug overlay — only the left vertical marker is needed.
- The
OverlayScalesetting was moved from theAppsection to theOCRsection in the config file. It will be migrated automatically on first launch after updating.
Full Changelog: 1.0.7...1.0.8
1.0.7
✨ What's New
- Bug report tool — Click the 🐛 icon in the app to automatically collect logs, crash reports, debug images, and system info into a
.zipfile. The tool guides you through reproducing the issue, then opens a pre-filled github issue and the folder containing the zip. Settings are snapshotted before enabling diagnostic mode and restored when done. In-case the app crashes or is closed during the bug report process, your settings are backed up before-hand and restored when the app next launches. - Dynamic log level — Changing
Log Levelin settings now takes effect immediately without needing to restart the app. - Pricing source warning — A yellow
⚠️ warning appears next toPricing Sourcewhenpoe.ninjais selected, noting thatpoe2scoutprovides more reliable pricing.
🚀 Improvements
- Anchor check hit rate — The debug panel now shows the league panel anchor-detection success rate, replacing the redundant overlay FPS counter that just mirrored the scans per second value.
🐛 Bug Fixes
- Fixed #6: a race condition in
BannerFormthat could cause a silent crash when displaying the unpriceable-items banner for skill gems. Also addedApplication.ThreadExceptionhandler so all WinForms UI thread exceptions, like this one, are correctly logged into a crash file. - Fixed #7: OCR row detection was inconsistent when the debug overlay was turned on — the yellow scan brackets were shifting row boundaries, and the wide scan region was picking up some rune icons as text. The brackets are now filtered out before OCR, and the scan area is narrowed to exclude rune icons (also slightly reducing CPU usage). The actual scan start area is now indicated by a yellow dashed line on the debug overlay.
Full Changelog: 1.0.6...1.0.7
1.0.6
✨ What's New
- Crash reporting — If the app crashes, a detailed crash log is now written to
logs/*-crash.txtwith the exception type, stack trace, system info (PID, OS, CLR version), and working set. This helps diagnose issues without needing to reproduce them. - Caught exception logging — Recoverable errors (e.g., background task failures) are logged to
logs/*-caught.txt, separate from crash logs.
🚀 Improvements
- Multi-user config support — The app now finds your PoE2 config file regardless of which Windows user profile it's in (handles multi-user setups and non-standard installs). It picks the most recently modified config automatically.
- Logging added across the codebase — Added
Trace/Debuglogging to the overlay rendering pipeline, OCR row detection, Lossless Scaling detection, config file watching, pricing source routing, and RPC service, making it easier to track down issues. - Disk I/O added to performance metrics — The debug panel now shows real-time disk read/write throughput in the System section.
🐛 Bug Fixes
- Fixed a regression where a corrupt
appsettings.jsonwould crash the app at startup instead of recovering with defaults. - The window resolution monitor was leaking process handles every ~1 second by not disposing
Processobjects fromGetProcesses(). Over a long play session this could accumulate into thousands of leaked handles. - The
RemoveIsolatedBlackNoisepreprocessing step was counting isolated black pixels but never actually clearing them, rendering the entire noise-reduction pass ineffective. This caused false text detections on noisy or high-contrast backgrounds. - The banner overlay form could crash when being hidden from a background thread due to a WinForms cross-thread operation. The form now dispatches boundary updates to the correct thread.
- The View Changelog button now works correctly.
Full Changelog: 1.0.5...1.0.6
1.0.5
✨ What's New
- Overlay text scaling — Overlay font sizes now scale proportionally to your game window height. Added a new
Overlay Scalesetting next toScan Intervalin the OCR section (auto or manual 0.5x–4.0x)
🐛 Bug Fixes
- The league panel will now be correctly detected when only 1 or 2 items with short names appear in the list
- The
Bring to foregroundsetting was sometimes not being respected, it should now always work as intended - In the metrics panel, 'Not active' next to Window is now red instead of amber, matching the color for 'Not visible' next to Interface and 'Not running' next to Lossless Scaling
1.0.4 has been skipped and was deleted soon after publish as there was a windows foreground bug causing the app to never come to the front when clicked on in that release
Full Changelog: 1.0.3...1.0.5
1.0.3
If you have the 'Open with PoE2' setting enabled, you need to disable it first before trying to update to this version, otherwise the update may fail
✨ What's New
- Auto price thresholds — The app can now automatically calculate price colors based on the items detected in each scan. When enabled, the highest-priced item sets the range, so expensive items show as green and cheaper items show as red or orange. Find the toggle in Settings → Pricing. This is enabled by default.
🐛 Bug Fixes
- The overlay colors now correctly match item prices when using exalt display mode. This wasn't always working correctly before and was sometimes using chaos instead of exalt.
- The app now properly handles cases where the game language can't be detected from the config file, instead of defaulting to English incorrectly.
- Memory in performance metrics now indicates the true memory usage of the app, the value was incorrect before.
- Window in performance metrics now immediately updates its value, it previously only did so when an OCR scan happened.
- Icons in performance metrics are now correct, bullet points were incorrectly showing instead of ticks for some fields before.
- The app UI will no longer temporarily freeze every 1-2 seconds to update the performance metrics. This is now done in the background on a different thread.
- The auto-updater should no longer sometimes fail due to an interaction with the 'Open with PoE2' setting.
- All text fields on the performance metrics page should now correctly fit inside their appropriate bounds. A couple of them were trying to render outside of their bounds before, causing the text to be cut off.
- The images that get sent to OCR now have less artifacting in the background for very long item names, allowing the text to match with the correct item more often.
Full Changelog: 1.0.2...1.0.3
This will probably be the last version for a while, as I've done all I want to in the PoE2 league. I'll likely come back and improve the tool further during the next league.
1.0.2
✨ What's New
- Multi-language item name translation — The app now supports item names in 7 new languages: Chinese Traditional, German, French, Korean, Portuguese, Russian, and Spanish. OCR-detected names are automatically translated to English for pricing lookups. Your game client can be in any of these languages, the app will automatically detect it and translate from your set language to English to lookup item prices. The translation data is from https://github.com/Kvan7/Exiled-Exchange-2 I did try for a long time to add Japanese, but couldn't figure it out. Russian and Korean do not work well at all with Windows OCR, even with the language packs, so they've been locked to only being usable with Tesseract for now.
- Performance metrics panel — Click the lightning bolt (⚡) to open a real-time dashboard which opens alongside the log / settings panel, showing OCR timing breakdowns, scans per second, cache hit rate, CPU and memory usage and a lot of other data. There's a
Copybutton lets you export the data, helpful for submitting bugs if you're having performance issues. - Open with PoE2 setting — A background watcher (
RPCService) that automatically launches the app when Path of Exile 2 starts. It also registers itself to start with Windows, so the setting persists across PC restarts. The service doesn't negatively affect performance at all. - Close with PoE2 setting — Automatically close the app when exiting Path of Exile 2.
- Always on top setting — Keep the app window above all other windows.
- Bring to foreground setting — Auto-focus the app window when launched.
- Capture mode setting — Choose between
PrintWindow(faster, slightly higher CPU) andDesktop(slower, lower CPU, compatible with Lossless Scaling). Nothing new was added here, this just allows you to modify the capture mode yourself, instead of the app deciding on the capture mode for you. HavingLossless Scalingrunning will lock the capture mode to Desktop because thePrintWindowmethod causes frame pacing issues with it. - Scan interval setting — Control the target scan rate directly (50–200ms range). Lower values update prices faster, higher values reduce CPU usage.
- Dynamic rate targeting — The engine automatically adjusts the timing between scans to account for how long OCR actually takes, so the effective scan rate stays close to your configured target even when recognition times vary. Without this, a slow OCR frame would push back the next scan, making the actual rate slower than what you set. This was previously just a flat value of 50 milliseconds, which meant scans per second could only reach around 15 at the most.
- Auto saving settings — Settings now save automatically as soon as they're changed.
- OCR language pack warnings — If a Windows OCR language pack isn't installed for your selected language and you're using Windows OCR, a banner appears with a link to install it or switch to Tesseract.
🚀 Performance
- Improved performance with league panel closed — In versions
1.0.0and1.0.1, the full OCR cycle was incorrectly running before the league panel detection was running, causing much more performance loss than intended. League panel detection has also been improved to use less CPU. CPU usage while testing went from 4-6% while in a map with no league panel open to 0.5-1.5% after these changes.
🛠️ Improvements & Polish
- Simplified OCR capture mode logic — removed
bitbltas it doesn't work with PoE2, and was always falling back to using alternative modes anyway. It was essentially just dead code worsening performance - Changed tooltip icon from the emoji 🛈 to a themed
?with improved opacity and alignment - Added a log button (📋) next to the settings gear to access the log panel
- The log button and settings button are now highlighted while on those windows
- Reorganised and improved the layout of the settings panel
- The height of the app has been locked to 652px so that the UI always renders consistently, and in the correct place.
- The checkbox hover areas in the settings panel now extend across the full row, including the small gap between the text and the checkbox, so clicking the gap between the checkbox and its label is properly recognized as a click instead of being ignored.
⚠️ Notes
- The separate
Update.exeis no longer included — the auto-updater should handle the transition tov1.0.2without issue. Future updates use PowerShell exclusively. - If your game language has no translation data, a banner appears in the dashboard letting you know.
Full Changelog: 1.0.1...1.0.2
Edit: Fixed a markdown issue with the changelog which was preventing the app from loading the changelog for 1.0.2.
1.0.1
✨ What's New
- Windows OCR — The tool now uses Windows' built-in OCR engine by default instead of
Tesseract. Over three times as fast, zero external dependencies, and much lower CPU usage. Requires Windows 10 version 1809 or later; older versions automatically fall back toTesseract. You can switch between the two anytime inSettings. Item Name Translation — PlayingThis isn't currently working as intended for all languages, it will be fixed in the next release.Path of Exile 2in a language other than English? The tool now translates item names automatically using the official trade API. Your game client can be in French, German, Spanish, Portuguese, Thai, Korean, Japanese, or Traditional Chinese — prices still work.- Auto-Update Overhaul — The updater no longer depends on a separate
Update.exe. Updates are now handled by aPowerShellscript, which works on every Windows system without requiring .NET to be installed.Update.exeis still included in1.0.1for backwards compatibility, but will be dropped in the next release.
🚀 Performance
- Dozens of small optimizations — the app now skips OCR work when nothing changes on screen, plus faster image processing, lighter memory allocations, and smarter capture logic throughout.
- Quick summary — there's a lot of technical detail below for those interested, but the headline numbers are:
- Scrolling CPU: 6.2% → 3.2% (nearly halved)
- Stationary CPU: 6.7% → 1.6% (76% reduction)
- Single-frame OCR: 172ms → 48ms (3.6x faster)
- Idle CPU: ~0.3% either way (already near zero)
- Scan frequency: previously capped at 6 scans/sec by Tesseract (170ms per frame plus overhead). Now the tool completes a full cycle in ~50ms (48ms Windows OCR + ~2ms overhead), delivering 20 scans per second — all while using significantly less CPU.
📊 Technical Details
Why Windows OCR over Tesseract
Windows.Media.Ocr is a built-in Windows 10+ component — no NuGet packages, no native DLLs, no traineddata files to manage. It recognizes text in ~48ms per frame vs ~172ms for Tesseract (3.6x faster). The binarized game-text images are an ideal input for Windows OCR's neural model, which was trained on a broad corpus of fonts and sizes. Tesseract remains available as a fallback for older Windows versions and non-English languages.
Frame differencing
A sparse-pixel hash (1 sample per 32 pixels) is computed row-by-row via LockBits with a ~2KB temporary buffer. When two consecutive captures produce the same hash, the entire OCR pipeline is skipped — only the GDI screen capture (CopyFromScreen), hash comparison, and league panel detection run each cycle. This eliminates ~76% of CPU usage when viewing a stationary panel.
Image processing pipeline
- Content-aware crop: the binarized image is scanned for the bounding box of black pixels, cropping away empty margins. Typical area reduction is ≥20%, directly reducing the pixel count fed into OCR.
- BMP Pix creation: Tesseract's native image format (Leptonica Pix) is constructed by writing a 54-byte BMP header + raw pixel rows directly to a byte array, avoiding the memory and CPU overhead of PNG/JPEG encode-decode round-trips.
- Direct pixel operations: upscaling uses nested
forloops with direct pixel replication instead ofGraphics.DrawImage. The white border pass fills edge pixels directly rather than clearing the entire surface. - Zero-allocation TSV parsing: Tesseract's TSV output is parsed with a manual span walker that identifies tab positions and slices substrings, avoiding the allocations of
string.Split.
Data pipeline
- StructLinq replaces all LINQ calls (
.Select,.Where,.ToArray,.Any,.Count) with zero-allocation struct enumerators, eliminating GC pressure from iterator allocations. - Pre-sized collections: arrays and lists are allocated with exact capacities computed in a counting pass, avoiding resize-and-copy overhead.
Capture and OCR orchestration
- Anchor pre-check: before a full GDI screen capture (~720 KB), a tiny anchor region (~2 KB) is sampled to check if the league panel is visible. If the panel isn't open, the full capture is skipped.
- Perf timing: a lightweight
Stopwatch-based accumulator tracks per-stage timings (capture, preprocessing, recognition, cache lookup) and logs averages every 20 cycles without measurable overhead. - Lossless Scaling compatibility: the capture method auto-detects whether Lossless Scaling is active and switches between
BitBltandCopyFromScreento minimize DWM frame-pacing disruption.
v1.0.0 → v1.0.1 (Tesseract baseline)
| Scenario | v1.0.0 (avg CPU) | v1.0.1 (avg CPU) | Change |
|---|---|---|---|
| Stationary | 6.74% | 1.62% | −76% |
| Scrolling | 6.59% | 6.54% | same |
| Idle | 0.37% | 0.30% | −18% |
v1.0.1: Tesseract vs Windows OCR
| Scenario | Tesseract (avg CPU) | Windows OCR (avg CPU) | Change |
|---|---|---|---|
| Stationary | 1.35% | 1.44% | same |
| Scrolling | 6.16% | 3.20% | −48% |
| Idle | 0.33% | 0.31% | same |
Single-frame recognition: Windows OCR 48ms vs Tesseract 172ms (3.6x faster). Windows OCR uses ~30 MB more memory for the WinRT engine's working set — a worthwhile trade for the CPU savings.
Stationary scenarios are dominated by the GDI CopyFromScreen capture and frame-differencing hash; OCR is cached after the first frame so the backend doesn't matter. At idle (game not foreground), OCR is paused entirely.
🐛 Bug Fixes
- Fixed log entries sometimes appearing blank on the first run
- Fixed log entries appearing in the wrong order during startup
- Fixed item names occasionally being cut short by one character during OCR
- Prices are now correctly re-fetched when changing the league
🛠️ Improvements & Polish
- Removed the redundant
Show Pricing OverlayandShow Banner Messagecheckboxes fromSettings— there's no reason to ever disable them. - Added tooltips to many more
Settingsitems and improved the look of the tooltip icon so it's easier to see against the background - Tooltips throughout
Settingsnow match the dark theme and have clearer, more helpful descriptions - The app now fades in on launch and no longer shows a brief white window when it starts
- The edges of the app window are now rounded
Hide when league panel not detectedandSave debug imagesnow only appear (and can only be enabled) whenShow debug overlayis checked- The
Settingswindow has been reorganized and improved in several places, so it looks neater - The app now has a fixed width — the width can no longer be resized, but the height still can be
- The app now prevents closing while auto updating, as doing so could cause corruption
⚠️ Notes
- Windows 10 version 1809 (build 17763) or later is required for Windows OCR. Older versions will use Tesseract automatically. Everyone on a supported version of Windows will be switched to Windows OCR — if you prefer Tesseract or if Windows isn't working for you, you can switch back in Settings.
- The tool can now be used on Windows 7, it previously required Windows 10. I can't guarantee it will work on versions before Windows 10, but I don't think there's anything preventing it from doing so.
- The separate
Update.exefile is no longer needed and will be removed in 1.0.2. Updates are now handled entirely by PowerShell. The file still needs to be included in this release for backwards compatibility.
Full Changelog: 1.0.0...1.0.1
1.0.0
✨ What's New
- Dashboard — A new window for the tool that replaces the old console window. You can now see logs, change settings, and view update notes all in one place. The Dashboard opens automatically when you start the app.
- Settings Panel — Change your pricing thresholds, preferred currency, OCR language, overlay options, and more through the Dashboard instead of editing config files by hand.
- First-Run Setup — When you use the tool for the first time, it now guides you through positioning the overlay correctly. No more guessing where to place things — just follow the on-screen instructions.
- Changelog After Updates — When a new version is installed, a changelog window appears in the Dashboard showing what changed. No more checking GitHub to see what's new.
- Better Prices — The tool now uses Poe2Scout as its main pricing source, with PoeNinja as a backup. Poe2Scout prices are averaged over 24 hours, giving more stable values. PoeNinja only provides the latest prices, which can fluctuate wildly.
- Language Switching — Changing the OCR language now takes effect right away without restarting the app.
- .NET 8 now included — .NET 8 no longer needs to be installed, its now contained within the app.
🐛 Bug Fixes
- Several item types that were missing prices now show them correctly.
- If the tool's language data file (
eng.traineddata) gets corrupted, it now detects this and repairs itself automatically. - The updater now handles errors more gracefully instead of silently failing.
✅ Testing
- The test suite has been fully rebuilt with automated tests covering all major features. These tests run on every release build, which means fewer bugs make it into releases.
Full Changelog: 0.2.2...1.0.0
Update 16/06: Was hoping to release 1.0.1 today but ran out of time for testing, will release it sometime tomorrow.