PingPoll

A small Flask library and app that pings a list of network devices, resolves their hostnames, and shows live status, latency and uptime on a dashboard — plus a subnet discovery sweep to find live hosts that aren't on your list yet.

Install

pip install -e .

Run

pingpoll --init        # write an example NetFile into the current directory
pingpoll               # serve the dashboard on http://localhost:5001

Or without installing:

pip install -r requirements.txt
python run.py

Use as a library

from pingpoll import serve
serve("NetFile", port=5001)          # blocking dev server

from pingpoll import create_app       # build the Flask app (e.g. for gunicorn)
app = create_app("NetFile")

from pingpoll import Monitor, Scanner # the pieces on their own

How it works

• NetFile — your device list. One entry per line: <ip_or_host> [optional friendly name]. Lines starting with # are ignored. The path defaults to $PINGPOLL_NETFILE, else ./NetFile.
• pingpoll.monitor — a background thread pings every device on an interval (default 10s), keeps rolling history, and computes uptime %, average latency, and up/down transitions. Hostnames are reverse-resolved.
• pingpoll.app — the Flask app factory serving the dashboard and JSON API.
• templates/ + static/ — the dashboard (auto-refreshes every 5s).

Network discovery

PingPoll can sweep your local subnet to find live hosts that aren't in the NetFile. It auto-detects the local /24 (and any private /24s implied by addresses already in the NetFile), pings every host, resolves hostnames, and flags each as In NetFile (defined) or Undefined.

• In the dashboard: click Scan network. Undefined hosts get a checkbox; select the ones you want and click Add selected to NetFile to append them (with their resolved hostname) and start monitoring immediately.

• From the terminal:

  pingpoll --scan
  

  prints a table of every live host and whether it's defined.

CLI

pingpoll [--netfile PATH] [--port 5001] [--host 0.0.0.0] [--open] [--debug]
pingpoll --init     # write an example NetFile and exit
pingpoll --scan     # one-off terminal subnet scan and exit

API

Configuration

Tunables live at the top of pingpoll/monitor.py: PING_INTERVAL, PING_TIMEOUT, HISTORY_LEN, WORKERS. Ping flags auto-adjust for macOS / Linux / Windows.