From abe8848cd6352efbc09258e67aac9b7a8a4e06f0 Mon Sep 17 00:00:00 2001 From: LeDragoX Date: Thu, 7 Dec 2023 11:44:41 -0300 Subject: [PATCH] Update README --- README.md | 82 +++++++++++++++++++++++++++---------------------------- 1 file changed, 40 insertions(+), 42 deletions(-) diff --git a/README.md b/README.md index d757cfef..561f7003 100644 --- a/README.md +++ b/README.md @@ -23,20 +23,18 @@ I need to change these files: -_These scripts will Customize, Debloat and Improve Privacy/Performance and System Responsiveness on Windows 10+._ - -This has a collection of scripts to tweak the system per category, using different functions to adjust the system settings and make Windows great again! You can also install your favorite softwares through the GUI with just one click after being selected. - -> [!IMPORTANT] -> _Use on a fresh Windows install to notice the differences. Using an admin account is recommended to avoid any compatibility issues._ +***Re-imagining Windows like a minimal OS install, already debloated with minimal impact for most functionality.*** > [!WARNING] -> ⚠️ **DISCLAIMER:** _You're doing this at your own risk, I am not responsible for any data loss or damage that may occur. It's not guaranteed that every feature removed from the system can be easily restored._ +> ⚠️ **DISCLAIMER:** *You're doing this at your own risk, I am not responsible for any data loss or damage that may occur. It's not guaranteed that every feature removed from the system can be easily restored.* ## 🚀 Download Latest Version Code located in the `main` branch is considered stable, the `develop` branch contains the most recent features. +> [!IMPORTANT] +> *Use on a fresh Windows install to notice the differences. Using an admin account is recommended to avoid any compatibility issues.* +
@@ -82,11 +80,11 @@ Set-ExecutionPolicy Unrestricted -Scope CurrentUser -Force; ls -Recurse *.ps*1 |
![Script GUI](./src/assets/script-gui.png) -_The `Apply Tweaks` button is the main one for debloating._ +*The `Apply Tweaks` button is the main one for debloating.*
-### **CLI Version** (Minimal, good for automation) +### **CLI Version** (Straight to debloat) ```ps1 Set-ExecutionPolicy Unrestricted -Scope CurrentUser -Force; ls -Recurse *.ps*1 | Unblock-File; .\"WinDebloatTools.ps1" 'CLI' @@ -107,21 +105,21 @@ Set-ExecutionPolicy Unrestricted -Scope CurrentUser -Force; ls -Recurse *.ps*1 |
Click to expand -**This part is also valid to the _Apply Tweaks_ button on the GUI.** +**This part is also valid to the *Apply Tweaks* button on the GUI.** -- [Import all necessary _modules_ before executing everything](./src/lib/); +- Import all necessary *modules* before executing everything ([Source](./src/lib/)); - Logs both script runs on `C:\Users\<>\AppData\Local\Temp\Win-DT-Logs`; -- [Make a Restore Point and Backup the Hosts file](./src/scripts/Backup-System.ps1); -- [Download AdwCleaner and Run the latest version for _Virus/Adware_ scan and from OOShutUp10 and import all Recommended settings from a file](./src/scripts/silent-debloat-softwares.ps1); -- [Disable _non-essential_ Telemetry from Scheduled Tasks and Optimize it](./src/scripts/Optimize-TaskScheduler.ps1); -- [Disable _heavy_ Services, but enable some on SSDs for optimum performance](./src/scripts/Optimize-ServicesRunning.ps1); -- [Remove some of the legacy system components called "_capabilities_", except the most popular ones](./src/scripts/Remove-CapabilitiesList.ps1); -- [Remove _Bloatware_ UWP Apps that comes with Windows 10+, except from my choice](./src/scripts/Remove-BloatwareAppsList.ps1); -- [Optimize Privacy by disabling more telemetry parts and changing GPOs, all through changing registry keys](./src/scripts/Optimize-Privacy.ps1); -- [Optimize Performance by changing away from default settings that slowdowns the system, utilizing _PowerShell_ commands and changing registries to disable features](./src/scripts/Optimize-Performance.ps1); -- [Apply General Personalization tweaks via Registry and _PowerShell_ commands](./src/scripts/Register-PersonalTweaksList.ps1); -- [Help improve the Security of Windows while maintaining performance](./src/scripts/Optimize-Security.ps1); -- [Disable _obsolete_ Windows optional features and enable some that might help](./src/scripts/Optimize-WindowsFeaturesList.ps1); +- Make a Restore Point and Backup the Hosts file ([Source](./src/scripts/Backup-System.ps1)); +- Download AdwCleaner and Run the latest version for *Virus/Adware* scan and from OOShutUp10 and import all Recommended settings from a file ([Source](./src/scripts/silent-debloat-softwares.ps1)); +- Disable *non-essential* **Telemetry** from **Scheduled Tasks** and Optimize it ([Source](./src/scripts/Optimize-TaskScheduler.ps1)); +- Disable *heavy* **Services**, but enable some on SSDs for optimum performance ([Source](./src/scripts/Optimize-ServicesRunning.ps1)); +- Remove some of the legacy system components called as "**Capabilities**", except the most popular ones ([Source](./src/scripts/Remove-CapabilitiesList.ps1)); +- Remove **Bloatware UWP Apps** that comes with Windows 10+, except from my choice ([Source](./src/scripts/Remove-BloatwareAppsList.ps1)); +- Optimize **Privacy** by disabling more **telemetry** parts and changing **GPOs**, all through changing **registry keys** ([Source](./src/scripts/Optimize-Privacy.ps1)); +- Optimize **Performance** by changing away from default settings that slowdowns the system, utilizing **PowerShell commands** and **changing registries** to disable features ([Source](./src/scripts/Optimize-Performance.ps1)); +- Apply **Personalization** tweaks on **UI** and **System Settings** via **Registry** and **PowerShell** commands ([Source](./src/scripts/Register-PersonalTweaksList.ps1)); +- Help improve the **Security** of Windows while maintaining performance ([Source](./src/scripts/Optimize-Security.ps1)); +- Disable **obsolete** Windows **optional features** and enable some that might help ([Source](./src/scripts/Optimize-WindowsFeaturesList.ps1));
@@ -134,9 +132,9 @@ Set-ExecutionPolicy Unrestricted -Scope CurrentUser -Force; ls -Recurse *.ps*1 | #### Customize System Features ([Can be found here](src/utils/Individual-Tweaks.psm1)) -- `Enable/Disable Dark Theme`: Apply _Dark Theme_ or _Light Theme_ on Windows; +- `Enable/Disable Dark Theme`: Apply *Dark Theme* or *Light Theme* on Windows; - `Enable/Disable Activity History`: Manages the **Activity History** setting; -- `Enable/Disable Background Apps`: Manages _ALL_ the **Background Apps** settings; +- `Enable/Disable Background Apps`: Manages *ALL* the **Background Apps** settings; - `Enable/Disable Clipboard History`: Manages the **Clipboard History** setting, that keeps a history from your clipboard pressing `Windows + V` key; - `Enable/Disable Clipboard Sync Across Devices`: Manages the **Clipboard Sync Across Devices** setting, which allows to use the same clipboard for multiple devices (must be using a MS account); - `Enable/Disable Cortana`: Manages the **Cortana** setting; @@ -145,7 +143,7 @@ Set-ExecutionPolicy Unrestricted -Scope CurrentUser -Force; ls -Recurse *.ps*1 | - `Enable/Disable Old Volume Control`: Manages the **Old Volume Control (Win 7/8.1)** setting; - `Enable/Disable Online Speech Recognition`: Manages the **Online Speech Recognition** setting, by pressing the keys `Windows + H` you can speak through your mic, then use it to type text using your voice; - `Enable/Disable Phone Link`: Manages the **Phone Link** setting, which can link your Android/iPhone devices notifications to Windows; -- `Enable/Disable Photo Viewer`: [_Enables_](./src/utils/enable-photo-viewer.reg) or [_Disables_](src/utils/disable-photo-viewer.reg) the old **Photo Viewer (Win 7/8.1)**; +- `Enable/Disable Photo Viewer`: [*Enables*](./src/utils/enable-photo-viewer.reg) or [*Disables*](src/utils/disable-photo-viewer.reg) the old **Photo Viewer (Win 7/8.1)**; - `Enable/Disable Search App for Unknown Ext.`: When running a unknown extension file, be able to search through **MS Store** for an App that can open it. - `Enable/Disable Telemetry`: Manages the **Windows Telemetry Level** setting; - `Enable/Disable WSearch Service`: Manages the **Windows Search Service** setting; @@ -154,21 +152,21 @@ Set-ExecutionPolicy Unrestricted -Scope CurrentUser -Force; ls -Recurse *.ps*1 | #### System Debloat Tools - `Apply Tweaks`: Run every Common Tweak scripts ([Go To **☑️ Common Script Features** section](#%EF%B8%8F-common-script-features)); -- `Undo Tweaks`: Re-apply some tweaks and _Revert_ all possible ones, covering the, `ShutUp10 settings`, `Scheduled Tasks`, `Services`, `Privacy and Performance`, `Personal` and `Optional Features` tweaks, then try to `Reinstall Pre-Installed Apps`; +- `Undo Tweaks`: Re-apply some tweaks and *Revert* all possible ones, covering the, `ShutUp10 settings`, `Scheduled Tasks`, `Services`, `Privacy and Performance`, `Personal` and `Optional Features` tweaks, then try to `Reinstall Pre-Installed Apps`; - [`Remove Microsoft Edge`](./src/scripts/Remove-MSEdge.ps1): uninstalls **Microsoft Edge**, disables Scheduled Tasks and Services related to Edge, then remove the remaining files, **Edge Web View** files will remain untouched, but apps which depends on **WebView2** will not install unless you install Microsoft Edge; - [`Remove OneDrive`](./src/scripts/Remove-OneDrive.ps1): completely removes OneDrive from the System, re-install is possible via Win Store; - [`Remove Xbox`](./src/scripts/Remove-Xbox.ps1): wipe Xbox Apps, disable Services related to Xbox and GameBar/GameDVR; #### Install System Apps ([Can be found here](src/utils/Install-Individual-System-Apps.psm1)) -_This section contains options to restore the system apps, by downloading them from the **MS Store** (mostly) and doing **Stock configurations** (for some Apps)._ +*This section contains options to restore the system apps, by downloading them from the **MS Store** (mostly) and doing **Stock configurations** (for some Apps).* > [!NOTE] > The Xbox button uses a script to restore functionalities and reinstall the Xbox Apps available on MS Store. #### Other Tools -_This section contains tools to solve some Windows problems and get info about how much debloated the system is._ +*This section contains tools to solve some Windows problems and get info about how much debloated the system is.* - [`Randomize System Color`](./src/scripts/other-scripts/New-SystemColor.ps1): Changes the Windows color pallette to a random generated hex color; - [`Reinstall Pre-Installed Apps`](./src/scripts/Install-DefaultAppsList.ps1): Rebloat Windows with all the Pre-Installed Apps; @@ -181,32 +179,32 @@ _This section contains tools to solve some Windows problems and get info about h #### Optional Features/Task Scheduler/Services/Windows Capabilities ([Can be found here](src/utils/Individual-Tweaks.psm1)) -_These sections can manually adjust **Features** from the system, working as a ON/OFF toggle._ +*These sections can manually adjust **Features** from the system, working as a ON/OFF toggle.* #### Miscellaneous Features ([Can be found here](src/utils/Individual-Tweaks.psm1)) -- `Enable/Disable Encrypted DNS`: Sets the DNS Client Servers to **Cloudflare's** and **Google's** (ipv4 and ipv6), and enables **DNS Over HTTPS** on _Windows 11_. +- `Enable/Disable Encrypted DNS`: Sets the DNS Client Servers to **Cloudflare's** and **Google's** (ipv4 and ipv6), and enables **DNS Over HTTPS** on *Windows 11*. - `Enable/Disable God Mode`: Manages the hidden Desktop folder called "**God Mode**"; - `Enable/Disable Mouse Acceleration`: Manages the **Enhance Pointer Precision** setting from mouse settings; - `Enable/Disable Mouse Natural Scroll`: Sets the mac-like mouse scrolling behavior, basically reverts mouse scroll direction; -- `Enable/Disable Take Ownership menu`: [_Enables_](./src/utils/enable-take-ownership-context-menu.reg) or [_Disables_](src/utils/disable-take-ownership-context-menu.reg) the **Take Ownership context menu**; +- `Enable/Disable Take Ownership menu`: [*Enables*](./src/utils/enable-take-ownership-context-menu.reg) or [*Disables*](src/utils/disable-take-ownership-context-menu.reg) the **Take Ownership context menu**; - `Enable/Disable Shutdown PC shortcut`: Manages the **Shutdown Computer desktop shortcut**; ### Software Install -- [Install _Winget/Chocolatey_ package managers](./src/lib/package-managers/); +- [Install *Winget/Chocolatey* package managers](./src/lib/package-managers/); - Be able to install the listed software in this script! Even from System apps. - **Importante Note:** When proceeding to install a new app, the script will automatically install the required package manager for that operation. -- [**Create** or **Remove** a Daily Upgrade Task for _Winget/Chocolatey_ packages](./src/lib/package-managers/); +- [**Create** or **Remove** a Daily Upgrade Task for *Winget/Chocolatey* packages](./src/lib/package-managers/); - - Creates a new Scheduled Job to daily upgrade all available softwares via _Winget_ at **12:00** and _Chocolatey_ at **13:00**; + - Creates a new Scheduled Job to daily upgrade all available softwares via *Winget* at **12:00** and *Chocolatey* at **13:00**; - Register daily upgrade logs on `C:\Users\<>\AppData\Local\Temp\Win-DT-Logs` and remove old log files; - `Remove All Chocolatey Packages`: List all packages from Chocolatey which are installed and remove everything at once; -- `Upgrade All Softwares`: Upgrades all Softwares installed on your machine installed through _Winget_ and _Chocolatey_. +- `Upgrade All Softwares`: Upgrades all Softwares installed on your machine installed through *Winget* and *Chocolatey*. - WSL will only update itself, not the distros installed. - `Install Selected`: Install the selected apps by marking the checkbox(es); - `Uninstall Mode`: Default as OFF, clicking this will switch the `Install Selected` button to `Uninstall Selected` and uninstall every selected apps (**Advice:** differently colored buttons may not be able to uninstall completely and WSL UWP Apps, but WSL Distros will be unregistered); @@ -215,7 +213,7 @@ _These sections can manually adjust **Features** from the system, working as a O ## ➕ Contributing -Found a _bug_ or want a _new feature_? You can open a new `Issue` [here](https://github.com/LeDragoX/Win-Debloat-Tools/issues/new/choose). +Found a *bug* or want a *new feature*? You can open a new `Issue` [here](https://github.com/LeDragoX/Win-Debloat-Tools/issues/new/choose). Wanting to add improvements or fixes? Please check out the [CONTRIBUTING.md](CONTRIBUTING.md) file. ## 🤍 Credits @@ -223,13 +221,13 @@ Wanting to add improvements or fixes? Please check out the [CONTRIBUTING.md](CON - Special thanks to [LowSpecGamer](https://youtu.be/IU5F01oOzQQ?t=324), he is the reason i've adapted this script. - Special thanks to [Fabio Akita](https://youtu.be/sjrW74Hx5Po?t=318), for believing in this project and making this script famous 🤍. - [W4RH4WK](https://github.com/W4RH4WK) - For his project ^^ -- [Tester] All of _my friends and people_ who trusted on me to run the script; +- [Tester] All of *my friends and people* who trusted on me to run the script; - [Tester] [yCr-shiddy](https://github.com/yCr-shiddy) - Helped giving more ideas and fixes; -- [Code] [Adamx's](https://www.youtube.com/channel/UCjidjWX76LR1g5yx18NSrLA) - by [_this video_](https://youtu.be/hQSkPmZRCjc) (and script); -- [Code] [Baboo's](https://www.youtube.com/user/baboo) - by [_this video_](https://youtu.be/qWESrvP_uU8) (and commands); -- [Code] [ChrisTitusTech](https://www.youtube.com/channel/UCg6gPGh8HU2U01vaFCAsvmQ) - by having taught how to mess with _PowerShell_ in [this Stream](https://youtu.be/ER27pGt5wH0) (and his _open-source_ debloat script); -- [Code] [Daniel Persson](https://www.youtube.com/channel/UCnG-TN23lswO6QbvWhMtxpA) - by [_this video_](https://youtu.be/EfrT_Bvgles) (and script explanation); -- [Code] [matthewjberger](https://gist.github.com/matthewjberger) - by [_this script_](https://gist.github.com/matthewjberger/2f4295887d6cb5738fa34e597f457b7f). +- [Code] [Adamx's](https://www.youtube.com/channel/UCjidjWX76LR1g5yx18NSrLA) - by [*this video*](https://youtu.be/hQSkPmZRCjc) (and script); +- [Code] [Baboo's](https://www.youtube.com/user/baboo) - by [*this video*](https://youtu.be/qWESrvP_uU8) (and commands); +- [Code] [ChrisTitusTech](https://www.youtube.com/channel/UCg6gPGh8HU2U01vaFCAsvmQ) - by having taught how to mess with *PowerShell* in [this Stream](https://youtu.be/ER27pGt5wH0) (and his *open-source* debloat script); +- [Code] [Daniel Persson](https://www.youtube.com/channel/UCnG-TN23lswO6QbvWhMtxpA) - by [*this video*](https://youtu.be/EfrT_Bvgles) (and script explanation); +- [Code] [matthewjberger](https://gist.github.com/matthewjberger) - by [*this script*](https://gist.github.com/matthewjberger/2f4295887d6cb5738fa34e597f457b7f). ## 🛣️ Roadmap