Skip to content

ios12checker/Windows-Maintenance-Tool

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

491 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Windows Maintenance Tool

Version Platform PowerShell License: MIT

Windows Maintenance Tool is an all-in-one GUI toolkit for repairing, cleaning, updating, and tuning Windows 10 and Windows 11 systems. It brings common maintenance tasks into one interface instead of spreading them across Settings, Control Panel, PowerShell, Task Scheduler, Registry Editor, and separate utilities.

It is built for technicians, power users, and end users who want practical Windows maintenance tools with clear buttons, visible output, confirmation prompts, and local backups where risky changes are involved.

Highlights

  • Modern grouped GUI for Windows repair, cleanup, updates, drivers, tweaks, firewall, DNS, and utilities.
  • Full dark/light theme support with a persistent theme toggle.
  • Package updater with Winget, Microsoft Store / Store CLI, pip, npm, pnpm, Chocolatey, Scoop, Ruby Gems, Cargo, .NET global tools, PowerShell modules, Composer, Steam game manifests, Legendary Epic Games updates, and GOGDL GOG game updates.
  • One-by-one package update flow with visible progress windows, plus experimental headless/background automation.
  • Optional EXE build support through PS2EXE for release builds.
  • Optional system tray mode with background update scans, notifications, and reduced RAM mode while hidden.
  • My Device dashboard with system specs, storage health, improved drive benchmark, network, battery/power, driver tools, RAM cleanup, TRIM, export, and quick shortcuts to related tools.
  • Startup Manager for startup apps, scheduled tasks, context menu entries, and services.
  • Restore Manager with create, delete, restore, enable, and disable actions.
  • Advanced Cleanup with analyze/preview mode, Winapp2 community rules, and BleachBit CleanerML support.
  • Safety prompts, backups, revert actions, and clearer error messages for risky operations.

Screenshot

image

What's New in v6

EXE, Tray, and Background Updates

  • Added PS2EXE build support for creating a release-ready WindowsMaintenanceTool.exe.
  • Added single-instance protection so launching WMT again restores the existing window instead of opening a second copy.
  • Added optional system tray mode with restore/exit actions, background update scans, native Windows notifications, and tray-balloon fallback.
  • Added optional RAM reduction while WMT is hidden in the tray.
  • Added experimental headless update/install mode and experimental auto-install from background scans.

Package Providers

  • Added Windows Update as a package/update provider using the Windows Update COM API, including optional update detection and install monitoring.
  • Added .NET global tools, PowerShell modules, and Composer global packages as update/search/install providers.
  • Added Steam manifest scanning for pending game updates, with update handling delegated to Steam.
  • Added Legendary/Epic Games update support with local legendary.exe management and EGL sync.
  • Added GOGDL/GOG update support with local GOGDL management, Heroic auth reuse, and GOG auth flow.
  • Added provider install/repair/open buttons in Provider Manager for supported external tools and launchers.
  • Added Microsoft Store GUI automation when Store CLI is not enough to complete Store app updates.

Interface and Managers

  • Rebuilt Startup Manager in WPF with startup apps, scheduled tasks, context menu entries, services, filtering, color/status styling, and entry editing.
  • Rebuilt Restore Manager with out-of-process restore work and loading/progress feedback.
  • Moved Advanced Cleanup selection and cleanup preview windows to WPF with grouped/searchable rule rendering.
  • Improved update-list checkboxes, smart column sizing, row clipboard export, sorting, and refresh behavior.
  • Improved Firewall Manager with background rule loading, lazy selected-rule details, caching, search, and sortable headers.
  • Improved My Device and Firewall startup behavior with background preloading for expensive data.

Registry Cleaner and Reliability

  • Reworked Registry Cleaner safelist behavior so protected or risky findings are shown as review-only instead of being hidden.
  • Added "Open in Regedit" and improved copy-selected/copy-all output for registry results.
  • Added repair handling for malformed COM server paths and broken executable/argument registry values.
  • Added deeper registry delete handling with native registry APIs, reg.exe fallback, ACL unlock attempts, 32-bit/64-bit target expansion, and verification.
  • Added crash diagnostics to data\last-crash.txt for unhandled WPF/update-monitor failures.
  • Fixed package manager progress, refresh, error detection, provider output deadlocks, Store GUI failures, GOG auth writes, Restore Manager crashes, Winapp2 Analyze crashes, stale tray icons, and duplicate-instance issues.

