IPMG — IP Management & Ping Monitoring Tool

Scan and monitor IP networks from the command line — or from a local web dashboard. IPMG pings hosts in parallel, resolves hostnames, and exports results as Excel, CSV, JSON, or Markdown reports.

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

Install

pip install ipmg

Check that it works:

ipmg --version

uv tool install git+https://github.com/sameeralam3127/ipmg.git

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

git clone https://github.com/sameeralam3127/ipmg.git
cd ipmg
pip install -e .

Quick start

# Scan your local subnet automatically
ipmg --discover

# Scan a single host
ipmg --input 8.8.8.8

# Scan a CIDR range
ipmg --input 192.168.1.0/24

# Scan an IP range
ipmg --input 10.0.0.1-10.0.0.50

# Scan targets from a file (xlsx, csv, txt, or list)
ipmg --input targets.txt

# Resolve hostnames and export CSV + a readable Markdown report
ipmg --input targets.txt --resolve --formats md csv

# Scan and report what changed since the previous scan
ipmg --input targets.txt --compare

# List stored scans, then compare any two of them
ipmg history
ipmg diff 12 14

# Open the local web dashboard
ipmg dashboard

Running plain ipmg uses ip_list.xlsx as input and creates a sample file if it does not exist.

Change detection

Every scan is stored in a local SQLite history (~/.ipmg/dashboard.db), shared by the CLI and the dashboard. IPMG can then tell you what moved between any two scans.

ipmg --input targets.txt --compare                   # compare with the previous scan
ipmg diff                                            # compare the two latest scans
ipmg diff 14                                         # compare scan 14 with the one before it
ipmg diff 12 14                                      # compare two specific scans
ipmg diff --diff-formats md json                     # export the change summary
ipmg diff --fail-on-change                           # exit 2 when anything changed (CI)
ipmg history --limit 10                              # list stored scans

Detected changes:

A latency change is only reported when it clears both --latency-threshold (default 5 ms) and --latency-pct (default 25%), which keeps normal jitter out of the report.

By default a scan is compared against the previous scan of the same target source, so file-based and --discover runs do not get mixed up.

Web dashboard

ipmg dashboard          # starts http://127.0.0.1:8080 and opens your browser

A modern browser UI that shares the CLI's scanning engine and runs fully offline — every stylesheet and script is bundled with the package, nothing is loaded from a CDN. It gives you:

• Dashboard — status donut, latency trend, and recent scan overview
• New Scan — upload Excel/CSV/text/JSON target files or type IPs, CIDR blocks, and ranges; configure threads, timeout, and DNS options
• Live Monitor — real-time progress and results over WebSockets
• History — every scan stored locally in SQLite (~/.ipmg/dashboard.db), searchable and downloadable as XLSX/CSV/JSON/Markdown
• Changes — pick any two scans and see new/offline hosts, IP and hostname moves, and latency shifts; export the summary as Markdown/JSON/CSV
• Inventory — every host seen across scans, with last status and export

ipmg web is an alias for ipmg dashboard.

Options

Exit codes: 0 success, 1 error, 2 changes detected (ipmg diff --fail-on-change), 130 interrupted.

Input formats

• Excel / CSV — must contain an IP Address column:

  IP Address
  192.168.1.1
  10.0.1.0/30

• Text file — one IP or CIDR per line; blank lines and # comments are ignored:

  # Production DNS
  8.8.8.8
  192.168.1.0/30
  

• Command line — a literal IP (8.8.8.8), CIDR block (10.0.0.0/24), or IP range (10.0.0.1-10.0.0.200)

Output

  ipmg 1.7.0  ·  scan
  ICMP probes only — scan only networks you are authorized to scan.

  Source   targets.txt
  Targets  3 hosts
  Config   50 threads · 2s timeout · 1 ping · reverse DNS

  Results
  ● Active   2  ━━━━━━━━━━━━━━━───────  66.7%
  ● Timeout  1  ━━━━━━━───────────────  33.3%

  3 hosts · 66.7% active · 5.8 ms avg · 3.08s · 2026-07-26 23:13:25

  Saved    results_20260726_231328.csv

Colors follow NO_COLOR, the progress bar is hidden when output is piped, and the symbols fall back to ASCII on terminals that cannot render them.

Result files (e.g. results_20260628_120000.xlsx) contain one row per host:

Status values: Active, Inactive, Timeout, Unreachable, Invalid IP, Error.

The md format produces a shareable Markdown report with a status summary table — handy for tickets, handoffs, and incident timelines.

Troubleshooting

• command not found: ipmg — make sure pip's script directory is on your PATH, or reinstall with pip install ipmg.
• Hostname shows Unresolvable — the host has no DNS PTR record.
• Input file rejected — check the extension is supported and that spreadsheets/CSVs include an IP Address column.

Development

pip install -e ".[dev]"
PYTEST_DISABLE_PLUGIN_AUTOLOAD=1 pytest -q

Releases are automated: merging a conventional commit (feat: ..., fix: ...) to main triggers GitHub Actions to run tests, create a semantic-release tag, and publish to PyPI.

License

MIT — free for commercial and personal use.