Skip to content

ProjectPhysX/hw-smi

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

hw-smi

A minimal, cross-compatible CPU/GPU telemetry monitor with accurate data directly from vendor APIs and beautiful ASCII visualization.

moritz@opencl-pc:~/hw-smi$ sudo bin/hw-smi --graphs

moritz@opencl-pc:~/hw-smi$ sudo bin/hw-smi --bars

Hardware/OS Support

Metric
(Windows/Linux)
CPUs
Win32//proc
 Nvidia GPUs 
NVML
   AMD GPUs   
ADLX/AMDSMI
  Intel GPUs  
SYSMAN
device name ✅/✅ ✅/✅ ✅/✅ ✅/✅
per-core/avg usage [%] ✅✅/✅✅ ✅✅/✅✅ ✅✅/✅✅ ✅✅/❎✅
memory bandwidth [MB/s] ❌❌/❌❌ ✅✅/✅✅ 🟨🟨/✅✅ ❎❎/❎❎
memory occupation [MB] ✅✅/✅✅ ✅✅/✅✅ ✅✅/✅✅ ✅✅/✅✅
temperature [°C] 🫠✅/✅✅ ✅✅/✅✅ ✅✅/✅✅ ❎✅/❎✅
power [W] ❌❌/❌❌ ✅✅/✅✅ ✅✅/✅✅ ❎✅/✅✅
fan [RPM] ❌❌/❌❌ 🟨🟨/🟨🟨 ✅✅/✅🟨 ✅🟨/🫠🟨
core clock [MHz] 🟨🟨/✅🟨 ✅✅/✅✅ ✅✅/✅✅ ✅✅/✅✅
memory clock [MHz] ❌❌/❌❌ ✅✅/✅✅ ✅✅/✅✅ ✅✅/🫠✅
PCIe bandwidth [MB/s] 🟨🟨/🟨🟨 ✅✅/✅✅ ❌❌/🫠✅ ❎✅/❎🫠
Legend Description
AB/CD current value (Windows), B max value (Windows)
current value (   Linux   ), D max value (   Linux   )
supported and working
supported and working, but administrator/sudo permissions required
🟨 vendor API does not directly provide metric, but workaround/estimate/default possible
🫠 available but broken in vendor API
unavailable in vendor API and no suitable default value possible
API issues submitted

Compiling the Source Code

Windows

  • Download and install Visual Studio Community. In Visual Studio Installer, add:
    • Desktop development with C++
    • MSVC v142
    • Windows 10 SDK
  • Download and unzip hw-smi.
  • Open hw-smi.vcxproj in Visual Studio Community.
  • Compile by clicking the ► Local Windows Debugger button.
  • Go to hw-smi/bin/ folder and double-click hw-smi.exe.
  • Alternatively, run from CMD:
    hw-smi.exe
    hw-smi.exe --graphs
    hw-smi.exe --bars
    hw-smi.exe --help
  • Note that it will also work without administrator permissions. However, some telemetry counters on Intel GPUs are not available without administrator permissions.

Linux

  • Clone from GitHub:
    git clone https://github.com/ProjectPhysX/hw-smi.git && cd hw-smi
  • Compile:
    chmod +x make.sh
    ./make.sh
  • Run:
    sudo bin/hw-smi
    sudo bin/hw-smi --graphs
    sudo bin/hw-smi --bars
    sudo bin/hw-smi --help
  • Note that it will also work without sudo. However, some telemetry counters on Intel GPUs are not available without sudo.