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

# 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.

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
• Inventory — every host seen across scans, with last status and export

ipmg web is an alias for ipmg dashboard.

Options

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

Every scan prints a color-coded summary and writes result files (e.g. results_20260628_120000.xlsx). Each row includes:

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.