Skip to content

Update README.md with WIKI links and modern formatting #5

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
BiosSystem merged 1 commit into from
Aug 14, 2026
Merged

Update README.md with WIKI links and modern formatting #5

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
221 changes: 49 additions & 172 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,172 +1,49 @@

<p align="center">
<img src="https://readme-typing-svg.herokuapp.com?font=Share+Tech+Mono&weight=bold&size=34&duration=3000&pause=1000&color=00FF72&center=true&vCenter=true&width=600&lines=WinSwift;The+Ultimate+Windows+Debloater;Powered+by+BiosSystem" alt="WinSwift Title" />
</p>

<p align="center">
<img src="https://img.shields.io/github/v/release/BiosSystem/WinSwift?color=00ff72&style=flat-square" alt="Version">
<img src="https://img.shields.io/badge/PowerShell-5.1+-blue?style=flat-square&logo=powershell" alt="PowerShell">
<img src="https://img.shields.io/github/license/BiosSystem/WinSwift?style=flat-square" alt="License">
<img src="https://img.shields.io/github/stars/BiosSystem/WinSwift?style=flat-square&color=00ff72" alt="Stars">
</p>

> **Notice:** WinSwift is an enterprise-grade, rebranded fork of the open-source project [Raphire/Win11Debloat](https://github.com/Raphire/Win11Debloat). All original credits and core architecture concepts belong to the Raphire team. We have implemented our own unified build system and UI adjustments to suit strict organizational needs.

WinSwift is a lightweight, easy-to-use PowerShell script that allows you to quickly declutter and customize your Windows experience—**no installation required!** Remove pre-installed apps, disable telemetry, strip out intrusive interface elements, and reclaim your operating system.

## 🏗️ Architecture & Execution Flow

WinSwift uses a robust PowerShell execution engine with strict error handling and UAC elevation to apply modifications safely.

```mermaid
graph TD
subgraph Execution["Initialization"]
A[User Runs Command] --> B{Admin Rights?}
B -- No --> C[Request UAC Elevation]
C --> D
B -- Yes --> D[Load WinSwift Engine]
end

subgraph CoreEngine["WinSwift Core Engine"]
D --> E[Parse Parameters]
E --> F[Backup Registry State]
F --> G[Load Modular Tweaks]
end

subgraph Operations["Targeted Operations"]
G --> H[Telemetry & Privacy]
G --> I[Appx Package Removal]
G --> J[UI/UX Modifications]
G --> K[AI/Copilot Purge]
end

H --> L[Done]
I --> L
J --> L
K --> L
```

## ✨ What's New in v3.1.0

We've overhauled WinSwift to keep up with the latest Windows 11 updates (24H2 and 25H2), focusing heavily on protecting your privacy from new AI integrations and telemetry.

- **The Ultimate AI Purge (August 2026 Update):** We now actively hunt down and disable Copilot (System-wide and Outlook), Windows Recall, Click to Do, and generative AI features embedded in Paint, Notepad, and Photos for the latest 24H2 builds.
- **Ironclad Privacy:** We've introduced a dual-layer telemetry block. WinSwift now disables tracking services at their root and applies hardcoded Firewall and HOSTS rules to prevent Windows from phoning home.
- **Unattend Generator:** Building a new PC? Use our built-in XML generator to create a Windows installation file that entirely skips the Microsoft Account requirement and OOBE tracking screens.
- **Ad-Free Experience:** We've expanded our ad-blocker to target the newest promotional banners Microsoft injected into the Settings app and File Explorer.

<p align="center">
<img src="Assets/Images/welcome.png" width="48%" />
<img src="Assets/Images/menu.png" width="48%" />
</p>
<p align="center">
<img src="Assets/Images/apps.png" width="48%" />
<img src="Assets/Images/deploy.png" width="48%" />
</p>

## 🚀 Usage

> [!WARNING]
> Great care went into making sure this script does not unintentionally break any OS functionality, but **use at your own risk!** If you run into any issues, please report them [on our Issue Tracker](https://github.com/BiosSystem/WinSwift/issues).

### Quick Method (Recommended)

Run the script directly from our raw GitHub repository using PowerShell.

1. Open PowerShell or Terminal.
2. Copy and paste the command below into PowerShell:

```PowerShell
$f = New-TemporaryFile | Rename-Item -NewName { $_.Name + '.ps1' } -PassThru
irm https://raw.githubusercontent.com/BiosSystem/WinSwift/master/WinSwift.ps1 -OutFile $f
& $f
Remove-Item $f -Force
```
*(Alternatively, you can download the script and run it manually)*

3. Wait for the script to automatically download and launch WinSwift.
4. Carefully read through and follow the on-screen instructions.

This method supports command-line parameters to customize the behaviour of the script. Please refer to our [Wiki](https://github.com/BiosSystem/WinSwift/wiki) for advanced parameters.

### Traditional Method

<details>
<summary>Click here for manual download instructions</summary><br/>

1. [Download the latest version](https://github.com/BiosSystem/WinSwift/releases/latest) and extract the `.ZIP` file to your desired location.
2. Navigate to the WinSwift folder.
3. Double click the `Run.bat` file to start the script.
4. Accept the Windows UAC prompt to run the script as administrator.
5. Carefully read through and follow the on-screen instructions.
</details>

### Advanced Method (PowerShell Direct)

<details>
<summary>Click here for advanced PowerShell execution</summary><br/>

1. [Download the latest version](https://github.com/BiosSystem/WinSwift/releases/latest) and extract the `.ZIP` file.
2. Open PowerShell as an administrator.
3. Temporarily enable PowerShell execution by entering the following command:

```PowerShell
Set-ExecutionPolicy Unrestricted -Scope Process -Force
```

4. Navigate to the directory where the files were extracted: `cd C:\WinSwift`
5. Run the script:

```PowerShell
.\WinSwift.ps1
```
</details>

## 📚 Developer Wiki & Technical Deep-Dive

Are you a developer, sysadmin, or power user? We have created a comprehensive, open-source technical Wiki detailing the exact registry keys, services, and execution flows used by WinSwift.

👉 **[Read the Developer Wiki & Documentation Here](docs/Home.md)**

## 🛠️ Feature Overview

> [!TIP]
> All changes made by WinSwift can easily be reverted, and almost all removed apps can be reinstalled through the Microsoft Store. Visit our [Wiki](https://github.com/BiosSystem/WinSwift/wiki/Reverting-Changes) for reversion instructions.

### 🗑️ App Removal & Bloatware
Clean up your Start menu by instantly removing pre-installed bloatware (like TikTok, Candy Crush, and OEM manufacturer apps) in a single click.

### 🕵️ Privacy & Telemetry Hardening
Take back control of your data. We disable background diagnostic data collection, activity history, targeted advertising IDs, and app-launch tracking. Your PC should serve you, not advertisers.

### 🤖 The AI Purge
Not a fan of Microsoft's new AI push? WinSwift completely neutralizes Windows Recall snapshots, Copilot integrations, and AI-driven suggestions across Edge, Paint, and the OS workspace.

### 🎮 Gaming & Performance Modes
Squeeze every drop of performance out of your hardware:
- **Gaming Mode:** Automatically switches your PC to High Performance, lowers network latency for multiplayer games, disables mouse acceleration, and prevents background maintenance tasks from interrupting your match.
- **Competitive Esports Mode:** For the hardcore players. Unlocks the hidden Ultimate Performance power plan, forces ultra-low system timer resolutions (0.5ms), and fine-tunes CPU/GPU scheduling to eliminate micro-stutters.
- **Defender Exclusions:** Automatically tells Windows Defender to ignore your Steam, Epic, and GOG libraries, stopping real-time antivirus scans from slowing down game loading screens.

### 🚫 System-Wide Ad Blocker
Microsoft has started putting ads inside the operating system itself. We turn them all off. Say goodbye to Lock Screen promotional banners, Start Menu suggested apps, and Settings app "tips".

### ⚡ General Performance Tweaks
We turn off unnecessary background services that eat up your RAM and slow down your hard drive, such as Windows Search indexing and Superfetch, making your desktop feel much snappier.

### 🛡️ Security Hardening
Close dangerous loopholes that malware loves to exploit. We disable outdated protocols (like SMBv1 and TLS 1.0) and block common attack vectors like AutoRun and Windows Script Host.

### 📦 Automated Software Installer
Setting up a new PC? Check a few boxes and let WinSwift automatically download and install your favorite essential apps (like 7-Zip, Brave, VLC, and Discord) without you having to click through a single installer wizard.

### 🔎 Dry-Run & Run Summaries
Curious about what WinSwift actually does under the hood? Turn on Dry-Run Mode to safely preview all the changes without actually applying them. When you do run it for real, you'll get a clean summary report of exactly what was modified.

## 🤝 Contributing

We welcome contributions of all kinds! Please see our [Contributing Guidelines](https://github.com/BiosSystem/WinSwift/blob/master/.github/CONTRIBUTING.md) for detailed instructions on how to get started.

## 📄 License

WinSwift is licensed under the MIT license. See the `LICENSE` file for more information.
<p align="center">
<img src="https://readme-typing-svg.herokuapp.com?font=Share+Tech+Mono&weight=bold&size=34&duration=3000&pause=1000&color=00FF72&center=true&vCenter=true&width=600&lines=WinSwift;The+Ultimate+Windows+Debloater;Powered+by+BiosSystem" alt="WinSwift Title" />
</p>

<p align="center">
<img src="https://img.shields.io/github/v/release/BiosSystem/WinSwift?color=00ff72&style=flat-square" alt="Version">
<img src="https://img.shields.io/badge/PowerShell-5.1+-blue?style=flat-square&logo=powershell" alt="PowerShell">
<img src="https://img.shields.io/github/license/BiosSystem/WinSwift?style=flat-square" alt="License">
<img src="https://img.shields.io/github/stars/BiosSystem/WinSwift?style=flat-square&color=00ff72" alt="Stars">
</p>

> **Notice:** WinSwift is an enterprise-grade, rebranded fork of the open-source project [Raphire/Win11Debloat](https://github.com/Raphire/Win11Debloat). All original credits and core architecture concepts belong to the Raphire team.

## 🚀 Elevator Pitch

WinSwift is a lightweight, modular PowerShell engine designed to quickly declutter and customize Windows 11 without requiring installation. It instantly strips out pre-installed bloatware, neutralizes telemetry, purges intrusive AI integrations like Copilot and Recall, and hardens system privacy while providing maximum performance for gaming and enterprise deployments.

## ✨ Features

- **App Removal & Bloatware Cleanup:** Instantly remove pre-installed bloatware (TikTok, Candy Crush, OEM apps) and clean up your Start menu.
- **Privacy & Telemetry Hardening:** Disable background diagnostic data collection, activity history, and targeted advertising IDs at the root.
- **The AI Purge (24H2 / 25H2):** Completely neutralize Copilot, Windows Recall, Click to Do, and generative AI features embedded in OS apps.
- **Performance Modes:** Switch between Gaming Mode and Competitive Esports Mode to squeeze maximum performance out of your hardware with ultra-low latency configurations.
- **System-Wide Ad Blocker:** Block promotional banners on the Lock Screen, Start Menu suggested apps, and Settings app ads.

## 📖 Technical Documentation

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

👉 **[Read the WinSwift Technical Wiki](docs/WIKI.md)**

## ⚡ Quick Start

Run WinSwift directly from PowerShell without downloading any files manually:

```PowerShell
$f = New-TemporaryFile | Rename-Item -NewName { $_.Name + '.ps1' } -PassThru
irm https://raw.githubusercontent.com/BiosSystem/WinSwift/master/WinSwift.ps1 -OutFile $f
& $f
Remove-Item $f -Force
```

> [!WARNING]
> While designed to be safe and reversible, modifying OS features carries inherent risks. Use at your own risk. Check out the [Wiki](docs/WIKI.md) for instructions on how to revert changes.

## 🤝 Contributing & License

We welcome contributions! Please see our [Contributing Guidelines](.github/CONTRIBUTING.md).
WinSwift is released under the MIT license.
Loading