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.

Install it Source

4.1.2 · pip install plumhud · Python 3.8+ with Tk · MIT

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

View on PyPI Source

How it works

Install itpip 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

A glance, not a dashboardThe whole fleet reduced to a strip you can read without stopping what you are doing.

Alerts when it mattersSilence while the machines are working. A machine that stops earning is the event, not the ordinary variation around it.

Built on moonbeam-minerDiscovery is shared with the tool that already finds the NerdMiners on your network.

Desktop, not a web appIt runs on your machine with Tk. Nothing is hosted and nothing phones home.

MIT licensedRead it, change it, ship it.

Version 4Four major revisions of one small idea, which is what happens when a tool is used daily by the person who wrote it.

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-miner for 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.