{"name":"netshow: Interactive Network Connection Monitor for Your Terminal","description":"netshow is a lightweight, performant, and interactive network connection monitor designed for your terminal. It provides human-friendly service names and deep process drill-down, making network analysis intuitive for both macOS and Linux users. This tool offers real-time metrics, advanced filtering, and a modern Textual UI for an enhanced monitoring experience.","github":"https://github.com/taylorwilsdon/netshow","url":"https://osrepos.com/repo/taylorwilsdon-netshow","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/taylorwilsdon-netshow","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/taylorwilsdon-netshow.md","json":"https://osrepos.com/repo/taylorwilsdon-netshow.json","topics":["netshow","networking","terminal-app","Python","network-monitor","system-monitoring","cli-tool","tcp-connections"],"keywords":["netshow","networking","terminal-app","Python","network-monitor","system-monitoring","cli-tool","tcp-connections"],"stars":null,"summary":"netshow is a lightweight, performant, and interactive network connection monitor designed for your terminal. It provides human-friendly service names and deep process drill-down, making network analysis intuitive for both macOS and Linux users. This tool offers real-time metrics, advanced filtering, and a modern Textual UI for an enhanced monitoring experience.","content":"## Introduction\n\nnetshow is an interactive, process-aware network monitoring tool built for your terminal. It offers a lightweight and performant way to observe TCP connections, providing friendly service names for common applications like Docker, Plex, and VS Code, rather than cryptic binaries. Designed for macOS and Linux, netshow gives users deep insights into network activity, including process details, real-time metrics, and advanced filtering capabilities, all within a modern Textual UI.\n\n## Installation\n\nGetting started with netshow is straightforward. The easiest method is using `uvx`, or you can clone the repository for a local build.\n\n**Using uvx (recommended):**\n\nbash\nuvx netshow\n\n\n**Local Build:**\n\nbash\ngit clone https://github.com/taylorwilsdon/netshow.git\ncd netshow\nuv run netshow\n\n\n**Note:** If run without root or sudo privileges, netshow will automatically switch to `lsof` for most connection data, still providing valuable insights.\n\n## Examples\n\nOnce installed, you can run netshow with default settings or customize its behavior.\n\n**Basic Usage:**\n\nbash\nnetshow\n\n\n**Custom Refresh Interval:**\n\nbash\nnetshow --interval 1.0\n\n\n**Keybindings for Interaction:**\nnetshow offers a rich set of keybindings for navigation and control:\n*   `? / ?`: Move cursor\n*   `? / Click`: Open detail view for a connection\n*   `Esc / ?`: Return to the main list\n*   `q`: Quit netshow\n*   `f` or `/`: Toggle filter input for advanced search\n*   `s`: Sort by connection status\n*   `p`: Sort by process name\n*   `i`: Cycle network interface for bandwidth monitoring\n\n## Why Use It\n\nnetshow stands out as a powerful network monitoring solution due to several key features:\n*   **Human-Friendly Names:** It translates complex process IDs and ports into recognizable application names, simplifying network analysis.\n*   **Deep Process Drill-Down:** Gain comprehensive details about each connection's associated process, including path, PID, command line, CPU usage, memory, and open files.\n*   **Real-time Metrics:** Monitor live connection counts and bandwidth usage, with the ability to select specific network interfaces.\n*   **Advanced Filtering:** Utilize regex-powered search across all connection fields for precise data isolation.\n*   **Modern UI:** Enjoy a smooth, interactive terminal experience powered by Textual, featuring dark theme support and optimized rendering for large datasets.\n*   **Flexible Operation:** Runs effectively both with root privileges for full fidelity via `psutil` and as a regular user using `lsof`.\n\n## Links\n\nFor more information, to contribute, or to report issues, please visit the official GitHub repository:\n\n*   **GitHub Repository:** [https://github.com/taylorwilsdon/netshow](https://github.com/taylorwilsdon/netshow)","metrics":{"detailViews":13,"githubClicks":17},"dates":{"published":null,"modified":"2026-01-03T12:00:59.000Z"}}