Ka0s 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. What is sitting in your bank right now is something the game already shows you. How it got that way is the part the client forgets the moment the bank window closes, and that is the part kept here. One book, account-wide, so every character writes to it and reads from it.

Screenshots

History browser

Insights panel

Current Banking Session (opens automatically at a bank)

Usage

/bl show opens the ledger and /bl hide closes it; /bl toggle, or a left-click on the minimap button, does whichever the window is not already doing, and Escape and the X in the top corner close it. A right-click on the minimap button, or /bl config, lands you in the settings instead. The window opens on History, one line per movement, newest first, already scoped to whoever you are logged in as. The bar above the table is how you narrow that: a search box for item names, dropdowns for date, direction, store, quality, type, sub-type and character, and a Group dropdown that folds the rows into blocks whose headers collapse when you click them. Any column header sorts on its column, and clicking it again flips the direction. Once the view is the way you like it, Save makes it the one every session opens on, Clear brings you back to it after you have wandered off, and Reset returns the default to stock. Character scope is the one thing never saved, so the window always opens on you, one click away from All.

Hover a row for the item's own tooltip. A gold row has no link to show, so it gets a small tooltip built by hand with the amount spelled out in full, because the Qty cell can truncate it. Shift-left-click drops the item into chat, and right-click opens the row menu: link it, blacklist it, whitelist it, or delete that single line out of the book. The two lists are point-in-time, so they decide what gets recorded from now on and leave everything already stored alone. If you want a look around before you have any history of your own, /bl test puts a sample ledger on screen. Only Link to chat works on those rows. The others would be writing fake item ids into your real settings.

The Insights tab swaps the table out for charts drawn through the same filter, so the two always describe the same slice. Fourteen headline figures come first, then seventeen charts, each of the main breakdowns followed by its deposits-against-withdrawals companion, with the ranked "Top Of The List" panels below. Gold charts appear only when the slice you are looking at contains a coin movement. Export takes whichever tab you are on, asks for All Data or Current View, and hands you the CSV in a copy box (Ctrl+C, then Esc). History rows carry a Wowhead link for the exact item that moved, bonus IDs and all.

Then there is the window you never have to open. Walk up to a bank and Current Banking Session opens with it, listing what you have moved during this visit as you move it; close the bank and it closes too. It stores nothing of its own, and everything in it is in your history as well. Placing it while a bank frame is in the way is a nuisance, so /bl session opens it on sample movements away from one. Both windows drag by the title bar and size from the grip in the bottom-right corner, and both come back where you left them — until you tick Lock frame on the settings' Master controls tab, which pins every window the addon owns.

Everything else is configuration, and it lives in two places: the addon's own page under Settings → AddOns in game, and /bl (or /bankledger), which prints the full command list.

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 with a gold slot, so a change in your money anywhere else came from something that was not a deposit.

Nothing is watched while every bank window is closed. Ordinary play, looting and vendoring and 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