In this section you will learn how to get information about installed graphics controllers and connected displays.

In version 6 the former graphics() function was split into two separate functions: gpu() (graphics controllers) and displays() (monitors / displays). Both return plain arrays.

On Windows, displays() reports physical monitors: in duplicate/mirror mode each mirrored monitor gets its own entry (sharing the resolution and position of the mirrored screen). All displays of such a mirrored set are flagged with mirror: true (Linux, macOS and Windows).

For function reference and examples we assume, that we imported systeminformation as follows:

const si = require('systeminformation');

Graphics Controllers

All functions in this section return a promise.

const si = require('systeminformation');
si.gpu().then(data => console.log(data));

[
  {
    vendor: 'Intel',
    model: 'Intel Iris Plus Graphics 655',
    bus: 'Built-In',
    vram: 1536,
    vramDynamic: true
  }
]

GPU metrics on Linux (Intel, AMD, NVIDIA)

Beside the optional nvidia-smi, gpu() reads the runtime values the kernel exposes per DRM card below /sys/class/drm/card*. This needs no additional tool and no root privileges, and it is matched to the controller by its PCI bus address. Values already delivered by nvidia-smi are never overwritten.

Intel GPU utilization is the one value that cannot be read this way: the i915 / xe drivers publish their engine busy counters through the perf / PMU interface instead of sysfs (#890). Every tool reading it - intel_gpu_top -J from intel-gpu-tools, nvtop - therefore needs root or the CAP_PERFMON capability, which a library like this cannot require. If you need the busy percentage of an Intel GPU, run intel_gpu_top yourself with the appropriate privileges; frequency, power and temperature are available through gpu().

Displays

const si = require('systeminformation');
si.displays().then(data => console.log(data));

[
  {
    vendor: '',
    model: 'Color LCD',
    main: true,
    mirror: false,
    builtin: false,
    connection: 'Internal',
    sizeX: null,
    sizeY: null,
    pixelDepth: 24,
    resolutionX: 2560,
    resolutionY: 1600,
    currentResX: 2560,
    currentResY: 1600,
    positionX: 0,
    positionY: 0,
    currentRefreshRate: null,
    scale: null
  }
]