Core Features

Updates and Software

  • Scan for updates from Winget, Microsoft Store / Store CLI, Chocolatey, pip, npm, pnpm, Scoop, Ruby Gems, Cargo, .NET global tools, PowerShell modules, Composer, Steam manifests, Legendary, GOGDL, and more.
  • Update packages one at a time with a visible update window.
  • Run optional background scans and experimental headless/auto-install flows from tray mode.
  • Search package results before updating.
  • Ignore selected Winget packages.
  • Browse and install curated software.
  • Handles slow providers with timeout protection.
  • Optionally include Winget unknown-version packages with --include-unknown.
  • Delegates Microsoft Store app updates through Store CLI / Microsoft Store update handling where supported.
  • Delegates Steam game updates through the Steam client after detecting pending local manifests.
  • Updates Epic games through the standalone Legendary executable when authenticated; updates installed GOG games through Heroic's GOGDL when GOG auth is available.
  • Right-click supported Winget package rows to view manifest details.
  • Use Update All for batch update flows where available.

System Health

  • Run sfc /scannow.
  • Run DISM CheckHealth and RestoreHealth.
  • Run Quick Fix for common Windows repair steps.
  • Check Windows Recovery Environment (WinRE) status with a simple summary and optional technical details.
  • Run CHKDSK tools.
  • Repair Windows Update components.
  • Reset update services.

My Device

  • View Windows, CPU, RAM, GPU, motherboard, storage, network, battery, and power details.
  • View drive health details and run a drive benchmark.
  • Export the current My Device summary.
  • Use related quick-action buttons from My Device cards, including driver, cleanup, storage, DNS, and health tools.
  • Check driver versions and open vendor driver pages.
  • Clean RAM.
  • Run SSD TRIM and disk optimization tools.
  • Open Disk Management.
  • Open Windows Update quickly.

Tweaks

  • Performance service optimization and revert actions.
  • Hibernation, SysMain, memory compression, and power plan controls.
  • Windows Update policy presets.
  • Optional Windows feature toggles.
  • Taskbar alignment, search, widgets, Task View, Chat, and button combine behavior.
  • Clock options for 12-hour/24-hour format and seconds display.
  • Hardware-Accelerated GPU Scheduling (HAGS) toggle.
  • Explorer options for file extensions, hidden files, full path title bars, launch location, and recent/frequent items.
  • Mouse pointer speed, acceleration, and single-click/double-click behavior.
  • Context menu tweaks for classic Windows 11 menu, Take Ownership, and PowerShell Here.
  • Privacy, search, gaming, visual effect, notification, and lock screen tweaks.
  • Bloatware and AppX cleanup tools.

Cleanup

  • Delete temporary files and recycle bin data.
  • Analyze cleanup targets before deleting files, including file status for protected or in-use items.
  • Clean selected files from the preview window.
  • Run advanced cleanup selections with internal rules, Winapp2 community rules, and BleachBit CleanerML rules.
  • Clear Windows Event Logs.
  • Clean browser and Explorer traces.
  • Find, inspect, fix, or delete broken shortcuts using the rebuilt Broken Shortcut Manager.
  • Clean selected registry issues with backups, review-only protected findings, richer scan coverage, Regedit context tools, and clearer result details.
  • Clear Xbox credentials for login-loop fixes.
  • Free local OneDrive disk space while keeping cloud copies.

Drivers

  • Export installed drivers with the Driver Export Tool GUI.
  • Export selected drivers by category.
  • Restore drivers from backup.
  • Generate driver reports.
  • Remove ghost devices.
  • Enable or disable Windows driver updates.
  • Toggle device metadata downloads.
  • Clean old duplicate drivers.

