lucasfevi/tbh-companion

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.