From 40b5cf4a7dd408ed0daf9605e1bfb2807e782f7f Mon Sep 17 00:00:00 2001
From: Jeffrey <9938813+Raphire@users.noreply.github.com>
Date: Mon, 20 May 2024 22:25:33 +0200
Subject: [PATCH] Update README.md
---
README.md | 356 +++++++++++++++++++++++++++++-------------------------
1 file changed, 190 insertions(+), 166 deletions(-)
diff --git a/README.md b/README.md
index fb8148e..4d6c8fe 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@
Win11Debloat is a simple, easy to use and lightweight powershell script that can remove pre-installed Windows bloatware apps, disable telemetry and declutter the experience by disabling or removing intrusive interface elements, ads and more. No need to painstakingly go through all the settings yourself, or remove apps one by one. Win11Debloat makes the process quick and easy!
-You can pick and choose exactly which modifications you want the script to make, or use the default settings. If you are unhappy with any of the changes you can easily revert them by using the registry files that are included in the 'Regfiles' folder, all of the apps that are removed can be reinstalled from the Microsoft store.
+You can pick and choose exactly which modifications you want the script to make, or use the default settings. If you are unhappy with any of the changes you can easily revert them by using the registry files that are included in the 'Regfiles' folder. All of the apps that are removed can be reinstalled from the Microsoft store.

