mirror of
https://github.com/Raphire/Win11Debloat.git
synced 2025-11-17 11:06:18 +00:00
Update README.md
This commit is contained in:
Jeffrey
188
README.md
188
README.md
@@ -14,6 +14,9 @@
|
||||
|
||||
# Win11Debloat
|
||||
|
||||
[](https://github.com/Raphire/Win11Debloat/discussions)
|
||||
[](https://github.com/Raphire/Win11Debloat/wiki/)
|
||||
|
||||
Win11Debloat is a simple, easy to use and lightweight PowerShell script that allows you to quickly declutter and improve your Windows experience. It can remove pre-installed bloatware apps, disable telemetry, remove intrusive interface elements and much more. No need to painstakingly go through all the settings yourself or remove apps one by one. Win11Debloat makes the process quick and easy!
|
||||
|
||||
The script also includes many features that system administrators will enjoy. Such as support for Windows Audit mode, the option to make changes to other Windows users and the ability to run the script without requiring user input during runtime.
|
||||
@@ -24,6 +27,64 @@ The script also includes many features that system administrators will enjoy. Su
|
||||
|
||||
[](https://ko-fi.com/M4M5C6UPC)
|
||||
|
||||
## 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 [here](https://github.com/Raphire/Win11Debloat/issues).
|
||||
|
||||
### Quick method
|
||||
|
||||
Download & run the script automatically via PowerShell.
|
||||
|
||||
1. Open PowerShell or Terminal, preferably as an administrator.
|
||||
2. Copy and paste the command below into PowerShell:
|
||||
|
||||
```PowerShell
|
||||
& ([scriptblock]::Create((irm "https://debloat.raphi.re/")))
|
||||
```
|
||||
|
||||
3. Wait for the script to automatically download Win11Debloat.
|
||||
4. Carefully read through and follow the on-screen instructions.
|
||||
|
||||
This method supports parameters to customize the behaviour of the script. Please click [here](https://github.com/Raphire/Win11Debloat/wiki/How-To-Use#parameters) for more information.
|
||||
|
||||
### Traditional method
|
||||
|
||||
<details>
|
||||
<summary>Manually download & run the script.</summary><br/>
|
||||
|
||||
1. [Download the latest version of the script](https://github.com/Raphire/Win11Debloat/archive/master.zip), and extract the .ZIP file to your desired location.
|
||||
2. Navigate to the Win11Debloat folder
|
||||
3. Double click the `Run.bat` file to start the script. NOTE: If the console window immediately closes and nothing happens, try the advanced method below.
|
||||
4. Accept the Windows UAC prompt to run the script as administrator, this is required for the script to function.
|
||||
5. Carefully read through and follow the on-screen instructions.
|
||||
</details>
|
||||
|
||||
### Advanced method
|
||||
|
||||
<details>
|
||||
<summary>Manually download the script & run the script via PowerShell. Recommended for advanced users.</summary><br/>
|
||||
|
||||
1. [Download the latest version of the script](https://github.com/Raphire/Win11Debloat/archive/master.zip), and extract the .ZIP file to your desired location.
|
||||
2. Open PowerShell or Terminal as an administrator.
|
||||
3. Temporarily enable PowerShell execution by entering the following command:
|
||||
|
||||
```PowerShell
|
||||
Set-ExecutionPolicy Unrestricted -Scope Process -Force
|
||||
```
|
||||
|
||||
4. In PowerShell, navigate to the directory where the files were extracted. Example: `cd c:\Win11Debloat`
|
||||
5. Now run the script by entering the following command:
|
||||
|
||||
```PowerShell
|
||||
.\Win11Debloat.ps1
|
||||
```
|
||||
|
||||
6. Carefully read through and follow the on-screen instructions.
|
||||
|
||||
This method supports parameters to customize the behaviour of the script. Please click [here](https://github.com/Raphire/Win11Debloat/wiki/How-To-Use#parameters) for more information.
|
||||
</details>
|
||||
|
||||
## Features
|
||||
|
||||
Below is an overview of the key features and functionality offered by Win11Debloat. For more information about which of these features are included in the default mode please click [here](#default-settings).
|
||||
@@ -270,129 +331,6 @@ The default mode allows you to quickly and easily apply the changes that are rec
|
||||
</details>
|
||||
</details>
|
||||
|
||||
## Usage
|
||||
## License
|
||||
|
||||
> [!Warning]
|
||||
> Great care went into making sure this script does not unintentionally break any OS functionality, but use at your own risk!
|
||||
|
||||
### Quick method
|
||||
|
||||
Download & run the script automatically via PowerShell. All files related to the script are saved to `%temp%/Win11Debloat` if you wish to inspect them. The script automatically cleans up the files after execution.
|
||||
|
||||
1. Open PowerShell, preferably as an administrator.
|
||||
2. Copy and paste the code below into PowerShell, press enter to run the script:
|
||||
|
||||
```PowerShell
|
||||
& ([scriptblock]::Create((irm "https://debloat.raphi.re/")))
|
||||
```
|
||||
|
||||
3. Wait for the script to automatically download Win11Debloat.
|
||||
4. A new PowerShell window will open showing the Win11Debloat menu, select any option to continue.
|
||||
5. Carefully read through and follow the on-screen instructions.
|
||||
|
||||
This method supports [parameters](#parameters). To use parameters simply run the script as explained above, but add the parameters at the end with spaces in between. Example:
|
||||
|
||||
```PowerShell
|
||||
& ([scriptblock]::Create((irm "https://debloat.raphi.re/"))) -RunDefaults -Silent
|
||||
```
|
||||
|
||||
### Traditional method
|
||||
|
||||
Manually download & run the script.
|
||||
|
||||
1. [Download the latest version of the script](https://github.com/Raphire/Win11Debloat/archive/master.zip), and extract the .ZIP file to your desired location.
|
||||
2. Navigate to the Win11Debloat folder
|
||||
3. Double click the `Run.bat` file to start the script. NOTE: If the console window immediately closes and nothing happens, try the advanced method below.
|
||||
4. Accept the Windows UAC prompt to run the script as administrator, this is required for the script to function.
|
||||
4. A new PowerShell window will open showing the Win11Debloat menu, select any option to continue.
|
||||
6. Carefully read through and follow the on-screen instructions.
|
||||
|
||||
### Advanced method
|
||||
|
||||
Manually download the script & run the script via PowerShell. Recommended for advanced users.
|
||||
|
||||
1. [Download the latest version of the script](https://github.com/Raphire/Win11Debloat/archive/master.zip), and extract the .ZIP file to your desired location.
|
||||
2. Open PowerShell as an administrator.
|
||||
3. Temporarily enable PowerShell execution by entering the following command:
|
||||
|
||||
```PowerShell
|
||||
Set-ExecutionPolicy Unrestricted -Scope Process
|
||||
```
|
||||
|
||||
4. In PowerShell, navigate to the directory where the files were extracted. Example: `cd c:\Win11Debloat`
|
||||
5. Now run the script by entering the following command:
|
||||
|
||||
```PowerShell
|
||||
.\Win11Debloat.ps1
|
||||
```
|
||||
|
||||
6. The Win11Debloat menu will now open, select any option to continue.
|
||||
7. Carefully read through and follow the on-screen instructions.
|
||||
|
||||
This method supports [parameters](#parameters). To use parameters simply run the script as explained above, but add the parameters at the end with spaces in between. Example:
|
||||
|
||||
```PowerShell
|
||||
.\Win11Debloat.ps1 -RemoveApps -DisableBing -Silent
|
||||
```
|
||||
|
||||
### Parameters
|
||||
|
||||
The quick and advanced usage methods support parameters to customize the behaviour of Win11Debloat. A table of all the supported parameters and what they do can be found below.
|
||||
|
||||
| Parameter | Description |
|
||||
| :-------: | ----------- |
|
||||
| -CreateRestorePoint | Create a system restore point before making any changes. Unless a restore point was already created in the last 24 hours. |
|
||||
| -Silent | Suppresses all interactive prompts, so the script will run without requiring any user input. |
|
||||
| -Sysprep | Run the script in Sysprep mode. All changes will be applied to the Windows default user profile and will only affect new user accounts. |
|
||||
| -LogPath `<PATH>` | Change where the script will save the log file. The log will be saved to the root folder of the script if no path is specified, or if the specified path doesn't exist. |
|
||||
| -User `<USERNAME>` | Run the script for the specified user, instead of the currently logged in user. This user must have logged on atleast once, and cannot be logged in at the time the script is run. |
|
||||
| -RunDefaults | Run the script with the default settings. |
|
||||
| -RunSavedSettings | Run the script with the saved custom settings from last time. These settings are saved to and read from the `SavedSettings` file in the root folder of the script. |
|
||||
| -RemoveApps | Remove the [default selection](https://github.com/Raphire/Win11Debloat/wiki/App-Removal#default-apps) of bloatware apps. |
|
||||
| -RemoveAppsCustom | Remove all apps specified in the 'CustomAppsList' file. IMPORTANT: You can generate your custom list by running the script with the `-RunAppsListGenerator` parameter. No apps will be removed if this file does not exist. |
|
||||
| -RunAppsListGenerator | Run the apps list generator to generate a custom list of apps to remove, the list is saved to the 'CustomAppsList' file inside the root folder of the script. Running the script with the `-RemoveAppsCustom` parameter will remove the selected apps. |
|
||||
| -RemoveHPApps | Remove preinstalled HP apps. Click [here](https://github.com/Raphire/Win11Debloat/wiki/App-Removal#hp-apps) for a full list. |
|
||||
| -RemoveCommApps | Remove the Mail, Calendar, and People apps. |
|
||||
| -RemoveW11Outlook | Remove the new Outlook for Windows app. |
|
||||
| -RemoveDevApps | Remove developer-related apps such as Remote Desktop, DevHome and Power Automate. |
|
||||
| -RemoveGamingApps | Remove the Xbox App and Xbox Gamebar. |
|
||||
| -ForceRemoveEdge | Forcefully remove Microsoft Edge, this option leaves Core, WebView and Update components installed for compatibility. NOT RECOMMENDED! |
|
||||
| -DisableDVR | Disable Xbox game/screen recording feature & stop gaming overlay popups. |
|
||||
| -ClearStart | Remove all pinned apps from start for the current user (Windows 11 update 22H2 or later only) |
|
||||
| -ClearStartAllUsers | Remove all pinned apps from start for all existing and new users. (Windows 11 update 22H2 or later only) |
|
||||
| -DisableTelemetry | Disable telemetry, diagnostic data & targeted ads. |
|
||||
| -DisableSuggestions | Disable tips, tricks, suggestions and ads in start, settings, notifications and File Explorer. |
|
||||
| -DisableDesktopSpotlight | Disable the 'Windows Spotlight' desktop background option. |
|
||||
| -DisableLockscreenTips | Disable tips & tricks on the lockscreen. |
|
||||
| -DisableBing | Disable & remove Bing web search, Bing AI & Cortana in Windows search. |
|
||||
| -DisableCopilot | Disable and remove Microsoft Copilot. (Windows 11 only) |
|
||||
| -DisableRecall | Disable Windows Recall snapshots. (Windows 11 only) |
|
||||
| -RevertContextMenu | Restore the old Windows 10 style context menu. (Windows 11 only) |
|
||||
| -DisableMouseAcceleration | Turn off Enhance Pointer Precision, also known as mouse acceleration. Requires reboot to apply. |
|
||||
| -DisableStickyKeys | Disable the Sticky Keys keyboard shortcut. |
|
||||
| -DisableFastStartup | Disables Fast Start-up to ensure a full shutdown. |
|
||||
| -ShowHiddenFolders | Show hidden files, folders and drives. |
|
||||
| -ShowKnownFileExt | Show file extensions for known file types. |
|
||||
| -HideDupliDrive | Hide duplicate removable drive entries from the File Explorer navigation pane, so only the entry under 'This PC' remains. |
|
||||
| -TaskbarAlignLeft | Align taskbar icons to the left. (Windows 11 only) |
|
||||
| -HideSearchTb | Hide search icon from the taskbar. (Windows 11 only) |
|
||||
| -ShowSearchIconTb | Show search icon on the taskbar. (Windows 11 only) |
|
||||
| -ShowSearchLabelTb | Show search icon with label on the taskbar. (Windows 11 only) |
|
||||
| -ShowSearchBoxTb | Show search box on the taskbar. (Windows 11 only) |
|
||||
| -HideTaskview | Hide the taskview button from the taskbar. (Windows 11 only) |
|
||||
| -HideChat | Hide the chat (meet now) icon from the taskbar. |
|
||||
| -DisableWidgets | Disable the widget service & hide the widget (news and interests) icon from the taskbar. |
|
||||
| -EnableEndTask | Enable the 'End Task' option in the taskbar right click menu. |
|
||||
| <pre>-DisableStartRecommended</pre> | Disable & hide the recommended section in the start menu. This will also change the start menu layout to `More pins`. |
|
||||
| -HideHome | Hide the home section from the File Explorer navigation pane and add a toggle in the File Explorer folder options. (Windows 11 only) |
|
||||
| -HideGallery | Hide the gallery section from the File Explorer navigation pane and add a toggle in the File Explorer folder options. (Windows 11 only) |
|
||||
| -ExplorerToHome | Change File Explorer to open to `Home`. |
|
||||
| -ExplorerToThisPC | Change File Explorer to open to `This PC`. |
|
||||
| -ExplorerToDownloads | Change File Explorer to open to `Downloads`. |
|
||||
| -ExplorerToOneDrive | Change File Explorer to open to `OneDrive`. |
|
||||
| -HideOnedrive | Hide the OneDrive folder from the File Explorer navigation pane. (Windows 10 only) |
|
||||
| -Hide3dObjects | Hide the 3D objects folder under 'This pc' in File Explorer. (Windows 10 only) |
|
||||
| -HideMusic | Hide the music folder under 'This pc' in File Explorer. (Windows 10 only) |
|
||||
| -HideIncludeInLibrary | Hide the 'Include in library' option in the context menu. (Windows 10 only) |
|
||||
| -HideGiveAccessTo | Hide the 'Give access to' option in the context menu. (Windows 10 only) |
|
||||
| -HideShare | Hide the 'Share' option in the context menu. (Windows 10 only) |
|
||||
Win11Debloat is licensed under the MIT license. See the LICENSE file for more information.
|
||||
|
||||
Reference in New Issue
Block a user