🧰 WindowsFixKit

Diagnostic and repair toolkit for Windows Update, hardware health, Wi-Fi, Bluetooth, network stack, and DNS errors

Compatible with Windows 7, 8.1, 10, and 11 — Built with PowerShell, native CMD fallbacks, and automated test coverage

---

📦 Download

Download the portable zip archive for offline troubleshooting without installing Git or dependencies:

• Current Release: v1.6.0 Release Notes
• Full Release History: GitHub Releases

---

🆘 Need Help with a Custom PC Issue or Error?

If you are facing an unusual Windows error, driver failure, or need custom technical support for your business, we are here to help! Reach out directly via Call, WhatsApp, or Email:

---

⚡ Quick Start

Option 1: One-Click Menu (Recommended for Most Users)

1. Download WindowsFixKit-latest.zip and extract it.
2. Double-click WindowsFixKit.bat (or run.bat).
3. Accept the Administrator prompt (UAC).
4. Choose an action from the numbered menu:

=================================================================
        WindowsFixKit - Windows Diagnostic and Auto-Repair
      DevSparks India | https://devsparksindia.com | 9521032268
=================================================================

  --- SYSTEM HEALTH & DIAGNOSTICS ---
  [1]  Full Hardware and System Health Diagnosis (Desktop HTML Report)
  [2]  Windows Update and Network Diagnostic + Auto-Fix (diagnose.ps1)
  [3]  Genuine Licensing, ESU & Security Baseline Audit (check_licensing_health)
  [4]  Windows Edition & Servicing Readiness Diagnostics (fix_edition_diagnostics)
  [5]  BSOD Crash Dump & BugCheck Analyzer (fix_bsod_analyzer)

  --- CORE SUBSYSTEM & APPLICATION REPAIRS ---
  [6]  WMI Repository & Core Windows Services Repair (fix_wmi_services)
  [7]  Deep DISM Component Store & SFC File Repair (fix_sfc_dism_deep)
  [8]  Microsoft Office C2R & MSI Diagnostic / Repair (fix_office_repair)
  [9]  Windows Script Host (WSH) & PATH Environment Fixer (fix_wsh_environment)
  [10] Fix Windows Update Stuck at 0% (fix_update_stuck)
  [11] Hardware Driver Auto-Repair & Catalog Scan (fix_driver_updater)
  [12] Windows 10/11 Upgrade Rollback Resolver (fix_upgrade_rollback)
  [13] .NET Framework & App Install Repair Tool (fix_dotnet_repair)

  --- OPTIMIZATION, NETWORK & MAINTENANCE ---
  [14] Safe Performance Debloat (fix_performance_debloat)
  [15] Telemetry & Privacy Registry Hardener (fix_telemetry_privacy)
  [16] Deep Junk & Temp Files Cleanup (%TEMP%, Prefetch, Recycle Bin)
  [17] Deep RAM Cache & Memory Optimizer (Empty Working Sets)
  [18] Full Network and DNS Stack Reset (fix_network_reset)
  [19] Fix Missing Wi-Fi Adapter (fix_wifi_missing)
  [20] Fix Missing Bluetooth Service (fix_bluetooth_missing)

  --- SUPPORT & QUALITY ASSURANCE ---
  [21] Package Diagnostic Logs & Share with DevSparks India (export_and_share_report)
  [22] Run Local CI Lint and Test Check (scripts\lint-check.ps1)
  [23] Exit
=================================================================

---

Option 2: PowerShell Module

# Navigate to WindowsFixKit folder
Set-Location "$HOME\Desktop\WindowsFixKit"

# Import Module locally
Import-Module .\WindowsFixKit.psd1 -Force

# Run full system diagnostics and export Desktop HTML report
Invoke-WindowsFixKit -DiagnosisType Full

# Run Windows Update and network diagnostics
Invoke-WindowsFixKit -DiagnosisType UpdateRepair

---

Option 3: PowerShell CLI

# Clone the repository
git clone https://github.com/nkdhawan76/WindowsFixKit.git
Set-Location WindowsFixKit

# Run the master diagnostic engine
.\scripts\diagnose.ps1

# Run full hardware diagnosis and export desktop HTML report
.\scripts\full_system_diagnosis.ps1

---

📖 What WindowsFixKit Does