@@ -10,188 +10,202 @@ You can pick and choose exactly which modifications you want the script to make,
[](https://ko-fi.com/M4M5C6UPC)
-## Features
+## Features
-Win11Debloat has many options, but not all of these options are executed when running the script with the default settings. Select 'Custom mode' in the script menu if you want more granular control over the script or if you want to access all of Win11Debloat's features.
+> [!Tip]
+> Select the custom mode to customize the script to your needs or select the [default mode](#default-mode) to apply the recommended changes.
-### Default Settings
-
-- Remove the default selection of bloatware apps from [this list](#apps-that-are-removed-by-default).
-- Disable telemetry, diagnostic data, app-launch tracking & targeted ads.
-- Disable & remove bing search & cortana in Windows search.
-- Disable tips, tricks, suggestions and ads in start, settings, notifications, Windows explorer, and on the lockscreen.
-- Disable Windows Copilot. (Windows 11 only)
-- Show file extensions for known file types.
-- Disable the widget service & hide the icon from the taskbar.
-- Hide the Chat (meet now) icon from the taskbar.
-- Hide the 3D objects folder under 'This pc' in Windows explorer. (Windows 10 only)
-
-### All Features
-
-- Remove bloatware apps, with the option to select exactly what apps to remove or keep.
+#### App Removal
+- Remove a wide variety of bloatware apps, with the option to select exactly what apps to remove and keep.
- Remove all pinned apps from the start menu. NOTE: This applies to all existing and new users. (Windows 11 only)
+
+#### Telemetry & Suggested Content
- Disable telemetry, diagnostic data, app-launch tracking & targeted ads.
-- Disable & remove bing search & cortana in Windows search.
- Disable tips, tricks, suggestions and ads in start, settings, notifications, Windows explorer, and on the lockscreen.
+
+#### Bing & Copilot
+- Disable & remove bing search & cortana in Windows search.
- Disable Windows Copilot. (Windows 11 only)
-- Restore the old Windows 10 style context menu. (Windows 11 only)
+
+#### Windows Explorer
- Show hidden files, folders and drives.
- Show file extensions for known file types.
- Hide duplicate removable drive entries from the Windows explorer navigation pane, so only the entry under 'This PC' remains.
+
+#### Taskbar
- Align taskbar icons to the left. (Windows 11 only)
- Hide or change the search icon/box on the taskbar. (Windows 11 only)
- Hide the taskview button from the taskbar. (Windows 11 only)
-- Disable the widget service & hide icon from the taskbar.
+- Disable the widgets service & hide icon from the taskbar.
- Hide the chat (meet now) icon from the taskbar.
+
+#### Context Menu
+- Restore the old Windows 10 style context menu. (Windows 11 only)
- Hide the 3D objects, music or onedrive folder in the Windows explorer sidepanel. (Windows 10 only)
- Hide the 'Include in library', 'Give access to' and 'Share' options in the context menu. (Windows 10 only)
-
+## Default Mode
-> [!TIP]
-> In 'custom mode' you can select exactly which apps to remove and which you want to keep!
-
-### Apps that ARE removed by default
+The default mode applies the changes that are recommended for most users, expand the section below for more info.
Click to expand
- Microsoft bloat:
- - Clipchamp.Clipchamp
- - Microsoft.3DBuilder
- - Microsoft.549981C3F5F10 (Cortana app)
- - Microsoft.BingFinance
- - Microsoft.BingFoodAndDrink
- - Microsoft.BingHealthAndFitness
- - Microsoft.BingNews
- - Microsoft.BingSearch* (Bing web search in Windows)
- - Microsoft.BingSports
- - Microsoft.BingTranslator
- - Microsoft.BingTravel
- - Microsoft.BingWeather
- - Microsoft.Getstarted (Cannot be uninstalled in Windows 11)
- - Microsoft.Messaging
- - Microsoft.Microsoft3DViewer
- - Microsoft.MicrosoftJournal
- - Microsoft.MicrosoftOfficeHub
- - Microsoft.MicrosoftPowerBIForWindows
- - Microsoft.MicrosoftSolitaireCollection
- - Microsoft.MicrosoftStickyNotes
- - Microsoft.MixedReality.Portal
- - Microsoft.NetworkSpeedTest
- - Microsoft.News
- - Microsoft.Office.OneNote (Discontinued UWP version only, does not remove new MS365 versions)
- - Microsoft.Office.Sway
- - Microsoft.OneConnect
- - Microsoft.Print3D
- - Microsoft.SkypeApp
- - Microsoft.Todos
- - Microsoft.WindowsAlarms
- - Microsoft.WindowsFeedbackHub
- - Microsoft.WindowsMaps
- - Microsoft.WindowsSoundRecorder
- - Microsoft.XboxApp (Old Xbox Console Companion App, no longer supported)
- - Microsoft.ZuneVideo
- - MicrosoftCorporationII.MicrosoftFamily (Microsoft Family Safety)
- - MicrosoftTeams (Personal version only, does not remove MS teams for business/enterprise)
-
- Third party bloat:
- - ACGMediaPlayer
- - ActiproSoftwareLLC
- - AdobeSystemsIncorporated.AdobePhotoshopExpress
- - Amazon.com.Amazon
- - AmazonVideo.PrimeVideo
- - Asphalt8Airborne
- - AutodeskSketchBook
- - CaesarsSlotsFreeCasino
- - COOKINGFEVER
- - CyberLinkMediaSuiteEssentials
- - DisneyMagicKingdoms
- - Disney
- - Dolby
- - DrawboardPDF
- - Duolingo-LearnLanguagesforFree
- - EclipseManager
- - Facebook
- - FarmVille2CountryEscape
- - fitbit
- - Flipboard
- - HiddenCity
- - HULULLC.HULUPLUS
- - iHeartRadio
- - Instagram
- - king.com.BubbleWitch3Saga
- - king.com.CandyCrushSaga
- - king.com.CandyCrushSodaSaga
- - LinkedInforWindows
- - MarchofEmpires
- - Netflix
- - NYTCrossword
- - OneCalendar
- - PandoraMediaInc
- - PhototasticCollage
- - PicsArt-PhotoStudio
- - Plex
- - PolarrPhotoEditorAcademicEdition
- - Royal Revolt
- - Shazam
- - Sidia.LiveWallpaper
- - SlingTV
- - Speed Test
- - Spotify
- - TikTok
- - TuneInRadio
- - Twitter
- - Viber
- - WinZipUniversal
- - Wunderlist
- - XING
-
- * App is removed when disabling Bing in Windows search.
+ Default mode applies the following changes:
+ - Remove the default selection of bloatware apps. (See below for full list)
+ - Disable telemetry, diagnostic data, app-launch tracking & targeted ads.
+ - Disable tips, tricks, suggestions and ads in start, settings, notifications, Windows explorer, and on the lockscreen.
+ - Disable & remove bing search & cortana in Windows search.
+ - Disable Windows Copilot. (Windows 11 only)
+ - Show file extensions for known file types.
+ - Hide the 3D objects folder under 'This pc' in Windows explorer. (Windows 10 only)
+ - Disable the widget service & hide the icon from the taskbar.
+ - Hide the Chat (meet now) icon from the taskbar.
-
-### Apps that are NOT removed by default
-
-
- Click to expand
-
-
- General apps that are not removed by default:
- - Microsoft.Edge (Edge browser, only removeable in the EEA)
- - Microsoft.GetHelp (Required for some Windows 11 Troubleshooters)
- - Microsoft.MSPaint (Paint 3D)
- - Microsoft.OutlookForWindows* (New mail app)
- - Microsoft.OneDrive (OneDrive consumer)
- - Microsoft.Paint (Classic Paint)
- - Microsoft.People* (Required for & included with Mail & Calendar)
- - Microsoft.ScreenSketch (Snipping Tool)
- - Microsoft.Whiteboard (Only preinstalled on devices with touchscreen and/or pen support)
- - Microsoft.Windows.Photos
- - Microsoft.WindowsCalculator
- - Microsoft.WindowsCamera
- - Microsoft.windowscommunicationsapps* (Mail & Calendar)
- - Microsoft.WindowsStore (Microsoft Store, NOTE: This app cannot be reinstalled!)
- - Microsoft.WindowsTerminal (New default terminal app in Windows 11)
- - Microsoft.YourPhone (Phone Link)
- - Microsoft.Xbox.TCUI (UI framework, removing this may break MS store, photos and certain games)
- - Microsoft.ZuneMusic (Modern Media Player)
-
- Gaming related apps that are not removed by default:
- - Microsoft.GamingApp* (Modern Xbox Gaming App, required for installing some games)
- - Microsoft.XboxGameOverlay* (Game overlay, required for some games)
- - Microsoft.XboxGamingOverlay* (Game overlay, required for some games)
- - Microsoft.XboxIdentityProvider (Xbox sign-in framework, required for some games)
- - Microsoft.XboxSpeechToTextOverlay (Might be required for some games, NOTE: This app cannot be reinstalled!)
-
- Developer related apps that are not removed by default:
- - Microsoft.PowerAutomateDesktop*
- - Microsoft.RemoteDesktop*
- - Windows.DevHome*
-
- * Can be removed by running the script with the relevant parameter. (See advanced method)
+ #### Apps that ARE removed by default
+
+
+ Click to expand
+
+
+ Microsoft bloat:
+ - Clipchamp.Clipchamp
+ - Microsoft.3DBuilder
+ - Microsoft.549981C3F5F10 (Cortana app)
+ - Microsoft.BingFinance
+ - Microsoft.BingFoodAndDrink
+ - Microsoft.BingHealthAndFitness
+ - Microsoft.BingNews
+ - Microsoft.BingSearch* (Bing web search in Windows)
+ - Microsoft.BingSports
+ - Microsoft.BingTranslator
+ - Microsoft.BingTravel
+ - Microsoft.BingWeather
+ - Microsoft.Getstarted (Cannot be uninstalled in Windows 11)
+ - Microsoft.Messaging
+ - Microsoft.Microsoft3DViewer
+ - Microsoft.MicrosoftJournal
+ - Microsoft.MicrosoftOfficeHub
+ - Microsoft.MicrosoftPowerBIForWindows
+ - Microsoft.MicrosoftSolitaireCollection
+ - Microsoft.MicrosoftStickyNotes
+ - Microsoft.MixedReality.Portal
+ - Microsoft.NetworkSpeedTest
+ - Microsoft.News
+ - Microsoft.Office.OneNote (Discontinued UWP version only, does not remove new MS365 versions)
+ - Microsoft.Office.Sway
+ - Microsoft.OneConnect
+ - Microsoft.Print3D
+ - Microsoft.SkypeApp
+ - Microsoft.Todos
+ - Microsoft.WindowsAlarms
+ - Microsoft.WindowsFeedbackHub
+ - Microsoft.WindowsMaps
+ - Microsoft.WindowsSoundRecorder
+ - Microsoft.XboxApp (Old Xbox Console Companion App, no longer supported)
+ - Microsoft.ZuneVideo
+ - MicrosoftCorporationII.MicrosoftFamily (Microsoft Family Safety)
+ - MicrosoftTeams (Personal version only, does not remove MS teams for business/enterprise)
+
+ Third party bloat:
+ - ACGMediaPlayer
+ - ActiproSoftwareLLC
+ - AdobeSystemsIncorporated.AdobePhotoshopExpress
+ - Amazon.com.Amazon
+ - AmazonVideo.PrimeVideo
+ - Asphalt8Airborne
+ - AutodeskSketchBook
+ - CaesarsSlotsFreeCasino
+ - COOKINGFEVER
+ - CyberLinkMediaSuiteEssentials
+ - DisneyMagicKingdoms
+ - Disney
+ - Dolby
+ - DrawboardPDF
+ - Duolingo-LearnLanguagesforFree
+ - EclipseManager
+ - Facebook
+ - FarmVille2CountryEscape
+ - fitbit
+ - Flipboard
+ - HiddenCity
+ - HULULLC.HULUPLUS
+ - iHeartRadio
+ - Instagram
+ - king.com.BubbleWitch3Saga
+ - king.com.CandyCrushSaga
+ - king.com.CandyCrushSodaSaga
+ - LinkedInforWindows
+ - MarchofEmpires
+ - Netflix
+ - NYTCrossword
+ - OneCalendar
+ - PandoraMediaInc
+ - PhototasticCollage
+ - PicsArt-PhotoStudio
+ - Plex
+ - PolarrPhotoEditorAcademicEdition
+ - Royal Revolt
+ - Shazam
+ - Sidia.LiveWallpaper
+ - SlingTV
+ - Speed Test
+ - Spotify
+ - TikTok
+ - TuneInRadio
+ - Twitter
+ - Viber
+ - WinZipUniversal
+ - Wunderlist
+ - XING
+
+ * App is removed when disabling Bing in Windows search.
+
+
+ #### Apps that are NOT removed by default
+
+
+ Click to expand
+
+
+ General apps that are not removed by default:
+ - Microsoft.Edge (Edge browser, only removeable in the EEA)
+ - Microsoft.GetHelp (Required for some Windows 11 Troubleshooters)
+ - Microsoft.MSPaint (Paint 3D)
+ - Microsoft.OutlookForWindows* (New mail app)
+ - Microsoft.OneDrive (OneDrive consumer)
+ - Microsoft.Paint (Classic Paint)
+ - Microsoft.People* (Required for & included with Mail & Calendar)
+ - Microsoft.ScreenSketch (Snipping Tool)
+ - Microsoft.Whiteboard (Only preinstalled on devices with touchscreen and/or pen support)
+ - Microsoft.Windows.Photos
+ - Microsoft.WindowsCalculator
+ - Microsoft.WindowsCamera
+ - Microsoft.windowscommunicationsapps* (Mail & Calendar)
+ - Microsoft.WindowsStore (Microsoft Store, NOTE: This app cannot be reinstalled!)
+ - Microsoft.WindowsTerminal (New default terminal app in Windows 11)
+ - Microsoft.YourPhone (Phone Link)
+ - Microsoft.Xbox.TCUI (UI framework, removing this may break MS store, photos and certain games)
+ - Microsoft.ZuneMusic (Modern Media Player)
+
+ Gaming related apps that are not removed by default:
+ - Microsoft.GamingApp* (Modern Xbox Gaming App, required for installing some games)
+ - Microsoft.XboxGameOverlay* (Game overlay, required for some games)
+ - Microsoft.XboxGamingOverlay* (Game overlay, required for some games)
+ - Microsoft.XboxIdentityProvider (Xbox sign-in framework, required for some games)
+ - Microsoft.XboxSpeechToTextOverlay (Might be required for some games, NOTE: This app cannot be reinstalled!)
+
+ Developer related apps that are not removed by default:
+ - Microsoft.PowerAutomateDesktop*
+ - Microsoft.RemoteDesktop*
+ - Windows.DevHome*
+
+ * Can be removed by running the script with the relevant parameter. (See parameters section below)
+
+
## Usage
@@ -205,15 +219,15 @@ Download & run the script automatically via powershell. Please note that this wi
1. Open powershell as an administrator.
2. Copy and paste the code below into powershell, press enter to run the script:
-```
+```powershell
& ([scriptblock]::Create((irm "https://raw.githubusercontent.com/Raphire/Win11Debloat/master/Get.ps1")))
```
3. Wait for the script to automatically install git and download Win11Debloat.
4. A new powershell window will open showing the Win11Debloat menu. Select either the default or custom mode to continue.
5. Carefully read through and follow the on-screen instructions.
-This method supports [parameters](#parameters). To run the script with parameters simply execute the script as explained above, but add the parameters at the end with spaces in between. Example:
-```
+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://raw.githubusercontent.com/Raphire/Win11Debloat/master/Get.ps1"))) -RunDefaults -Silent
```
@@ -223,7 +237,7 @@ 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.
+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. A new powershell window will now open showing the Win11Debloat menu. Select either the default or custom mode to continue.
6. Carefully read through and follow the on-screen instructions.
@@ -234,12 +248,22 @@ Manually download the script & run the script via powershell. Only recommended f
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. Enable powershell execution by entering the following command: `Set-ExecutionPolicy Unrestricted -Scope Process`
+3. 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: `.\Win11Debloat.ps1`
+5. Now run the script by entering the following command:
+```powershell
+.\Win11Debloat.ps1
+```
6. The Win11Debloat menu will now open. Select either the default or custom setup to continue.
+7. Carefully read through and follow the on-screen instructions.
-This method supports [parameters](#parameters). To run the script with parameters simply execute the script as explained above, but add the parameters at the end with spaces in between. Example: `.\Win11Debloat.ps1 -RemoveApps -DisableBing -Silent`
+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
@@ -249,7 +273,7 @@ The quick and advanced method support parameters to tailor the behaviour of the
| :-------: | ----------- |
| -Silent | Suppresses all interactive prompts, so the script will run without requiring any user input. |
| -RunDefaults | Run the script with the default settings. |
-| -RemoveApps | Remove all bloatware apps from [this list](#apps-that-are-removed-by-default). |
+| -RemoveApps | Remove the default selection of bloatware apps. |
| -RemoveAppsCustom | Remove all apps from the 'CustomAppsList' file. IMPORTANT: Run the script with the `-RunAppConfigurator` parameter to create this file first. No apps will be removed if this file does not exist! |
| -RunAppConfigurator | Run the app configurator to create a 'CustomAppsList' file. Run the script with the `-RemoveAppsCustom` parameter to remove these apps. |
| -RemoveCommApps | Remove the Mail, Calender, and People apps. |