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

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