Skip to content

Repository files navigation

WinSwift Title

Version PowerShell License Stars

WinSwift Optimization Engine

Notice: WinSwift is a rebranded fork of the open-source project Raphire/Win11Debloat. Preserve all original credits and upstream attribution.


🚀 The Ultimate Windows Optimization Engine

WinSwift is a lightweight, highly modular PowerShell engine engineered to instantly declutter, customize, and harden Windows 11 without requiring any installation or permanent background services.

Whether you are provisioning enterprise workstations, configuring a dedicated competitive gaming rig, or simply reclaiming your privacy from invasive telemetry, WinSwift executes rapid, surgical strikes on OS bloatware.


🎮 Engineered for Competitive Gaming & Low Latency

Stock Windows 11 ships with default scheduling intervals, background telemetry pipelines, and continuous recording hooks that introduce input lag, frame pacing jitter, and 1% low drops in competitive titles (Valorant, CS2, Apex Legends, Call of Duty, Fortnite).

WinSwift provides a dedicated, non-destructive low-latency optimization stack designed to eliminate OS-level microstutters while maintaining 100% compatibility with kernel anti-cheats (Vanguard, EAC, BattlEye, FACEIT) and official Windows Updates.

WinSwift Esports Low Latency HUD

🕹️ Gaming Performance Stack

Optimization Layer Technical Implementation Gaming Benefit
0.5ms Timer Resolution Forces GlobalTimerResolutionRequests = 1 in kernel session manager Replaces 15.6ms default tick with 0.5ms high-precision scheduling, reducing frame-time variance on 144Hz-540Hz monitors
BCD Clock Synchronization Sets useplatformtick=yes and disabledynamictick=yes Eliminates timer drift and dynamic tick synchronization stalls across high-core-count CPUs
Zero-Buffer Network Protocol Disables Nagle's Algorithm (TcpAckFrequency = 1, TCPNoDelay = 1) Eliminates TCP packet buffering delay for instantaneous hit registration and network updates
MMCSS Network Throttling Kill Sets NetworkThrottlingIndex = 0xFFFFFFFF and SystemResponsiveness = 0 Prevents Windows from throttling network traffic during intensive background multimedia tasks
MMCSS Games Task Priority Sets GPU Priority = 8, Priority = 6, Scheduling Category = High Grants game render threads top-tier GPU scheduler priority over desktop window manager processes
Core Parking Elimination Disables CPU core parking via power policy (ValueMax = 0) Prevents dormant CPU cores from entering deep C-states, eliminating latency spikes when cores wake up mid-match
GameDVR & Game Bar Purge Disables AppCaptureEnabled and AllowGameDVR system-wide Frees dedicated VRAM, disables background encoding buffers, and removes DWM capture hooks
Defender Game Exclusions Whitelists Steam, Epic Games, and GOG directories via Add-MpPreference Prevents real-time antivirus IOPS bottlenecks during in-game asset streaming and shader compilation
1:1 Raw Input Parity Disables Windows pointer precision acceleration curves Delivers true linear 1:1 hardware sensor tracking without erratic OS mouse acceleration
Hardware GPU Scheduling Enables HwSchMode = 2 (HAGS) in graphics driver registry Offloads high-frequency scheduling tasks directly to GPU memory management hardware

⚖️ Why WinSwift vs. Alternatives?

Feature / Criteria WinSwift Stripped Custom ISOs (AtlasOS, ReviOS, Tiny11) Generic Script Suites (Chris Titus, Sophia)
Anti-Cheat Compatibility 100% Compatible (Vanguard, EAC, BattlEye, FACEIT) Often broken due to stripped security modules Mixed (some scripts break Hyper-V / VBS dependencies)
Windows Update Support Full Support (Standard cumulative updates work normally) Broken or permanently disabled Supported
Execution Architecture Native PowerShell 5.1 in-memory execution Modified ISO reinstall required (data wipe) External package managers and third-party CLIs
Rollback & Safety Automatic state backup snapshot with instant -Revert Impossible without full OS reinstallation Manual registry inspection required
Security Posture Retains core Defender & SmartScreen by default Defender stripped completely (malware risk) Toggles vary
Verification Auditing Built-in -Verify and -VerifyProfile audit engine No automated state verification None


🛡️ Windows 11 24H2 / 25H2 Compatibility Matrix

24H2 Verified 25H2 Verified Anti-Cheat Safe Update Lifecycle

Microsoft introduced six structural changes in Windows 11 24H2 that directly affect gamers and power users. WinSwift handles each with a non-destructive, policy-level fix that preserves update integrity and kernel anti-cheat trust chains.

