Skip to content
forked from biskero/nvtop

NVIDIA GPUs htop like monitoring tool

License

Unknown, GPL-3.0 licenses found

Licenses found

Unknown
LICENSE
GPL-3.0
COPYING
Notifications You must be signed in to change notification settings

ganzocrypt/nvtop

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

NVTOP

What is NVTOP?

Nvtop stands for NVidia TOP, a (h)top like task monitor for NVIDIA GPUs. It can handle multiple GPUs and print information about them in a htop familiar way.

Because a picture is worth a thousand words:

NVTOP interface

Table of Contents

  1. NVTOP Options and Interactive Commands
  2. GPU Support
  3. Build
    1. Ubuntu / Debian
    2. Fedora / RedHat / CentOS
    3. OpenSUSE
    4. Archlinux
    5. NVTOP Build
  4. License

NVTOP Options and Interactive Commands

NVTOP comes with a manpage!

man nvtop

For quick command line arguments help

nvtop -h
nvtop --help

GPU Support

The NVML library does not support some of the queries for GPUs coming before the Kepler microarchitecture. Anything starting at GeForce 600, GeForce 800M and successor should work fine. For more information about supported GPUs please take a look at the NVML documentation.

Build

Two libraries are required:

  • The NVIDIA Management Library (NVML) which comes with the GPU driver.
    • This queries the GPU for information.
  • The ncurses library driving the user interface.
    • This makes the screen look beautiful.

Distribution Specific Installation Process

Ubuntu / Debian

Fedora / RedHat / CentOS

  • NVIDIA drivers, CUDA required for nvml libraries (see RPM Fusion)
  • CMake, ncurses and git
    sudo dnf install cmake ncurses-devel git
  • NVTOP

OpenSUSE

Archlinux

  • NVIDIA drivers (see Archlinux wiki)
  • CMake, ncurses and git
    sudo pacman -S cmake ncurses git
  • NVTOP

NVTOP Build

git clone https://github.com/ganzocrypt/nvtop.git
mkdir -p nvtop/build && cd nvtop/build
cmake ..

# If it errors with "Could NOT find NVML (missing: NVML_INCLUDE_DIRS)"
# try the following command instead, otherwise skip to the build with make.
cmake .. -DNVML_RETRIEVE_HEADER_ONLINE=True

make
make install # You may need sufficent permission for that (root)

The build system supports multiple build type (e.g. -DCMAKE_BUILD_TYPE=Optimized):

  • Release: Binary without debug information
  • RelWithDebInfo: Binary with debug information
  • Debug: Compile warning flags and address/undefined sanitizer (For development only)
  • Optimized: Build with architecture specific optimisations (May be not portable across machines with different processor)

License

Nvtop is licensed under the GPLV3 license or any later version. You will find a copy of the license inside the COPYING file of the repository or at the gnu website <www.gnu.org/licenses/>.

About

NVIDIA GPUs htop like monitoring tool

Topics

Resources

License

Unknown, GPL-3.0 licenses found

Licenses found

Unknown
LICENSE
GPL-3.0
COPYING

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C 88.9%
  • CMake 11.1%