summaryrefslogtreecommitdiffstats
path: root/docs/devices.md
blob: 4f9e34ce308895dafd92b814cf029cb512b336ca (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
# Device filtering

Some devices have quite a number of data points; on OSX, for instance, there are dozens of temperature readings. These can be filtered through a configuration file.  There is no command-line argument for this filter.

The list will grow, but for now the only device that supports filtering is the temperature widget.  The configuration entry is called `temperature`, and it contains an exact-match list of comma-separated values with no spaces.  To see the list of valid values, run gotop with the `--list devices` command.  Gotop will print out the type of device and the legal values.  For example, on Linux:

```
$ gotop --list devices
Temperatures:
        acpitz
        nvme_composite
        nvme_sensor1
        nvme_sensor2
        pch_cannonlake
        coretemp_packageid0
        coretemp_core0
        coretemp_core1
        coretemp_core2
        coretemp_core3
        ath10k_hwmon
```
You might then add the following line to the config file.  First, find where gotop looks for config files:
```
➜  gotop --list paths
Loadable colorschemes & layouts, and the config file, are searched for, in order:
/home/ser/workspace/gotop.d/gotop
/home/ser/.config/gotop
/etc/xdg/gotop

The log file is in /home/ser/.cache/gotop/errors.log
```
So you might use `${HOME}/.config/gotop/gotop.conf`, and add (or modify) this line:
```
temperatures=acpitz,coretemp_core0,ath10k_hwmon
```
This will cause the temp widget to show only four of the eleven temps.