{"id":20828933,"url":"https://github.com/darvid/stashvision","last_synced_at":"2026-02-12T07:36:41.660Z","repository":{"id":57497279,"uuid":"210192895","full_name":"darvid/stashvision","owner":"darvid","description":"⚔️ A private stash indexing tool and in-game item highlighting overlay for Path of Exile. 🗡️🧰","archived":false,"fork":false,"pushed_at":"2023-02-25T04:01:31.000Z","size":13027,"stargazers_count":19,"open_issues_count":11,"forks_count":4,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-09-12T04:16:09.649Z","etag":null,"topics":["pathofexile"],"latest_commit_sha":null,"homepage":"","language":"AutoHotkey","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/darvid.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-09-22T18:12:35.000Z","updated_at":"2024-06-23T00:25:38.000Z","dependencies_parsed_at":"2024-06-20T06:07:43.149Z","dependency_job_id":null,"html_url":"https://github.com/darvid/stashvision","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/darvid/stashvision","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darvid%2Fstashvision","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darvid%2Fstashvision/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darvid%2Fstashvision/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darvid%2Fstashvision/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/darvid","download_url":"https://codeload.github.com/darvid/stashvision/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darvid%2Fstashvision/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29361617,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-12T01:03:07.613Z","status":"online","status_checked_at":"2026-02-12T02:00:06.911Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["pathofexile"],"created_at":"2024-11-17T23:18:55.232Z","updated_at":"2026-02-12T07:36:41.646Z","avatar_url":"https://github.com/darvid.png","language":"AutoHotkey","funding_links":[],"categories":[],"sub_categories":[],"readme":"# stashvision\n\n![unsplash.com/@romankraft](splash.jpg)\n\nStashvision is a **proof-of-concept** private stash indexing tool and\noverlay for [Path of Exile][1].\n\n## Rationale\n\n### Better search\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://i.imgur.com/gunkgNe.png\"\u003e\n\u003c/p\u003e\n\nNaive stash searching is something many players have complained about\nover the years, with few solutions other than just dealing with it until\nGGG develops more powerful searching functionality.\n\nA number of open source tools exist for searching the stash locally,\noutside of the game, but it's just as painful having to lookup the item\nposition in-game.\n\n### Recipe discovery\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://i.imgur.com/LfK4nuu.png\"\u003e\n\u003c/p\u003e\n\nChaos recipes are great for passively making currency, but a time\ninvestment trade-off must be made; either play stash tab tetris prior\nto mapping in an effort to \"optimize\" rapid stashing of items\npost-grind, or spend a considerable amount of time (only after your\ntab(s) are full, granted) searching for the right item classes for each\nset.\n\nMaybe GGG will implement some form of a premium recipe fulfilling tab\nin the distant dystopian future, but until then, the only way to truly\noptimize vendor recipe discovery (WITHOUT buying 10 quad tabs) is to\naugment your brain with an AI implant, improving chaos recipe item\nrecognition by a factor of 10. As an added bonus, the AI will be able\nto discern what killed you in Blight encounters when your screen looks\nlike a bowl of spaghetti.\n\nOr just use **Stashvision**.\n\n---\n\n**Stashvision** provides a stash tab item indexing framework and CLI\nutility for indexing, querying, and recipe scanning your private stash\ntabs, as well as an AutoHotkey-based overlay that highlights the items\nat the press of a hotkey.\n\n**No auto-clicking is involved, so Stashvision should be 100% ToS\ncompliant.**\n\n## Features\n\n* Private stash tab indexing and full-text search (powered by [Bleve][3]).\n* Customizable stash tab item highlighting for search results and recipes.\n* Portable as heck, the user is not expected to install any developer\n  frameworks or runtimes other than [AutoHotkey][4], which many PoE players\n  have installed regardless for [PoE-TradeMacro][5].\n* Non-intrusive to the game client. Completely hotkey-driven, and\n  absolutely no auto-clicking.\n\n## Caveats\n\n* Avoid manipulating your stash tabs (or at least the one being scanned)\n  excessively, as updates are nowhere close to real-time. For chaos\n  recipes, the ideal workflow would be to start with a full quad tab,\n  highlight the recipe, move items from the stash to your inventory,\n  vendor, cycle to the next set of items, rinse and repeat, all without\n  moving any items around, or adding new ones to the stash tab.\n* The overlay only works if your game is running in windowed borderless\n  mode. The language will also likely need to be set to English, much\n  like PoE-TradeMacro and other tools that consume PoE's stash API.\n\n## Screenshots\n\n![Search capability](screenshot-search-1.png)\n![Chaos recipe highlighting](screenshot-chaosrecipe-1.png)\n\n## Quickstart\n\n1. Download the **current version** of [AutoHotkey][4] (not V2).\n2. Download and extract the [latest release][6] of **Stashvision**.\n3. Copy `stashvision.ini.example` to `stashvision.ini`, and fill in your\n   POESESSID, account name, and any other desired configuration.\n3. Run `stashvision.ahk`.\n\n**Note:** Ensure your game client is running in *borderless mode*, and\nthe language is set to *English*.\n\n## Default Hotkeys\n\n**shift + alt + c**:\n    Highlight chaos recipe in configured stash tab. Subsequent triggers\n    will cycle through multiple recipe item sets. After all sets have\n    been cycled through, a new index scan will occur.\n\n**shift + alt + s**:\n    Search and highlight items in configured stash tab.\n\n**escape**:\n    Close the overlay or search window.\n\n## Configuration (``stashvision.ini``)\n\n#### Account settings\n\n```ini\n[General]\nSessionId = xxx\nAccountName = xxx\n```\n\n**SessionId** is your **POESESSID**.\n\n### Stash settings\n\n```ini\n[Stash]\nDumpTabIndex = 0\nDumpTabQuad = true\n```\n\nCurrently, Stashvision only supports searching and highlighting one tab\nat a time.\n\n### Display\n\n```ini\n[Display]\nDefaultHighlightBorder = 0xff1aff1a\n```\n\nExpected color code format is AARRGGBB.\n\n### Hotkeys\n\n```ini\n[Bindings]\nChaosRecipe = +!c\nSearch = +!s\n```\n\nSee AutoHotkey's documentation on [hotkey modifier symbols][7] for more\ninformation.\n\n## Indexer application\n\n**Stashvision** provides a Golang-based indexer application that can be\ninvoked separately from the AutoHotkey script, to manually manage a\nlocal index, search for items, or scan a stash index for sets of items\nthat meet vendor recipe criteria.\n\n```\n$ ./stashvision.exe\nstashvision - Index and analyze your Path of Exile stash.\n\ncommands:\n  q, query     query stash items index\n  r, recipe    evaluate recipes against index\n  s, server    run stash indexing server\n\nusage:\n  stashvision query [--json] -s=\u003cquerystring\u003e\n  stashvision server -s=\u003cpoesessionid\u003e -a=\u003caccount_name\u003e\n\narguments:\n  --help             show this screen\n  --version          show version\n\n```\n\n## Search\n\nSee [Bleve's query string syntax][3] for specifics about query string\nformat. Features at a glance include:\n\n* Boolean queries (prefix items with `+` or `-`)\n* Phrase queries (quote phrases with double quotes)\n* Numeric queries (e.g. `field:\u003e8`, `field:\u003c=9`, or `field:10`)\n\nIn addition to robust searching capability, **Stashvision** adds a\nnumber of fields to item metadata that are not easily searchable\nin-game.\n\n**Note:** Due to shortcomings of the indexing library used, Stashvision\nstores boolean fields as integers. So a query string for\n`identified:true` should actually be `identified:1`.\n\n### Fields\n\n```\nclass\ncorrupted\nframeType\nh\nicon\nid\nidentified\nilvl\ninventoryId\nleague\nname\nnumLinks\nnumSockets\nproperties\ntabIndex\ntypeLine\nverified\nw\nx\ny\n```\n\n### Convenience fields\n\n**class**:\n    The class name of an item, e.g. *Gloves*, *Body Armour*, or *Boots*.\n\n**numSockets**:\n    The total number of sockets on an item.\n\n**numLinks**:\n    The name is a bit of a misnomer, as this is really just the *maximum\n    number of links across all socket groups*.\n\n\n## Roadmap\n\nIn no particular order...\n\n* Settings GUI\n* Autocomplete search\n* OAuth\n* Multiple stash tab support\n* Detect in-game stash tab state non-intrusively\n* More vendor recipe support\n* Automatically find item sets (i.e. ring + ring + amulet) that fulfill\n  missing resistance values\n* Total potential chaos recipe reward displayed as another overlay\n\n\n[1]: http://pathofexile.com/\n[2]: https://pathofexile.gamepedia.com/Vendor_recipe_system#Full_Rare_Sets\n[3]: https://blevesearch.com/docs/Query-String-Query/\n[4]: https://www.autohotkey.com/\n[5]: https://poe-trademacro.github.io\n[6]: https://github.com/darvid/stashvision/releases/latest\n[7]: https://www.autohotkey.com/docs/Hotkeys.htm#Symbols\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdarvid%2Fstashvision","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdarvid%2Fstashvision","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdarvid%2Fstashvision/lists"}