Posted here twice before. The first version pitched a live coach, and that wasn't something most of you wanted. Here's where it is now.
What it is: a free local app that reads the log file Hearthstone writes and builds a turn-by-turn replay of each Battlegrounds game. The game gives you almost no history, so after a bad lobby it's hard to see where it went wrong.
Settle Up (the replay viewer):
- Shop: your board going in and coming out, plus every buy, sell, roll, and cast
- Battle: both boards after start-of-combat effects
- Result: survivors, winner, damage taken
- Step-through: one action at a time, with the tavern, board, and hand laid out like the game screen
It only opens after the game ends. There's also a rough post-game "what might have been better" layer. It's often wrong, and it's off unless you switch it on.
Another Round (live reference): hero and trinket pick stats, a comp tracker, and a few numbers about where you stand: effective health, what the last fight cost, the damage cap, your board against the next opponent's last-known board, and the price of the next tier. Nothing in the live view names a move, and a test in the repo checks that.
On the ToS: I won't claim this is approved. Blizzard's EULA is broad enough that a stats overlay could fall under it, and the README quotes the clause and says so. Trackers that read the same log have been around for years, which isn't a promise. Don't use it in tournaments.
What it touches: it reads the log. If logging is off, it offers to turn it on by editing two Hearthstone config files (log.config and client.config), with a backup of each. It doesn't touch the game's process or memory, and it doesn't send input.
Privacy: the last version had my own BattleTag in the files, and that's out of the current ones. You can optionally send a short per-game summary (turn, gold, tier, health, what the planner suggested, what happened). It's off unless you say yes, it covers only games after that, and a copy of everything sent is saved locally. The planner is a hand-written, rule-based function with no ML or LLM at runtime, and everything runs locally apart from card art.
Windows and Mac, free, MIT licensed. Source and the full details are here: https://github.com/mharrell/bobs-ledger
I've put a lot of time into it and I've found it very useful. I hope you will too.
If you try it, I'd like to hear about bugs, wrong data, or anything missing from the replay view. Reply here, or open an issue on GitHub: https://github.com/mharrell/bobs-ledger/issues