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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/amanusks-tui.svg)](https://yunodb.com/tools/amanusks-tui?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/amanusks-tui?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/amanusks-tui.svg" alt="Featured on YunoDB" height="20"></a>