HotBox - Network & System Monitor Utility
Version 1.0
Author: K0NxT3D
Date: 2025

--------------------------------------------------------
REQUIREMENTS
--------------------------------------------------------
- Go 1.20+ installed
- Linux, macOS, or Windows
- WiFi interface (optional, for monitoring connected clients)
- LAN interface (optional, for network throughput metrics)
- `iw` command installed on Linux for WiFi client detection
  (Linux: sudo apt install iw)
  
--------------------------------------------------------
INSTALLATION
--------------------------------------------------------

# Initialize Go module
go mod init hotbox

# Install required Go modules
go get github.com/gin-gonic/gin
go get github.com/gorilla/websocket
go get github.com/shirou/gopsutil/v3/cpu
go get github.com/shirou/gopsutil/v3/disk
go get github.com/shirou/gopsutil/v3/host
go get github.com/shirou/gopsutil/v3/mem
go get github.com/shirou/gopsutil/v3/net

# Build the executable
go build -o hotbox hotbox.go

# Run HotBox
./hotbox

--------------------------------------------------------
DESCRIPTION
--------------------------------------------------------
HotBox is a lightweight, cross-platform network and system monitoring utility
designed to provide real-time insights into your computer's hardware, network
interfaces, and connected WiFi clients.

FEATURES:

1. Interface Detection:
   - Automatically detects LAN and WiFi interfaces.
   - Allows users to select the interface they want to monitor via a web browser UI.

2. Real-Time WiFi Client Monitoring:
   - For WiFi interfaces, displays all connected devices and their signal strengths (dBm).
   - Continuously updates every few seconds.

3. System Monitoring:
   - CPU usage percentage.
   - RAM usage (total, used, and percent).
   - Disk usage (total, used, and percent).
   - Temperature sensors (if supported by the OS).
   - Network throughput for selected interface (RX/TX in bytes and rate per second).

4. Web-Based Interface:
   - Clean, responsive browser UI.
   - Dropdown to select network interface.
   - Displays connected WiFi devices and system metrics live.
   - Lightweight and requires no external HTML, CSS, or JS files.

5. Cross-Platform Compatibility:
   - Works on Linux, macOS, and Windows.
   - Automatically opens default browser on launch for user convenience.

6. Ease of Deployment:
   - Single Go file (`hotbox.go`) containing all logic and HTML.
   - Can be run as a service or standalone executable.
   - Minimal setup and dependencies.

--------------------------------------------------------
USAGE
--------------------------------------------------------
1. Launch HotBox:
   ./hotbox

2. Your default browser will open automatically to:
   http://127.0.0.1:6969

3. Select the network interface you want to monitor from the dropdown.

4. Monitor system metrics and connected WiFi clients in real-time.

--------------------------------------------------------
VALUE
--------------------------------------------------------
HotBox provides a **unified, clean, and visually intuitive** way to monitor
your computer’s network and system health. It combines essential metrics
and real-time WiFi client data in one lightweight, portable tool. It is ideal
for:
   - Network administrators monitoring multiple devices.
   - Home users tracking WiFi signal and network performance.
   - Developers and enthusiasts needing quick hardware insights.
   - Deploying as a service for constant monitoring.

--------------------------------------------------------
END OF README
--------------------------------------------------------


