Skip to content

Fast and reliable network diagnostics for IT, cybersecurity, and system administrators. Simplify troubleshooting, monitoring, and save precious time.

License

Notifications You must be signed in to change notification settings

MrMazine/NetSage

Repository files navigation

⚡NetSage

Fast and reliable network diagnostics for IT, cybersecurity, and system administrators. Simplify troubleshooting, monitoring, and save precious time.

✨ Why Use NetSage?

NetSage is an all-in-one network diagnostics tool designed to make your daily IT, network administration, and cybersecurity tasks easier, faster, and more efficient.

  • Save Precious Time: Quickly gather key network information without manually typing multiple commands.
  • Powerful Diagnostics: Includes ping tests, traceroutes, port scans, ARP table checks, network statistics, internet speed tests, DNS checks, and much more.
  • Cross-Platform: Works on both Windows and Linux (macOS partially supported).
  • Highly Customizable: Easily adjust scanning settings, like adding new ports to the scan list, or targeting specific DNS servers.
  • Professional Results: Outputs are organized and clear, making it easier to troubleshoot or create reports.

NetSage is ideal for:

  • Network Administrators
  • Cybersecurity Professionals
  • System Administrators
  • IT Support Technicians
  • Penetration Testers

Instead of switching between dozens of tools or writing custom scripts each time — NetSage puts everything in one place to help you win time.

⚙️ How to Use

  1. Clone the repository:

    git clone https://github.com/MrMazine/NetSage.git
    cd NetSage
  2. Install dependencies:

    pip install -r requirements.txt
  3. Run the script:

    python3 netsage.py

🔧 Customizing Parameters

  • Ports to Scan:
    Modify the ports list inside the port_scan() function:

    def port_scan(host, ports=[80, 443, 22, 21, 3389, 8080, 8443, 53, 25]):

    ➔ Add any other ports you want inside the list!

  • Gateway IP Address:
    Default: 192.168.1.1
    You can input another IP manually when prompted.

  • Testing Hosts:
    Default hosts are google.com and 8.8.8.8.
    Change test_host or dns_server variables in the code if needed.

📦 Requirements

Python 3.7+ is required.

Install required packages:

pip install -r requirements.txt

Contents of requirements.txt:

pandas
ping3
psutil
speedtest-cli

📜 Features

  • Local IP Detection
  • Ping Test to Gateway, DNS, and External Host
  • DNS Resolution Check
  • Traceroute
  • Open Ports Scanner
  • Internet Speed Test (Download / Upload / Ping)
  • Wi-Fi Signal Strength Checker
  • Network Interface Statistics
  • Network Path Analysis (MTR if available)
  • DHCP Lease Info
  • ARP Table
  • Active Network Connections Viewer
  • DNS Server Benchmarking
  • Bandwidth Monitoring

All presented in a clear, interactive, and colorful terminal output.

🛡️ Permissions Notice

Some features (like Wi-Fi signal or DHCP leases) may require administrative rights (sudo on Linux, Run as Admin on Windows).

✍️ Attribution

Created and maintained by MrMazine 🚀

📚 Sources

About

Fast and reliable network diagnostics for IT, cybersecurity, and system administrators. Simplify troubleshooting, monitoring, and save precious time.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages