Pocket Ledger

A lightweight World of Warcraft addon that tracks gold across all your characters, monitors session earnings, keeps tabs on your active auctions, and displays live stats — FPS, location coordinates, and XP with an ETA — on a draggable mini bar.

Features

Account-Wide Gold Tracking — See gold totals for every character on your account in one place, color-coded by class.
Session Summary — Tracks how much gold you've earned or spent since logging in.
Auction House Tracking — Automatically scans your active auctions when you visit the AH, showing item details, buyout prices, and color-coded time remaining.
Mini Bar — A small, draggable on-screen bar showing your current gold. Optionally displays FPS, current location + coordinates, and XP needed with an ETA. Click it to open the full Pocket Ledger window.
Options Panel — Full in-game options UI (via the WoW Settings menu or /pl options). Toggle individual sections, lock the mini bar, adjust bar scale, coordinate precision, and more.
Slash Commands — /pl or /pocketledger to toggle the window; see the command table below for all options.

Installation

Download or clone this repository:

   git clone git@github.com:TheGraele/PocketLedger.git

Copy (or symlink) the folder into your WoW addons directory and rename it to PocketLedger:

   /Applications/World of Warcraft/_retail_/Interface/AddOns/PocketLedger/

The folder name must match the .toc filename exactly.

Restart WoW or return to the character select screen. The addon will appear in your AddOns list.

Usage

Command	Description
`/pl`	Toggle the Pocket Ledger window
`/pl help`	Show available commands
`/pl reset`	Reset session gold baseline to current gold
`/pl options`	Open the options panel
`/pl defaults`	Reset all options to defaults
`/pl diag`	Print DB diagnostics to chat

You can also click the mini bar to toggle the window. The bar is draggable and can be locked in place via the options panel.

Auction data updates automatically whenever you open the Auction House.

File Structure

File	Purpose
`PocketLedger.toc`	Addon manifest (interface version, saved variables)
`Core.lua`	Addon initialization, event routing, shared utilities
`GoldTracker.lua`	Per-character gold tracking, account-wide storage
`AuctionTracker.lua`	Owned auction scanning and persistence
`UI.lua`	Main display frame, mini tracker, slash commands

Requirements

World of Warcraft Retail (Midnight — patch 12.0.5+)