PortScout

PortScout

PortScout is a terminal-based User Interface (TUI) tool designed to monitor network connections and manage the associated processes. Developed using the Bubble Tea framework, PortScout offers a streamlined approach for users to gain insights into their network activity.

Features

• Live Connection Monitor: Displays a real-time table of network connections, showcasing details such as port, process name, Process ID (PID), protocol (TCP/UDP), connection status, and remote address with automatic updates every second.
• Search and Filter Capabilities: Quickly filter results by any field using the / key, allowing for partial matches. For example, typing node highlights all Node.js connections, while 8080 isolates results on that specific port.
• Detailed Process Information: By selecting a row and hitting Enter, users can access comprehensive details about the process including the command line, user information, CPU/memory usage, file descriptors, current working directory, and start time.
• Group by PID Functionality: Users can organize connections by their respective processes using the g key, revealing the count of connections per process for improved workflow management.
• Process Termination: The ability to terminate any process directly from PortScout by selecting the process and confirming with the k key enhances user control over network management.
• Dynamic Sorting Options: Users can sort the displayed connections by various columns—simply press s to cycle through sort options and S to reverse the sorting order.
• Pause Auto-Refresh: To examine specific snapshots of data, the f key can be leveraged to temporarily freeze the display, preventing data from updating automatically.

Keybindings

Key	Action
q / Ctrl+C	Quit the application
/	Initiate filtering by various criteria
Enter	Confirm filter or view process details
Esc	Exit filter mode or clear filter
k	Kill the selected process with confirmation
s	Cycle through sort columns
S	Reverse the sort direction
f	Freeze or unfreeze the auto-refresh
g	Toggle group-by-PID view
Up / Down	Navigate through rows

Tech Stack

PortScout utilizes a variety of powerful libraries to deliver its functionality:

• Bubble Tea for TUI
• Lip Gloss for styling
• Bubbles for the table component
• gopsutil for cross-platform process and network data

For those looking for an efficient solution to monitor and manage network connections, PortScout provides an intuitive and effective interface.