WindowsFixKit scans and resolves common Windows Update failures, network drops, driver lockups, and hardware bottlenecks:

• 🔍 Error Log Harvesting: Parses WindowsUpdate.log, ReportingEvents.log, and Event Viewer logs with regex pattern matching to identify active HRESULT / NT error codes.
• 🩺 Full System Diagnostics: Audits hardware specs, disk SMART health counters, RAM buffers, battery degradation, CPU thermals, drive capacities, and startup programs.
• 💥 BSOD Crash Dump Analysis: Parses C:\Windows\Minidump\*.dmp and Event ID 1001 to pinpoint faulty drivers (nvlddmkm.sys, rtwlanu.sys) and stop codes.
• 🛠️ WMI & Core Services Recovery: Remediates WMI database corruption, unblocks SuppressRulesEngine, verifies Null driver, and recovers vital background services (sppsvc, ClipSVC, KeyIso, BITS, CryptSvc, TrustedInstaller, wuauserv).
• 🏬 Deep DISM & SFC Servicing: Executes /RestoreHealth component store repairs and packages large servicing logs into a timestamped Desktop .zip bundle.
• 📑 Office Diagnostic & C2R Repair: Detects Office suites (2016-2024, Microsoft 365), executes 1-click Quick/Online Repairs, cleans stale identity residues, and sets resiliency policies.
• 📜 WSH & PATH Environment Restorer: Re-enables Windows Script Host in registry, fixes broken System %PATH%, and unblocks downloaded scripts via Unblock-File.
• 🔄 Driver Auto-Repair: Rescans PnP bus via pnputil and queries Microsoft Update Catalog for missing/corrupted drivers.
• 📦 1-Click Support Bundling: Packages HTML reports, telemetry, and repair logs into a desktop ZIP with instant Email/WhatsApp escalation.
• 📊 Exportable Reports: Creates a clean, styled HTML report saved directly to your Desktop (WindowsFixKit-Report.html).
• ⚙️ Targeted Fixes: Runs isolated scripts focused specifically on the detected problem, creating backups instead of blindly deleting files.
• 🌐 Backward Compatibility: Uses native PowerShell cmdlets on Windows 10/11 with CMD batch (.bat) fallbacks (netsh, sc, ipconfig) for Windows 7 and 8.1.
• 📋 Summary Reporting: Displays a summary table of issues found, actions taken, and reboot requirements.

---

🖥️ System Health Diagnostics

Run scripts/full_system_diagnosis.ps1 to perform a hardware and system health audit, or execute individual diagnostic scripts directly:

Subsystem	Diagnostic Script	Checks & Metrics
System Info	check_os_info.ps1	OS edition, version, build number, architecture, model, manufacturer, and uptime.
Licensing & Security	check_licensing_health.ps1	Genuine Windows/Office licensing state, partial key, ESU eligibility, Smart App Control (SAC), and Defender baseline.
Storage & SMART	check_disk_health.ps1	NVMe/SSD/HDD media types, drive wear %, operating temperature, read errors, and partition free space.
Memory (RAM)	check_ram_health.ps1	RAM stick vendors, clock speeds, capacities, and active buffer headroom (flags when free RAM < 10%).
Battery Health	check_battery_health.ps1	Design capacity vs full charge capacity, degradation %, and AC power state (flags when health < 60%).
CPU Thermals	check_cpu_temp.ps1	ACPI thermal zone diode temperature readings (flags when temp > 80°C/90°C).
Startup Apps	check_startup_apps.ps1	Scans autostart applications in registry and WMI (flags when > 15 apps are active).
BSOD Crash Dumps	check_bsod_dump.ps1	Scans Minidumps and Event ID 1001 for BugChecks, crash stop codes, and culprit .sys drivers.

---

📋 Supported Error Codes & Remediations

