lucasfevi/tbh-companion — explained in plain English
Analysis updated 2026-05-18
Track XP per hour and gold per hour while playing TBH: Task Bar Hero.
Check the Steam Market value of your in-game inventory at a glance.
Use an always-on-top mini overlay to keep stats visible during gameplay.
Get sound alerts when a stage boss chest cooldown finishes.
| lucasfevi/tbh-companion | alamops/agetor | aza-ali/blendpixel.com | |
|---|---|---|---|
| Stars | 12 | 12 | 12 |
| Language | TypeScript | TypeScript | TypeScript |
| Setup difficulty | moderate | hard | easy |
| Complexity | 2/5 | 4/5 | 2/5 |
| Audience | general | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
Requires Node.js and npm install in the app/ folder, Electron's binary may need a manual install step.
TBH Companion is a desktop stats overlay for an idle game called TBH: Task Bar Hero. If you play that game, this app reads your local save file and shows you live performance numbers: how much XP you are earning per hour, how much gold per hour, a breakdown by each hero character, your session history, and the current value of your inventory based on live Steam Market prices. The app never writes to your save file or communicates with the game's servers, it only reads. The app runs as a separate desktop window built with Electron, React, and TypeScript. It has two display modes: a full-size tabbed window and a compact always-on-top mini overlay you can keep visible while playing. The tabs cover live stats, inventory with price lookups, a market tab to update Steam prices, a chest tracker with cooldown timers, pet unlock progress, app settings, and an about page that handles in-app updates. The mini overlay shows the most important numbers (XP and gold rates, current map, inventory value) in a small frameless window. One notable feature is a stage boss chest tracker. Certain chests in the game have cooldown timers, and this tracker shows when each one will be ready again. It can detect chest drops automatically by watching the game's log file, and it plays a sound alert when a cooldown finishes. The sound options include several short chimes and a silence option. The app polls your save file every few seconds (configurable) and keeps a rolling window of XP changes to compute the per-hour rate. It can also log every XP change to a CSV file for your own records. Settings are stored in a config file that you can edit through the app's Settings tab or by hand. The project targets Windows and ships as a standard installer built with GitHub Actions. The README notes that builds are unsigned, so Windows SmartScreen may show a warning on first install. It is a fan-made tool with no affiliation to the game's developers.
TBH Companion is a Windows desktop app that reads your TBH: Task Bar Hero save file to show live XP, gold, and inventory value stats, without modifying the save.
Mainly TypeScript. The stack also includes TypeScript, Electron, React.
The README does not state a license.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly general.
This repo across BitVibe Labs
Verify against the repo before relying on details.