# The Stress Terminal UI: s-tui
[](https://badge.fury.io/py/s-tui)
[](https://pepy.tech/project/s-tui)
Stress-Terminal UI, s-tui, monitors CPU temperature, frequency, power and utilization in a graphical way from the terminal.
## Screenshot
# Table of Contents
- [The Stress Terminal UI: s-tui](#the-stress-terminal-ui-s-tui)
- [Screenshot](#screenshot)
- [What it does](#what-it-does)
- [Usage](#usage)
- [Simple installation](#simple-installation)
- [pip (x86 ARM)](#pip-x86--arm)
- [More installation methods](#more-installation-methods)
- [Ubuntu (18.10 and newer)](#ubuntu-1810-and-newer)
- [Ubuntu (18.04, 16.04)](#ubuntu-1804-1604)
- [Arch Linux, Manjaro](#arch-linux-manjaro)
- [OpenSUSE](#opensuse)
- [Fedora](#fedora)
- [Options](#options)
- [Dependencies](#dependencies)
- [Configuration](#configuration)
- [Saving a configuration](#saving-a-configuration)
- [Adding threshold scripts](#adding-threshold-scripts)
- [Run from source code](#run-from-source-code)
- [OPTIONAL integration of FIRESTARTER (via submodule, does not work on all systems)](#optional-integration-of-firestarter-via-submodule-does-not-work-on-all-systems)
- [Compatibility](#compatibility)
- [FAQ](#faq)
- [Contributing](#contributing)
- [Tip](#tip)
## What it does
- Monitoring your CPU temperature/utilization/frequency/power
- Shows performance dips caused by thermal throttling
- Requires no X-server
- Built-in options for stressing the CPU (stress/stress-ng/FIRESTARTER)
## Usage
```
s-tui
```
## Simple installation
### pip (x86 + ARM)
The most up to date version of s-tui is available with pip.
Install with:
```
pip install s-tui --user
```
(This usually creates an executable in ~/.local/bin/ dir. Make sure it is in your PATH)
To install as root
```
sudo pip install s-tui
```
You might need to install `python-dev` first
Installation in virtualenv with [pipsi](https://github.com/mitsuhiko/pipsi):
```
pipsi install s-tui
```
## More installation methods
### Ubuntu (18.10 and newer)
```
sudo apt install s-tui
```
### Ubuntu (18.04, 16.04)
A PPA is available but is not up to date
```
sudo add-apt-repository ppa:amanusk/python-s-tui
sudo apt-get update
sudo apt-get install python3-s-tui
```
### Arch Linux, Manjaro
`s-tui` is in the Arch repository:
```
sudo pacman -S s-tui
```
`s-tui-git` follows the master branch, maintained by [@MauroMombelli](https://github.com/MauroMombelli)
Install it with:
`yay -S s-tui-git`
### OpenSUSE
```
sudo zypper install s-tui
```
### Fedora
`s-tui` is in the Fedora [repository](https://src.fedoraproject.org/rpms/s-tui):
```
sudo dnf install s-tui
```
## Options
```
TUI interface:
The side bar houses the controls for the displayed graphs.
At the bottom, all sensors reading are presented in text form.
* Use the arrow keys or 'hjkl' to navigate the side bar
* Toggle between stressed and regular operation using the radio buttons in 'Modes'.
* If you wish to alternate stress defaults, you can do it in <Stress options>
* Select graphs to display in the <Graphs> menu
* Select summaries to display in the <Summaries> menu
* Use the <Reset> button to reset graphs and statistics
* If your system supports it, you can use the UTF-8 button to get a smoother graph
* Save your current configuration with the <Save Settings> button
* Press 'q' or the <Quit> button to quit
* Run `s-tui --help` to get this message and additional cli options
optional arguments:
-h, --help show this help message and exit
-d, --debug Output debug log to _s-tui.log
--debug-file DEBUG_FILE
Use a custom debug file. Default: _s-tui.log
-dr, --debug_run Run for 5 seconds and quit
-c, --csv Save stats to csv file
--csv-file CSV_FILE Use a custom CSV file. Default: s-tui_log_<TIME>.csv
-t, --terminal Display a single line of stats without tui
-j, --json Display a single line of stats in JSON format
-nm, --no-mouse Disable Mouse for TTY systems
-v, --version Display version
-tt T_THRESH, --t_thresh T_THRESH
High Temperature threshold. Default: 80
```
## Dependencies
s-tui is great for monitoring. If you would like to stress your system, install stress. Stress options will then show up in s-tui (optional)
```
sudo apt-get install stress
```
## Configuration
s-tui is a self-contained application that can run out-of-the-box and doesn't need config files to drive its core features. However, additional features like running scripts when a certain threshold has been exceeded (e.g. CPU temperature) does necessitate creating a config directory. This directory will be made in `~/.config/s-tui` by default.
### Saving a configuration
Selecting \<Save Settings\> will save the current configuration to `~/.config/s-tui/s-tui.conf`. If you would like to restore defaults, simply remove the file.
### Adding threshold scripts
s-tui gives you the ability to run arbitrary shell scripts when a certain threshold is surpassed, like your CPU temperature. You can define this custom behaviour by adding a shell file to the directory `~/.config/s-tui/hooks.d` with one of the following names, depending on what threshold you're interested in reacting to:
- `tempsource.sh`: triggered when the CPU temperature threshold is exceeded
If s-tui finds a script in the hooks directory with the name of a source it supports, it will run that script every 30 seconds as long as the current value of the source remains above the threshold.
Note that at the moment only CPU temperature threshold hooks are supported.
## Run from source code
Start by cloning the repository
```
git clone https://github.com/amanusk/s-tui.git
cd s-tui
```
Install required dependencies as \[root\] or as (local user)
```
[sudo] pip install urwid (--user)
[sudo] pip install psutil (--user)
```
Install stress (optional)
```
sudo apt-get install stress
```
Run the .py file
```
python -m s_tui.s_tui
```
### OPTIONAL integration of FIRESTARTER (via submodule, does not work on all systems)
[FIRESTARTER](https://github.com/tud-zih-energy/FIRESTARTER) is a great tool to stress your system to the extreme.
If you would like, you can integrate FIRESTARTER submodule into s-tui.
To build FIRESTARTER:
```
git submodule init
git submodule update
cd ./FIRESTARTER
./code-generator.py
make
```
Once you have completed these steps, you can either:
- Install FIRESTARTER to make it accessible to s-tui, e.g make a soft-link to FIRESTARTER in /usr/local/bin.
- Run s-tui from the main project directory with `python -m s_tui.s_tui`
An option to run FIRESTARTER will then be available in s-tui
## Compatibility
s-tui uses [psutil](https://github.com/giampaolo/psutil) to probe hardware information. If your hardware is not supported, you might not see all the information.
s-tui uses [urwid](https://github.com/urwid/urwid) as a graphical engine. urwid only works with UNIX-like systems
- Power read is supported on Intel Core CPUs of the second generation and newer (Sandy Bridge)
and on AMD Family 17h CPUs through the [amd_energy](https://www.kernel.org/doc/html/latest/hwmon/amd_energy.html) driver.
- s-tui tested to run on Raspberry-Pi 4,3,2,1
## FAQ
**Q**: How is this different from htop?
**A**: s-tui is not a processes monitor like htop. The purpose is to monitor your CPU statistics and have an option to test the system under heavy load. (Think AIDA64 stress test, not task manager).
**Q**: I am using the TTY with no X server and s-tui crashes on start
**A**: By default, s-tui is handles mouse inputs. This causes some systems to crash. Try running `s-tui --no-mouse`
**Q**: I am not seeing all the stats in the sidebar.
**A**: The sidebar is scrollable, you can scroll down with `DOWN` or `j` or scroll to the bottom with `PG-DN` or `G`. You might consider also decreasing the size of the font that you use in your terminal.:)
## Contributing
New issues and Pull Requests are welcome :)
If you notice a bug, please report it as a new issue, using the provided template.
To open a Pull Request, please see [CONTRIBUTING](https://github.com/amanusk/s-tui/blob/master/CONTRIBUTING.md) for more information.
## Tip
If you like this work, please star it on GitHub.
BTC: `1PPhYgecwvAN7utN2EotgTfy2mmLqzF8m3`
ETH: `0xc169699A825066f2F07E0b29C4082094b32A3F3e`
Raw data
{
"_id": null,
"home_page": "https://github.com/amanusk/s-tui",
"name": "s-tui",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "stress,monitoring,TUI",
"author": "Alex Manuskin",
"author_email": "amanusk@pm.me",
"download_url": "https://files.pythonhosted.org/packages/dd/63/1aedb342cc25b7ebc1104b9ebc44f185e1f17df84a02fd5a1c21e3ff001c/s-tui-1.1.6.tar.gz",
"platform": null,
"description": "# The Stress Terminal UI: s-tui\n\n[](https://badge.fury.io/py/s-tui)\n[](https://pepy.tech/project/s-tui)\n\n\n\nStress-Terminal UI, s-tui, monitors CPU temperature, frequency, power and utilization in a graphical way from the terminal.\n\n## Screenshot\n\n\n\n# Table of Contents\n\n- [The Stress Terminal UI: s-tui](#the-stress-terminal-ui-s-tui)\n - [Screenshot](#screenshot)\n - [What it does](#what-it-does)\n - [Usage](#usage)\n - [Simple installation](#simple-installation)\n - [pip (x86 ARM)](#pip-x86--arm)\n - [More installation methods](#more-installation-methods)\n - [Ubuntu (18.10 and newer)](#ubuntu-1810-and-newer)\n - [Ubuntu (18.04, 16.04)](#ubuntu-1804-1604)\n - [Arch Linux, Manjaro](#arch-linux-manjaro)\n - [OpenSUSE](#opensuse)\n - [Fedora](#fedora)\n - [Options](#options)\n - [Dependencies](#dependencies)\n - [Configuration](#configuration)\n - [Saving a configuration](#saving-a-configuration)\n - [Adding threshold scripts](#adding-threshold-scripts)\n - [Run from source code](#run-from-source-code)\n - [OPTIONAL integration of FIRESTARTER (via submodule, does not work on all systems)](#optional-integration-of-firestarter-via-submodule-does-not-work-on-all-systems)\n - [Compatibility](#compatibility)\n - [FAQ](#faq)\n - [Contributing](#contributing)\n - [Tip](#tip)\n\n## What it does\n\n- Monitoring your CPU temperature/utilization/frequency/power\n- Shows performance dips caused by thermal throttling\n- Requires no X-server\n- Built-in options for stressing the CPU (stress/stress-ng/FIRESTARTER)\n\n## Usage\n\n```\ns-tui\n```\n\n## Simple installation\n\n### pip (x86 + ARM)\n\nThe most up to date version of s-tui is available with pip.\n\nInstall with:\n\n```\npip install s-tui --user\n```\n\n(This usually creates an executable in ~/.local/bin/ dir. Make sure it is in your PATH)\n\nTo install as root\n\n```\nsudo pip install s-tui\n```\n\nYou might need to install `python-dev` first\n\nInstallation in virtualenv with [pipsi](https://github.com/mitsuhiko/pipsi):\n\n```\npipsi install s-tui\n```\n\n## More installation methods\n\n### Ubuntu (18.10 and newer)\n\n```\nsudo apt install s-tui\n```\n\n### Ubuntu (18.04, 16.04)\n\nA PPA is available but is not up to date\n\n```\nsudo add-apt-repository ppa:amanusk/python-s-tui\nsudo apt-get update\nsudo apt-get install python3-s-tui\n```\n\n### Arch Linux, Manjaro\n\n`s-tui` is in the Arch repository:\n\n```\nsudo pacman -S s-tui\n```\n\n`s-tui-git` follows the master branch, maintained by [@MauroMombelli](https://github.com/MauroMombelli)\n\nInstall it with:\n`yay -S s-tui-git`\n\n### OpenSUSE\n\n```\nsudo zypper install s-tui\n```\n\n### Fedora\n\n`s-tui` is in the Fedora [repository](https://src.fedoraproject.org/rpms/s-tui):\n\n```\nsudo dnf install s-tui\n```\n\n## Options\n\n```\nTUI interface:\n\nThe side bar houses the controls for the displayed graphs.\nAt the bottom, all sensors reading are presented in text form.\n\n* Use the arrow keys or 'hjkl' to navigate the side bar\n* Toggle between stressed and regular operation using the radio buttons in 'Modes'.\n* If you wish to alternate stress defaults, you can do it in <Stress options>\n* Select graphs to display in the <Graphs> menu\n* Select summaries to display in the <Summaries> menu\n* Use the <Reset> button to reset graphs and statistics\n* If your system supports it, you can use the UTF-8 button to get a smoother graph\n* Save your current configuration with the <Save Settings> button\n* Press 'q' or the <Quit> button to quit\n\n* Run `s-tui --help` to get this message and additional cli options\n\noptional arguments:\n -h, --help show this help message and exit\n -d, --debug Output debug log to _s-tui.log\n --debug-file DEBUG_FILE\n Use a custom debug file. Default: _s-tui.log\n -dr, --debug_run Run for 5 seconds and quit\n -c, --csv Save stats to csv file\n --csv-file CSV_FILE Use a custom CSV file. Default: s-tui_log_<TIME>.csv\n -t, --terminal Display a single line of stats without tui\n -j, --json Display a single line of stats in JSON format\n -nm, --no-mouse Disable Mouse for TTY systems\n -v, --version Display version\n -tt T_THRESH, --t_thresh T_THRESH\n High Temperature threshold. Default: 80\n\n```\n\n## Dependencies\n\ns-tui is great for monitoring. If you would like to stress your system, install stress. Stress options will then show up in s-tui (optional)\n\n```\nsudo apt-get install stress\n```\n\n## Configuration\n\ns-tui is a self-contained application that can run out-of-the-box and doesn't need config files to drive its core features. However, additional features like running scripts when a certain threshold has been exceeded (e.g. CPU temperature) does necessitate creating a config directory. This directory will be made in `~/.config/s-tui` by default.\n\n### Saving a configuration\n\nSelecting \\<Save Settings\\> will save the current configuration to `~/.config/s-tui/s-tui.conf`. If you would like to restore defaults, simply remove the file.\n\n### Adding threshold scripts\n\ns-tui gives you the ability to run arbitrary shell scripts when a certain threshold is surpassed, like your CPU temperature. You can define this custom behaviour by adding a shell file to the directory `~/.config/s-tui/hooks.d` with one of the following names, depending on what threshold you're interested in reacting to:\n\n- `tempsource.sh`: triggered when the CPU temperature threshold is exceeded\n\nIf s-tui finds a script in the hooks directory with the name of a source it supports, it will run that script every 30 seconds as long as the current value of the source remains above the threshold.\n\nNote that at the moment only CPU temperature threshold hooks are supported.\n\n## Run from source code\n\nStart by cloning the repository\n\n```\ngit clone https://github.com/amanusk/s-tui.git\ncd s-tui\n```\n\nInstall required dependencies as \\[root\\] or as (local user)\n\n```\n[sudo] pip install urwid (--user)\n[sudo] pip install psutil (--user)\n```\n\nInstall stress (optional)\n\n```\nsudo apt-get install stress\n```\n\nRun the .py file\n\n```\npython -m s_tui.s_tui\n```\n\n### OPTIONAL integration of FIRESTARTER (via submodule, does not work on all systems)\n\n[FIRESTARTER](https://github.com/tud-zih-energy/FIRESTARTER) is a great tool to stress your system to the extreme.\nIf you would like, you can integrate FIRESTARTER submodule into s-tui.\n\nTo build FIRESTARTER:\n\n```\ngit submodule init\ngit submodule update\ncd ./FIRESTARTER\n./code-generator.py\nmake\n```\n\nOnce you have completed these steps, you can either:\n\n- Install FIRESTARTER to make it accessible to s-tui, e.g make a soft-link to FIRESTARTER in /usr/local/bin.\n- Run s-tui from the main project directory with `python -m s_tui.s_tui` \n An option to run FIRESTARTER will then be available in s-tui\n\n## Compatibility\n\ns-tui uses [psutil](https://github.com/giampaolo/psutil) to probe hardware information. If your hardware is not supported, you might not see all the information.\n\ns-tui uses [urwid](https://github.com/urwid/urwid) as a graphical engine. urwid only works with UNIX-like systems\n\n- Power read is supported on Intel Core CPUs of the second generation and newer (Sandy Bridge)\n and on AMD Family 17h CPUs through the [amd_energy](https://www.kernel.org/doc/html/latest/hwmon/amd_energy.html) driver.\n- s-tui tested to run on Raspberry-Pi 4,3,2,1\n\n## FAQ\n\n**Q**: How is this different from htop? \n**A**: s-tui is not a processes monitor like htop. The purpose is to monitor your CPU statistics and have an option to test the system under heavy load. (Think AIDA64 stress test, not task manager).\n\n**Q**: I am using the TTY with no X server and s-tui crashes on start \n**A**: By default, s-tui is handles mouse inputs. This causes some systems to crash. Try running `s-tui --no-mouse`\n\n**Q**: I am not seeing all the stats in the sidebar. \n**A**: The sidebar is scrollable, you can scroll down with `DOWN` or `j` or scroll to the bottom with `PG-DN` or `G`. You might consider also decreasing the size of the font that you use in your terminal.:)\n\n## Contributing\n\nNew issues and Pull Requests are welcome :)\n\nIf you notice a bug, please report it as a new issue, using the provided template.\n\nTo open a Pull Request, please see [CONTRIBUTING](https://github.com/amanusk/s-tui/blob/master/CONTRIBUTING.md) for more information.\n\n## Tip\n\nIf you like this work, please star it on GitHub.\n\nBTC: `1PPhYgecwvAN7utN2EotgTfy2mmLqzF8m3` \nETH: `0xc169699A825066f2F07E0b29C4082094b32A3F3e`",
"bugtrack_url": null,
"license": "GPLv2",
"summary": "Stress Terminal UI stress test and monitoring tool",
"version": "1.1.6",
"project_urls": {
"Homepage": "https://github.com/amanusk/s-tui"
},
"split_keywords": [
"stress",
"monitoring",
"tui"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "dd631aedb342cc25b7ebc1104b9ebc44f185e1f17df84a02fd5a1c21e3ff001c",
"md5": "e8796247bafa773c0e3713dcd36b9780",
"sha256": "9d27699ccf2e6e87653f09af7663454e7f53b12f22ee55816760a27cc1c37b57"
},
"downloads": -1,
"filename": "s-tui-1.1.6.tar.gz",
"has_sig": false,
"md5_digest": "e8796247bafa773c0e3713dcd36b9780",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 41915,
"upload_time": "2024-01-28T03:29:42",
"upload_time_iso_8601": "2024-01-28T03:29:42.097393Z",
"url": "https://files.pythonhosted.org/packages/dd/63/1aedb342cc25b7ebc1104b9ebc44f185e1f17df84a02fd5a1c21e3ff001c/s-tui-1.1.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-28 03:29:42",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "amanusk",
"github_project": "s-tui",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "s-tui"
}
JSON