Error Code / Category	Subsystem	Description	Fix Script (.ps1)	Fallback (.bat)	Reboot?
0x80070005	Windows Update	Access Denied - ACL & permission issues on WinSxS / SoftwareDistribution	fix_0x80070005.ps1	—	Yes
0x8024402c	Windows Update	Update Server Unreachable - Proxy misconfiguration or corrupt update cache	fix_0x8024402c.ps1	—	No
0x8024402f	Windows Update	Update Install Failure Loop - Corrupted datastore or catalog database	fix_0x8024402f.ps1	—	Yes
0x80072EFD	Windows Update	Server Connection Interrupted - TLS protocol mismatch or firewall block	fix_0x80072EFD.ps1	—	No
0x800f0922	Windows Update	SSU / .NET Failure - System Partition (ESP) space limit or active VPN filter	fix_0x800f0922.ps1	—	Yes
windows_update_stuck_zero_percent	Windows Update	Update download stuck at 0% or hangs at "Checking for updates"	fix_update_stuck.ps1	—	Yes
wmi_repository_corrupt	System / Core Services	WMI repository database corruption / inconsistent repository	fix_wmi_services.ps1	fix_wmi_services.bat	Yes
wsh_script_host_disabled	System / Environment	Windows Script Host disabled in registry policy	fix_wsh_environment.ps1	—	No
office_c2r_licensing_issue	Applications / Office	Office C2R configuration corruption or stale vNext tokens	fix_office_repair.ps1	—	No
dism_component_store_corrupt	Servicing / Component Store	Corrupted CBS component store packages or payload files	fix_sfc_dism_deep.ps1	—	Yes
pending_reboot_blocking_servicing	Servicing / Upgrades	Unfinished reboot flags in CBS or Windows Update blocking servicing	fix_edition_diagnostics.ps1	—	Yes
licensing_service_degraded	Licensing / Security	Software Protection Platform (sppsvc/ClipSVC) service failure	fix_wmi_services.ps1	fix_wmi_services.bat	Yes
0xC1900101	windows_upgrade	Generic Upgrade Rollback - Device driver conflicts & DISM errors	fix_upgrade_rollback.ps1	—	Yes
0xC1900210	windows_upgrade	MOSETUP_E_COMPAT_SCANONLY_NO_ISSUES - Compatibility scan passed	fix_upgrade_rollback.ps1	—	No
0xC1900208	windows_upgrade	MOSETUP_E_COMPAT_APPS_BLOCK - Incompatible applications blocking upgrade	fix_upgrade_rollback.ps1	—	Yes
0xC1900204	windows_upgrade	MOSETUP_E_COMPAT_MIG_CHOICE_NO_DEFAULT - Architecture/Edition ineligible	fix_upgrade_rollback.ps1	—	No
0xC1900200	windows_upgrade	MOSETUP_E_COMPAT_SYSREQ_NOT_MET - TPM 2.0, Secure Boot, or CPU requirement	fix_upgrade_rollback.ps1	—	No
0xC190020E	windows_upgrade	MOSETUP_E_COMPAT_DISKSPACE_BLOCK - Insufficient partition storage space	fix_storage_cleanup.ps1	—	No
third_party_install_badimageformat	App Install	System.BadImageFormatException referencing PresentationFramework / .NET	fix_dotnet_repair.ps1	—	No
bsod_crash_detected	Hardware / Kernel	Recent Blue Screen of Death memory dump or BugCheck event detected	fix_bsod_analyzer.ps1	—	Yes
driver_device_error	Hardware / Drivers	PnP Hardware Device Driver Error (Code 10/28/43) in Device Manager	fix_driver_updater.ps1	—	Yes
wifi_missing_post_update	Hardware / Wi-Fi	Wi-Fi adapter or tray icon disappears after an update or sleep cycle	fix_wifi_missing.ps1	fix_wifi_missing.bat	No
bluetooth_missing_post_update	Hardware / Bluetooth	Bluetooth service (bthserv) disabled or radio device missing post-update	fix_bluetooth_missing.ps1	fix_bluetooth_missing.bat	No
network_no_internet	Networking	Adapter connected to LAN but displays "No Internet Access"	fix_network_reset.ps1	fix_network_reset.bat	Yes
dns_not_resolving	Networking / DNS	Domain lookups fail while direct IP pings succeed	fix_dns.ps1	fix_dns.bat	No
hdd_ssd_unhealthy	Hardware / Storage	Physical disk wear >80%, SMART warnings, or read error spikes	fix_disk_errors.ps1	—	Yes
ram_error_detected	Hardware / Memory	Available RAM < 10% or memory pool exhaustion	fix_ram_cache.ps1	—	No
battery_degraded	Hardware / Power	Full charge battery capacity degraded < 60% of original design	fix_battery_optimization.ps1	—	No
cpu_overheating	Hardware / CPU	Core temperature > 80°C under load / thermal throttling	fix_cpu_thermal.ps1	—	No
storage_almost_full	Storage / Partitions	Logical drive capacity > 90% full	fix_storage_cleanup.ps1	—	No
startup_bloat	System / Startup	More than 15 startup apps active, causing slow boot times	fix_startup_bloat.ps1	—	No