Windows 11 Change Impact Without WinSwift WinSwift Fix Implementation
BitLocker Auto-Encryption Software BitLocker enabled silently on clean install - SSD write throughput reduced by up to 45% with risk of recovery-key lockout Prevents auto-encryption before it activates Disable_Bitlocker_Auto_Encryption.reg sets PreventDeviceEncryption = 1
Windows Recall Snapshots Continuous NPU/CPU screenshot indexing consumes 3-8% CPU headroom during gaming sessions Non-destructive policy suppression - no file deletion that could destabilize explorer.exe Disable_AI_Recall.reg and Disable_AI_Service_Auto_Start.reg suppress Recall scheduling without touching CoreAIComponents binaries
Modern Standby Network (S0) Network adapters stay active during sleep, draining laptop battery and generating thermal load Enforces disconnected standby state Disable_Modern_Standby_Networking.reg re-routes S0 into network-disconnected idle mode
Windows Update Driver Overwrite Cumulative updates replace NVIDIA/AMD drivers with generic OEM packages, introducing microstutter after each patch cycle Blocks WU from scanning and installing drivers Disable_WU_Driver_Search.reg sets ExcludeWUDriversInQualityUpdate = 1
Phone Link Start Menu Panel Microsoft injects Phone Link and Microsoft 365 promotional cards into Start Menu and Settings Home Removes promotional injections without breaking shell binaries Disable_Phone_Link_In_Start.reg and Disable_Settings_365_Ads.reg
Click To Do and Edge AI Contextual AI analysis on cursor hover and Edge background AI inference workers consume idle CPU Disables all context AI workers and Edge AI features Disable_Click_to_Do.reg, Disable_Edge_AI_Features.reg, and ExtendedAIPurge.ps1

Important

WinSwift uses non-destructive GPO and registry policy suppression for all AI components. Aggressive binary deletion of CoreAIComponents causes explorer.exe and SearchHost.exe crash loops in 24H2 builds. WinSwift never performs binary stripping.

Anti-Cheat Safety Guarantee

Kernel anti-cheats (Riot Vanguard, Epic EAC, BattlEye, FACEIT) verify the integrity of specific Windows security components at driver initialization. WinSwift is validated safe across all four:

Anti-Cheat Kernel Dependencies Preserved by WinSwift
Riot Vanguard Xbox Identity Provider, Windows Security Center API, Code Integrity services
Epic EAC Windows Update service chain, UWP certificate stores, AppModel host
BattlEye Windows Firewall service bindings, WMI repository, kernel patch guard
FACEIT Hypervisor-Protected Code Integrity (HVCI), Secure Boot chain, TPM attestation

WinSwift disables only background behavior (DVR recording buffers, telemetry scheduled tasks, advertising ID generation) while keeping all security service binaries and registrations intact.


🔁 State Snapshot, Verification and Rollback Architecture

WinSwift implements a three-stage execution safety model before and after applying any system modification.

Stage 1 - Pre-Execution Snapshot

Before any registry key is written, WinSwift captures a point-in-time backup of all registry paths scheduled for modification. The backup is written to a timestamped .reg export under %TEMP%\WinSwift_Backup_<timestamp>. If -SkipRegistryBackup is not specified, this step is mandatory and blocks execution on failure. A System Restore point is created before any of the four high-impact custom modules run.

Stage 2 - Feature Apply Engine

The apply engine dispatches each feature through Invoke-WinSwiftFeature, which reads the registry target, expected value, and optional service or Appx action from Config/Features.json. Each operation is wrapped in ShouldProcess for -WhatIf support. No binary files are deleted. No Windows service registrations are removed from the service control manager database.

Stage 3 - Desired-State Verification

After applying changes, or at any time using -Verify or -VerifyProfile, WinSwift reads the actual system state and compares it against the requested configuration:

  • Registry values: read back via Get-ItemPropertyValue and compared to the expected target.
  • Appx packages: checked via Get-AppxPackage and Get-AppxProvisionedPackage to confirm removal across user and system contexts.
  • Custom modules: verified through metadata-driven adapters for gaming, AI purge, security hardening, and telemetry firewall state.

Exit code 0 signals full compliance. Exit code 2 signals drift, an unsupported feature state, or a verification failure. This enables automated rollout pipelines and endpoint compliance auditing without manual inspection.

⚙️ How It Works

WinSwift operates entirely in memory using standard PowerShell protocols. It takes a backup snapshot of your state, parses your configuration, and surgically removes or alters OS components.

flowchart TD
    A[User Execution] --> B{Elevation Check}
    B -- Not Admin --> C[Prompt UAC]
    C --> D
    B -- Is Admin --> D[Initialize Core Engine]
    
    D --> E[State Backup & Snapshot]
    E --> F[Parse Parameters & Modules]
    
    F --> G[Module: App Removal]
    F --> H[Module: Privacy & Telemetry]
    F --> I[Module: The AI Purge]
    F --> J[Module: Performance & Gaming]
    
    G & H & I & J --> K[Commit Changes]
    K --> L[Generate Summary Report]
