hw-smi
Cross-compatible CPU/GPU telemetry monitor with ASCII visualization.
Tested on Linux
Use it
Linux x86_64
These steps ran from a folder named work in the home folder, which already existed. Make it and run them from there:
mkdir -p "$HOME/work" && cd "$HOME/work"git clone the hw-smi source repository
cd "$HOME"/work && git clone https://github.com/ProjectPhysX/hw-smi.git && cd hw-smichmod +x make.sh and ./make.sh: compiles bin/hw-smi with g++ (no GPU drivers on this box, so the no-GPU build line ran)
cd "$HOME"/work/hw-smi && chmod +x make.sh && ./make.sh
Where the README and reality differ
- README: sudo bin/hw-smi --help
What worked: --help prints the option list and then 'Press Enter to continue.' and waits for input; with stdin closed it did not exit (killed after 60 s, exit 137). Under timeout with SIGINT it continued into the monitor display instead of exiting, so it is not a clean non-interactive check. - README: writes all telemetry data into a file hw-smi-YYYY-DD-MM-hh-mm-ss.log located next to the hw-smi executable
What worked: File written in bin/ next to the executable, named hw-smi-2026-11-16-05-15-54.log style: the date order is YYYY-MM-DD, not YYYY-DD-MM as the README says. The --help text says the file is hw-smi.log.
Verified in pickfit: the commands exactly as its sandbox ran them
For the record only: they name the sandbox's home, /home/sbx.
cd /home/sbx/work && git clone https://github.com/ProjectPhysX/hw-smi.git && cd hw-smicd /home/sbx/work/hw-smi && chmod +x make.sh && ./make.shcd /home/sbx/work/hw-smi && timeout --preserve-status -s INT 5 bin/hw-smi --bars < /dev/nullcd /home/sbx/work/hw-smi && timeout --preserve-status -s INT 5 bin/hw-smi --bars < /dev/nullCheck that it works
cd "$HOME"/work/hw-smi && timeout --preserve-status -s INT 5 bin/hw-smi --bars < /dev/nullThe output should contain “Usage [”.
First thing to try
cd "$HOME"/work/hw-smi && timeout --preserve-status -s INT 5 bin/hw-smi --bars < /dev/nullWhat it does
- Show CPU/GPU telemetry as ASCII barsTested
- Log telemetry data to a fileTested
- Plot telemetry history as ASCII graphsNot tested
- Show a graphical on-screen HUD on WindowsNot tested
How far pickfit got
Linux x86_64
- Installs
- Starts
- 2 of 4 features work
- Works offline
Windows: the project says it runs there; pickfit hasn’t tried it.
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
Its main function works
- Replayed from scratch
- Works offline
- Checked on 16 Nov 2026
Differences the test machine hit
- README: sudo bin/hw-smi --help / sudo bin/hw-smi --bars (run with sudo)
In the test: Works without sudo on this box (no GPU, so only CPU/RAM metrics); README itself says it also works without sudo, sudo only matters for some Intel GPU counters. - README: hw-smi --bars / --graphs / --log are run interactively
In the test: Both --bars and --graphs run until Enter/Ctrl+C; tested with timeout --preserve-status -s INT. Output is a continuous screen redraw. - README: Prerequisites: g++, ocl-icd-opencl-dev (and GPU drivers)
In the test: For a build with no GPU driver found, make.sh compiled with plain g++ -std=c++17 -O3 and no OpenCL headers were needed; the box has no root so ocl-icd-opencl-dev was not installed. GPU driver support could not be built or tested here.