Download AHledger

1. 01The addon scansOpen the auction house; the addon reads every listing and keeps it in the game.
2. 02Saved to diskThe scan is written to the addon's saved-variables file on your machine.
3. 03Sync uploads itSync watches that file and sends each new scan to ahledger.com.
4. 04Prices come backThe latest price table for every market is written into the addon folder for the next /reload.

World of Warcraft addons cannot use the network. Blizzard's addon rules give them no way to send or receive anything, so an addon can only read and write files on your own disk. That is what keeps addons safe, and it is also why an addon by itself cannot share what it sees on the auction house or fetch what others have seen.

AHledger sync is the bridge. When the addon scans the auction house, it saves the listings to its saved-variables file. Sync watches that file, uploads each new scan to ahledger.com, and downloads the latest price table for every market back into the addon folder. The game reads that file at login or after /reload.

Contribution is on by default in the addon and can be turned off in its options. A scan holds item ids, quantities, buyout and bid prices, and the time, for one market. No character names, seller names, account details, or chat ever leave the game.

The people who scan the most are on the contributors page, ranked by the market hours their scans cover. Pick a name on your account page and you are on it.

1. Install the addon from CurseForge and log in once so it creates its saved-variables file.
2. On Windows, run the sync installer. SmartScreen may ask to confirm an app from a new publisher; choose More info, then Run anyway (see why scanners flag it). On a Mac, open the disk image and drag AHledger sync into Applications, then approve it once as described in opening sync on a Mac.
3. Open AHledger sync, press Detect, and pick the AHledger.lua it finds under your World of Warcraft folder. On a Mac, Detect looks in Applications; if the game is installed somewhere else, pick the file by hand.
4. Press Connect with ahledger.com. Your browser opens; sign in with your email and press Approve when the code matches the one in sync. Sync receives its own upload key, so there is nothing to copy. You can still create a key on the account page and enter it by hand.
5. That is all: once the key arrives, sync saves the settings and starts watching on its own. It uploads new scans as they happen and writes fresh price tables into the addon folder. Type /reload in game to pick them up. If you entered a key by hand, press Save and start instead.

Used sync during the beta? It is still watching the beta's file, which the game stopped writing at launch, so nothing uploads. Press Detect and pick the AHledger.lua under World of Warcraft\_forever_\WTF\Account\…\SavedVariables, then press Save and start. Install AHledger in the live game and log in once first, so that file exists. Sync 0.2.27 and later make the move on their own.

The Mac build is not yet signed with an Apple Developer ID, so macOS will not open it until you approve it once. It runs on macOS 11 or later, on Apple Silicon and Intel.

1. Open AHledger sync from Applications. macOS says it could not verify the app; choose Done.
2. Open System Settings, then Privacy & Security, and scroll down to Security. Next to the line about AHledger sync, choose Open Anyway and confirm with your password or Touch ID.
3. Open AHledger sync again and choose Open. macOS remembers the choice; a new version asks once more.

On macOS 14 or earlier you can instead Control-click the app in Applications, choose Open, then Open again.

If the game is kept in Documents, on the desktop or on another drive, macOS asks once whether AHledger sync may read files there. Choose Allow, or sync cannot see your scans; the choice can be changed later under Privacy & Security, Files and Folders.

The source of sync and of the addon is public on GitHub: read exactly what they do, or build sync yourself. Each release is published here and on the GitHub releases page. Its SHA-256 checksums are below; compare the Windows one with certutil -hashfile AHledger-sync-0.2.27-setup.exe SHA256 in a Windows terminal, or the Mac one with shasum -a 256 AHledger-sync-0.2.27-macos.dmg in Terminal, if you want to be sure the file is unchanged.

Sync stores your upload key on your machine only, talks to api.ahledger.com over HTTPS, and writes exactly one file into the game folder: the addon's price table. It never reads anything from the game beyond the saved-variables file you point it at.

Windows Security or an antivirus flagged the installer? The Windows installer is not code-signed yet, and a few antivirus engines score any unsigned installer from a publisher they have not seen as suspicious. That is why SmartScreen asks, and why a handful of the engines on VirusTotal flag it while Microsoft and the rest find nothing. Check the file yourself: compare its checksum with the one above, read the VirusTotal report for this exact build, or read the source. A signed installer is on the way, which ends both the prompt and the flags.