PathOfPriceCheck

A native, lightweight Path of Exile price-check overlay - C++20 and Dear ImGui on SDL3. No Electron, no bundled browser, no wrapper runtime.

Hover an item in game, press the hotkey. The tool copies it, parses it, prices it against the official trade API, poe.ninja and GGG's own in-game currency exchange, and draws the result over the game in the game's own typeface.

Early development. It works and it is used daily, but interfaces, settings and the panel layout all still move. Issues are very welcome; pull requests are not being accepted yet - see CONTRIBUTING.md.

• One hotkey. Ctrl+D over an item: the game's copy shortcut is synthesized for you, so there is no separate Ctrl+C to remember.
• Reads the item properly. Rarity, implicits, explicits, fractured, crafted, enchants, corruption, influences, quality - and the numbers the game leaves implicit, like quality-20 DPS and where a base's defences fall in their own roll range.
• Searches for what actually matters, and it is different for every kind of item. A rare is searched on its modifiers, bounded by the tier each one rolled. A unique is searched on the rolls that vary - including the ones that vary without printing a range, which needs a per-unique modifier dataset to know about. A white, magic or rare item can be priced as its base type with item level and influences. A map is searched on none of its affixes, because a Chaos Orb re-rolls them all: it goes on tier, quantity, pack size, the drop bonuses a chisel added and whether dying in it voids the character. A gem goes on its name, level and quality and no modifier at all.
• A reference price from poe.ninja for the things a stat query cannot answer: uniques, gems, currency, and base types. Variants are resolved from the modifiers the copy in your hand actually rolled, and where two candidates cannot be told apart the row says so instead of guessing.
• The in-game currency exchange, from GGG's own hourly digests. A stack of currency, a scarab, an essence or a divination card is not sold through listings at all, so the trade site has nothing to say about any of them - the search below the panel would not be empty, it would be the wrong question. For those the panel shows what the market actually cleared at: the volume-weighted average, the band around it, and the volume on both sides. Items that trade there get no Search button, and one that had no trade in the last hour says so rather than showing you nothing.
• QuickPaste. Alt+V opens your saved snippets at the cursor - a map regex, a vendor search, the whisper you send twenty times an evening. Pick one by clicking it or by pressing its number, and it is on your clipboard. It does not press Ctrl+V for you: you paste it yourself, in the field you meant, at your own time. Nine at a time, because that is how many number keys there are; keep as many as you like and switch them in and out in Settings.
• Listings you can read. Account, listing age and price, with the seller's own item drawn beside the list when you hover a row - through the same renderer as the item in your hand, so the comparison is like-for-like.
• Keeps itself up to date, on your terms. It checks for a new release in the background and applies it as you close the tool, so the next start is already the new version. It never restarts itself unasked and never closes over a running game - and the check is a static file download, not a phone-home. Turn it off in Settings.
• Polite to the APIs. GGG publishes its rate limits in every response header; those are parsed, tracked and waited on proactively, and the state survives a restart. Searching is a button, not something that fires on every hotkey press.

Everything here starts from the text the game writes to your clipboard, and every modifier is matched against the wording the client printed. Those wordings are language-specific, so a client set to another language produces item text this tool cannot parse - it will not mis-price an item, it simply will not recognise one.

This is a stretch goal, not a design limit, and the application side of it is now built. Every word the client prints - the section labels, the flag lines, the property names, the Advanced Mod Descriptions vocabulary - is read from a table rather than compared against a literal, English is one entry in that table, and Settings has a Client language row listing whatever the installed data bundle declares. There is one build for every language: what a language costs is a data release, not a separate download.

What is still missing is upstream. GGG ships localised stat-description files that the data builder does not yet fetch, so en is the only language any bundle declares and the row has one entry in it. Two smaller things follow that data rather than lead it: a unique's poe.ninja variant is still matched on the wording the client printed, and a weapon's DPS is still totalled from English modifier wordings, so both fall back to what a printed range can prove until there is a translated bundle to verify them against.

The application's own text - Settings, the panel, the buttons - is a separate setting (Interface, defaulting to whichever the client is) and a separate table. Only English is written so far. Translating it buys nothing toward reading a translated client, which is why the two are not one switch.

Grab the latest release.

Neither Windows download is code-signed, so SmartScreen says "Windows protected your PC" the first time you run one - More info → Run anyway. A certificate is a yearly fee, and this project charges nobody anything; what it offers instead is that every release is built in public by GitHub Actions from the source here, with a SHA-256 for each asset published beside it.

Both Linux builds are compiled against glibc 2.35 (Ubuntu 22.04, Debian 12) and neither can bundle glibc itself, so an older distribution than that needs a build from source. If the AppImage refuses to start with a FUSE error, your distribution no longer installs libfuse2: run it as ./PathOfPriceCheck-*.AppImage --appimage-extract-and-run, or install that package.

On first launch it downloads the game-data bundle (~4 MB) from PathOfPriceCheck-Data. Nothing is baked into the binary, which is why a new league needs a data build rather than a new release of this.

Then open Settings (Shift+Space by default) and pick your league.

Building from source: BUILDING.md, which carries per-distribution package lists for Arch, Debian/Ubuntu/Mint/Pop!_OS and Fedora, plus the Windows toolchain.

All three hotkeys are rebindable in Settings, and all three are ignored unless Path of Exile is the window in front - they are grabbed system-wide, so they must not go off in your browser.

QuickPaste's number keys go by the key's position, not by what your layout prints on it, so the top row works whatever keyboard you have.

The panel docks beside the frame the item came from: right of the stash, or left of the inventory, depending on which half of the screen your cursor was in. If it lands wrong, the stash and inventory edges are sliders in Settings - set them against the live game rather than off a screenshot.

CLAUDE.md and the docs/ it maps are the real design document - written for an AI assistant working in this repository, but the only place the hard parts are explained: why the clipboard is read by hand instead of through SDL, what Wine does with the X selection and how it is coaxed out of it, why quality is inverted the way it is, and which mistakes were already made and reverted.

No account, no telemetry, no analytics, no update ping, and no server on the other end - this project operates no backend at all. It talks to pathofexile.com, poe.ninja, GitHub and the PoE CDN, identifies itself in the User-Agent as the API policy asks, and stores its cache and settings under your usual config and cache directories. The clipboard is read only when you press the hotkey. The debug log, which records clipboard contents, is off by default. Full detail in PRIVACY.md.

MAJOR.MINOR.BUILD - MAJOR.MINOR lives in VERSION, BUILD is the cumulative CI run counter. A push to master is not a release: the Release workflow is run by hand, optionally carrying the MAJOR.MINOR bump with it, and publishes the Windows installer and zip, the Linux tarball and the AppImage together.

MIT - see LICENSE - and as otherwise stated by the attributed projects. The libraries, the game data, the poewiki modifier groupings (CC BY-NC 3.0, non-commercial) and the embedded Fontin typeface each keep their own terms; ATTRIBUTION.md lists every one of them.

Path of Exile is © Grinding Gear Games. This project is not affiliated with or endorsed by Grinding Gear Games in any way.