https://github.com/stefanicjuraj/sysview
command-line tool to list active network processes and listening ports
https://github.com/stefanicjuraj/sysview
cli network ports system
Last synced: 5 months ago
JSON representation
command-line tool to list active network processes and listening ports
- Host: GitHub
- URL: https://github.com/stefanicjuraj/sysview
- Owner: stefanicjuraj
- Created: 2025-12-18T01:45:26.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-12-18T02:04:10.000Z (6 months ago)
- Last Synced: 2025-12-21T12:12:08.954Z (6 months ago)
- Topics: cli, network, ports, system
- Language: Go
- Homepage:
- Size: 8.79 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# sysview
Command-line tool to list active network processes and connections. The tool uses `lsof` to query active network connections and displays all connections with their local and remote addresses.
```
Active Network Processes (48)
--------------------------------------------------------------------------------------------------
PID COMMAND PROTO PORT LOCAL ADDRESS REMOTE ADDRESS STATE
--------------------------------------------------------------------------------------------------
626 identitys TCP 1024 fe80:1a::3437:40d... fe80:1a::f26f:da2... ESTABLISHED
12500 node TCP 3000 ::1 - LISTEN
580 ControlCenter TCP 5000 0.0.0.0 - LISTEN
420 Brave Browser TCP 7000 0.0.0.0 - LISTEN
250 Raycast TCP 1234 127.0.0.1 - LISTEN
585 rapportd TCP 52001 0.0.0.0 - LISTEN
...
```
```
Total Connections: 44
TCP: 37
UDP: 7
IPv4: 34
IPv6: 10
Listening: 5
Established: 31
```
## Installation
### Build from Source
1. Clone the repository:
```bash
git clone https://github.com/stefanicjuraj/sysview
```
2. Build the binary:
```bash
go build -o sysview .
```
3. Install (choose one):
**System-wide installation** (requires sudo):
```bash
sudo cp sysview /usr/local/bin/
```
**User installation** (no sudo required):
```bash
cp sysview ~/go/bin/
```
Make sure `~/go/bin` is in your PATH.
## Usage
```bash
sysview # Show all network connections (default)
sysview stats # Show network statistics summary
sysview state ESTABLISHED # Filter by connection state (LISTEN, ESTABLISHED, TIME_WAIT, CLOSE_WAIT, etc.)
```
### `stats`
Displays network statistics summary:
- Total connections
- TCP vs UDP counts
- IPv4 vs IPv6 counts
- Listening vs Established connections
### `state`
Filter connections by state:
- `sysview state LISTEN`: show only listening ports
- `sysview state ESTABLISHED`: show only established connections
- `sysview state TIME_WAIT`: show connections in time wait state
- `sysview state CLOSE_WAIT`: show connections in close wait state