This is a native macOS (Apple Silicon) port of Path of Building Community for Path of Exile 2.
It keeps the original Lua application and the entire calculation engine unchanged — every offence/defence calculation, the passive tree, items, skills and import/export logic are identical to the upstream project. Only the Windows-only SimpleGraphic runtime has been replaced with a native macOS host (SDL3 + LuaJIT + a bitmap font/DDS renderer) — originally created by stevep51 — so it runs as a real .app instead of through Wine/CrossOver or the Windows .exe. See Credits.
Download the latest release — grab PathOfBuilding-PoE2-macos-arm64.zip from the assets, unzip, and move Path of Building (PoE2).app to your Applications folder. See Install below for the first-launch (Gatekeeper) step.
- Apple Silicon Mac (arm64)
- macOS 13 (Ventura) or newer
Download the latest PathOfBuilding-PoE2-macos-arm64.zip from the Releases page, unzip it, and move Path of Building (PoE2).app to your Applications folder. On first launch, macOS Gatekeeper may require you to right‑click the app and choose Open (it is not notarized).
Your builds and settings are stored under:
~/Library/Application Support/Path of Building (PoE2)/
Yes — and you don't have to take that on faith. This app talks only to
Grinding Gear Games' official servers, has no telemetry, and never sends your
account, tokens, or builds to anyone. Sign-in is optional and uses the standard
OAuth + PKCE flow: you log in on pathofexile.com in your browser, and the app
never sees your password. See SECURITY.md for the full
breakdown (including how to verify or build the app yourself).
- Comprehensive offence + defence calculations:
- Calculate your skill DPS, damage over time, life/mana/ES totals and much more!
- Can factor in auras, buffs, charges, curses, monster resistances and more, to estimate your effective DPS
- Also calculates life/mana reservations
- Shows a summary of character stats in the side bar, as well as a detailed calculations breakdown tab
- Supports all skills and support gems, and most passives and item modifiers
- Full support for minions, party play and support builds
- Passive skill tree planner:
- Support for jewels including most radius/conversion and timeless jewels
- Alternate path tracing (mouse over a sequence of nodes while holding shift, then click to allocate them all)
- Fully integrated with the offence/defence calculations
- Can import PathOfExile.com and PoEPlanner.com passive tree links
- Skill planner: add any number of main or supporting skills; toggle auras/curses/buffs on and off
- Item planner: paste items straight from the game, search trade, craft items, and browse a unique/rare database
- Import your characters directly from your Path of Exile account (OAuth sign-in)
- Share builds with other Path of Building users via build codes
See docs/macos.md for full build/package instructions. In short:
brew install cmake ninja sdl3 luajit curl zlib zstd
tools/macos/build_app.sh # builds build/macos-arm64/PathOfBuilding-PoE2.app
tools/macos/package_app.sh # produces dist/macos-arm64/PathOfBuilding-PoE2-macos-arm64.zipThe calculation engine, data, passive tree, skills, items and UI logic are unchanged. The changes below are what make it run natively on macOS:
- Native macOS host (
macos/) replaces the Windows-only SimpleGraphic runtime: a Cocoa + SDL3 window with layer-correct draw ordering, a bitmap font renderer, DDS/TGA texture decoders, libcurl-backed HTTPS downloads, a loopback OAuth sign-in server, and background sub-scripts. The app loads its bundled Lua from inside the.app(Contents/Resources), falling back to the source tree when run from a checkout. - macOS-native conventions: keyboard shortcuts use
Cmd(e.g.Cmd+1–7 to switch tabs,Cmd+S to save,Cmd+`for the console), and user data is stored under~/Library/Application Support/Path of Building (PoE2)/instead of the Windows path. - Windows runtime removed: the
.exe/.dllbinaries are not shipped. Only the shared Lua sources, fonts (runtime/SimpleGraphic/Fonts) and Lua libraries (runtime/lua) are retained. - Updates: the in-app updater works just like the Windows build — the same update toast and green "Update Ready" button, checked on startup, periodically, and via Check for Update — but it tracks this port's GitHub Releases (the app ships as a whole
.app, so there's no Windows-style file updater). When a newer build is found it downloads it, verifies it against the published SHA-256, swaps the app in place, and restarts. See SECURITY.md for how the checksum verification works. The About dialog links to this repository. - Versioning: releases keep the upstream engine version and add a macOS build counter (e.g. tag
v0.16.0-macos.1), shown in-app asVersion: 0.16.0abovemacOS Port (build 1). See RELEASE.md for the scheme.
- macOS-port changes — see the GitHub Releases.
- Engine changes — tracked upstream.
See CHANGELOG.md for where each kind of change is recorded.
This distribution stands on the work of others:
- Path of Building Community — created and maintain Path of Building and the Path of Exile 2 fork. All calculation logic, data, the passive tree, items, skills and UI are theirs.
- stevep51 — created the native macOS host (SDL3 + LuaJIT + bitmap-font/DDS renderer) that replaces the Windows-only SimpleGraphic runtime. This port is built directly on that work, which did the heavy lifting of the engine port.
- This repository (jacul/PathOfBuilding-PoE2-MacOS) packages the above — tracking the latest upstream Path of Building engine version, adding macOS host fixes (e.g. DDS texture-array / non-square sheet support for the passive tree), and adding a macOS-specific in-app updater (a native GitHub-release check that downloads, verifies, and swaps the
.appin place, reusing the app's normal update toast and "Update Ready" button).
For 3rd-party licences, see LICENSE. The licensing information is considered to be part of the documentation.