IPMG — IP Management & Ping Monitoring Tool

Know what changed on your network since the last scan.

IPMG scans IPs, CIDR blocks, and ranges in parallel, keeps a history of every scan, and tells you what moved between two of them: hosts that went offline or appeared, IP addresses, hostnames, and MAC addresses that changed, latency that shifted, web services that started failing. Every change carries a severity, so only the ones that matter reach Slack, Teams, a webhook, or email, or fail a cron job or CI step. Use it from the command line or from IPMG Web, a local dashboard that works offline.

curl -sSL https://raw.githubusercontent.com/sameeralam3127/ipmg/main/install.sh | bash
ipmg --discover             # scan the network you are on, right now
ipmg --discover --compare   # later: scan again and see what changed
ipmg web --lan              # open the dashboard from any machine on your network

Please read: only scan networks you are authorized to scan. Unauthorized scanning may violate your organization's policies or the law.

Website: sameeralam3127.github.io/ipmg · Live demo: IPMG Web with sample data · Command builder: pick what you want, copy the command · Docs: everything else

What it does

• Scans fast, without root. IPv4 and IPv6, CIDR blocks, ranges, and target files (text, CSV, Excel, JSON), --threads hosts at a time, using your system's own ping.
• Finds hosts that block ping with TCP probes (--probe icmp,tcp), and checks web services (--http-check: status, response time, TLS, certificate expiry).
• Identifies devices by reverse DNS name and, on your LAN, by MAC address and vendor (--mac). Wakes them with Wake-on-LAN (ipmg wake).
• Remembers every scan and reports what changed, with severities and alerts to Slack, Teams, webhooks, or email.
• Fits into automation: exit codes for cron and CI, a GitHub Action, --json for scripts, systemd and launchd templates, Prometheus metrics.
• IPMG Web, a local dashboard: live scans, history, changes, inventory, and scheduled scans.
• Reports in Excel, CSV, JSON, JSON Lines, and Markdown, written as the scan runs, so an interrupted scan keeps its results and can be resumed.

How it compares with nmap, fping, and Uptime Kuma.

Install

Linux and macOS, on any distribution, with no Python needed:

curl -sSL https://raw.githubusercontent.com/sameeralam3127/ipmg/main/install.sh | bash

Windows (PowerShell, no administrator rights):

irm https://raw.githubusercontent.com/sameeralam3127/ipmg/main/install.ps1 | iex

Homebrew: brew install sameeralam3127/tap/ipmg · uv: uv tool install --python ">=3.10" "ipmg[web]" · pipx: pipx install "ipmg[web]" · Docker: docker run --rm ghcr.io/sameeralam3127/ipmg --input 10.0.0.0/24

IPMG needs Python 3.10 or newer (the installers bring their own) and the system ping command. Minimal images, version pinning, upgrading from 3.x, tab completion, and the systems CI verifies are in the install guide.

Your first scan

ipmg --input 192.168.1.0/24 --stream        # each host as it answers

  ipmg X.Y.Z  ·  scan
  ICMP probes only — scan only networks you are authorized to scan.

  Source   192.168.1.0/24
  Targets  254 hosts
  Config   50 threads · 2s timeout · 1 ping

  Results
  ● Active    12  ━───────────────────────   4.7%
  ● Timeout  242  ━━━━━━━━━━━━━━━━━━━━━━━━  95.3%

  254 hosts · 4.7% active · 3.1 ms avg · 5.21s · 2026-10-18 09:15:02

  Saved    results_20261018_091502.xlsx

Every scan is stored in a local history (~/.ipmg/dashboard.db). Scan again with --compare to see what changed, or open IPMG Web to browse it.

Common tasks

IPMG Web

ipmg web          # this machine: opens http://127.0.0.1:8080 in your browser
ipmg web --lan    # any machine on your network: prints the link to open

With --lan, IPMG Web prints the link with this machine's address and access token, checks the firewall, and tells you the exact command that opens the port if it is blocked (sudo ipmg web --open-firewall opens it only while IPMG Web runs). Every request needs the token in that link.

Dashboard, live monitor, history, changes, inventory with Wake-on-LAN, and scheduled scans; see the IPMG Web guide. Try it first with the live demo.

Documentation

Security

IPMG runs ping as a direct process call with no shell, validates every target first, and needs no root. IPMG Web listens on 127.0.0.1 unless you pass --lan, serves everything locally, and requires its access token on every request, behind a strict Content-Security-Policy. The only outbound requests IPMG makes are the notifications and HTTP checks you ask for. Found a vulnerability? See SECURITY.md.

Contributing

Contributions are welcome. CONTRIBUTING.md covers the development setup, the tests, and the commit format that drives releases, and ARCHITECTURE.md explains the code. Everyone taking part is expected to follow the Code of Conduct.

License

MIT — free for commercial and personal use.