Loading

✨ Core Capabilities

WinSwift is divided into powerful, self-contained modules that target specific operational areas of the Windows environment.

1. Privacy & Telemetry Hardening

Regain control over your data. WinSwift cuts off diagnostics, tracking, and advertising pipelines at the root.

Feature Description Impact Level
Diagnostic Data Disables Windows diagnostic data collection and activity history. High
Telemetry Endpoints Applies hardcoded firewall and HOSTS file rules to block telemetry servers. High
Advertising IDs Turns off targeted advertising IDs and system-wide ad tracking. Medium
Ad Blocker Disables Start Menu suggested apps, Settings banners, and Lock Screen ads. Medium

2. App Removal & Bloatware Cleanup

Strip the operating system down to its bare essentials for maximum efficiency.

Feature Description Impact Level
OEM Bloatware Removes manufacturer-installed junkware and trial software. High
Consumer Apps Uninstalls TikTok, Candy Crush, and other consumer pre-installs. Medium
Start Menu Cleanup Unpins dead tiles and promotional shortcuts. Low
System Apps Safely removes unused built-in Windows applications via Remove-AppxPackage. Medium

3. The AI Purge (24H2 / 25H2)

For environments where embedded Generative AI is a liability or unwanted distraction.

Feature Description Impact Level
Windows Copilot Neutralizes Copilot integrations system-wide, including the taskbar icon. High
Windows Recall Disables Windows Recall snapshots and related background services. High
Click to Do Turns off contextual AI actions across the OS. Medium
Embedded AI Disables generative AI features in Paint, Notepad, and Photos. Low

4. Performance & Gaming Profiles

Unlock the full potential of your hardware with specialized tuning profiles.

Mode Target Audience Key Adjustments
Gaming Mode Gamers, Power Users High Performance power plan, network latency optimization, disabled mouse acceleration, HAGS enabled.
Esports Mode Competitive Gamers Ultimate Performance plan, 0.5ms system timer resolution, CPU/GPU scheduling prioritization, core unparking.
Defender Tweaks All Gamers Whitelists game libraries (Steam, Epic, GOG) to prevent real-time scan overhead during gameplay.

📖 Technical Documentation

For an in-depth look at our architecture, registry modifications, deployment methods, and security practices, please consult our comprehensive technical wiki.

👉 Read the WinSwift Technical Wiki


⚡ Quick Start

Download the standalone release asset when you need a single-file deployment. The standalone script contains the complete modular payload and launches it through Windows PowerShell 5.1.

$scriptPath = Join-Path $env:TEMP 'WinSwift-Standalone.ps1'
Invoke-WebRequest 'https://github.com/BiosSystem/WinSwift/releases/latest/download/WinSwift-Standalone.ps1' -OutFile $scriptPath
powershell.exe -NoProfile -ExecutionPolicy Bypass -File $scriptPath
Remove-Item -LiteralPath $scriptPath -Force

Clone the complete repository when you need modular source, configuration files, registry definitions, or development tools:

git clone https://github.com/BiosSystem/WinSwift.git
Set-Location .\WinSwift
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\WinSwift.ps1

Do not download and run WinSwift.ps1 by itself. The modular entry point requires the Assets, Config, Regfiles, Schemas, and Scripts directories.

Warning

While designed to be safe and reversible, modifying OS features carries inherent risks. Use at your own risk. Check out the Wiki for instructions on how to revert changes.


Requirements and verification

Run WinSwift with Windows PowerShell 5.1 through powershell.exe. Do not run the tool with PowerShell 7 because Appx removal and system restore cmdlets cannot complete correctly there.

Check selected feature state without applying changes:

powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\WinSwift.ps1 -Verify -DisableTelemetry -DisableCopilot -Silent

Check an exported configuration or preset:

powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\WinSwift.ps1 -VerifyProfile .\Config\DefaultSettings.json -Silent

Treat exit code 0 as compliant. Treat exit code 2 as noncompliant, unsupported, or failed verification. Review each result to identify registry values or Appx packages that remain outside the requested state.

Use -SkipExplorerRestart to defer the Explorer restart. Use -SkipRegistryBackup only in controlled disposable environments.


🤝 Contributing & License

Read the Contributing Guidelines before submitting a pull request.

Review upstream credits before redistributing a modified build.

WinSwift is released under the MIT license.

About

Lightweight Windows debloat and customization toolkit with a CLI interface, audit mode support, and exportable settings profiles.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages