Ka0s Bank Ledger

Ka0s Bank Ledger is a passbook for your banks. Every time you put something in or take something out — your own bank, the warband bank, the guild bank — it writes a line: what moved, which way, how much, and when. Gold is tracked the same way at the two banks that hold gold.

It records movements, not contents. It never tries to tell you what is sitting in your bank right now; it tells you the story of how it got that way, which is the thing the game itself forgets the moment you close the window. The ledger is account-wide, so every character writes to and reads from the same book.

Open it with /bl, browse and filter the History tab, switch to Insights for the charts, and use Export whenever you want the numbers in a spreadsheet. Configure it in the Blizzard settings panel or with /bl config.

Once you have the filters, grouping and sort the way you like them, Save makes that your default view and every session opens on it. Clear returns to it whenever you have wandered off, and Reset puts the default back to stock. The Character filter is the one thing never saved — the window always opens scoped to whoever you are logged in as, one click away from All.

There is also a second, smaller window you never have to open yourself: whenever you are standing at a bank, Current Banking Session lists what you have moved during that visit, as you move it. Close the bank and it closes with it.

What's new in 1.0.0

• First release: a complete passbook of every item and gold movement between your bags and your character bank, warband bank and guild bank.
• History tab with search, per-column filters, grouping and sorting — plus a saved view, so Save makes your layout the one every session opens on.
• Insights tab with fourteen headline figures and seventeen charts, including deposit/withdrawal companions for every breakdown and ranked "Top Of The List" panels.
• A live Current Banking Session window that opens with any bank and lists what you moved during that visit.
• CSV export for either tab — all your data or just the view on screen — with a Wowhead link for the exact item that moved, bonus IDs and all.

Screenshots

History browser

Insights

Current Banking Session (opens automatically at a bank)

Settings Panel

Usage

Slash commands

/bl is the short form and /bankledger the long one; both do the same thing. Everything the addon prints to chat carries the cyan [BL] tag.

/bl debug scan and /bl debug panel write straight to the console whether or not logging is on, so you can run one without turning logging on first. scan is the one to paste into a bug report: it reports which container ids and which money-balance readers this build actually exposes.

While the sample ledger (/bl test) is on screen the History table's right-click menu offers Link to chat only — Delete, Blacklist and Whitelist are greyed out, because the sample rows are synthetic and those actions would otherwise reach your real settings and history.

Settings panel

General has three sections. Master Controls is the top-level stuff: the switch that turns recording on or off, the minimap button, whether the Current Banking Session window appears at a bank, the debug console, and the window scale. Capture is what actually gets recorded — a minimum item quality, how long history is kept (30 days by default), whether items and gold are tracked, and which banks you care about. Storage shows how much you have recorded and how big it is, with a button to wipe it.

Filters manages two lists of items by id. Blacklisted items are never recorded; whitelisted items are always recorded, even below your minimum quality. Add an item by typing its id or by shift-clicking its link into the box. Both lists only affect what happens from now on — nothing already in your ledger is ever hidden or removed by them.

How the ledger works

The game never announces "you deposited this", so the addon works it out by watching.

1. When you open a bank, it takes a private snapshot of your bags and of that bank's contents.
2. Every time something changes, it takes a fresh snapshot and compares the two.
3. If an item's count went down in your bags and up in the bank, that is a deposit. The other way round is a withdrawal.
4. If something changed on only one side — you looted an item into your bags while the bank happened to be open — nothing is recorded, because nothing crossed between the two.
5. Gold works the same way, but only at the guild bank and the warband bank. Those are the only two that have a gold slot, so a change in your money anywhere else came from something other than a deposit.

Nothing is watched while every bank window is closed, so ordinary play — looting, vendoring, questing — never ends up in the book.

FAQ

Troubleshooting

Issues and feature requests

Bugs and feature requests are tracked at github.com/tusharsaxena/BankLedger/issues. Please file them there rather than in comments — it is the single place the project's to-do list lives.

Version History