Bank Ledger

Ka0s Bank Ledger is a passbook for your banks. Put something in or take something out, at your own bank, the warband bank or the guild bank, and 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. The game already shows you what is sitting in your bank right now. What the client forgets the moment the bank window closes is how it got that way, and that is what this addon keeps. There is one book for the whole account, so every character writes to it and reads from it.

Screenshots

History browser

Insights panel

Current Banking Session (opens automatically at a bank)

Usage

On a fresh install nothing opens but the minimap button. Left-click it for the settings, or right-click it for a small menu. Both of the addon's windows drag by their title bar and resize from the bottom-right corner, and Lock frame on the settings' Master controls tab pins them in place. Want to see the ledger before you have any history? /bl test, or the Test mode box on that same tab, fills it with a sample. It turns itself off when you enter combat.

You don't have to do anything to start recording. A first visit to the bank goes like this.

• Go to a bank. Open your character bank, the warband bank or your guild bank and move something in or out. Current Banking Session opens alongside and lists each movement as you make it, then closes when the bank does. It's only a view, and everything in it lands in your history too. To place it without a bank in the way, /bl session opens it filled with sample rows.
• Open the ledger. Type /bl show, or tick Show window in the minimap button's right-click menu. It opens on the History tab, one line per movement with the newest at the top, and it only shows the character you're logged in as until you pick All. /bl hide, Escape or the X closes it.
• Narrow it down. The bar above the table has a search box for item names and dropdowns for date, direction, store, quality, type, sub-type and character. The Group dropdown folds rows into blocks you can collapse, and a click on any column header sorts by it. History and Insights each keep their own filters. Save keeps the tab's view as the one that tab opens on. Clear brings that tab back to it, and Reset sends that tab back to stock. The other tab's filters and saved view are left alone.
• Act on a row. Hover it for the item's tooltip, or shift-click it to drop the item into chat. Right-click gives you a menu to link it, delete that one line, or blacklist or whitelist the item. The two lists only decide what gets recorded from now on, and what's already in the book stays put.
• Look at the totals. The Insights tab turns whatever you've filtered into headline figures and charts, so the two tabs always describe the same rows. Export hands you either tab as CSV, all of it or just the current view, in a box you copy with Ctrl+C. History rows carry a Wowhead link to the exact item.

Movements older than 30 days are dropped at login, and Keep history for on the settings' History tab changes that. /bl purge deletes your history and leaves your settings alone. /bl resetall does the opposite: it puts the current profile's settings, filter lists and saved views (one per tab) back to defaults and keeps your history. Both ask before they do anything.

Your settings live in a profile. Every character shares the one Default profile until you choose otherwise under Settings → AddOns → Ka0s Bank Ledger → Profiles, where you can give a character its own. From chat, /bl profile lists your profiles and /bl profile <name> switches to one you already have. The history is never part of a profile: every character on every profile reads and writes the same ledger. Keep history for is shared the same way, so switching, copying or resetting a profile never deletes history.

Everything else is on the addon's page under Settings → AddOns, which a bare /bl opens, and /bl help (or /bankledger help) lists every command.

How the ledger works

The game never announces "you deposited this", so the addon works it out by watching. What the game does give an addon is a read of every bag and bank slot, plus an event each time one of them changes. The whole ledger is built from those two.

• When you open a bank, it takes a private snapshot of your bags and of that bank's contents.
• Every time something changes, it takes a fresh snapshot and compares the two.
• 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.
• If something changed on only one side (say you looted an item into your bags while the bank happened to be open), nothing is recorded, because nothing crossed between the two.
• Gold works the same way, but only at the guild bank and the warband bank. Those are the only two with a gold slot, so a change in your money anywhere else came from something that was not a deposit.

While every bank window is closed, the addon watches nothing. Ordinary play, looting and vendoring and questing, never ends up in the book.

FAQ

Troubleshooting

Reporting a bug

• Type /bl debug on and reproduce the bug.
• Type /bl diagnostics.
• If the debug window isn't open, open it with /bl debug. Press Copy, copy the entire output, and include it with your bug report.

The report is added after the debug trace in the same window, so one copy carries both.

Issues and feature requests

Bugs and feature requests are tracked at github.com/tusharsaxena/BankLedger/issues. Please file them there rather than in comments. That's where the project's whole to-do list lives.

Version History

Credits

The debug console and the ledger window's sort arrows use JetBrains Mono, licensed under the SIL Open Font License 1.1, and the ledger window's close, search, dropdown and checkbox marks and the export dialog's icon are drawn from Open Iconic (MIT). Each ships with its license text.