A live DPS / Gold / EXP meter & run tracker overlay for Task Bar Hero
Unaffiliated, open-source fan project — not made by or endorsed by the game's developer.
TBH Meter is a lightweight, always-on-top overlay that tracks your Task Bar Hero runs in real time:
| Metric | Description |
|---|---|
| MODE | Current run difficulty (Normal / Nightmare / Hell / Torment) |
| STAGE | Current stage and act |
| DPS | Live damage per second |
| DAMAGE | Total damage dealt this run |
| MOBS | Monsters killed / total |
| TIME | Elapsed run time |
Every finished run is also saved with full detail — result (success / fail / abandoned), gold & XP gained, gold/XP per second, and a complete snapshot of your heroes (class, level, items, mods, skills, stats) — browsable from the built-in Runs window.
Windows 10+ only. The reader uses Windows APIs to read game memory.
- Download
tbh-meter-Setup-<version>.exefrom the latest release. - Run the installer — no admin rights needed (it installs per-user).
- Launch Task Bar Hero and TBH Meter in any order. The first attach takes 1–2 minutes; after that, live stats appear automatically.
The app keeps itself up to date — it checks on launch and every 6 hours, downloads in the background, and offers a Restart to update prompt.
"Windows protected your PC" warning
The builds are not code-signed (signing is expensive for a free fan tool), so SmartScreen shows a blue warning the first time you run them. Click More info → Run anyway.
Antivirus flags tbh-reader.exe
That is a false positive. tbh-reader.exe is the bundled game reader — it only reads memory, never writes to or modifies the game. Allow or restore it so the meter can work. See SECURITY.md for what the reader does.
The meter ships as two pieces that talk over the filesystem:
Task Bar Hero (game process)
│ ReadProcessMemory (read-only)
▼
reader/ ──► tbh-reader.exe a pure-Python "sensor": resolves IL2CPP classes and
│ writes one run record per finished run + a live feed
▼
app/ ──► tbh-meter (Electron) converts runs, derives sessions, draws the overlay
+ runs list
reader/— the memory reader. Purectypes+ stdlib (zero runtime dependencies), frozen into a singletbh-reader.exewith PyInstaller. A read-only sensor: it never modifies game memory, files, or behavior, and never injects code.app/— the Electron overlay. Owns everything user-facing: the live overlay, the runs list and detail views, session grouping, settings, and auto-update.
The meter is fully local: your runs are stored as files in ~/tbh-meter/ (configurable in Settings) and never leave your machine. The only network traffic is the auto-update check against GitHub Releases.
You need Node 22 + pnpm (app) and Python 3.12 (reader). The live memory-reading path is Windows-only; on macOS/Linux you can run the app's UI, lint, and tests, but not attach to the game.
# App (Electron overlay)
cd app
pnpm install
pnpm dev # run the overlay (macOS renders UI only — no game attach)
pnpm check # eslint + tsc
pnpm test # vitest
pnpm dist:win # build the Windows installer (requires Windows)
# Reader (Python sensor)
cd reader
pip install ruff -r requirements-dev.txt
ruff check .
python -m pytestThe app bundles a small game-data snapshot (committed under data/); app/scripts/sync-data.mjs copies it in at build time, so the app builds offline. See CONTRIBUTING.md to refresh it after a game patch.
Issues and PRs are welcome — start with CONTRIBUTING.md for setup, the test gates, and the release flow, and the Code of Conduct. Found a security issue? See SECURITY.md. Come say hi on Discord.
We are migrating the board project to a public one: https://github.com/orgs/mad-labs-org/projects/10/views/1. Feel free to contribute!
If TBH Meter helps your runs, consider buying the team a coffee — it keeps development going.
MIT. Task Bar Hero and its assets belong to their respective owner; this project only reads publicly observable game state for the player's own use.