A cross-platform network scanner and defensive security toolkit — in a single window, with no Python required to run it.
NetScout shows you every device on your network, what each one is, and whether anything looks wrong — then gives you the tools to look closer and keep it safe. It runs on Windows, macOS and Linux, is written in pure Python standard library (no third-party runtime dependencies), and ships as a standalone app that needs nothing installed on the machines you run it on.
Scope: NetScout is a defensive tool for networks you own or are authorised to administer — your home, your company, your lab. It only ever acts through equipment you control, and it will not perform attacker techniques (see Philosophy below). Don't point it at networks that aren't yours.
- 36 tools in one interface — device discovery, WiFi/Bluetooth, monitoring, a one-click security audit, deep server and vulnerability scans, an emailable weekly health report and an action audit log, a passive packet inspector, credentialed power control and power policy (sleep-when-idle, after-hours shutdown, fleet deployment pack), and everyday network utilities (subnet calculator, DNS toolkit, website health).
- Scans your whole site, not just one LAN (v1.5.0) — sweep several subnets/VLANs in one run, each device tagged with the network it's on, and save the set as a reusable scan profile ("Server VLAN", "Guest WiFi").
- Pure standard library. No
pip installneeded to run from source; Bluetooth is the only optional extra. - Truly standalone builds. The packaged app bundles its own Python and Tcl/Tk — target machines need nothing installed. The build scripts prove it before they finish.
- Cross-platform, with per-OS backends that degrade gracefully when a feature isn't available on a given machine.
- 1,000+ automated checks across 59 test files covering the engine and the GUI.
- Switch X-ray. Point it at a managed switch and read it (read-only SNMP): every port's cable health and a port map of which device is plugged into each port — named from your scan, with its VLAN — so you can see your whole switch at a glance and find exactly where a device lives.
- Find it instantly. A live search box filters the device table as you type — by IP, name, brand, vendor, type, even risk level — and a PRIORITY column ranks every device by a 0–100 threat score, so whatever needs your attention is already at the top.
- 24/7 Guardian. Leave it running and NetScout watches over time: it diffs every scan into a plain-language "what changed" feed (new/departed devices, newly opened ports, rising risk), learns an approved baseline and flags drift from it, and pushes alerts to desktop, e-mail, and Slack/Teams/Discord — so you hear about it even with the app closed.
- Honest by design. Where a result is an estimate or a guess, it says so; where something can't be done safely, it explains why instead of faking it.
| Bluetooth & item-tracker detection | IP camera (ONVIF) control |
|---|---|
![]() |
![]() |
- Device Scan — every device on the network, with best-effort identification of type, brand and model (MAC vendor, hostnames, mDNS/Bonjour, WS-Discovery, UPnP, SNMP, open ports, TTL). Tells a laptop from a desktop and names the actual product line when the device reveals it — XPS, Latitude, ThinkPad, IdeaPad, Legion, EliteBook, Pavilion, ROG, ZenBook, Aspire, Predator, MacBook, Surface, Galaxy Book, MateBook, Framework, LG gram, TERRA and more, across Dell, HP, Lenovo, ASUS, Acer, MSI, Apple, Samsung, Huawei, Microsoft, Razer, Fujitsu and others — even from a bare model code (FX506 → ASUS TUF). It reports the maker of the computer, not the maker of its Wi-Fi card: a laptop with an Intel/Realtek/MediaTek card still reads "ASUS TUF", not "Intel". Finds devices that ignore ping — phones with randomised MAC addresses, and the cameras, printers and Windows PCs that only answer WS-Discovery — and drops devices that have left instead of listing stale ARP-cache entries (it checks the OS's own neighbour re-probe on Linux and Windows). On Linux with admin rights it also runs an active ARP sweep — asking every address on the segment for its MAC — which uncovers devices that are silent to ping and to every other probe; discovery is fast on every network: a quick first ping pass with a full-wait retry only for the addresses that stay silent, then a single parallel probe sweep across every remaining address and port at once — tuned to the network's measured round-trip time — in place of the old one-address-at-a-time check. A firewalled, ping-silent device is now found in a fraction of the time, so faster scans and more devices come together, not at each other's expense.
- Network Info — your IP, subnet, gateway, DHCP and DNS at a glance, plus Internet Check (reachability, latency, DNS tampering detection) and a Speed Test.
- Topology Map — a picture of the network with the router at the centre.
- Interfaces, Ping (with Trace Route), Router Scan (including a UPnP port-forward audit).
- Network Scan — every WiFi network in range, sortable/filterable by band. On Windows each pass triggers a fresh scan through the WLAN API (no admin rights), instead of re-reading Windows' cached list.
- Access Points — physical access points nearest-first, with a "warmer/colder" locator to walk to one.
- WiFi Audit — open networks, weak encryption, possible evil twins, rogue hotspots, A–F security grades.
- Spectrum — per-channel interference map and the best channel for your own network.
- Coverage Survey — walk room to room and build a signal heatmap to find dead spots.
- WiFi Password (for the network you're on).
- Bluetooth — passive BLE (and, on Linux, classic) discovery with median-smoothed signal and a calibrated distance range. Decodes what devices announce: Apple Continuity (AirPods, Watch, Handoff, Hotspot…), iBeacon and Eddystone beacons (including the URL), makers from Bluetooth company IDs.
- Computers nearby — reads the Windows Connected Devices (CDP) beacon, which states laptop vs desktop outright, and recognises laptops by name, so the Bluetooth scan surfaces a "COMPUTERS NEARBY" line listing the laptops and desktop PCs physically around you — whether or not they're on your network.
- Item-tracker detection — AirTags / Find My items (and whether one is separated from its owner), Tile, Samsung SmartTag, Chipolo and Google Find My Device tags are flagged and listed first.
- Live Monitor — continuous latency/packet-loss view.
- Background Watch — the 24/7 Guardian. Re-scans on an interval and turns NetScout into a continuous watch. Every pass is diffed against the one before it into a severity-tagged change feed — new device joined, departed, new open port (risky ones flagged louder), risk rose LOW→HIGH, vendor changed on the same MAC — shown live with a trend sparkline of devices and risks. Approve the current network as a golden baseline and it flags anything that drifts from it. Alerts go out at a severity you choose via desktop notification, e-mail (SMTP), and a Slack/Teams/Discord webhook, so you're told the moment something changes even if NetScout is closed. Already-approved devices are filtered out so it never cries wolf.
- Threat Monitor — watches for attacks in progress: deauthentication floods, evil twins, security downgrades, a vanishing network, beacon floods, and ARP-spoofing / man-in-the-middle.
- Packet Inspector — a passive, tcpdump/Wireshark-style look at live traffic on a link you administer: a packet-by-packet list plus an analysis of the protocol mix, who is talking to whom, the busiest ports, and plaintext protocols worth securing. It only listens (never transmits), keeps packet headers and metadata only — never message contents — and is admin-gated (Linux
AF_PACKET; WindowsSIO_RCVALL; on macOS it points you atsudo tcpdump). - Optional desktop notifications so alerts are seen when the window is minimised.
- Security Audit — one read-only pass that reuses the device scan, WiFi scan and router/firewall checks, then scores the network A–F and lists every issue worst-first with a concrete fix (open admin ports, open/weak WiFi, WPS, missing PMF, known-vulnerable software, router/ARP integrity, this machine's firewall). It also flags devices that may still have their factory-default password (cameras, routers, printers, NAS, server BMCs like iDRAC/iLO/Supermicro — advice only, it never tries a login) and network conflicts: one MAC address answering on several IPs (a classic sign of ARP spoofing or a misconfigured bridge) and more than one gateway (a rogue router or accidental double-NAT). It only reads what a scan can see — it changes nothing, and it's a posture check, not a penetration test.
- Server Scan — point it at the servers on your LAN and get a full per-server audit: a confirmed scan across ~100 service ports, service/version detection, known-vulnerability flags, exposed-datastore and risky-service detection, and TLS-certificate checks — each server graded A–F with a fix for every issue. Reads only; never exploits anything.
- Vulnerability Scan — the same deep audit aimed at every device, flattened into one worst-first list of everything known-vulnerable or dangerously exposed (outdated/EOL software, unauthenticated databases, exposed admin panels and management consoles, remote-control / backdoor / C2 ports, an open X11 display, expired/self-signed certificates, and other risky open services) — each with a plain-English fix. Version- and exposure-based ("update, or confirm it's patched") — not an exploit scanner.
- Full Report — one click runs the audit + server scan + vulnerability scan and produces a single branded, self-contained HTML report (NetScout reaper + wordmark, overall A–F grade, executive summary, every finding with a fix). Opens in any browser and prints cleanly to PDF to email or attach to a ticket. All scanned text is HTML-escaped, so a hostile banner can't tamper with the page.
- Port Scan — open ports with service/version detection and outdated / known-vulnerable software warnings, plus TLS certificate checks.
- Firewall — shows your real attack surface and whether the OS firewall is guarding it.
- MAC Privacy — a randomised hardware address, the way phones do it.
- Switch X-ray — read-only SNMP on a managed switch: every port's cable health (the gigabit port quietly linking at 100 because a pair is broken), plus a port map of which device is on each port (named from your scan, with its VLAN; uplinks/trunks flagged). Plus Switch Port (locate one device's port) and DHCP Check (catch a rogue DHCP server).
- Power Control — Wake-on-LAN, a usage check, and credentialed shutdown/restart over Windows admin, WinRM, SSH+sudo, or a server's IPMI/BMC — which can also power the server on and hard-cycle it when it's off or hung (the target authenticates; the BMC password is passed via the environment, never the command line or stored), including bulk shutdown of idle machines. There is no uncredentialed / forced power-off, by design.
- Power Policy (v1.4.0) — push a lasting power policy to a machine you administer, over the same credentialed channel (WinRM into Windows, SSH into Linux/Mac): sleep-when-idle, after-hours shutdown, and the root-cause fix for laptops on the Public firewall profile — a scoped firewall allow for your IT-management subnet only (WinRM/RDP/SMB), so IT can reach them without weakening anything else. Pick a device, see the exact command before it runs, and every "set" has a matching "clear" — all reversible.
- Power Saver (v1.4.0) — estimate the energy and money wasted by machines left on after hours (worst offenders first, your own watt/price assumptions), and save a fleet deployment pack: ready-to-roll GPO / PowerShell / cron scripts (sleep + nightly shutdown + the root-cause allow) plus a plain-English root-cause guide, to roll the policy out to the whole fleet at once.
- Health Report (v1.5.0) — a branded weekly summary: how many devices, an A–F grade, the risks worst-first with reasons, and what changed since last week. Save it as HTML or email it with your Guardian settings — and one command schedules it to send itself every week (the built app runs
wreportheadless, so NetScout needn't be open). - Action Log (v1.5.0) — an append-only accountability trail of every state-changing action NetScout sends (shutdowns, power policies, firewall blocks, switch-port changes): who ran it, when, the exact command, and whether it worked. Export it for your records.
- IP Camera — live picture and pan/tilt/zoom (W/A/S/D, E/Q) for ONVIF cameras you administer, using the camera's own login (WS-Security digest; the camera authenticates every frame and move). No access to cameras you have no login for.
- Attack response — cut an offending host off without powering anything off: block it at this machine's own OS firewall (Windows/Linux, reversible, needs local admin) or, with a managed switch, disable its switch port (SNMP, reversible). The ARP-spoofing check names the specific host impersonating the router.
- Subnet Calculator — IPv4/IPv6 subnet maths: network, broadcast, usable host range and count, netmask and wildcard — from a CIDR, an IP + mask, or a bare address — plus splitting a block into equal subnets. Pure, no traffic.
- DNS Toolkit — forward and reverse lookups and the common record types (A, AAAA, MX, TXT, NS, CNAME, SOA, PTR) against the system resolver or one you name, with the response time and status.
- Website Health — fetch a site (following redirects), report status and response time, inspect the TLS certificate and its expiry, and check the common security response-headers (HSTS, CSP, X-Frame-Options…) — graded A–F.
- Save results as TXT / CSV / JSON, or a self-contained HTML report to share with a colleague.
Grab the build for your OS (or build it yourself, below) and run it. No Python needed.
- Windows: run
NetScout.exe. If SmartScreen warns about an unknown app, choose More info → Run anyway. On locked-down PCs, use theNetScout-Folderversion. - macOS: right-click
NetScout.app→ Open the first time. - Linux: run the
NetScoutbinary (a.desktopentry is installed too).
Requires Python 3.9+ (3.11–3.13 recommended). No third-party packages are needed to run.
python3 netscout_gui.py # the graphical app
python3 netscout.py --help # the command-line interfaceBluetooth scanning is optional and uses bleak:
pip install bleakNetScout is packaged with PyInstaller. PyInstaller can't cross-compile, so build once on each OS you want a copy for:
Windows: build_windows.bat
macOS: bash build_macos.sh
Linux: bash build_linux.sh
Each script finds a suitable Python, bundles Tcl/Tk, builds the app, and then starts it with Python hidden from it to verify it really is standalone before finishing. Full details — including why a build can "still need Python on some PCs" and how that's prevented — are in BUILD_README / the Build Guide PDF.
Build with a standard python.org Python (not the Microsoft Store build, not a "free-threaded"
3.13tbuild). The Windows script will refuse the Store build and tell you why.
- Open NetScout and click Device Scan → Run. In a few seconds you'll see everything on your network.
- Turn on Background Watch to get alerted when something new joins.
- Right-click any device for notes, approval, or power actions.
- Explore — everything that only reads is completely safe; anything that changes something asks first.
A full beginner's guide is included as USER_MANUAL / the User Manual PDF.
NetScout is deliberately built so it can't be turned into an attack tool, because that's what makes it safe to hand to everyone on a team:
- It reads by default. The few actions that change something (firewall, MAC, disconnect, power) warn first and act only through infrastructure you administer.
- Even the capture tool is passive and metadata-only: the Packet Inspector opens a receive-only socket, never transmits, and keeps packet headers and summaries — not the contents of anyone's messages. There is no stream reassembly, no credential scraping, and no payload capture.
- Every powerful action is gated on credentials the target itself checks — SNMP write community for a switch port, admin rights or SSH for a shutdown. NetScout never forces a device that hasn't accepted the command.
- It won't do attacker techniques: no deauthentication/jamming, no ARP/IP spoofing, no evil-twin creation, no credential or handshake cracking, no forcing devices it has no rights over.
- It doesn't pretend. "Make me untraceable" isn't a real thing, so it offers MAC randomisation and points to a VPN/Tor instead of faking it.
- Vulnerability warnings are version-based. A vendor that back-ports a fix without changing the version string will still be flagged — the wording is always "update, or confirm it's patched".
- Device identification is best-effort. NetScout names the specific model line (laptop vs desktop, XPS / ThinkPad / Galaxy Book…) when the device reveals it in its hostname, mDNS or UPnP; when it reveals nothing, the label falls back to the broad "Computer" ("a PC/laptop but can't tell which") — still correct, just less specific.
- Some tools need the right environment. SNMP tools need a managed switch; true deauth-frame detection needs monitor mode (NetScout uses the OS's own disconnect log instead, which works everywhere but is indirect); spectrum analysis sees only WiFi, not microwaves or other RF.
- Distances are estimates from signal strength — a radius, not a GPS fix.
- Speed Test / Internet Check may be blocked on some corporate networks.
| File | What it is |
|---|---|
netscout.py |
The engine — all the network logic and the CLI. |
netscout_gui.py |
The graphical app (generated; Tkinter). |
netscout.spec |
PyInstaller build recipe (same file for all three OSes). |
build_windows.bat / build_macos.sh / build_linux.sh |
Per-OS build scripts. |
USER_MANUAL |
Beginner's guide. |
BUILD_README |
How to build the standalone app. |
© 2026 TheCodingExperiment — free software under the GNU AGPL v3. You may use, study, share and modify NetScout freely. The condition that matters: if you distribute it — or run a modified version as a network service — you must keep it open, publishing your source under the same AGPL-3.0 licence and keeping the author's copyright notice intact. That's what makes NetScout open source that nobody can quietly close up and resell as their own product. It comes with no warranty. Full terms in LICENSE.
NetScout is provided for legitimate network administration and defensive security on networks you own or are explicitly authorised to manage. You are responsible for how you use it. Scanning or interacting with networks and devices without authorisation may be illegal in your jurisdiction. The authors accept no liability for misuse or for any damage arising from its use.


