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/>.