gitwtfhub

wtf is minerwatch?

imlenti/minerwatch — explained in plain English

Analysis updated 2026-05-18

2PythonAudience · generalComplexity · 2/5Setup · easy

TL;DR

A Python web app that runs on your home network and gives you a browser dashboard for monitoring small-scale Bitcoin mining hardware.

Mindmap

mindmap
  root((MinerWatch))
    What it does
      Polls miners locally
      Live dashboard
      Alerts on records
    Tech stack
      Python
      SQLite
      Telegram bot
    Use cases
      Home mining dashboard
      Fleet temperature control
      Push notifications
    Audience
      Home miners
      Hobbyists

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Monitor hash rate, temperature, and power draw for all your home miners in one dashboard

REASON 2

Get a push notification or Telegram alert when a miner beats its best share

REASON 3

Auto-discover Bitaxe, NerdQAxe, or Avalon Nano devices on your local network

REASON 4

Run an automatic fan controller to hold a target temperature across your fleet

What's in the stack?

PythonSQLiteTelegram Bot API

How it stacks up

imlenti/minerwatch0-bingwu-0/live-interpreter0xkaz/llm-governance-dashboard
Stars222
LanguagePythonPythonPython
Setup difficultyeasymoderatehard
Complexity2/52/54/5
Audiencegeneralgeneralops devops

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 30min

Runs locally with no cloud account required, needs compatible mining hardware on the same network.

Wtf does this do

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.

Yoink these prompts

Prompt 1
Help me set up MinerWatch on a Raspberry Pi to monitor my Bitaxe miners
Prompt 2
Explain how MinerWatch's MAC address pinning keeps tracking devices after IP changes
Prompt 3
Show me how to configure MinerWatch's Telegram alerts for record shares
Prompt 4
How does MinerWatch's block-probability prediction widget work?

Frequently asked questions

wtf is minerwatch?

A Python web app that runs on your home network and gives you a browser dashboard for monitoring small-scale Bitcoin mining hardware.

What language is minerwatch written in?

Mainly Python. The stack also includes Python, SQLite, Telegram Bot API.

How hard is minerwatch to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is minerwatch for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.