Skip to content

x1n-Q/Inspectrax

Repository files navigation

InspecTrax

Inspect your system before it fails.

InspecTrax is a modern Windows diagnostics and hardware intelligence app built with C# .NET 9 and WinUI 3. It provides clear system health insights for everyday users and JSON/PDF diagnostic reports for technicians — without fake cleaners, boost buttons, or cloud data collection.

InspecTrax is developed and published by Dantrix.

Brand assets

The primary wordmark and app icon are stored under Inspectrax.App/Assets/Branding. Run scripts/Generate-BrandAssets.ps1 to reproduce the Windows icon, tile, and splash variants from the two master PNG files.

Features

  • Dashboard — Health score (0–100), live CPU/RAM/disk/GPU/battery/network metrics, warnings, recommendations, session health history
  • Storage diagnostics — Drive space, media type, SMART attributes, temperature, low-space highlighting
  • Hardware info — CPU, RAM, GPU, motherboard, BIOS, Windows version, driver list
  • Battery health — Charge, wear, cycle count (when reported), recommendations
  • Network diagnostics — Ping, DNS, gateway, public IP, adapter list, optional download/upload speed test
  • System status — Problem devices, startup apps, Windows updates, BSOD/crash dumps, recent event log entries
  • Warnings — Consolidated view of all detected issues with severity
  • Reports — JSON and PDF export for technicians and repair shops
  • Technician workspace — Persistent customer cases, reported issues, notes, evidence-backed findings, repair history, and before/after health snapshots
  • Repair center — Previewed and audited DISM, SFC, CHKDSK, DNS-cache, and Plug and Play operations with explicit confirmation and Windows administrator approval
  • Incident Correlation Lab — Reconstructs a cross-source failure timeline, fingerprints recurring faults, ranks transparent root-cause hypotheses, and separates temporal correlation from proof
  • Repair Proof — Compares before/after findings to classify a repair as verified, improved, unchanged, regressed, or inconclusive
  • Expanded Repair Center — 18 fixed, previewable actions for Windows integrity, Windows Update, network recovery, drivers, restore points, print queues, boot auditing, and local support bundles
  • Common App Installer — Search and install 20 reviewed official-publisher apps through exact Winget package IDs, with installed-state detection and visible post-install verification

Solution structure

Inspectrax.sln
├── Inspectrax.App            # WinUI 3 shell (MVVM)
├── Inspectrax.Core           # Interfaces, models, DTOs
├── Inspectrax.Infrastructure # WMI, perf counters, WinRT APIs
├── Inspectrax.Diagnostics    # Health score, metrics history, recommendations
├── Inspectrax.Reports        # JSON + PDF export (QuestPDF)
└── Inspectrax.Tests          # Unit tests

Requirements

  • Windows 10 1809+ / Windows 11
  • .NET 9 SDK
  • Windows App SDK 1.6 (restored via NuGet)
  • Visual Studio 2022 17.10+ with Windows application development workload (recommended)

Build and run

cd D:\Projects\Inspectrax

# If C: drive is low on space, use D: for NuGet and temp:
$env:NUGET_PACKAGES = "D:\Projects\.nuget\packages"
$env:TEMP = "D:\Projects\temp"
$env:TMP = "D:\Projects\temp"
$env:PATH = "D:\Projects\.dotnet\sdk;" + $env:PATH

dotnet restore
dotnet build
dotnet test

# Recommended launch (self-contained; works without Developer Mode or global .NET 9):
.\run.ps1

# Or publish and run manually:
dotnet publish Inspectrax.App\Inspectrax.App.csproj -c Debug -r win-x64 --self-contained true -p:WindowsAppSDKSelfContained=true -o publish
.\publish\InspecTrax.exe

Note: dotnet run requires Developer Mode for MSIX packaging. On this machine, use run.ps1 or the published .exe instead.

Architecture

  • MVVM with ViewModelBase and DI via Microsoft.Extensions.DependencyInjection
  • Modular services — each diagnostic domain has an interface in Core and implementation in Infrastructure
  • Rule-based recommendations — plain-English guidance from thresholds (disk space, SMART, BSOD, drivers, startup bloat, battery, network)
  • Session metrics history — in-memory health score snapshots during the app session
  • Case records — local JSON records under %LOCALAPPDATA%\Inspectrax\Cases; the active case is included in JSON and PDF reports
  • Repair safety — fixed command allowlist, command preview, risk labels, UAC elevation, captured output, and active-case audit history
  • No admin required for most scans; restricted features degrade gracefully

Technician workflow

  1. Open Technician, create or select a case, and record the reported problem.
  2. Run triage and capture a Before repair snapshot.
  3. Open Repair Center, review the exact command and risk, then approve only the required operation.
  4. Return to Technician and capture an After repair snapshot.
  5. Export the active case from Reports as JSON or PDF.

Repair Center does not accept arbitrary commands and does not install third-party drivers. Its 18 reviewed actions are grouped by job type, marked ReadOnly/Low/Moderate/High, confirmed before execution, and audited with an execution-verification result. Winsock and TCP/IP resets clearly flag their restart requirement. High-risk cache and print-queue actions receive an additional warning.

The Correlation Lab is the advanced investigation view. It combines Windows events, crash dumps, updates, problem devices, repair actions, and diagnostic snapshots into one timeline. Its confidence scores are deterministic and evidence-backed; it never claims that timing alone proves causation.

Common App Installer safety

The App Installer uses a fixed InspecTrax catalog; search only filters that catalog and can never become an arbitrary command. Every installation pins the exact package ID and the Microsoft-hosted winget source, previews the command, requests confirmation, and preserves Winget output.

The Official publisher badge means Dantrix reviewed the displayed package identity, publisher, and official website. The winget source is a Microsoft-hosted community catalog, so catalog inclusion by itself is not represented as publisher endorsement. Winget validates downloaded installers against manifest hashes and blocks integrity failures. InspecTrax never uses --force, bypasses security hashes, supplies custom installer arguments, or allows automatic restarts.

Deferred (not in scope)

  • Microsoft Store packaging and certification polish
  • Cloud sync, AI APIs, plugin system, portable report viewer

License

Copyright © 2026 Dantrix. All rights reserved.

About

InspecTrax by Dantrix — an all-in-one Windows technician tool with diagnostics, repair verification, root-cause analysis, and a safe Winget app installer.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages