LSGPUS(1)

NAME
lsgpus - list graphics cards with details, outputs, and connected monitors

SYNOPSIS
lsgpus [OPTIONS]

DESCRIPTION
lsgpus lists all graphics cards (GPUs) with their driver, VRAM, PCI address, and for NVIDIA cards: utilization, memory usage, temperature, and power draw. Each GPU output port is listed with its connection status and, when connected, the monitor's manufacturer, model, and size (parsed from EDID).

GPU information is obtained from /sys/class/drm and lspci(8). NVIDIA runtime stats are obtained from nvidia-smi(1) when available. Monitor identification uses EDID data from /sys/class/drm/card*-*/edid.

lsgpus is similar in spirit to lscpu(1), lsusb(8), and lspci(8), but focused on graphics cards and their display outputs.

The binary is named lsgpus (with a trailing “s”) since v0.2.0, to avoid a name clash with the lsgpu(1) utility shipped by igt-gpu-tools — a low-level debug/test tool for the Intel Graphics Tests framework (different audience, same Unix path namespace).

OPTIONS

--json
    Output all GPU information as JSON.

--short, -s
    Compact output with one line per GPU.

--all, -a
    Show all output ports, including disconnected ones (hidden by default).

--watch, -w [SEC]
    Continuously refresh the listing in place every SEC seconds (default 2), showing live NVIDIA stats. Press Ctrl+C to stop — there is no quit key.

--version, -V
    Show version number and exit.

--help, -h
    Show help message and exit.

OUTPUT

GRAPHICS CARDS
    For each GPU: card name, full GPU model, driver, VRAM size, and NVIDIA runtime stats (utilization %, memory used/total, temperature, power draw). Below each GPU, output ports are listed with connection status and connected monitor details.

In --watch mode the same data is redrawn in place, with a utilization progress bar and a rolling sparkline per card — e.g. while a model loads on card1 via Ollama:

    GPU MONITOR — 15:26:01 (Ctrl+C to stop)
      card0: NVIDIA Corporation GA107 [GeForce RTX 3050 6GB] (rev a1)  [PCI 82:00.0 | nvidia-smi GPU1]
        Driver: nvidia
        GPU  [░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░]   0%  ▁▁▁▄▂▁
        MEM  [█████████████████░░░░░░░░░░░░░] 3608/6144MB (59%)
        TEMP 43°C   POWER 28.1W
      card1: NVIDIA Corporation AD106 [GeForce RTX 4060 Ti] (rev a1)  [PCI 02:00.0 | nvidia-smi GPU0]
        Driver: nvidia
        GPU  [█████████████████████████████░]  98%  ▇▇▇▇▇▇
        MEM  [████████████████████████░░░░░░] 13158/16380MB (80%)
        TEMP 62°C   POWER 123.2W
        └ PID 1965377  python  122MB
        └ PID 2733331  ollama  5498MB
        └ PID 2775015  ollama  7492MB
      card2: Intel Corporation Arrow Lake-S [Intel Graphics] (rev 06)  [PCI 00:02.0]
        Driver: i915

EXAMPLES
lsgpus
lsgpus --short
lsgpus --all
lsgpus --watch
lsgpus --watch 5
lsgpus --json
lsgpus --json | jq '.[].name'

FILES

/sys/class/drm/card[0-9]
    DRM card entries for each GPU.

/sys/class/drm/card*-*/edid
    EDID binary data for each output port.

/sys/class/drm/card*-*/status
    Connection status (connected/disconnected).

/sys/class/drm/card*/device/mem_info_vram_total
    Total VRAM in bytes (NVIDIA/AMD).

/sys/class/drm/card*/device/driver
    Kernel driver in use (nvidia, i915, amdgpu, etc.).

SEE ALSO
lsdisplay(1), lsgpu(1) from igt-gpu-tools, lspci(8), lsusb(8), lscpu(1), nvidia-smi(1), xrandr(1)

BUGS
Report bugs at https://github.com/AGuyMarc/lsgpu/issues (GitHub repository keeps its original name lsgpu — only the installed binary was renamed in v0.2.0).

AUTHOR
Guy-Marc APRIN <2026@gm.casa>
NB: contact email rotates yearly — 2027@gm.casa in 2027, etc.

LICENSE
GPL-2.0. See LICENSE for the full text.