1
2nvtop(1)                         nvtop command                        nvtop(1)
3
4
5

NAME

7       nvtop - interactive GPU process viewer
8
9

SYNOPSIS

11       nvtop [-hv] [-d delay]
12
13

DESCRIPTION

15       nvtop  is  a  ncurses-based GPU status viewer for AMD, Intel and NVIDIA
16       GPUs.
17
18

COMMAND-LINE OPTIONS

20       -d, --delay=delay
21              Delay between updates, in tenths of seconds (delay * 0.1s).
22
23       -h, --help
24              Print the help and exit.
25
26       -C, --no-color
27              Monochrome mode.
28
29       -f, --freedom-unit
30              Use fahrenheit as temperature scale.
31
32       -E, --encode-hide=seconds
33              Modify the setting for the encode/decode auto-hide timer. Always
34              visible if negative. Default to 30 seconds.
35
36       -r, --reverse-abs
37              Reverse  abscissa:  switch the plot data order from "old --- re‐
38              cent" (default) to "recent --- old".
39
40       -p, --no-plot
41              Show only one bar plot corresponding to the maximum of all GPUs.
42
43       -v, --version
44              Print the version and exit.
45
46

INTERACTIVE SETUP WINDOW

48       You can enter the setup utility by pressing F2 to view and  modify  the
49       following interface options:
50
51       General
52              This section deals with general interface options. Color support
53              and interface update interval can be modified.
54
55       Devices
56              This section deals with the devices display (top of  the  inter‐
57              face).  You  can  switch the temperature scale to fahrenheit and
58              set the encoder/decoder hiding timer.
59
60       Chart  This section deals with the line plots  (middle  of  the  inter‐
61              face).  You can reverse the plot direction and select which met‐
62              ric is being shown in the plots.
63
64       Processes
65              This section deals with the process list (bottom of  the  inter‐
66              face). You can select the sort order, select the metric by which
67              to sort the processes by and select which metric is displayed.
68
69

INTERACTIVE COMMANDS

71       The following commands are available while in nvtop:
72
73       Up     Select (highlight) the previous process.
74
75       Down   Select (highlight) the next process.
76
77       Left / Right
78              Scroll in the process row.
79
80       +      Sort increasingly.
81
82       -      Sort decreasingly.
83
84       F2     Enter the setup utility to modify the interface options.
85
86       F12    Save the current interface options to persistent  storage.   See
87              the CONFIGURATION FILE section.
88
89       F9     "Kill"  process:  Select  a  signal  to  send to the highlighted
90              process.
91
92       F6     Sort: Select the field for sorting. The current  sort  field  is
93              highlighted inside the header bar.
94
95       F10, q, Esc
96              Quit.
97
98

DYNAMIC METERS

100       When  the  video encoder (ENC) and decoder (DEC) of the GPU are in use,
101       new percentage meters will appear next to the GPU utilization bar. They
102       will  disappear automatically after some time of inactivity (see option
103       -E).
104
105

CONFIGURATION FILE

107       The configuration file follows the XDG Base Directory Specification and
108       is  stored  at  $XDG_CONFIG_HOME/nvtop/interface.ini.  The location de‐
109       faults to $HOME/.config/nvtop/interface.ini if the XDG location is  not
110       defined.
111
112       Do  not  edit  this  file. The file is automatically created or updated
113       upon toggling the interface saving key F12.
114
115       The configuration is loaded during program initialization.  If no  con‐
116       figuration file is present, default options are used.
117
118

MEMORY SIZES

120       Memory  sizes  in  nvtop  are displayed as multiples of 1024 bytes or 1
121       KiB.
122
123

BUGS

125       Some fields are shown as N/A
126              Ask AMD or NVIDIA for better support of your hardware!
127
128              If your card uses the AMDGPU driver, a more recent kernel  might
129              have improved support.
130
131       Compatibility issues
132              Does not work with nouveau driver stack and older NVIDIA GPU for
133              the time being.
134
135              Does not work for AMD graphics card using the old radeon driver.
136

AUTHOR

138       Written by Maxime Schmitt.
139
140
141
142Version 3.0.2                      July 2023                          nvtop(1)