https://github.com/errorx2/hd2-log-viewer
Why read a CSV when it can read itself?
https://github.com/errorx2/hd2-log-viewer
automated csv-reading hardware-report stability-testing troubleshooting
Last synced: 14 days ago
JSON representation
Why read a CSV when it can read itself?
- Host: GitHub
- URL: https://github.com/errorx2/hd2-log-viewer
- Owner: ERRORX2
- License: mit
- Created: 2026-04-19T10:43:55.000Z (3 months ago)
- Default Branch: master
- Last Pushed: 2026-07-04T11:02:31.000Z (14 days ago)
- Last Synced: 2026-07-04T12:04:16.003Z (14 days ago)
- Topics: automated, csv-reading, hardware-report, stability-testing, troubleshooting
- Language: Python
- Homepage:
- Size: 1.34 MB
- Stars: 3
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
- Security: SECURITY.md
Awesome Lists containing this project
README
# HD2 LOG VIEWER
**HD2 LOG VIEWER** is a professional-grade telemetry utility designed for high-frequency hardware log analysis. Optimized for stability testing, thermal diagnostics, and hardware troubleshooting, it provides an interactive interface for visualizing and diagnosing data from **HWiNFO64**, **GPU-Z**, and **MSI Afterburner**.
---
## ๐ Installation & Deployment
### ๐ฆ Option 1: Latest Windows Release (Recommended for Most Users)
### ๐ Latest Windows Release: v1.6.5 (2026-07-05)
- Download: [release_release_v1.6.5.zip](https://github.com/ERRORX2/HD2-LOG-VIEWER/releases/download/v1.6.5/release_v1.6.5.zip)
### ๐ Integrity
Cryptographic Hashes
* EXE SHA256: `099C9C646CBCCAEBEFF2E75B01BF86AD0BE1C45ACED233BB0CCBDAE60D450A4A`
* Groups JSON SHA256: `2710F6B17317CD911D1C1DB6F68056FDD77306761FD250ADC895BBF54DF1F275`
* Manifest SHA256: `242313C91CEA58F8FA268BEC584E59F581781BB35DA59BE02AA55C044D3381C3`
* ZIP SHA256: `072FD4D99AEF9DC1D6911619A4BF782880FFAFF748C2A768212831986703AE86`
1. Download the **[Latest Release](../../releases/latest)**.
2. Download the `HD2_LOG_VIEWER_latest.zip` archive.
3. **Extract the ZIP fully** to a folder of your choice.
4. Run `HD2_LOG_VIEWER.exe`.
*Ensure `groups.json` stays in the same folder as the EXE to load your presets.*
---
### ๐ ๏ธ Option 2: Running on Linux (Arch/CachyOS)
1. Install dependencies
```sudo pacman -S git python tk python-pandas python-matplotlib python-numpy python-pip```
2. git clone ``https://github.com/ERRORX2/HD2-LOG-VIEWER.git``
3. cd ``HD2-LOG-VIEWER``
4. python ``HD2_LOG_VIEWER.pyw``
---
### ๐ ๏ธ Option 3: Running from Source (For Developers)
**Prerequisites:**
* Python 3.12
* pip
1. git clone ``https://github.com/ERRORX2/HD2-LOG-VIEWER.git``
2. cd ``HD2-LOG-VIEWER``
3. pip install ``pandas matplotlib numpy``
4. pythonw ``HD2_LOG_VIEWER.pyw``
---
## ๐ Usage
1. **Load a Log:** Launch the app and select your HWiNFO64 CSV. A spinner dialog loads it in the background.
2. **Select Sensors:** Use the categorized sidebar to toggle sensors, or apply a saved preset. Use the search box to filter by name.
3. **Analyze:** Hover over the chart for a live synchronized readout. Use Multi-Plot, Heatmap, Delta, or Time mode to change the view.
4. **Diagnose:** Click **๐ฌ Diagnose Hardware Signatures** to run the full analysis and review any findings. Use **๐ Copy Discord Summary** to share results instantly.
5. **Save Presets:** Type a name and click Save to store the current sensor selection. Share it via the clipboard icon next to each preset.
6. **Export:** Save a PNG of the current chart or generate a full HTML report for offline sharing or archiving.
---
## ๐ ๏ธ Core Features
### ๐ Visualization
* **Multi-Plot Mode:** Split sensors into categorized subplots - temperatures, clocks, voltages, utilization - for side-by-side comparison without overlap.
* **Heatmap Mode:** Color-coded stress visualization across all selected sensors simultaneously, using absolute thresholds for known sensor types and per-sensor normalization as fallback.
* **ฮ Delta Mode:** Graph the absolute difference between sensor values over time - useful for tracking GPU core vs. hotspot spread or VRM thermal delta.
* **Time Mode:** Switch the X-axis between raw polling ticks and actual elapsed time when a timestamp column is detected.
* **Interactive Tooltip:** Hover over any point on the chart for a synchronized readout of all plotted sensors at that exact moment.
* **Signal Event Timeline:** A dedicated timeline strip below the chart marks where hardware anomalies were detected. Click any marker to jump directly to that moment and see what triggered it.
* **Chart Export:** Save the current view as a high-resolution PNG (300 DPI) including the full sensor legend, or copy it directly to the clipboard with `Ctrl+C`.
### ๐ Sensor Management
* **Categorized Sensor List:** Sensors are automatically sorted into groups - Temperatures, Utilization, Clocks, Power, Voltage, Fan Speeds - for fast navigation across large logs.
* **Live Search:** Filter the sensor list in real time by typing; results update instantly.
* **Out-of-Spec Filter:** One click hides all normal sensors and shows only those currently reading outside safe thresholds, highlighted in the list.
* **Sensor Alias System:** Permanently rename ambiguous or hardware-specific sensor columns so they are correctly identified across any future log file from the same machine.
* **Preset Groups:** Save any combination of selected sensors as a named preset. Apply, rename, delete, or share presets via clipboard - paste a shared preset from another user directly into the app.
### ๐ฌ Diagnostics
* **Hardware Failure Diagnosis:** Runs a full signature scan and presents findings as severity-tagged cards (Critical / Warning / Info) with plain-English descriptions, evidence values, and one-click sensor selection to jump straight to the relevant chart.
* **Session Summary Narrative:** Automatically generates a plain-English paragraph summarizing the most significant findings and any causal relationships between issues detected.
* **Discord Summary Copy:** Copies a compact, formatted summary of the session narrative and all detected signals - including severity and evidence - ready to paste directly into Discord or a support ticket.
* **Real-Time Signature Badges:** The sidebar shows a live count of critical, warning, and info signals as soon as the scan completes in the background, without opening the diagnosis window.
* **Out-of-Spec Detection:** Independently flags individual sensors that exceed configured thresholds, separate from the full signature engine.
* **Detected Hardware View:** Parses the CSV label rows to identify and display the actual hardware devices present in the log - CPU, GPU, storage drives, network adapters, and more - grouped by category.
### ๐ Session Comparison
* **Reference Baseline:** Pin the current session as a reference, then load a second CSV to compare directly against it.
* **Overlay Mode:** Draws both sessions on the same axes so differences in thermals, clocks, or power are immediately visible.
* **Delta Summary Panel:** Shows avg/max/min differences between the current and reference session for every selected sensor, displayed as an annotated panel on the chart.
* **Swap Reference:** Swap the current and reference sessions without reloading either file.
### ๐ Reporting
* **HTML Report Export:** Generates a fully self-contained HTML report including detected hardware, session summary, all signature findings, out-of-spec sensors, per-sensor charts (selected and by category), PSU rail voltages, and a full statistics table. No internet connection required to view.
### ๐จ Theming
* **14 Built-in Themes:** Dark (Default), Light (Default), Slate, Teal, Forest Green, Crimson, Steel, Lime, Violet, Lavender, Cobalt, Neon Blue, Sand, Monochrome, and the Helldivers 2 theme.
* **Theme Editor:** Customize any theme's background, surface, border, text, accent, plot line colors, and heatmap band colors using a color picker. Save as a named user theme.
* **Import / Export Themes:** Share themes as `.json` files. Import a theme file and it is immediately available in the editor.
* **Persistent Theme:** The active theme and all customizations are saved and restored between sessions.
### โ๏ธ Settings & Configuration
* **Limits Editor:** Configure every detection threshold - temperature limits per component type, voltage rail safe ranges, power maximums, fan stall thresholds, frametime limits, and all signature-specific sensitivity parameters.
* **Signature Controls:** Enable or disable individual signatures from the settings panel. The signal timeline and badge counts update accordingly.
* **Tooltip Toggle:** Enable or disable the hover tooltip from the top bar without restarting.
* **Crash Recovery:** Automatically trims corrupted or zeroed rows commonly left at the end of logs after crashes or hard resets.
* **Update Notifications:** Checks for new releases silently on startup. If an update is found, you can open the release page, ignore that specific version, or disable future notifications. A manual check is available via the โณ button at any time.
* **Debug Dump:** A hidden developer panel (`Ctrl+F8`) shows all resolved sensor columns, detected values, fabric clock ratios, PSU rail analysis, and internal state - useful for diagnosing why a signature did or did not fire.
---
## ๐ฌ Diagnostics Engine
HD2 LOG VIEWER includes an advanced signature detection system that analyzes system behavior across thermals, power delivery, memory stability, storage performance, and OS-level scheduling.
### ๐ง Detection Coverage
**๐ก๏ธ Thermal & Cooling**
* CPU thermal throttling and sustained temperature stress
* GPU hotspot and edge-to-hotspot delta analysis
* VRAM junction temperature throttling
* VRM and MOSFET overheating
* Chipset / PCH thermal throttling
* Fan stall detection during active load
**โก Power & Voltage**
* CPU clock stretching (major and minor) - effective vs. requested clock ratio analysis per core
* GPU power limit saturation and oscillation
* PSU +12V rail sag and ripple analysis
* Multi-rail voltage out-of-spec detection (+12V, +5V, +3.3V)
* Laptop power delivery failure / limp mode detection
* Phantom GPU clock cap detection
**๐งฌ Memory & Fabric**
* System RAM exhaustion and virtual memory / pagefile overflow
* VRAM overflow with spillover into system memory
* Ryzen FCLK/UCLK fabric desync (DDR4 and DDR5 modes)
* Memory XMP/EXPO profile disabled detection
* Memory controller clock mismatch
**๐งฉ System & OS**
* Hardware (WHEA) errors
* GPU driver TDR / timeout pattern detection
* CPU bottleneck (GPU idle while CPU saturated)
* Background process CPU interference
* GPU priority conflict from background applications
* GPU engine wait bottleneck (PresentMon frame data)
* Kernel driver / DPC latency spikes
* PCIe bus interface chokepoint and signal instability
**๐พ Storage & I/O**
* Drive I/O bottleneck and sustained 100% activity
* NVMe and SSD thermal throttling
* S.M.A.R.T. hardware failure flags
* SSD lifespan critical and wear warnings
* Pagefile overuse
**๐งช Meta & Platform**
* Sensor alias validation and auto-detection prompting
* Log row integrity and crash-truncation cleanup
* USB rail voltage sag
---
## โ๏ธ License
MIT License - Developed for the hardware enthusiast and troubleshooting community.