heimdall-network-monitor 0.2.6

A Python app that continuously polls your home WiFi and network uptime, logs any downtime, and serves a live status dashboard in your browser. The dashboard can be accessed by any device on the same network.

Heimdall Network Watcher

A Python app that continuously polls your home WiFi and network uptime, logs any downtime, and serves a live status dashboard in your browser. The dashboard can be accessed by any device on the same network.

Features

• Continuous monitoring - Pings a configurable target (default: 8.8.8.8) at a set interval
• Downtime logging - Records each outage with start and end time in SQLite
• Live dashboard - Web UI showing current status, 24h uptime %, and recent downtime events
• Cross-platform - Uses the system ping command (Windows and Unix)

Install with pip

Install from PyPI:

pip install heimdall-network-monitor
python -m heimdall

Install from local source:

pip install .
python -m heimdall

Quick start

Project structure:

heimdall/
  pyproject.toml
  README.md
  src/
    heimdall/
      __main__.py
      app.py
      config.py
      database.py
      monitor.py
      templates/
        dashboard.html
      static/
        style.css
        logo.png

1. Create a virtual environment and install dependencies

   python -m venv .venv
   .venv\Scripts\activate   # Windows
   # source .venv/bin/activate   # macOS/Linux
   pip install -e .
   

   pip install -e . installs this project in editable mode so local source changes are picked up without reinstalling.

2. Run the app

   python -m heimdall
   

3. Open the dashboard

   In your browser go to: http://localhost:9000 On the same WiFi, other devices can use http://:9000 (for example, http://192.168.1.42:9000).

The monitor runs in the background and the dashboard auto-refreshes every few seconds.

Configuration

Environment variables (optional):

Variable	Description	Default
HEIMDALL_PING_TARGET	Host to ping (IP or hostname)	8.8.8.8
HEIMDALL_POLL_INTERVAL	Seconds between checks	10
HEIMDALL_PING_TIMEOUT	Ping timeout in seconds	5
HEIMDALL_DB	SQLite database path	heimdall.db
HEIMDALL_HOST	Flask bind address	0.0.0.0
HEIMDALL_PORT	Flask port	9000

Example: Monitor your router and check every 5 seconds:

set HEIMDALL_PING_TARGET=8.8.8.8
set HEIMDALL_POLL_INTERVAL=5
python -m heimdall

On Linux/macOS use export HEIMDALL_PING_TARGET=192.168.1.1 etc.

API

• GET / - Dashboard (HTML)
• GET /api/status - Current status (up/down, last check, current downtime)
• GET /api/stats - 24h uptime % and sample count
• GET /api/downtimes - Recent downtime intervals

Requirements

• Python 3.8+
• Flask (see requirements.txt)

No special permissions needed; uses standard ping and a local SQLite file.