
PlumHUD
A heads-up display for a fleet of miners. It sits on your desktop, goes quiet while everything is fine, and tells you the moment a machine stops earning.
What it does
A borderless overlay HUD that sits on top of whatever you are doing, with four display modes, an opacity slider and five skins. A five-tab command center for miners, analytics, alerts, skin and settings. Every poll is written to a local database with thirty-day retention.
Alerts
Rules for offline, hashrate below a floor, temperature above a ceiling and reject spikes, delivered to Discord or Telegram with a per-rule cooldown.
What version 4 changed
Nothing is invented any more. Version 3 filled missing readings with random numbers, so a miner that answered without a hashrate displayed a believable figure you had no way to identify as fake. A field the miner did not send is now shown as a dash and stored as null, and alert rules stay quiet rather than reporting an absent measurement as a low one.
The config also stopped moving. It lives in one per-user directory, created owner-only, because it holds a Discord webhook and a Telegram token.
pip install plumhud plumhud the overlay HUD plumhud check poll once, print, exit plumhud where where config and history live
How it works
- Install it
pip install plumhud. It needs Python 3.8 or newer and Tk, which ships with most Python builds. - Point it at the fleetIt finds the miners through
moonbeam-miner, so the discovery you already have is the discovery it uses. - Leave it aloneThat is the design. It is a heads-up display, so the correct amount of attention to give it while things work is none.
What it does
Specifications
| Name | Personal Ledger Utility Monitor, Heads-Up Display |
|---|---|
| Version | 4.1.2 |
| License | MIT |
| Install | pip install plumhud |
| Requires | Python 3.8+, Tk |
| Depends on | moonbeam-miner |
Questions
- What does the name mean?
- Personal Ledger Utility Monitor, Heads-Up Display. It was a joke that stuck.
- Do I need Moonbeam too?
- It depends on
moonbeam-minerfor discovery, which pip installs for you. - Will it run on a headless box?
- No. It draws a window with Tk, so it wants a desktop. The machine being watched can be headless; the machine watching cannot.