[Software Name] is a terminal visualization tool designed to monitor real-time hardware sensor data from HWInfo. The software provides a clean, gping-inspired interface for tracking and analyzing critical system metrics.
Key Features:
Real-time monitoring of hardware sensors with configurable refresh rates
Unit-based filtering for organizing and visualizing sensors by measurement type
Dual Y-axes charts for displaying different units on the same graph
Responsive design that adapts to terminal size and supports compact mode
Fuzzy sensor matching for partial name searches with suggestions
Rich statistics including min, max, average, and 95th percentile values
Ideal for tech enthusiasts, system administrators, and gamers who need a clear and intuitive way to visualize hardware performance data in real-time. The tool can be installed via winget or other package managers, making it accessible across multiple platforms while maintaining its terminal-based simplicity.
README
🖥️ HWInfo TUI
A terminal plotting tool for visualizing real-time hardware sensor data from HWInfo64 (Windows), inspired by gping.
# top left pane
hwinfo-tui monitor sensors.CSV "CPU Package Power" "Total System Power" "GPU Power" --time-window 120 --refresh-rate 1
# bottom left pane
hwinfo-tui monitor sensors.CSV "Physical Memory Load" "Total CPU Usage" "GPU D3D Usage" --time-window 120 --refresh-rate 1
# top right pane
hwinfo-tui monitor sensors.CSV "Core Temperatures" "CPU Package" "GPU Temperature" --time-window 120 --refresh-rate 1
# bottom right pane
hwinfo-tui monitor sensors.CSV "Core Thermal Throttling" "Core Critical Temperature" "Package/Ring Thermal Throttling" --time-window 120 --refresh-rate 1
✨ Features
Real-time Monitoring: Live sensor data visualization with configurable refresh rates
gping-inspired UI: Clean interface with statistics table and interactive chart
Unit-based Filtering: Automatically groups sensors by units, supports up to 2 units simultaneously
Dual Y-axes: Charts can display different units on left and right axes
Clean Interface: Focused visualization without unnecessary interactive distractions
Responsive Design: Automatically adapts to terminal size with compact mode
Fuzzy Sensor Matching: Partial sensor name matching with suggestions
git clone https://github.com/hwinfo-tui/hwinfo-tui.git
cd hwinfo-tui
# Quick setup (recommended)
./setup.sh # or setup.bat/setup.ps1 on Windows
# Manual setup
python -m venv venv
source venv/bin/activate # or venv\Scripts\activate on Windows
pip install -e .
🚀 Quick Start
Configure HWInfo64 logging (Windows): Open HWiNFO → Sensors → Start Logging → Choose CSV format and location
> Note: While HWInfo TUI can run on any platform with Python, HWInfo64 is only available for Windows. On other platforms, you can use HWInfo TUI with CSV files generated on Windows.
🚀 Performance
Memory Usage: < 50MB baseline, < 100MB with full data retention
CPU Overhead: < 2% of single core during normal operation
Startup Time: < 2 seconds from launch to first display
Update Frequency: Configurable from 0.1 to 60 seconds
🛠️ Troubleshooting
No matching sensors found
hwinfo-tui list-sensors sensors.csv # Check available sensors
hwinfo-tui monitor sensors.csv "CPU" "GPU" # Use partial names
Too many units excluded
Maximum 2 units supported - group sensors by similar units
# Clone and setup
git clone https://github.com/hwinfo-tui/hwinfo-tui.git
cd hwinfo-tui
./setup.sh # or setup.bat on Windows
# Activate environment
source ./activate.sh # or activate.bat/activate.ps1 on Windows
# Run tests
pytest
# Run the app
hwinfo-tui monitor sensors.csv "CPU"