Network and DNS

  • Flush DNS and reset network settings.
  • Set DNS to Cloudflare, Google, Quad9, DHCP, or custom DNS servers.
  • Set custom IPv4/IPv6 DNS servers from a dedicated dialog.
  • Register or remove DNS over HTTPS templates for custom DNS entries.
  • Enable or disable DNS over HTTPS rules.
  • View routing tables.
  • Edit the hosts file.
  • Apply ad-block hosts lists.

Firewall Manager

  • View and search firewall rules.
  • Lazy-load firewall rules and selected-rule details for better responsiveness, with background preload and detail caching.
  • Add, edit, enable, disable, and delete firewall rules.
  • Export and import firewall policies.
  • Restore firewall defaults or purge rules with confirmation.

Utilities

  • Startup Manager.
  • Restore Manager.
  • Context menu builder.
  • System reports.
  • Release download stats.
  • .NET roll-forward configuration.
  • PS2EXE build script for creating release EXE builds.
  • Group Policy Editor installer for supported Windows Home systems.
  • Optional MAS activation helper with explicit user confirmation.

Getting Started

Recommended Launch

Double-click:

Start_WMT_GUI.bat

Keep Start_WMT_GUI.bat and WMT-GUI.ps1 in the same folder. The launcher validates the script and starts the GUI with the required permissions.

EXE Build

To build a local EXE release:

.\PS2EXE\Build-Exe.ps1 -InstallPS2EXE

The default output is:

dist\WindowsMaintenanceTool.exe

The EXE build uses the version from $AppVersion in WMT-GUI.ps1 and requires administrator privileges at runtime.

Manual Launch

powershell -NoProfile -ExecutionPolicy Bypass -File "WMT-GUI.ps1"

Requirements

  • Windows 10 or Windows 11
  • PowerShell 5.1 or later
  • Administrator privileges
  • Internet connection for update checks, package scans, downloads, and online sources

Output and Data Folder

WMT stores generated files in a local data folder next to the script.

Output Purpose
settings.json Saved WMT settings
Installed_Drivers.txt Driver report
Drivers_Backup_* Exported driver backups
SystemReports_* System, network, and driver reports
RegistryBackups Registry cleanup backups
hosts_backups Hosts file backups
winapp2.ini / cache files Advanced cleanup community rules
legendary / gogdl Local game-provider helper tools and auth files
last-crash.txt Last captured WMT crash/monitor diagnostic

Safety Notes

  • Destructive actions use confirmation prompts.
  • Registry and hosts changes create backups where applicable.
  • Many tweak groups include revert actions.
  • Startup and service changes are visible in Startup Manager.
  • Registry cleaner review-only rows are shown for inspection and are not fixed automatically.
  • Tray/headless package automation is experimental and may still require manual provider interaction.
  • WMT itself does not send telemetry.
  • Some features use online sources, package managers, or Microsoft/Windows components.

Troubleshooting

Problem What to Try
The app does not start Run Start_WMT_GUI.bat from the same folder as WMT-GUI.ps1.
SmartScreen blocks launch Choose More info and Run anyway if you trust your local copy.
Admin prompt appears Accept it. Most maintenance actions require elevation.
Winget scan fails Make sure App Installer / Winget is installed and internet is available.
Package update hangs Retry the individual provider or update the package manually.
Background/headless update does not finish Disable headless mode and run the provider visibly from the Updates tab.
A tweak causes issues Use the matching revert button where available.
Registry cleanup finds protected entries Review-only entries are intentionally not fixed automatically. Inspect them before taking action.

Project Links

Credits

Community

Discord

Contributing

Issues and pull requests are welcome. Please include:

  • Windows version
  • WMT version
  • Steps to reproduce
  • Screenshot or error output when possible

If this tool helps you, consider starring the repository.

About

A powerful, all-in-one Windows maintenance toolkit built entirely in Batch & PowerShell. Designed for power users, sysadmins, and curious tinkerers – now smarter, safer, and fully offline-compatible.

Resources

License

Contributing

Stars

Watchers

Forks

Sponsor this project

  •  

Contributors