netsweep

Network Swiss Army Knife - A single command for comprehensive network diagnostics.

``
╭──────────────────────────────────╮
│ NETSWEEP - Network Diagnostics │
╰──────────────────────────────────╯
┌─ CONNECTION ────────────────────────────────────────────────┐
│ Interface: Wi-Fi (en0) │
│ Local IP: 192.168.0.31 │
│ Gateway: 192.168.0.1 │
│ External IP: 85.123.45.67 │
│ DNS: 1.1.1.1, 8.8.8.8 │
└──────────────────────────────────────────────────────────────┘
┌─ SPEED ─────────────────────────────────────────────────────┐
│ ↓ Download: 245.3 Mbps │
│ ↑ Upload: 48.7 Mbps │
│ Latency: 12ms (jitter: 2.3ms) │
└──────────────────────────────────────────────────────────────┘
┌─ DEVICES (4 found) ─────────────────────────────────────────┐
│ IP │ MAC │ Vendor │ Name │
├─────────────────┼────────────────────┼──────────────┼────────┤
│ 192.168.0.1 │ F0:81:75:22:32:22 │ Sagemcom │ - │
│ 192.168.0.7 │ 00:17:88:2E:09:31 │ Philips │ - │
│ 192.168.0.31 │ 80:A9:97:35:64:71 │ Apple │ This Mac│
└─────────────────┴────────────────────┴──────────────┴────────┘
┌─ GATEWAY PORTS (192.168.0.1) ───────────────────────────────┐
│ 53/tcp DNS OPEN │
│ 80/tcp HTTP OPEN │
└──────────────────────────────────────────────────────────────┘
┌─ WIFI ──────────────────────────────────────────────────────┐
│ SSID: MyNetwork │
│ Signal: -52 dBm (Excellent) │
│ Noise: -90 dBm │
│ Channel: 36 (5 GHz) │
│ Tx Rate: 867 Mbps │
└──────────────────────────────────────────────────────────────┘
┌─ ISP & LOCATION ────────────────────────────────────────────┐
│ ISP: Telenor Norge AS │
│ ASN: AS2119 │
│ Location: Oslo, Norway │
│ Coordinates: 59.9139° N, 10.7522° E │
└──────────────────────────────────────────────────────────────┘
┌─ TRACEROUTE (to 1.1.1.1) ───────────────────────────────────┐
│ 1 192.168.0.1 1.2ms ██ │
│ 2 10.0.0.1 8.4ms ████ │
│ 3 85.123.45.1 12.1ms ██████ │
│ 4 1.1.1.1 14.3ms ███████ │
└──────────────────────────────────────────────────────────────┘
┌─ INTERNET HEALTH ───────────────────────────────────────────┐
│ Google ✓ 12ms │
│ Cloudflare ✓ 8ms │
│ GitHub ✓ 45ms │
│ AWS ✓ 23ms │
└──────────────────────────────────────────────────────────────┘
`

Features

- Connection Info - Local IP, gateway, external IP, DNS servers
- Device Discovery - Find all devices on your network via ARP with vendor identification
- Speed Test - Download/upload speeds and latency via Cloudflare
- Port Scanner - Scan common ports on any host
- WiFi Info - Signal strength, noise, channel, and transmit rate
- ISP & Geolocation - ISP name, ASN, and location lookup
- Traceroute - Visual traceroute with latency bars
- Internet Health - Check connectivity to major services
- Beautiful Output - Clean terminal UI with colors and tables
- JSON Output - Pipe results to other tools

Installation

$3

`bash


Run directly without installing

bunx netsweep

Or install globally

bun install -g netsweep
netsweep
`

$3

`bash


Run directly

npx netsweep

Or install globally

npm install -g netsweep
netsweep
`

$3

`bash
git clone https://github.com/Johannes-Berggren/netprobe.git
cd netprobe
bun install
bun link
netsweep
`

Usage

`bash


Full network scan (all diagnostics)

netsweep

Individual scans

netsweep -d # Devices only
netsweep -s # Speed test only
netsweep -p # Gateway ports only
netsweep -w # WiFi info only
netsweep --isp # ISP & location only
netsweep --trace # Traceroute only
netsweep --health # Internet health only

Scan specific host

netsweep -p -t 192.168.0.7

JSON output for scripting

netsweep --json
netsweep -d --json | jq '.devices[] | select(.vendor == "Apple")'
`

Options

| Flag | Short | Description |
|------|-------|-------------|
| --all | -a | Run all scans (default) |
| --devices | -d | Scan for network devices |
| --speed | -s | Run speed test |
| --ports | -p | Scan gateway ports |
| --wifi | -w | Show WiFi info |
| --isp | -i | Show ISP & geolocation |
| --trace | -r | Run traceroute to 1.1.1.1 |
| --health | | Check internet health |
| --target | -t | Scan specific IP for ports |
| --json | | Output as JSON |
| --help | | Show help |

Requirements

- Bun >= 1.0 or Node.js >= 18
- macOS (Linux support coming soon)

How it works

- Connection: Uses ipconfig, netstat`, and ipify.org API
- Devices: Parses the ARP table with MAC vendor lookup (1000+ vendors)
- Speed: Tests against Cloudflare's speed test endpoints
- Ports: TCP connect scan on common service ports
- WiFi: Reads from macOS system_profiler
- ISP: Queries ip-api.com (free, no API key required)
- Traceroute: Runs native traceroute command
- Health: HTTP HEAD requests to major services

License

MIT