Skip to content

Latest commit

 

History

History
130 lines (86 loc) · 3.75 KB

README.md

File metadata and controls

130 lines (86 loc) · 3.75 KB
Raw

This repository contains:

  • hwtop - TUI monitor for CPU usage, thermal and fan sensors, and network usage.

  • sensord - D-Bus service that broadcasts CPU usage, thermal and fan sensors, and network usage information as a periodic signal. Used by hwtop.

Installation

  1. Build and install the sensord and hwtop binaries (to /usr/bin) and the sensord systemd service and D-Bus config files:

    sudo make install

  2. Create sensord's config file at /etc/sensord/config.toml See the examples under sensord/config-examples/ for reference.

  3. Start the sensord service.

    systemd:

    sudo systemctl start sensord

# sudo systemctl enable sensord   # To start it automatically on boot

    openrc:

    sudo rc-service sensord start

# sudo rc-update add sensord default   # To start it automatically on boot

  4. Start hwtop in a terminal.

    hwtop

Example hwtop output

(The actual output uses colors that are not visible here.)

  1. Output for the device corresponding to pinephone.toml:

      0:   4.0% 648.0 MHz    2:  15.5% 648.0 MHz
  1:   6.9% 648.0 MHz    3:   8.0% 648.0 MHz
Avg:   8.8% 

CPU:  40.1°C
GPU:  40.2°C   40.6°C
Bat:                     +  80%

 eth0:   3.3 Kb/s down    24.1 Kb/s up
wwan0:   0    b/s down     0    b/s up    [i] toggle sensor names  [q] exit

  2. Output for the device corresponding to raspberry-pi.toml

      0:   0.0% 600.0 MHz    1:   1.0% 600.0 MHz    2:   0.0% 600.0 MHz    3:   3.0% 600.0 MHz
Avg:   1.0%

CPU:  47.2°C

eth0:   2.1 KB/s down     1.5 KB/s up    [i] toggle sensor names  [q] exit

  3. Output for the device corresponding to t61.toml

      0:   0.0% 797.9 MHz    1:   7.0% 797.9 MHz
Avg:   3.5%

 CPU:  48.0°C   45.0°C   53.0°C
 GPU:  59.0°C   50.0°C
Mobo:  42.0°C   38.0°C   31.0°C   40.0°C   48.0°C   46.0°C   14% (3236 RPM)
Mobo:   N/A     28.0°C    N/A      N/A

enp0s25:    140 B/s down     1.0 KB/s up    [i] toggle sensor names  [q] exit

  4. Output for the device corresponding to threadripper2.toml

      0:   2.0% 2.086 GHz    6:   0.0% 2.313 GHz   12:   0.0% 2.053 GHz   18:  18.0% 3.204 GHz
  1:   1.0% 2.111 GHz    7:   0.0% 2.057 GHz   13:   0.0% 2.143 GHz   19:   3.0% 2.165 GHz
  2:   1.0% 2.099 GHz    8:   0.0% 2.054 GHz   14:   0.0% 2.113 GHz   20:   0.0% 1.970 GHz
  3:   1.0% 1.957 GHz    9:   1.0% 2.805 GHz   15:   0.0% 2.060 GHz   21:   3.0% 3.477 GHz
  4:   0.0% 1.909 GHz   10:   0.0% 1.938 GHz   16:   0.0% 1.918 GHz   22:   0.0% 1.972 GHz
  5:   0.0% 2.004 GHz   11:   0.0% 2.184 GHz   17:   0.0% 2.094 GHz   23:   2.0% 2.155 GHz
Avg:   1.3%

 CPU:  30.0°C   30.0°C   30.0°C            69% (1002 RPM)
 CPU:   B/A     30.0°C                     69% (1002 RPM)
 GPU:  28.0°C   29.0°C   29.0°C            25% ( 835 RPM)
Mobo:  30.0°C   40.0°C   33.0°C   36.0°C   65% ( 624 RPM)   65% ( 779 RPM)   65% ( 704 RPM)

enp4s0:   4.1 KB/s down      476 B/s up    [i] toggle sensor names  [q] exit

License

AGPL-3.0-only

hwtop

https://github.com/Arnavion/hwtop

Copyright 2019 Arnav Singh

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as
published by the Free Software Foundation, version 3 of the
License.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.