Skip to main content

Terminal-based network diagnostics and intelligence toolkit

Project description

🧠 Netcut

Netcut is a powerful all-in-one terminal-based network toolkit designed for diagnostics, analytics, reconnaissance, and debugging. From uptime analytics to wireless scanning, Netcut brings around 25 features in one unified CLI interface.


🚀 Features at a Glance

🧠 Core Networking Tools

  • Downtime Analytics Dashboard — Show uptime %, longest downtime, mean response time
    netcut stats
  • Geo-IP Tracking — Lookup host’s geographic location
    netcut geo <host>
  • ICMP Ping & TCP Port Check — Ping with ICMP or check TCP port
    netcut check <host>
  • Multi-Protocol Support — ICMP fallback, TCP checks for HTTP/SSH, etc.
  • Status Page Generator — Export static HTML with service status
    netcut statuspage

📈 Monitoring & Analysis

  • Bandwidth Usage Monitor — Show live per-process bandwidth
    netcut bandwidth
  • Packet Sniffer — Live packet analyzer with filters
    netcut sniffer --port 80
  • Port Scanner — Fast or deep TCP/UDP scans
    netcut scan <host>
  • ARP Table Viewer & Spoof Detection — Detect MAC duplicates
    netcut arp, netcut mitm-detect
  • Firewall Rule Lister/Editor — List/add/remove iptables/UFW rules
    netcut firewall
  • Network Interface Stats — Show IP, MAC, RX/TX bytes, errors
    netcut interfaces

🌐 Internet & Web Tools

  • SSL Certificate Viewer — Show cert chain, issuer, expiry
    netcut ssl <host>
  • Subdomain Enumerator — Find subdomains via wordlist
    netcut subdomains <domain>
  • CDN Detection — Identify Cloudflare, Akamai, etc.
    netcut cdn <domain>
  • Website Technology Fingerprinter — Detect stack: CMS, web server, JS libs
    netcut tech <url>
  • API Latency & Auth Monitor — Test protected endpoints, uptime, latency
    netcut api <url>

📡 Wireless & Local Network

  • WiFi Signal Heatmap Export — Export signal data to CSV/JSON
    netcut wifi
  • Bluetooth Device Scanner — Detect nearby BT devices
    netcut bt
  • DHCP Lease Viewer — Parse local DHCP leases
    netcut dhcp
  • LAN Service Discovery — mDNS/Bonjour discovery
    netcut lan

⚙️ Security & Debugging

  • Proxy Checker — Test HTTP/SOCKS proxies
    netcut proxy <proxy_url>
  • DNS Leak Test — Reveal actual DNS servers used
    netcut dnsleak
  • Traceroute Visualizer — ASCII tree showing hops/latency
    netcut traceroute <host>
  • MITM Detection — Detect ARP spoofing and MAC conflicts
    netcut mitm-detect
  • VPN Tunnel Leak Detection — Compare IP, DNS routes to detect leaks
    netcut tunnel-check

🚀 Utility & Extensions

  • Speedtest CLI — Measure download, upload, ping
    netcut speedtest
  • Reachability Tester — Batch check multiple URLs
    netcut reachability <file.txt>
  • WHOIS Lookup — Domain registrar, expiration info
    netcut whois <domain>

🖥️ Demo

speedtest

speedtest

bandwidth

bandwidth

interfaces

interfaces


🔧 Installation

git clone https://github.com/shaileshsaravanan/netcut.git
cd netcut

# Option 1: Install via wheel (recommended)
python3 -m build
pip install dist/netcut-*.whl

# Option 2: Install in editable mode (for development)
pip install -r requirements.txt
pip install -e .

📦 Install from PyPI

You can also install Netcut directly from PyPI using uv or pip:

uv pip install netcut

Or with pip:

pip install netcut

✅ After installing, use it from anywhere:

netcut stats
netcut geo google.com
netcut reachability targets.txt

📦 CLI Usage

General CLI Help

netcut --help

Common Commands

Command Description
netcut stats Show uptime, downtime, response time
netcut geo <host> Lookup IP geolocation
netcut check <host> ICMP/TCP ping to check host
netcut scan <host> TCP/UDP port scan
netcut firewall --list Show current firewall rules
netcut ssl <host> Show SSL certificate info
netcut wifi Export WiFi heatmap
netcut api <url> Test API with headers/auth
netcut traceroute <host> Show ASCII hop map
netcut mitm-detect Detect ARP/MAC spoofing (MITM)
netcut reachability <file> Check multiple URLs from file
netcut whois <domain> Perform WHOIS lookup

See the full command list by running netcut --help.

📁 targets.txt Example

https://google.com https://github.com https://api.example.com/health

Use:

netcut reachability targets.txt

💻 Supported Platforms • ✅ Linux (Debian/Ubuntu/Arch) • ✅ macOS • 🧪 WSL (some features limited)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

netcut-1.1.tar.gz (15.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

netcut-1.1-py3-none-any.whl (18.6 kB view details)

Uploaded Python 3

File details

Details for the file netcut-1.1.tar.gz.

File metadata

  • Download URL: netcut-1.1.tar.gz
  • Upload date:
  • Size: 15.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.4

File hashes

Hashes for netcut-1.1.tar.gz
Algorithm Hash digest
SHA256 81508776a0eb0f5604d9a632dfdc5c210df425db48d07c08177a1ec18d47d938
MD5 337a53b00eb6c2b8c005b55d08dccffc
BLAKE2b-256 95b33fcfe19c4203f385a8e005a9a391a88f0390e0d09f774482461649df97b4

See more details on using hashes here.

File details

Details for the file netcut-1.1-py3-none-any.whl.

File metadata

  • Download URL: netcut-1.1-py3-none-any.whl
  • Upload date:
  • Size: 18.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.4

File hashes

Hashes for netcut-1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 5e3dc5e58877a6dfde0a1ef2ec5eadcfb3cc79bf541f2cb002ee357dabf72a31
MD5 f6a6e9884a6e39b71a2e16d97a26db80
BLAKE2b-256 111b7e87fbe9bb4cc70150ad6f07a22ef9668701f46a5ff252f3fb7cb9a49536

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page