FreeBSD Manual Pages
nvtop(1) nvtop command nvtop(1) NAME nvtop - interactive GPU process viewer SYNOPSIS nvtop [-hvCfpPris] [-d delay] [-c config-file] [-E seconds] 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 fol- lowing 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 en- coder/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 high- lighted 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 configu- ration 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.3.2 August 2026 nvtop(1)
NAME | SYNOPSIS | DESCRIPTION | COMMAND-LINE OPTIONS | INTERACTIVE SETUP WINDOW | INTERACTIVE COMMANDS | DYNAMIC METERS | CONFIGURATION FILE | MEMORY SIZES | BUGS | AUTHOR
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=nvtop&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>