Skip to main content
A video walkthrough is available at youtu.be/JJvW9e4X7k0.
1

Check requirements

Before running WinSux, confirm you have:
  • Windows 10 or 11 — any edition (Home, Pro, LTSC, IoT, Server)
  • Active internet connection — the script downloads files during Phase 1
  • Administrator access — you must run the terminal as Administrator
WinSux is best run on a fresh Windows install. Running it on an existing system is possible but may produce unexpected results since it removes all UWP apps, clears startup entries, and wipes all startup scheduled tasks.
2

Enable PowerShell script execution (if needed)

The recommended one-liner uses -useb (UseBasicParsing) and pipes to iex, which runs without needing a policy change. If you prefer to download and run the script directly, you may need to enable execution first.
If you cloned the repo or downloaded the ZIP, run AllowScripts.cmd as Administrator and choose option 1 (Scripts: On) before running WinSux.ps1.
What AllowScripts.cmd does when you choose option 1:
AllowScripts.cmd
:: allow double click powershell scripts
reg add "HKCR\Applications\powershell.exe\shell\open\command" /ve /t REG_SZ /d "C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe -NoLogo -ExecutionPolicy unrestricted -File \"%%1\"" /f
:: allow powershell scripts
reg add "HKCU\SOFTWARE\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell" /v "ExecutionPolicy" /t REG_SZ /d "Unrestricted" /f
reg add "HKLM\SOFTWARE\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell" /v "ExecutionPolicy" /t REG_SZ /d "Unrestricted" /f
:: unblock all files in current directory
powershell -Command "Get-ChildItem -Path $PSScriptRoot -Recurse | Unblock-File"
3

Open an elevated terminal

WinSux must run as Administrator. Right-click Start and choose one of:
  • Terminal (Admin) — Windows 11
  • Windows PowerShell (Admin) — Windows 10
To verify you have full privileges, run:
whoami /priv
You should see SeShutdownPrivilege in the output.
4

Run the script

Choose your preferred method:
5

Phase 1 — Initial setup (automated)

WinSux runs Phase 1 automatically with no input required:
  1. Verifies internet connectivity (pings 8.8.8.8)
  2. Downloads all temp files from https://api.github.com/repos/FR33THYFR33THY/WinSux/contents/Temp to %SystemRoot%\Temp
  3. Installs 7-Zip silently and configures its context menu
  4. Installs all Visual C++ redistributables (2005 through 2022, x86 and x64)
  5. Extracts and configures DDU (Display Driver Uninstaller)
  6. Installs Google Chrome and force-installs uBlock Origin Lite
  7. Extracts and installs DirectX
  8. Registers stepone.ps1 to run on next boot via Winlogon
  9. Registers steptwo.ps1 to run via RunOnce after Safe Mode
  10. Sets boot to Safe Mode: bcdedit /set {current} safeboot minimal
  11. Restarts your computer
Do not interrupt the script during Phase 1. Let it run to completion and allow the automatic restart.
6

Phase 2 — Safe Mode (fully automatic)

After the restart, Windows boots into Safe Mode and stepone.ps1 runs automatically via Winlogon. No input is required.
  • Restores Winlogon to userinit.exe (removes itself from the boot chain)
  • Runs security configuration commands as TrustedInstaller (disables Defender Tamper Protection, HVCI, VBS, Smart App Control)
  • Disables UAC
  • Removes the Safe Mode boot flag
  • Runs DDU with flags -CleanSoundBlaster -CleanRealtek -CleanAllGpus -Restart
  • Restarts your computer (triggered by DDU)
7

Phase 3 — Final configuration

After the second restart, Windows boots normally and steptwo.ps1 runs automatically via RunOnce. Most of Phase 3 is automated, but it pauses at two points:GPU driver selection: A menu appears asking you to choose your GPU brand:
INSTALL GRAPHICS DRIVERS
SELECT YOUR SYSTEM'S GPU
 1.  NVIDIA
 2.  AMD
 3.  INTEL
 4.  SKIP
Select your GPU brand. Chrome will open to the vendor’s driver download page. Download the latest driver, then select it using the file picker that appears. WinSux will extract, debloat, and install it automatically.Display and sound settings: After driver installation, you are prompted to:
  • Set your display resolution and refresh rate
  • Set your primary display (if you have multiple monitors)
  • Set your sound output device
Windows Settings, NVIDIA Control Panel (if applicable), and Sound settings open automatically for you to configure.After you close those windows, Phase 3 completes:
  • Power plan set to Ultimate Performance (all others deleted)
  • Timer Resolution Service installed and started
  • System restore point created (“backup”)
  • Final restart
8

You're done

After the final restart, your system is fully optimized. Everything has been configured:
  • Essential software installed (7-Zip, Chrome, DirectX, VC++ runtimes)
  • Bloatware removed (Edge, OneDrive, UWP apps, legacy Windows features)
  • Windows settings, privacy, and security configured
  • Power plan set to Ultimate Performance
  • GPU driver installed and configured
  • Timer resolution at maximum for minimum input latency
A system restore point named “backup” was created at the end of Phase 3. If you need to undo changes, open System Properties → System Protection → System Restore and select it.

Build docs developers (and LLMs) love

Get started for freeTalk to us