---

🏗️ Repository Architecture

WindowsFixKit/
├── .github/
│   ├── ISSUE_TEMPLATE/
│   │   ├── bug_report.md
│   │   └── new_error_request.md
│   ├── workflows/
│   │   ├── ci.yml
│   │   ├── version-bump.yml
│   │   ├── release-zip.yml
│   │   └── publish-psgallery.yml
│   ├── CODEOWNERS
│   └── PULL_REQUEST_TEMPLATE.md
├── docs/
│   └── how-it-works.md
├── errors/
│   └── errors_db.json
├── reports/
│   └── report_template.html
├── scripts/
│   ├── full_system_diagnosis.ps1
│   ├── diagnose.ps1
│   ├── lint-check.ps1
│   ├── diagnostics/
│   │   ├── check_os_info.ps1
│   │   ├── check_disk_health.ps1
│   │   ├── check_ram_health.ps1
│   │   ├── check_battery_health.ps1
│   │   ├── check_cpu_temp.ps1
│   │   └── check_startup_apps.ps1
│   ├── fix_0x80070005.ps1
│   ├── fix_0x8024402c.ps1
│   ├── fix_0x8024402f.ps1
│   ├── fix_0x80072EFD.ps1
│   ├── fix_0xc1900101.ps1
│   ├── fix_0x800f0922.ps1
│   ├── fix_wifi_missing.ps1 + fix_wifi_missing.bat
│   ├── fix_bluetooth_missing.ps1 + fix_bluetooth_missing.bat
│   ├── fix_network_reset.ps1 + fix_network_reset.bat
│   ├── fix_dns.ps1 + fix_dns.bat
│   ├── fix_storage_cleanup.ps1
│   ├── fix_startup_bloat.ps1
│   ├── fix_disk_errors.ps1
│   ├── fix_ram_cache.ps1
│   ├── fix_cpu_thermal.ps1
│   └── fix_battery_optimization.ps1
├── tests/
│   ├── Diagnostics.Tests.ps1
│   ├── Scripts.Tests.ps1
│   └── Validate-ErrorsDb.Tests.ps1
├── .all-contributorsrc
├── .gitignore
├── .markdownlint.json
├── CHANGELOG.md
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
├── LICENSE
├── README.md
├── run.bat
├── VERSION
├── WindowsFixKit.bat
├── WindowsFixKit.psd1
└── WindowsFixKit.psm1

---

🔒 Safety & Design Principles

1. Native Binaries Only: Uses built-in Windows system tools (dism.exe, sfc.exe, netsh.exe, icacls.exe, takeown.exe, sc.exe, pnputil.exe, powercfg.exe).
2. Idempotency: All scripts can be re-run safely without producing unintended side effects.
3. Safe Backups: Corrupted update folders and cache directories are rotated with .bak extensions instead of being deleted.

For in-depth architectural details, see How It Works.

---

🤝 Contributing

Contributions and new error code mappings are welcome. Please read CONTRIBUTING.md before submitting a Pull Request.

Run the local test and lint suite before pushing changes:

.\scripts\lint-check.ps1

---

---

👨‍💻 Project Lead & Creator

Nikil Dhawan

Founder & Lead Engineer • DevSparks India

---

👥 Community & Contributions

We welcome contributions from the community to help make WindowsFixKit the most reliable diagnostic toolkit for Windows.

How to Contribute:

1. 💡 Suggest New Fixes: Have an error code or PowerShell fix? Open a Feature Request.
2. 🐛 Report a Bug: Encountered an issue on a specific Windows build? Submit a Bug Report.
3. 🛠️ Submit Pull Requests: Check out CONTRIBUTING.md and run .\scripts\lint-check.ps1 before submitting.

---

📄 License

This project is licensed under the MIT License.