Skip to content

Commit e0ac4a4

Browse files
authored
Update README for version 2.5 changes
Updated version information and fixed various bugs in network testing and reporting.
1 parent 0c958d2 commit e0ac4a4

1 file changed

Lines changed: 26 additions & 22 deletions

File tree

README.md

Lines changed: 26 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -21,9 +21,9 @@ A zero-dependency **PowerShell solution** that runs a comprehensive, curated set
2121
* Quickly identifying performance bottlenecks.
2222
---
2323

24-
## What's New in v2.4
24+
## What's New in v2.5
2525

26-
v2.4 focuses on fixing real-world network testing failures observed in the field, particularly on systems running VPN software (Mullvad, Tailscale, WireGuard) and environments with virtual adapters (VMware, Hyper-V). It also resolves a latency test crash that affected every system, and fixes report encoding that caused garbled output in Notepad and legacy viewers.
26+
v2.5 focuses on fixing real-world network testing failures observed in the field, particularly on systems running VPN software (Mullvad, Tailscale, WireGuard) and environments with virtual adapters (VMware, Hyper-V). It also resolves a latency test crash that affected every system, and fixes report encoding that caused garbled output in Notepad and legacy viewers.
2727

2828
### Bug Fixes
2929

@@ -71,25 +71,29 @@ v2.4 focuses on fixing real-world network testing failures observed in the field
7171
* **One-click Menu or Autorun** — interactive menu or `-AutoRun` parameter
7272
* **Output Cleaner** — removes banners, EULA text, usage blocks for readable reports
7373
* **Comprehensive Tests** — CPU, RAM, Disk, GPU, Network, OS Health, Windows Update status
74+
* **Smart Hardware Detection**: Accurate VRAM reporting for modern GPUs (RTX 30/40/50-series) bypassing WMI 4GB limits.
7475
* **Enhanced GPU Testing** — Multi-GPU support, NVIDIA/AMD vendor tools, display configuration
7576
* **Network Speed & Latency** — Multi-URL fallback download test, PsPing integration, VPN-aware
77+
* **Deep Diagnostics**: Automated DISM/SFC, Storage health, and Network throughput testing.
7678
* **Tool Integrity Verification** — Digital signature checking for all Sysinternals tools
7779
* **Smart Reporting** — timestamped Clean Summary + Detailed TXT reports with recommendations
7880
* **Fully Portable** — runs from USB; no installation required
7981
* **Graceful Degradation** — missing tools detected and skipped automatically
8082
* **Robust Elevation Handling** — reliable admin detection (Windows Home compatible)
8183
* **Auto-Download Tools** — built-in Sysinternals Suite downloader via batch launcher
84+
* **Resilient Downloads**: Triple-redundant download engine (BITS > IWR > WebClient) for Sysinternals utilities.
8285
* **Windows Update Integration** — checks pending updates and service status
8386
* **Modern PowerShell** — uses CIM instances (not deprecated WMI) for better performance
8487
---
8588

86-
## Requirements
89+
## 📋 Requirements
8790

88-
* **OS:** Windows 10/11 (Windows Server supported)
89-
* **PowerShell:** 5.1+ or PowerShell 7
91+
* **OS:** Windows 10/11 (Home/Pro/Enterprise & Windows Server supported)
92+
* **PowerShell:** 5.1+ or PowerShell 7 (Standard Windows PowerShell)
9093
* **Permissions:** Administrator rights recommended (some tests require elevation)
91-
* **Internet:** Only needed for auto-download feature (optional)
94+
* **Internet**: Required for Option 5 (Sysinternals Download)
9295
* **Sysinternals Tools:** Auto-downloadable via launcher or manual installation
96+
* *Note: v2.5 now supports TLS 1.3 for secure communication with Microsoft CDNs.*
9397
* **GPU Tools (Optional):** NVIDIA drivers (nvidia-smi), AMD drivers, GPU-Z
9498
---
9599

@@ -173,9 +177,9 @@ For enhanced GPU testing:
173177
| 14 | Hardware Events | WHEA error logs (last 7 days) | Event Viewer |
174178
| 15 | Windows Update | Pending updates, service status | Windows Update COM API |
175179

176-
### Network Testing (Option 7) — v2.4 Changes
180+
### Network Testing (Option 7) — v2.5 Changes
177181

178-
The network test was the most heavily revised area in v2.4. Specific improvements:
182+
The network test was the most heavily revised area in v2.5. Specific improvements:
179183

