s-tui
Terminal-based CPU stress and monitoring utility
What is s-tui?
Terminal-based CPU stress and monitoring utility
Overview of s-tui
What it is
s-tui is a terminal-based CPU stress and monitoring utility. It displays CPU temperature, frequency, power, and utilization in graphical form directly in the terminal. The tool requires no X-server and includes a built-in CPU stress test that works out of the box.
Key features
- Monitors CPU temperature, utilization, frequency, and power in real time
- Shows performance dips caused by thermal throttling
- Built-in CPU stress test with zero extra dependencies (falls back to SHA-256 hashing; uses BLAS matrix multiplication when numpy is available)
- Optional integration with external stress tools (stress/stress-ng)
- Supports throttle indicators for Intel (thermal, PROCHOT, power limit, etc.) and AMD (P-state cap) when run with root and msr module
- Configurable threshold scripts (e.g., run a shell script when CPU temperature exceeds a threshold)
- Save and restore configuration via a config file
Use cases
- Monitoring CPU health and thermal performance under load
- Testing system cooling and power delivery by running the built-in stress test
- Debugging thermal throttling issues on servers or workstations without a graphical environment
- Automating threshold-based actions (e.g., logging or alerting when CPU temperature exceeds a set limit)
Getting started
Install via pip (x86 and ARM):
pip install s-tui --user
Make sure ~/.local/bin is in your PATH. Then run:
s-tui
For other installation methods (Ubuntu, Debian, Arch, Fedora, OpenSUSE), see the repository README.
License and pricing
License: GPL-2.0. Pricing: open source (free).
Based on the project's public README and repository metadata.