Skip to Content
Front pageLabsLabs, projects & CCNA notes

tunit

A single Go binary for hardware checks, CPU stress tests, network checks and HTTP load tests on Windows, Linux and macOS. No runtime dependencies, so it runs on a repair bench or in CI.



Install

Linux and macOS:

bash
Wrap linesDownloadCopy code
curl -fsSL https://github.com/raiz-toff/tunit/releases/latest/download/install.sh | bash

Windows (PowerShell, run as Administrator):

powershell
Wrap linesDownloadCopy code
irm https://github.com/raiz-toff/tunit/releases/latest/download/tunit.ps1 | iex

Run tunit with no arguments to open the interactive menu.


Commands

CommandWhat it runs
tunitInteractive guided menu
tunit qcHardware QC: serial, CPU, RAM, BIOS, battery and S.M.A.R.T., then human checks for audio, webcam, keyboard, display and USB
tunit stressCPU thermal stress test with live temperature monitoring and throttle detection
tunit netPing, DNS latency, TCP port probes and a bandwidth test
tunit loadHTTP load test with rate control and latency percentiles
tunit reportLists the QC reports saved in the current directory

Hardware QC

bash
Wrap linesDownloadCopy code
tunit qc                            # full interactive QC
tunit qc --auto                     # skip human checks (CI-safe)
tunit qc --repaired battery         # add post-repair checks
tunit qc --repaired screen --lookup # add a warranty lookup
FlagDescription
--autoRuns the automated checks only
--lookupQueries the Dell, HP or Lenovo API for warranty expiry
--repaired <type>Adds post-repair checks for screen, motherboard, battery, storage or keyboard

The command exits with code 0 on a pass and 2 on a fail.

The --repaired flag targets faults that a repair can introduce elsewhere on the unit:

Repair typeExtra check
screenWi-Fi antenna signal, because the antenna cable runs through the hinge
motherboardWindows activation, which a board swap can deactivate
batteryCharging circuit: AC adapter and battery charging state

Platforms

PlatformBinary
Linux x86-64tunit-linux-amd64
Linux ARM64tunit-linux-arm64
macOS Inteltunit-darwin-amd64
macOS Apple Silicontunit-darwin-arm64
Windows x86-64tunit-windows-amd64.exe

To build from source, use Go 1.23 or later:

bash
Wrap linesDownloadCopy code
git clone https://github.com/raiz-toff/tunit && cd tunit
go build -o tunit ./cmd/tunit
Back to top