180184
* **Speed test** now tries three servers in sequence (Cloudflare, Hetzner HTTP, OVH) and stops at the first success, rather than failing outright if the single Hetzner HTTPS URL is blocked or intercepted
181185
* **SSL certificate bypass** is applied per-attempt and restored immediately after, handling VPN and proxy setups that perform TLS interception (Mullvad, corporate proxies, etc.)
@@ -189,7 +193,7 @@ The network test was the most heavily revised area in v2.4. Specific improvement
189193
### Clean Summary Report
190194
```
191195
=========================================
192-
SYSTEM TEST REPORT v2.4
196+
SYSTEM TEST REPORT v2.5
193197
CLEAN SUMMARY
194198
=========================================
195199
Date: 04/23/2026 14:30:22
@@ -231,7 +235,7 @@ GPU:
231235
232236
NETWORK SPEED:
233237
Active Link Speeds:
234-
Wi-Fi: 2.4 Gbps
238+
Wi-Fi: 2.5 Gbps
235239
Mullvad: 100 Gbps
236240
Tailscale: 100 Gbps
237241
Internet Download Test:
@@ -248,7 +252,7 @@ NETWORK LATENCY:
248252
PsPing Summary:
249253
Min: 11.2 ms
250254
Max: 14.7 ms
251-
Avg: 12.4 ms
255+
Avg: 12.5 ms
252256
253257
WINDOWS UPDATE:
254258
Service: Running
@@ -279,34 +283,34 @@ The batch launcher (`SystemTester.bat`) provides:
279283
2. **Run ALL Tests Automatically** — Complete system scan with auto-report
280284
3. **Fix PowerShell Execution Policy** — Set CurrentUser to RemoteSigned
281285
4. **Verify Tool Integrity** — Check digital signatures and file sizes of Sysinternals tools
282-
5. **Download/Update Sysinternals Suite** — Auto-download from Microsoft (~35 MB); VPN-compatible in v2.4
286+
5. **Download/Update Sysinternals Suite** — Auto-download from Microsoft (~35 MB); VPN-compatible in v2.5
283287
6. **GPU Testing Tools Manager** — Download and manage GPU testing tools
284-
7. **Help / Troubleshooting** — Comprehensive troubleshooting guide updated for v2.4
288+
7. **Help / Troubleshooting** — Comprehensive troubleshooting guide updated for v2.5
285289
8. **Exit**
286290
---
287291

288292
## Troubleshooting
289293

290294
### Network speed test fails / SSL error
291295
**Cause:** VPN or proxy performing TLS inspection (Mullvad, Tailscale, corporate proxy).
292-
**Status:** Fixed in v2.4. The script now tries three different servers and bypasses certificate validation per-attempt.
296+
**Status:** Fixed in v2.5. The script now tries three different servers and bypasses certificate validation per-attempt.
293297
If all three fail, check firewall rules blocking outbound HTTP/HTTPS.
294298

295299
### Latency test always fails with "Port" error
296300
**Cause:** Bug in v2.21 — an undefined `$targetPort` variable caused `Test-NetConnection` to receive `Port=0`, which Windows rejects.
297-
**Status:** Fixed in v2.4.
301+
**Status:** Fixed in v2.5.
298302

299303
### PsPing shows "Unable to parse latency results"
300304
**Cause:** PsPing output formatting variation not matched by the old strict regex.
301-
**Status:** Fixed in v2.4. If it still shows, the debug line will display the raw PsPing output for diagnosis.
305+
**Status:** Fixed in v2.5. If it still shows, the debug line will display the raw PsPing output for diagnosis.
302306

303307
### VMware or VPN adapters flagged as "slow NIC"
304308
**Cause:** Old recommendation logic matched `100 Mbps` anywhere in the adapter list, including virtual adapters.
305-
**Status:** Fixed in v2.4. Virtual and VPN adapters are now excluded from the physical NIC speed check.
309+
**Status:** Fixed in v2.5. Virtual and VPN adapters are now excluded from the physical NIC speed check.
306310

307311
### Reports contain garbled characters (• â†')
308312
**Cause:** Report was written as UTF-8 but viewed in Notepad or a tool expecting ASCII/Latin-1.
309-
**Status:** Fixed in v2.4. Reports now use ASCII encoding and plain `*` / `->` characters.
313+
**Status:** Fixed in v2.5. Reports now use ASCII encoding and plain `*` / `->` characters.
310314

311315
### "Execution policy" errors
312316
**Solution:** Use launcher Menu Option 3, or run:
@@ -346,7 +350,7 @@ The `Reports\` folder is created automatically the first time a report is genera
346350

347351
## Version History
348352

349-
### v2.4 — April 2026
353+
### v2.5 — April 2026
350354
- Fixed latency test crash: removed undefined `$targetPort` and broken `Test-NetConnection` args
351355
- Fixed speed test SSL failure under VPN/proxy TLS interception
352356
- Added 3-URL fallback chain for speed test (Cloudflare, Hetzner HTTP, OVH)
@@ -361,7 +365,7 @@ The `Reports\` folder is created automatically the first time a report is genera
361365
- Batch: Added SSL bypass to Sysinternals Suite download
362366
- Batch: Simplified VERIFY section, removed misleading exit-code branching
363367
- Batch: Removed stale `SystemTester_FIXED.ps1` legacy filename reference
364-
- Batch: Updated Help section to document v2.4 changes
368+
- Batch: Updated Help section to document v2.5 changes
365369
- Batch: EXIT screen updated to show `Reports\` subfolder path
366370
### v2.21 — 2025
367371
- Added tool integrity verification (digital signature checking)
@@ -503,6 +507,6 @@ MIT License — See [LICENSE](LICENSE) file for details.
503507
* **PowerShell Community** — For patterns and best practices
504508
---
505509

506-
*Tested on Windows 10 (1909+) and Windows 11 — Enterprise, Pro, and Home editions*
510+
*Tested on Windows 10 (1909+) and Windows 11 — Enterprise, Pro, Home & Server editions*
507511

508-
**Last Updated:** April 2026 | **Version:** 2.4 | **Status:** Production Ready
512+
**Last Updated:** AMay 2026 | **Version:** 2.5 | **Status:** Production Ready

0 commit comments

Comments
 (0)