Skip to content
SecretLULPublic

About

🩺 Finds out why Windows acts up and repairs it: failing updates, no internet, crashes, a slow PC. One portable .exe for Windows 10 and 11.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

539 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

WinMedic: healing Windows at 1 HP. Fast. Reliable. Easy.

CI Version Windows 10 / 11 License: GPL-3.0

Windows acting up? Updates that fail, no internet, a slow or crashing PC: WinMedic finds out why and repairs it, so you do not have to reinstall Windows.

It is a single program. Nothing to install, nothing else to download. It only looks until you click Repair, and it creates a restore point first, so you can go back. If Windows will not create one, WinMedic asks before it repairs without it.

WinMedic after a scan: the problems it found, what Repair does, and the Repair button

Download

WinMedic runs on 64-bit Windows 10 and 11.

With WinGet, which comes with Windows 10 and 11:

winget install SecretLUL.WinMedic

Or by hand: download winmedic-<version>.exe from the latest release and start it. WinMedic is not code-signed yet, so Windows may warn you the first time: click More info, then Run anyway. How to check the download first

How to use it

  1. Start WinMedic and confirm the Windows prompt. WinMedic needs administrator rights to check and repair Windows.
  2. Click Scan now. It takes a minute or two and changes nothing.
  3. Click Repair. WinMedic fixes what it can and tells you if Windows needs a restart.

WinMedic opens in Easy mode: how your PC is doing, what Repair will do (for example "Frees about 8.4 GB of disk space") and two big buttons. Press F7, or click Advanced mode top right, for Advanced mode: every detail, filters, the logs, and a simulation that shows what a repair would do without doing it.

What it checks

Area What WinMedic looks for
System files Damaged Windows files, the recovery environment, WMI, Start, Settings or the Store not opening, Windows features whose installation was rolled back
Windows Update Stuck update services and download caches, updates that keep failing and why
Internet A switched-off adapter, no IP address from the router (DHCP), name resolution (DNS), dead DNS servers, Winsock, broken proxies
Crashes Blue screens, what changed in the week before they began, the last memory test, program add-ons that crash Explorer
Hardware Processor, memory and PCIe errors Windows has logged
Disk File system errors, drive health, disk and controller errors Windows logged, temporary files
Startup Autostart entries and scheduled tasks that point at deleted programs or keep failing
Cleanup Caches and leftovers that take up space
Memory A switched-off or too small page file
Tweaks Services, Windows system devices, policies and Defender that "tweak" and debloat tools switched off, and which device keeps a service from starting
Clock and restart A wrong clock, a PC that has not been restarted for weeks
Devices Devices that stopped working or have no driver, a stuck print queue

Exactly what each check looks at and runs is in How WinMedic works.

Is it safe?

  • Scanning only reads. Nothing changes until you click Repair.
  • Before a repair, WinMedic creates a Windows restore point and backs up the registry keys it deletes from or rewrites; those can be rolled back under Settings. Emptying the Recycle Bin or a cache cannot be undone, which is why WinMedic asks you first.
  • Repairs that delete something you may want to keep, or need a restart, are never picked for you. You decide on those in Advanced mode.
  • WinMedic is open source. Its checks are tested against output captured from real Windows installations, and every change runs a real scan in CI.

Privacy

WinMedic collects no data and has no telemetry. It goes online only for this:

  • Updates: it asks GitHub whether there is a newer version and downloads it when you click Update now. You can turn the check off under Settings. GitHub's privacy statement applies to both.
  • Scan: it tests your internet connection by looking up dns.google and www.microsoft.com, and compares your clock with time.windows.com. It asks the DNS servers and proxies set on your PC whether they answer, and when names do not resolve it pings 1.1.1.1 by address, to tell a DNS fault from no connection at all.
  • Repair: DISM takes intact system files from Windows Update, and the clock is set from time.windows.com.

For IT admins

WinMedic also runs without its window, for scripts and remote support, from a console started as Administrator:

winmedic --scan                        # check and print the findings
winmedic --scan --output report.html   # ... and save a report (.html, .md or .json)
winmedic --auto-fix                    # check and repair what is safe to repair
winmedic --dry-run                     # show each repair and its steps, run nothing

The exit code tells a script how it went: 0 fine, 1 warnings, 2 critical problems, 3 a repair failed, 7 a check could not run, so the findings are incomplete. 2 and 3 can also come with an incomplete scan; without --json the console names each failed module ([X] Module ... failed). Every flag and code is listed in How WinMedic works.

Uninstall

First click Settings → Remove WinMedic from Windows, or run winmedic --uninstall. That removes the background scan, if you turned it on. Then delete winmedic.exe, or run winget uninstall SecretLUL.WinMedic if you installed it with WinGet.

Your settings and logs stay in %APPDATA%\WinMedic, the registry backups in %ProgramData%\WinMedic and HKLM\SOFTWARE\WinMedic; winmedic --uninstall --purge deletes them too.

For developers

WinMedic is written in Rust. You need Windows 10 or 11, Rust 1.95 or newer and the MSVC build tools:

git clone https://github.com/SecretLUL/WinMedic.git
cd WinMedic
cargo build --locked --release   # creates target\release\winmedic.exe

CONTRIBUTING.md explains what CI checks and which parts need extra care. Please report security problems privately, as described in SECURITY.md.

License

Copyright (c) 2026 Ammar (https://github.com/SecretLUL)

GPL-3.0-only, see LICENSE. Version 0.8.0 and earlier were released under the MIT License.

About

🩺 Finds out why Windows acts up and repairs it: failing updates, no internet, crashes, a slow PC. One portable .exe for Windows 10 and 11.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages