NETWATCH NG

Supervise your network from the terminal: device discovery, Wi-Fi analysis, firewall, diagnostics and activity log, in a keyboard-driven terminal interface built for Linux.

Linux amd64 · Debian and antiX · netwatch-ng package 2.1.1 available

Get started with NETWATCH NG

Via the official APT repository

Recommended method: signed repository published on GitHub Pages, netwatch-ng package 2.1.1 (stable suite, main component, amd64 index). Works on Debian and antiX.

set -eu
sudo install -d -m 0755 /usr/share/keyrings
curl -fsSL https://sudomarc.github.io/NETWATCH/public.key \
| sudo gpg --dearmor --yes --output /usr/share/keyrings/netwatch-ng-archive-keyring.gpg
sudo chmod 0644 /usr/share/keyrings/netwatch-ng-archive-keyring.gpg

printf '%s\n' 'deb [arch=amd64 signed-by=/usr/share/keyrings/netwatch-ng-archive-keyring.gpg] https://sudomarc.github.io/NETWATCH/ stable main' \
| sudo tee /etc/apt/sources.list.d/netwatch-ng.list >/dev/null
sudo chown root:root /etc/apt/sources.list.d/netwatch-ng.list
sudo chmod 0644 /etc/apt/sources.list.d/netwatch-ng.list

sudo apt update
sudo apt install netwatch-ng
Version 2.1.1 release

From source

The alternative for developing or contributing: clone the repository, install the Python package in editable mode and launch the TUI. No third-party dependency required.

git clone https://github.com/sudomarc/NETWATCH.git
cd NETWATCH
python -m pip install -e .
python -m netwatch_ng
Full installation instructions
Included in version 2.x See all capabilities
  • Dashboard & interface inspection
  • ARP/NDP discovery & Nmap
  • Wi-Fi inventory & survey
  • IPv4/IPv6 firewall control
  • Network diagnostics
  • JSON / CSV exports

Signed and verified APT repository (public key, index and package signature). NETWATCH NG remains an administration tool: use it only on systems and networks you own or are explicitly authorized to manage.

What NETWATCH NG monitors

Every module is implemented and tested. The TUI delegates all business logic to the command layer: validation, ownership checks and SSH host verification remain in the core.

netwatch-ng — Devices

        

Device discovery

Continuous passive ARP/NDP discovery, operator-triggered Nmap on an authorized target or subnet, evidence-based identification (neighbors, Nmap, local OUI table) with source and confidence level displayed. Inventory export to JSON or CSV.

Adapts to your terminal

Keyboard-driven TUI

curses interface with no third-party Python dependency: `↑↓` navigation, `/` to filter, `?` for help, explicit confirmations for every destructive action.

Machine output

`scan json` / `scan csv` remain pure CLI interfaces, intended for scripting and automation: never decorated by human display.

Tools detected at runtime

Nmap, iproute2, iptables, OpenSSH, Aircrack-ng: each optional tool is detected at startup, and the capabilities that depend on it are announced as unavailable rather than simulated.

Security-first design

The principles that govern every NETWATCH NG screen.

« Identification is evidence-based: neighbors, Nmap and local OUI table. Every device attribute remains labeled with its source and confidence level. »

Evidence-based identification

« Block and unblock operate only on the NETWATCH chain explicitly marked as owned. A pre-existing chain with the same name is rejected, never modified. »

Owned Netfilter chains

« No destructive action is ever a one-key action: scope, target and owned resources are displayed before confirmation. »

Explicit confirmations

« With `--dry-run`, no write occurs — not iptables, not tc, not ARP, not state files — while read-only validation describes what would happen. »

Dry-run contract

Relies on your favorite Linux tools

NETWATCH NG runs the standard Linux networking utilities you already use — nmap, iproute2, iptables, tc, aircrack-ng, OpenSSH — and reports which ones are present or missing.

  • nmap
  • iproute2
  • iptables
  • ip6tables
  • tc
  • aircrack-ng
  • OpenSSH
  • iw

FAQ

On which systems does NETWATCH NG run?

NETWATCH NG is a Linux-only tool. The TUI requires Python 3.10+ (standard library `curses`, no third-party dependency). Debian package builds are validated in CI for Debian 12 and 13.

Are root privileges required?

Control operations — firewall, Wi-Fi monitor mode, traffic policing, reset — require root. Passive discovery, interface inspection and diagnostics work without elevation, with separate state directories by privilege.

Is Wi-Fi monitor mode dangerous for my connection?

Putting an interface into monitor mode interrupts the Wi-Fi connection on that interface: it's an explicit action, preceded by a warning and confirmation. The survey refuses to force the interface carrying the default route, and the TUI restores the adapter on exit. `airmon-ng check kill` is never run automatically.

Which optional tools enrich NETWATCH NG?

Nmap for active discovery and service identification, the Aircrack-ng suite for Wi-Fi inventory and survey, `dsniff`/`arping` for ARP support on the 1.x line. Missing tools are detected at runtime and the corresponding capabilities are announced as unavailable.

What is the difference between NG and the legacy Bash 1.x line?

NETWATCH NG is the Python 3 rewrite with an exclusive full-screen TUI (dashboard, devices, firewall, diagnostics, persistent settings, bounded activity log). The legacy Bash 1.x scripts remain available as the historical CLI surface; the 1.x capability table in the README describes that line, not the rewrite.

What is the latest stable version?

NETWATCH NG 2.1.1 is published on the official signed APT repository (stable/main, amd64). See the 2.1.1 release notes.

How do I update NETWATCH NG?

Refresh APT and install the latest available package with sudo apt update followed by sudo apt install --only-upgrade netwatch-ng. To upgrade all installed packages, use sudo apt upgrade.

Why does the repository use amd64 only?

The NETWATCH APT index is published for amd64. The installation entry uses arch=amd64 only for this repository; it does not disable the system-wide i386 architecture or affect other repositories.

Can I contribute or report a security issue?

Yes. See `CONTRIBUTING.md` for contributions and `SECURITY.md` for responsible disclosure. Regression tests (Bash and Python) and the pseudo-terminal E2E suite run locally without real network scanning.

Supervise your network from your terminal.

NETWATCH NG runs where you work: in your terminal.

set -eu
sudo install -d -m 0755 /usr/share/keyrings
curl -fsSL https://sudomarc.github.io/NETWATCH/public.key \
| sudo gpg --dearmor --yes --output /usr/share/keyrings/netwatch-ng-archive-keyring.gpg
sudo chmod 0644 /usr/share/keyrings/netwatch-ng-archive-keyring.gpg

printf '%s\n' 'deb [arch=amd64 signed-by=/usr/share/keyrings/netwatch-ng-archive-keyring.gpg] https://sudomarc.github.io/NETWATCH/ stable main' \
| sudo tee /etc/apt/sources.list.d/netwatch-ng.list >/dev/null
sudo chown root:root /etc/apt/sources.list.d/netwatch-ng.list
sudo chmod 0644 /etc/apt/sources.list.d/netwatch-ng.list

sudo apt update
sudo apt install netwatch-ng

Or consult the documentation or the version 2.1.1 release.