imlenti/minerwatch

MinerWatch is a Python web app that runs on your home network and gives you a browser dashboard for monitoring small-scale Bitcoin mining hardware, the kind of compact, purpose-built devices people run at home rather than in a data center. Instead of relying on any external service, it polls each miner every few seconds, stores the collected data in a local SQLite database, and serves everything through a browser interface accessible from any phone, tablet, or laptop on the same network. The dashboard shows live hash rate (how fast each device is searching for a Bitcoin solution), chip temperatures, fan speeds, power consumption, efficiency, and share statistics for every miner at a glance, refreshed automatically. Clicking into a device opens a detail view with tabs for hardware specs, historical graphs, and controls. A predictions widget estimates the probability of finding a block or beating an all-time best share based on current performance. When a miner breaks its own record, the app sends a native push notification, a Telegram bot integration is also available for alerts. MinerWatch supports Bitaxe, NerdQAxe, Canaan Avalon Nano, and Braiins BMM hardware. It auto-discovers compatible devices on the local network and uses MAC address pinning so device tracking survives IP address changes. An automatic fan speed controller runs server-side to hold a target temperature across the fleet. The project targets home miners comfortable using a terminal but not necessarily software developers. It can run on a Mac, a Linux machine, or a Raspberry Pi, and stores all data locally with no cloud account required. The full README is longer than what was provided.