IPMG — IP Management & Ping Monitoring Tool

---

IPMG (IP Management Tool) is a modern, modular, enterprise-ready network scanner and monitoring utility. It replaces the legacy ip_pinger.py script with a clean package architecture, CLI tooling, and automated workflows.

Designed for:

• Network administrators
• Systems engineers
• Cybersecurity teams
• DevOps and SREs

IPMG supports:

• Subnet auto-discovery
• Parallel pinging with thread pools
• Hostname resolution
• Multi-format reporting (XLSX/CSV/JSON)
• Scheduled recurrent scans
• Auto-generated sample Excel input
• Colorized CLI output
• Modular testable architecture

---

⚠️ Security Disclaimer

Do NOT use this tool on networks without explicit authorization. Always obtain written approval from your organization's Cybersecurity / Network Security team. Unauthorized scanning may violate internal policies or law.

IPMG includes a built-in disclaimer shown at runtime (security.py).

---

Features

• Fully modular Python package (src/ipmg)
• System-wide CLI command: ipmg
• Test coverage via pytest
• Formatting and linting via ruff and black
• CI-friendly project structure

---

Installation

Option 1 — Install from PyPI (recommended for most users)

Install the latest stable release (ipmg 1.0.2) from PyPI:

pip install ipmg

Verify installation:

ipmg --help

---

Option 2 — Install via uv (recommended for isolated global install)

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

Test:

ipmg --help

---

Option 3 — Install via pip (editable, development mode)

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

Verify:

ipmg --help

---

Option 4 — Install using curl installer

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

This script:

• Installs uv if missing
• Installs ipmg globally using uv

Verify:

ipmg --help

---

Use Case	Command	Description
Basic Example (Default Input)	ipmg	Runs with default config. Creates ip_list.xlsx with sample IPs if missing.
Scan a Custom Input File	ipmg --input network_devices.xlsx	Scans IPs from the specified Excel file.
Auto-discover LAN Subnet	ipmg --discover	Automatically detects and scans devices in the local subnet.
Export Results to CSV + XLSX	ipmg --formats csv xlsx	Exports scan results in CSV and Excel formats.
Resolve Hostnames (PTR Records)	ipmg --resolve	Performs reverse DNS (PTR) lookups for hostnames.
Run Every 10 Minutes	ipmg --interval 10	Repeats the scan every 10 minutes.

If ip_list.xlsx does not exist → it will be created with sample IPs.

---

Sample Output Summary

=== IPMG Summary ===
Active: 132
Inactive: 12
Unreachable: 4
Timeout: 2

Success Rate: 88.00%

---

Input File Format (Excel or CSV)

Example:

IP Address
192.168.1.1
10.0.0.1
8.8.8.8

---

Output File Format

IP Address	Status	Latency	Hostname	Timestamp
8.8.8.8	Active	12.5 ms	dns.google	2025-10-12 18:40:15

---

Troubleshooting

Command not found: ipmg

Solution:

pip install -e .

Permission denied output folder

Run inside a writeable directory or use:

sudo ipmg ...

Hostname Unresolvable

Likely missing DNS PTR records.

---

macOS GUI (PingMonitorApp – Beta)

A native macOS interface for IPMG is under active development.

Download Beta:

👉 https://github.com/sameeralam3127/IP_Management/releases/tag/macOS

---

License

MIT License — free for commercial and personal use.

---

Made with ❤️ using Python & uv.