netshow: Monitor Network Connections in Your Terminal

Overview

Netshow is a process-aware terminal interface for inspecting live TCP connections on macOS and Linux. It connects network endpoints to processes and their details, making it easier to see what is communicating without piecing together separate command-line outputs.

It is useful for local troubleshooting and quick inspection rather than measuring per-process traffic: its bandwidth readings cover the host or a selected interface. The interface is built with Textual and supports interactive filtering, sorting, and process termination.

Key Features

• Lists live TCP connections with process IDs, service names, endpoints, and statuses.
• Shows process information such as executable, owner, command, working directory, threads, and CPU and memory usage.
• Displays host or interface receive and transmit rates with a 30-second sparkline.
• Filters connections with regular expressions across process IDs, names, addresses, and statuses.
• Sorts by process or status while preserving the selected connection.
• Offers connection and process details, including full IPv6 addresses.
• Provides confirmed process termination, with a separate confirmation before force-killing a process.
• Includes dark, light, and ANSI themes, plus a compact layout for small terminals.

Use Cases

• Developers investigating which local processes have open network connections.
• System administrators checking connection state and process ownership during routine troubleshooting.
• Operators watching host or interface bandwidth while diagnosing network activity.
• Users who want to filter or sort a busy connection list without leaving the terminal.

Getting Started

Install and run with uvx netshow. For additional installation options and usage details, see the README.

Considerations

• Requires Python 3.11 or newer and targets macOS and Linux.
• Connection visibility can be incomplete without sufficient privileges. Netshow tries psutil first and falls back to lsof when access is denied; install lsof if it is not present.
• Bandwidth is measured for the whole host or selected interface, not per process or connection. Summing interfaces can count traffic more than once on systems with bridges, tunnels, or virtual interfaces.
• Termination affects the whole process and its connections. Netshow asks for confirmation, checks process identity, and does not escalate automatically.
• The supplied repository metadata reports the license as NOASSERTION, while the README describes the project as MIT licensed. Check the repository license file when confirming licensing terms.