Skip to main content

Temp Monitor

https://img.shields.io/pypi/v/tmonpy.svg https://img.shields.io/travis/gmagno/tmon.svg Documentation Status GitHub All Releases

A Python CLI utility to monitor cpu temperature

Install

pip install tmonpy

or

$ # download the AppImage file from the releases page
$ wget https://github.com/gmagno/tmon/releases/latest/download/tmon-???????-x86_64.AppImage
$ chmod +x tmon-*-x86_64.AppImage

Usage

tmon -h
usage: tmon [-h] [-v] [-y YSIZE] [-x XSIZE] [-l MIN MAX] ...

Temperature Monitor (tmon v0.3.6) -- executes a program while
monitoring CPU temperature, reporting the min, max and mean
temperatures and plotting an ascii chart at the end to stderr.
All signals are redirected to the program.
If no program is passed, tmon runs as expected returning on
SIGINT (Ctrl-C).
For full documentation check the repo: https://github.com/gmagno/tmon

positional arguments:
CMD                   Command args to run.

optional arguments:
-h, --help            show this help message and exit
-v, --version         Shows tmon version.
-y YSIZE, --ysize YSIZE
                        Y-axis size in number terminal characters
-x XSIZE, --xsize XSIZE
                        X-axis size in number terminal characters
-l MIN MAX, --ylim MIN MAX
                        Y-axis view limits with min and max values. It is
                        ignored if the measured temperatures fall outside the
                        specified range.

return:
    tmon returns when the child program exits, stops, or is
    terminated by a signal. The return value of tmon is the return
    value of the program it executed.

examples:
    $ tmon echo How can a clam cram in a clean cream can
    How can a clam cram in a clean cream can

    ===================
    Temp Monitor Report:

    Temp (°C) for a period of 0:00:00
    >> 53.0 °C <<

    /tmp/tmon-YYYYMMDD@HHhMMmSS-XXXXXXXX.txt
    ===================

    $ tmon bash -c 'sleep 6; stress -c 4 -t 3; sleep 6'
    stress: info: [17832] dispatching hogs: 4 cpu, 0 io, 0 vm, 0 hdd
    stress: info: [17832] successful run completed in 3s

    ===================
    Temp Monitor Report:

    Temp (°C) for a period of 0:00:15
    59.00  ┤
    58.67  ┤
    58.33  ┤
    58.00  ┤
    57.67  ┤      ╭─╮
    57.33  ┤      │ │
    57.00  ┤      │ │
    56.67  ┤     ╭╯ ╰╮
    56.33  ┤     │   │
    56.00  ┤     │   │
    55.67  ┼─╮   │   │
    55.33  ┤ │   │   │
    55.00  ┤ ╰───╯   ╰────╮
    54.67  ┤              │
    54.33  ┤              │
    54.00  ┤              ╰

    /tmp/tmon-YYYYMMDD@HHhMMmSS-XXXXXXXX.txt
    ===================

    $ tmon -y 5 -x 5 bash -c 'sleep 6; stress -c 4 -t 3; sleep 6'
    stress: info: [17181] dispatching hogs: 4 cpu, 0 io, 0 vm, 0 hdd
    stress: info: [17181] successful run completed in 3s

    ===================
    Temp Monitor Report:

    Temp (°C) for a period of 0:00:15
    60.00  ┤
    59.00  ┤  ╭╮
    58.00  ┼╮╭╯│
    57.00  ┤╰╯ │
    56.00  ┤   ╰─

    /tmp/tmon-YYYYMMDD@HHhMMmSS-XXXXXXXX.txt
    ===================

    $ tmon -l 40 70 -x 10 -y 10 bash -c 'stress -c 4 -t 3; sleep 6'
    stress: info: [19677] dispatching hogs: 4 cpu, 0 io, 0 vm, 0 hdd
    stress: info: [19677] successful run completed in 3s

    ===================
    Temp Monitor Report:

    Temp (°C) for a period of 0:00:09
    70.00  ┤
    66.67  ┤
    63.33  ┤
    60.00  ┤
    56.67  ┼───╮
    53.33  ┤   ╰─────
    50.00  ┤
    46.67  ┤
    43.33  ┤
    40.00  ┤

    /tmp/tmon-YYYYMMDD@HHhMMmSS-XXXXXXXX.txt
    ===================

copyright:
    Copyright © 2020 Gonçalo Magno <goncalo@gmagno.dev>
    This software is licensed under the MIT License.

History

0.1.0 (2020-01-28)

  • First release on PyPI.

Release files for tmonpy 0.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tmonpy 0.4.0
File Size Uploaded
tmonpy-0.4.0.tar.gz 17.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for tmonpy 0.4.0
File Interpreter ABI Platform
tmonpy-0.4.0-py2.py3-none-any.whl Python 2, Python 3 none any Details

Total release size: 27.3 kB

Release files / tmonpy-0.4.0.tar.gz

Download URL tmonpy-0.4.0.tar.gz
Size 17.1 kB
Tags Source
SHA-256 checksum
How to use checksums
30117a6f199e3f22bbad11cad35fcb79ac7ca6aca4815c0dde7085965347a074
BLAKE2b-256 checksum
How to use checksums
5f03291db2cd959183f75d823b07096ffff5ac2d24d0afcb80a269db617d33ec
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.14.0 pkginfo/1.5.0.1 requests/2.23.0 setuptools/42.0.2 requests-toolbelt/0.9.1 tqdm/4.43.0 CPython/3.8.1

Release files / tmonpy-0.4.0-py2.py3-none-any.whl

Download URL tmonpy-0.4.0-py2.py3-none-any.whl
Size 10.2 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
61ae591ebbb2e6a3727fdc0abb1d9627c2493070eec4bf3798c1e76ef85a3afc
BLAKE2b-256 checksum
How to use checksums
3f8fa7508c68a8e578ad6fe09648a61a5db209191232494b21f4c6c81e408192
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.14.0 pkginfo/1.5.0.1 requests/2.23.0 setuptools/42.0.2 requests-toolbelt/0.9.1 tqdm/4.43.0 CPython/3.8.1

Release history Release notifications | RSS feed

This release

0.4.0 This release

2 release files

0.3.8

2 release files

0.3.7

2 release files

0.3.6

2 release files

0.3.5

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page