nets

A fast, interactive network dashboard for your terminal.

---

nets is a cross-platform, real-time network dashboard for the terminal, inspired by htop but focused on networking. It gives you a live, interactive view of local ports, processes, and LAN devices—all in a modern TUI.

---

Features

• Live port & process table
• LAN device discovery
• Fast keyboard navigation & filtering
• Animated ping modal
• IP, router, and hostname in header
• Colorful, modern UI
• Paging & scrolling for large tables
• Cross-platform (Linux, macOS, Windows)
• Modular, extensible codebase

Potential/Future Features

• Copy IP/host/ping results to clipboard
• Traceroute modal
• Export tables to CSV/JSON
• Service name lookup for ports
• Network interface stats (live RX/TX)
• Notifications for new devices/ports
• Theme toggle (light/dark/high-contrast)
• Block/allowlist for devices/ports

Install

You can install nets in two ways:

With Cargo (recommended)

cargo install nets

From GitHub Releases

1. Download the latest release for your platform from the releases page.
2. Unpack the archive and move the nets binary to a directory in your $PATH (e.g., /usr/local/bin).
3. Run nets from your terminal!

Usage

cargo run --release -- [OPTIONS]

Options

• -r, --refresh <SECONDS> Refresh interval (default: 2)
• --no-lan Disable LAN device scanning
• -p, --port <PORT> Filter by port number

Keyboard Shortcuts

• / Start text filter
• p Open ping modal
• Tab Switch focus between tables
• Up/Down Scroll
• PageUp/PageDown Page scroll
• q Quit

Usage Example

$ cargo run --release -- --refresh 1

---

Try nets today and take control of your network visibility! 🚦

Building

Requires Rust 2021+. Clone the repo and run:

cargo build --release

License

nets is licensed under the MIT License. See LICENSE for details.

Contributing

Contributions, bug reports, and feature requests are welcome! Please open an issue or pull request.

Acknowledgments

• ratatui for the TUI framework
• tokio for async runtime
• procfs for process/port info
• get_if_addrs for network interfaces

---

nets: The network dashboard your terminal deserves.