NAME

       nvtop - interactive GPU process viewer

SYNOPSIS

       nvtop [-hv] [-d delay]

DESCRIPTION

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

COMMAND-LINE OPTIONS

       -d, --delay=delay
              Delay between updates, in tenths of seconds (delay * 0.1s).

       -h, --help
              Print the help and exit.

       -C, --no-color
              Monochrome mode.

       -f, --freedom-unit
              Use fahrenheit as temperature scale.

       -E, --encode-hide=seconds
              Modify  the  setting for the encode/decode auto-hide timer. Always visible if negative. Default to
              30 seconds.

       -r, --reverse-abs
              Reverse abscissa: switch the plot data order from "old --- recent" (default) to "recent --- old".

       -p, --no-plot
              Show only one bar plot corresponding to the maximum of all GPUs.

       -v, --version
              Print the version and exit.

INTERACTIVE SETUP WINDOW

       You can enter the setup utility by pressing F2 to view and modify the following interface options:

       General
              This section deals with general interface options. Color support and interface update interval can
              be modified.

       Devices
              This section deals with the devices display (top of the interface). You can switch the temperature
              scale to fahrenheit and set the encoder/decoder hiding timer.

       Chart  This section deals with the line plots (middle  of  the  interface).  You  can  reverse  the  plot
              direction and select which metric is being shown in the plots.

       Processes
              This section deals with the process list (bottom of the interface). You can select the sort order,
              select the metric by which to sort the processes by and select which metric is displayed.

INTERACTIVE COMMANDS

       The following commands are available while in nvtop:

       Up     Select (highlight) the previous process.

       Down   Select (highlight) the next process.

       Left / Right
              Scroll in the process row.

       +      Sort increasingly.

       -      Sort decreasingly.

       F2     Enter the setup utility to modify the interface options.

       F12    Save the current interface options to persistent storage.  See the CONFIGURATION FILE section.

       F9     "Kill" process: Select a signal to send to the highlighted process.

       F6     Sort: Select the field for sorting. The current sort field is highlighted inside the header bar.

       F10, q, Esc
              Quit.

DYNAMIC METERS

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

CONFIGURATION FILE

       The   configuration   file   follows   the   XDG   Base   Directory   Specification   and  is  stored  at
       $XDG_CONFIG_HOME/nvtop/interface.ini. The location defaults to $HOME/.config/nvtop/interface.ini  if  the
       XDG location is not defined.

       Do  not  edit  this file. The file is automatically created or updated upon toggling the interface saving
       key F12.

       The configuration is loaded during program initialization.  If no configuration file is present,  default
       options are used.

MEMORY SIZES

       Memory sizes in nvtop are displayed as multiples of 1024 bytes or 1 KiB.

BUGS

       Some fields are shown as N/A
              Ask AMD or NVIDIA for better support of your hardware!

              If your card uses the AMDGPU driver, a more recent kernel might have improved support.

       Compatibility issues
              Does not work with nouveau driver stack and older NVIDIA GPU for the time being.

              Does not work for AMD graphics card using the old radeon driver.

AUTHOR

       Written by Maxime Schmitt.

Version 3.2.0                                      April 2025                                           nvtop(1)