Native Windows and Linux USB fault-isolation coach. Case-oriented: establish a baseline, change one variable, observe the symptom, get an evidence-backed ranking of likely fault domains.
Not a USB tree viewer, protocol sniffer, driver updater, or electrical cable certifier.
| Platform | Capture | Packages |
|---|---|---|
| Windows 10/11 | PnP / SetupAPI via PowerShell | NSIS setup, MSI, portable EXE |
| Linux | /sys/bus/usb/devices |
AppImage, .deb, .rpm |
Full step-by-step tutorial (prebuilt packages and build-from-source) lives in INSTALL.md.
Quick auto-detect, from a machine that already has built packages in release/:
Windows (PowerShell):
.\scripts\install-windows.ps1Linux:
bash scripts/install-linux.shAuto (Git Bash / WSL / Linux):
bash scripts/install.shThe installer detects your OS, picks NSIS/MSI/AppImage/deb/rpm from release/, and
installs or links it. No cloud account. No telemetry.
- Reads present USB devices and parent/location topology
- Detects connect / disconnect / state changes between snapshots
- Groups simultaneous sibling changes as one cascade
- Guided experiments: cable, port, hub, powered path, power policy, other PC
- Ranks cable, hub/power, port, device, and driver/policy explanations
- Exports a privacy-redacted HTML report locally
- Uploads nothing
Host software cannot measure voltage droop, contact resistance, or signal integrity. PlugProof ranks relative support (“more consistent with the cable”), never electrical certification.
Prerequisites:
- Node.js 24+
- Rust stable
- Windows: MSVC toolchain + WebView2
- Linux:
webkit2gtk,libgtk-3, and usual Tauri Linux deps
npm install
npm run check
cargo test --manifest-path src-tauri/Cargo.toml
npm run tauri dev
npm run tauri build
After tauri build, copy bundles into release/ (or keep Tauri’s default output) and
run the matching install script.
Browser preview uses demonstration devices. Real capture only runs inside the native app.
Proprietary and confidential — all rights reserved. This is not open source. No license or right of any kind is granted: no use, access, copying, downloading, running, building, modification, redistribution, or AI/dataset use is permitted without the Owner's prior signed written permission. The Owner retains all copyright, patent, trademark, and trade-secret rights. See LICENSE.