Skip to content

Latest commit

 

History

39 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

NetWatch

PyPI version Python License: MIT

A lightweight, real-time network monitoring tool for the Linux terminal — ping, bandwidth, wifi, scanning, traceroute, and SNMP queries, all in one CLI.

image

Why NetWatch

Most network diagnostics on Linux mean reaching for half a dozen separate tools — ping, iftop, traceroute, iwconfig, snmpwalk — each with its own output format. NetWatch wraps the common ones into a single, fast CLI with a clean terminal UI, so day-to-day network troubleshooting stays in one place.

Features

  • Live dashboard — ping, speed, and wifi info in one view
  • Network scanning — discover active hosts on your LAN, with optional CIDR range
  • Bandwidth monitor — real-time RX/TX speed, packet rate, errors, and totals, per interface or default
  • Traceroute — hop-by-hop path to any host
  • SNMP queries — pull device info without a separate SNMP client
  • Wifi info — interface details at a glance
  • Built on Rich for a fast, clean terminal UI

Installation

Quick install (from source)

git clone git@github.com:WhoamiRAGE/NetWatch.git
cd NetWatch
./install.sh

This creates a virtual environment, installs NetWatch into it, installs a netwatch launcher to ~/.local/bin, and wires that directory into your shell's PATH — bash, zsh, and fish are all handled automatically. Open a new terminal afterward and run netwatch.

From PyPI

pip install netwatch-cli

Manual (from source)

git clone git@github.com:WhoamiRAGE/NetWatch.git
cd NetWatch

python -m venv .venv
source .venv/bin/activate

pip install -e .

Usage

netwatch                       Live dashboard (ping, speed, wifi)
netwatch scan                  Scan local network for active hosts
netwatch scan --range <CIDR>   Scan a specific network range
netwatch wifi                  Show wifi interface info
netwatch trace <host>          Traceroute to a host
netwatch bw                    Bandwidth monitor (default interface)
netwatch bw <interface>        Bandwidth monitor for a specific interface
netwatch snmp <host>           Query a device via SNMP
netwatch --version             Show version
netwatch --help                Show this help message

Requirements

  • Linux
  • Python 3.10+
  • Network access

Contributing

Issues and pull requests are welcome — see Issues.

License

MIT — see LICENSE.

About

Real-time network monitoring CLI for Linux — ping, bandwidth, wifi, scanning, traceroute, and SNMP in one tool

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages