BatStat

BatStat 🦇📊

A terminal user interface (TUI) tool for monitoring, analyzing, and managing network connections in real time.

Table of Contents

• Main Interface
• Features
  • Process Management
  • Network Diagnostics
  • Export to CSV
  • In-App Help Panel
• Installation
• Usage
• Contributing
• License

Main Interface

The main view provides a two-pane layout:

• Left Pane: Live-updating list of connections
• Right Pane: Detailed information for the selected connection

This design makes it easy to monitor and analyze network activity efficiently.

(screenshot or asciinema gif here would really help 🚀)

Features

🔴 Live Monitoring

• Auto-refreshes the connection list every few seconds
• Real-time filtering (/ to filter by process name, PID, status, or address)
• Color-coded connection states (ESTABLISHED, LISTEN, CLOSE_WAIT, etc.)

📑 Two-Pane Layout

• View all connections and details simultaneously
• Column sorting:
  • Press s → cycle through sortable columns
  • Press S → toggle ascending/descending order

⚙️ Process Management

• k → Gracefully kill process for selected connection
• K → Force kill with SIGKILL

🌐 Network Diagnostics

• p → Ping remote address in a live modal overlay

📂 Export to CSV

• e → Export visible connections to BatStat_export.csv

❓ In-App Help Panel

• h → Toggle a detailed, colorful panel with all keybindings

Installation

Requires Go 1.21+.

Latest verison:

go install github.com/MrBrooks89/BatStat/cmd/BatStat@latest

Or Specific version:

go install github.com/MrBrooks89/BatStat/cmd/BatStat@v0.1.0

Make sure your GOPATH/bin is in your $PATH:
👉 Go Wiki: Setting GOPATH

Usage

Run BatStat:

BatStat

Press h at any time for a full list of keybindings.

Contributing

PRs are welcome!

• Open an issue for bugs or feature requests
• Fork and submit a pull request

License

MIT License — see LICENSE.