Repolode
Submit
amanusk

amanusk/s-tui

Terminal UI that graphs CPU temperature, frequency, power and utilization, with a built-in CPU stress test.

Open-source alternative to:AIDA64

View on GitHubWebsite
Stars
5,117
Forks
183
Open issues
40
Last commit
2 months ago

What is it?

s-tui is a terminal-based monitor for CPU temperature, frequency, power draw and utilization. It draws live graphs in the console without needing an X server, so it works over SSH and on headless machines. It is aimed at checking whether a system's cooling and power limits hold under load rather than at listing running processes.

The tool includes a built-in CPU stress test that needs no extra dependencies. When numpy is installed, the stresser uses dense matrix multiplication for higher load; otherwise it falls back to SHA-256 hashing. Optional integration with stress or stress-ng adds memory, I/O and sync workloads.

When CPU throttling is detected, s-tui recolors the frequency graph and labels the cause, with separate reason codes for Intel and AMD chips when root access and the msr module are available. Users can log stats to CSV, print a single line of stats or JSON, and run shell scripts when a temperature threshold is exceeded.

Key features

  • 01Live terminal graphs for CPU temperature, frequency, power and utilization.
  • 02Built-in CPU stress test that works without extra dependencies.
  • 03Throttle indicators that show when and why the CPU has slowed down.
  • 04CSV logging and single-line text or JSON output for scripting.
  • 05Threshold hooks that run shell scripts when temperature is exceeded.

Use cases

  • Checking whether a server or workstation throttles under sustained load.
  • Monitoring CPU temperature and power on a headless Linux machine over SSH.
  • Stress testing a new cooling setup or overclock from the terminal.
  • Logging CPU metrics to CSV during a long benchmark run.

Quick start

  1. 1

    Install s-tui with pip

    pip install s-tui --user
  2. 2

    Run s-tui in the terminal

    s-tui

Things to know

  • Works only on UNIX-like systems, since urwid does not support Windows.
  • Licensed under GPL-2.0, a copyleft license.
  • Power readings are only available on certain Intel and AMD CPUs.
  • Detailed Intel and AMD throttle reasons need root access and the msr kernel module.

In collections

Terminal UI appsCLI & terminal tools

Topics

#cpu#monitoring#terminal#tui#stress-test#temperature#linux#python#cli#console

FAQ

What is s-tui?
Terminal UI that graphs CPU temperature, frequency, power and utilization, with a built-in CPU stress test. s-tui is a terminal-based monitor for CPU temperature, frequency, power draw and utilization. It draws live graphs in the console without needing an X server, so it works over SSH and on headless machines. It is aimed at checking whether a system's cooling and power limits hold under load rather than at listing running processes.
Is s-tui free to use? What license does it have?
s-tui is open source under the GPL-2.0 license. Check the license terms before using it in commercial products.
Is s-tui still maintained?
Updated within 6 months. The last commit to s-tui was on Sep 15, 2026.
What can I use s-tui for?
Checking whether a server or workstation throttles under sustained load. Monitoring CPU temperature and power on a headless Linux machine over SSH. Stress testing a new cooling setup or overclock from the terminal. Logging CPU metrics to CSV during a long benchmark run.
How do I install s-tui?
Install s-tui with pip: pip install s-tui --user Run s-tui in the terminal: s-tui
Where can I get s-tui?
The source code and installation instructions are on GitHub: https://github.com/amanusk/s-tui

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects