mirror of
https://github.com/Raphire/Win11Debloat.git
synced 2026-07-03 07:08:27 +00:00
Compare commits
94 Commits
2026.03.09
...
2026.06.24
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
9ee0126259 | ||
|
|
e23ecf36d6 | ||
|
|
32dc3d6bdf | ||
|
|
f76adc5054 | ||
|
|
95b583606d | ||
|
|
693b805114 | ||
|
|
5ebc50d36a | ||
|
|
d1fe541b62 | ||
|
|
71e3f2e44d | ||
|
|
4891aa401a | ||
|
|
a6d59c0dc1 | ||
|
|
ac54bde383 | ||
|
|
dfe7810346 | ||
|
|
82894176d9 | ||
|
|
87b3035eda | ||
|
|
a89b53504c | ||
|
|
91a6266d50 | ||
|
|
469751f8e8 | ||
|
|
908274a500 | ||
|
|
6e4a616f1c | ||
|
|
535b62db40 | ||
|
|
c039b04717 | ||
|
|
a7a46bb5bf | ||
|
|
a95b5adee8 | ||
|
|
2b97021341 | ||
|
|
1235306f80 | ||
|
|
1a69d19f30 | ||
|
|
5628f6e0b7 | ||
|
|
6f349b4992 | ||
|
|
2193591448 | ||
|
|
e9269c5501 | ||
|
|
fdac0a6d14 | ||
|
|
2aa9afaa2c | ||
|
|
67c9cc6ba3 | ||
|
|
157d26bb22 | ||
|
|
53ca51dffd | ||
|
|
db24865051 | ||
|
|
33b77f19a0 | ||
|
|
37872b2030 | ||
|
|
abfc5db2c3 | ||
|
|
1d828d6a78 | ||
|
|
4d9da4749b | ||
|
|
5cf9ac4082 | ||
|
|
924c192ca5 | ||
|
|
2a5cb986c9 | ||
|
|
66982ada28 | ||
|
|
489af33a8b | ||
|
|
51aa288dfd | ||
|
|
24a6f1bcf8 | ||
|
|
8ac664e45f | ||
|
|
85aa67b5d2 | ||
|
|
c8b4563954 | ||
|
|
22f3144c0f | ||
|
|
2c360961e3 | ||
|
|
11a324365d | ||
|
|
5daa922148 | ||
|
|
1826d6d8be | ||
|
|
c15309bcf6 | ||
|
|
c1dc8f7ce3 | ||
|
|
ebb3a293d4 | ||
|
|
2a7fbf9a2d | ||
|
|
b52a332247 | ||
|
|
92ac5b441e | ||
|
|
5f1d0fb604 | ||
|
|
9ca87b129c | ||
|
|
6db2c158bd | ||
|
|
17654c3f7d | ||
|
|
dd492b523d | ||
|
|
797a232b17 | ||
|
|
9070be6d3f | ||
|
|
b6e7fb1903 | ||
|
|
bb31e98df7 | ||
|
|
ff98febb9a | ||
|
|
342f498344 | ||
|
|
6c321f9d97 | ||
|
|
69354d823e | ||
|
|
c0d00e640d | ||
|
|
d372b00072 | ||
|
|
fbdc5740db | ||
|
|
cbd61902ed | ||
|
|
54edf224a3 | ||
|
|
3eade4ddba | ||
|
|
487b1fbee9 | ||
|
|
774c8ecd92 | ||
|
|
e05af92acc | ||
|
|
edd815fdbb | ||
|
|
17ee530962 | ||
|
|
999e442658 | ||
|
|
1d4cf4a801 | ||
|
|
7a3431e56b | ||
|
|
1b41f05743 | ||
|
|
c6535803ec | ||
|
|
c37bdcf5f2 | ||
|
|
d187679cd0 |
88
.github/CONTRIBUTING.md
vendored
88
.github/CONTRIBUTING.md
vendored
@@ -1,6 +1,7 @@
|
|||||||
# How to Contribute?
|
# How to Contribute?
|
||||||
|
|
||||||
We welcome contributions from the community. You can contribute to Win11Debloat by:
|
We welcome contributions from the community. You can contribute to Win11Debloat by:
|
||||||
|
|
||||||
- Reporting issues and bugs [here](https://github.com/Raphire/Win11Debloat/issues/new?template=bug_report.yml)
|
- Reporting issues and bugs [here](https://github.com/Raphire/Win11Debloat/issues/new?template=bug_report.yml)
|
||||||
- Submitting feature requests [here](https://github.com/Raphire/Win11Debloat/issues/new?template=feature_request.yml)
|
- Submitting feature requests [here](https://github.com/Raphire/Win11Debloat/issues/new?template=feature_request.yml)
|
||||||
- Testing Win11Debloat
|
- Testing Win11Debloat
|
||||||
@@ -15,6 +16,7 @@ You can help us test the latest changes and additions to the script. If you enco
|
|||||||
> The prerelease version of Win11Debloat is meant for developers to test the script. Don't use this in production environments!
|
> The prerelease version of Win11Debloat is meant for developers to test the script. Don't use this in production environments!
|
||||||
|
|
||||||
You can launch the prerelease version of Win11Debloat by running this command:
|
You can launch the prerelease version of Win11Debloat by running this command:
|
||||||
|
|
||||||
```ps1
|
```ps1
|
||||||
& ([scriptblock]::Create((irm "https://debloat.raphi.re/dev")))
|
& ([scriptblock]::Create((irm "https://debloat.raphi.re/dev")))
|
||||||
```
|
```
|
||||||
@@ -28,12 +30,14 @@ You can launch the prerelease version of Win11Debloat by running this command:
|
|||||||
1. **Fork the project** on GitHub by clicking the "Fork" button at the top right of the repository page.
|
1. **Fork the project** on GitHub by clicking the "Fork" button at the top right of the repository page.
|
||||||
|
|
||||||
2. **Clone the repository** to your local machine:
|
2. **Clone the repository** to your local machine:
|
||||||
|
|
||||||
```powershell
|
```powershell
|
||||||
git clone https://github.com/YOUR-USERNAME/Win11Debloat.git
|
git clone https://github.com/YOUR-USERNAME/Win11Debloat.git
|
||||||
cd Win11Debloat
|
cd Win11Debloat
|
||||||
```
|
```
|
||||||
|
|
||||||
3. **Create a new branch** for your contribution:
|
3. **Create a new branch** for your contribution:
|
||||||
|
|
||||||
```powershell
|
```powershell
|
||||||
git checkout -b feature/your-feature-name
|
git checkout -b feature/your-feature-name
|
||||||
```
|
```
|
||||||
@@ -42,11 +46,14 @@ You can launch the prerelease version of Win11Debloat by running this command:
|
|||||||
|
|
||||||
1. Open PowerShell as an administrator
|
1. Open PowerShell as an administrator
|
||||||
2. Enable script execution if necessary:
|
2. Enable script execution if necessary:
|
||||||
|
|
||||||
```powershell
|
```powershell
|
||||||
Set-ExecutionPolicy Unrestricted -Scope Process -Force
|
Set-ExecutionPolicy Unrestricted -Scope Process -Force
|
||||||
```
|
```
|
||||||
|
|
||||||
3. Navigate to your Win11Debloat directory
|
3. Navigate to your Win11Debloat directory
|
||||||
4. Run the script:
|
4. Run the script:
|
||||||
|
|
||||||
```powershell
|
```powershell
|
||||||
.\Win11Debloat.ps1
|
.\Win11Debloat.ps1
|
||||||
```
|
```
|
||||||
@@ -57,18 +64,31 @@ You can launch the prerelease version of Win11Debloat by running this command:
|
|||||||
|
|
||||||
Understanding the project structure is essential for contributing effectively:
|
Understanding the project structure is essential for contributing effectively:
|
||||||
|
|
||||||
```
|
```text
|
||||||
Win11Debloat/
|
Win11Debloat/
|
||||||
├── Win11Debloat.ps1 # Main PowerShell script
|
├── Win11Debloat.ps1 # Main PowerShell script
|
||||||
|
├── Run.bat # Batch launcher for the quick launch method
|
||||||
├── Scripts/ # Additional PowerShell scripts and functions
|
├── Scripts/ # Additional PowerShell scripts and functions
|
||||||
│ └── Get.ps1 # Script used for the quick launch method to automatically download and run Win11debloat
|
│ ├── Get.ps1 # Script used for the quick launch method to automatically download and run Win11debloat
|
||||||
|
│ ├── AppRemoval/ # App package removal logic
|
||||||
|
│ ├── CLI/ # Command-line interface helpers
|
||||||
|
│ ├── Features/ # Feature apply/undo logic (e.g. InvokeChanges.ps1, ReplaceStartMenu.ps1)
|
||||||
|
│ ├── FileIO/ # File input/output helpers
|
||||||
|
│ ├── GUI/ # GUI window definitions and logic
|
||||||
|
│ ├── Helpers/ # Shared helper functions
|
||||||
|
│ └── Threading/ # Threading utilities
|
||||||
├── Config/
|
├── Config/
|
||||||
│ ├── Apps.json # List of supported apps for removal
|
│ ├── Apps.json # List of supported apps for removal
|
||||||
│ ├── DefaultSettings.json # Default configuration preset
|
│ ├── DefaultSettings.json # Default configuration preset
|
||||||
│ ├── Features.json # All features with metadata
|
│ ├── Features.json # All features with metadata
|
||||||
│ └── LastUsedSettings.json # Last used configuration (generated during use)
|
│ └── LastUsedSettings.json # Last used configuration (generated during use)
|
||||||
├── Regfiles/ # Registry files for each feature
|
├── Regfiles/ # Registry files for all features
|
||||||
└── Schemas/ # XAML Schemas for GUI elements
|
│ ├── Undo/ # Registry files for reverting features
|
||||||
|
│ └── Sysprep/ # Registry files for Sysprep mode
|
||||||
|
├── Schemas/ # XAML Schemas for GUI elements
|
||||||
|
├── Assets/ # Static assets (icons, start menu templates)
|
||||||
|
├── Backups/ # Registry backups (generated during use)
|
||||||
|
└── Logs/ # Script logs (generated during use)
|
||||||
```
|
```
|
||||||
|
|
||||||
### Best Practices
|
### Best Practices
|
||||||
@@ -77,7 +97,7 @@ Win11Debloat/
|
|||||||
2. **Document Changes**: Update the `README.md` and other relevant documentation. Wiki documentation will be generated/updated based on the `Features.json` and `Apps.json` files.
|
2. **Document Changes**: Update the `README.md` and other relevant documentation. Wiki documentation will be generated/updated based on the `Features.json` and `Apps.json` files.
|
||||||
3. **Follow Existing Patterns**: Look at existing implementations for guidance.
|
3. **Follow Existing Patterns**: Look at existing implementations for guidance.
|
||||||
4. **Use Clear Naming**: Choose descriptive names for features, IDs, and registry files.
|
4. **Use Clear Naming**: Choose descriptive names for features, IDs, and registry files.
|
||||||
5. **Minimal Changes**: Registry files should only modify what's necessary.
|
5. **Minimal Changes**: Registry files should only modify what's necessary. Avoid using policies where possible.
|
||||||
6. **Comment Your Code**: Add comments explaining your reasoning for complex logic in PowerShell scripts.
|
6. **Comment Your Code**: Add comments explaining your reasoning for complex logic in PowerShell scripts.
|
||||||
7. **Version Constraints**: Use `MinVersion` and `MaxVersion` if a feature only applies to specific Windows versions.
|
7. **Version Constraints**: Use `MinVersion` and `MaxVersion` if a feature only applies to specific Windows versions.
|
||||||
8. **Limit pull requests to 1 feature**: Keep pull requests limited to just one feature, this makes it easier to review your changes.
|
8. **Limit pull requests to 1 feature**: Keep pull requests limited to just one feature, this makes it easier to review your changes.
|
||||||
@@ -98,20 +118,20 @@ Avoid these common mistakes when contributing:
|
|||||||
|
|
||||||
1. **Forgetting Get.ps1**: When adding a new command-line parameter, contributors often remember to add it to `Win11Debloat.ps1` but forget to add the same parameter to `Scripts/Get.ps1`. Both files **must** have matching parameters.
|
1. **Forgetting Get.ps1**: When adding a new command-line parameter, contributors often remember to add it to `Win11Debloat.ps1` but forget to add the same parameter to `Scripts/Get.ps1`. Both files **must** have matching parameters.
|
||||||
|
|
||||||
2. **Missing Registry Files**: Always create an `Undo` registry file for reversibility, aswell as a `Sysprep` registry file for Sysprep mode.
|
2. **Missing Registry Files**: Always create an `Undo` registry file for reversibility, aswell as a `Sysprep` registry file for applying changes to other users and Sysprep mode.
|
||||||
|
|
||||||
3. **Incorrect Registry Hives for Sysprep**: Sysprep registry files apply changes to Windows' default user, registry keys in the `HKEY_CURRENT_USER` hive must use `hkey_users\default` instead. Ensure you update **all** registry keys in the file.
|
3. **Incorrect Registry Hives for Sysprep**: Sysprep registry files are meant to apply changes to a different user. Registry keys in the `HKEY_CURRENT_USER` hive must use `hkey_users\default` instead. Ensure you update **all** registry keys in the file.
|
||||||
|
|
||||||
4. **Wrong Registry File Location**:
|
4. **Wrong Registry File Location**:
|
||||||
- Main action files go in `Regfiles/`
|
- Main action files go in `Regfiles/`
|
||||||
- Undo files go in `Regfiles/Undo/`
|
- Undo files go in `Regfiles/Undo/`
|
||||||
- Sysprep files go in `Regfiles/Sysprep/`
|
- Sysprep files go in `Regfiles/Sysprep/`
|
||||||
|
|
||||||
Placing files in the wrong directory will cause the script to fail when trying to apply or undo changes.
|
Placing files in the wrong directory may cause the script to fail when trying to apply or undo changes.
|
||||||
|
|
||||||
6. **Not Testing Undo Functionality**: Always test that your undo registry file properly reverts all changes. A feature that can't be undone will frustrate users.
|
5. **Not Testing Undo Functionality**: Always test that your undo registry file properly reverts all changes.
|
||||||
|
|
||||||
7. **Not Testing User/Sysprep Functionality**: Always test that your feature works when applied to another user or to the Windows default user with Sysprep. Sysprep changes can be tested by creating new users after running the script.
|
6. **Not Testing User/Sysprep Functionality**: Always test that your feature works when applied to another user or to the Windows default user with Sysprep. Sysprep changes can be tested by creating new users after running the script.
|
||||||
|
|
||||||
7. **Missing Category**: Features without a `Category` field (set to `null`) won't appear in the GUI. This is intentional for command-line-only features, make sure this is what you want before submitting.
|
7. **Missing Category**: Features without a `Category` field (set to `null`) won't appear in the GUI. This is intentional for command-line-only features, make sure this is what you want before submitting.
|
||||||
|
|
||||||
@@ -127,11 +147,13 @@ Avoid these common mistakes when contributing:
|
|||||||
To add a new app that can be removed via Win11Debloat:
|
To add a new app that can be removed via Win11Debloat:
|
||||||
|
|
||||||
1. **Find the AppId**: To find the correct AppId for an app:
|
1. **Find the AppId**: To find the correct AppId for an app:
|
||||||
|
|
||||||
```powershell
|
```powershell
|
||||||
Get-AppxPackage | Select-Object Name, PackageFullName
|
Get-AppxPackage | Select-Object Name, PackageFullName
|
||||||
```
|
```
|
||||||
|
|
||||||
2. **Edit `Config/Apps.json`**: Add a new entry to the `"Apps"` array:
|
2. **Edit `Config/Apps.json`**: Add a new entry to the `"Apps"` array:
|
||||||
|
|
||||||
```json
|
```json
|
||||||
{
|
{
|
||||||
"FriendlyName": "Display Name",
|
"FriendlyName": "Display Name",
|
||||||
@@ -142,6 +164,7 @@ To add a new app that can be removed via Win11Debloat:
|
|||||||
```
|
```
|
||||||
|
|
||||||
3. **Follow the Guidelines**:
|
3. **Follow the Guidelines**:
|
||||||
|
|
||||||
- Use clear, user-friendly names for `FriendlyName`
|
- Use clear, user-friendly names for `FriendlyName`
|
||||||
- Set `SelectedByDefault` to `true` only for apps that are largely considered bloatware, otherwise set to `false`
|
- Set `SelectedByDefault` to `true` only for apps that are largely considered bloatware, otherwise set to `false`
|
||||||
- Provide a concise description explaining what the app does
|
- Provide a concise description explaining what the app does
|
||||||
@@ -162,6 +185,7 @@ Create new registry files in the `Regfiles/` directory:
|
|||||||
- **Sysprep file**: `Sysprep/Disable_YourFeature.reg` (for Sysprep mode)
|
- **Sysprep file**: `Sysprep/Disable_YourFeature.reg` (for Sysprep mode)
|
||||||
|
|
||||||
Example registry file structure:
|
Example registry file structure:
|
||||||
|
|
||||||
```reg
|
```reg
|
||||||
Windows Registry Editor Version 5.00
|
Windows Registry Editor Version 5.00
|
||||||
|
|
||||||
@@ -170,6 +194,7 @@ Windows Registry Editor Version 5.00
|
|||||||
```
|
```
|
||||||
|
|
||||||
A Sysprep registry file should apply the same changes as the normal action. Replace the hive of registry keys that start with `HKEY_CURRENT_USER` with `hkey_users\default`. For example:
|
A Sysprep registry file should apply the same changes as the normal action. Replace the hive of registry keys that start with `HKEY_CURRENT_USER` with `hkey_users\default`. For example:
|
||||||
|
|
||||||
```reg
|
```reg
|
||||||
Windows Registry Editor Version 5.00
|
Windows Registry Editor Version 5.00
|
||||||
|
|
||||||
@@ -179,7 +204,7 @@ Windows Registry Editor Version 5.00
|
|||||||
|
|
||||||
#### 1b. Implement the Feature Logic
|
#### 1b. Implement the Feature Logic
|
||||||
|
|
||||||
If your feature requires more than just applying a registry file, add custom logic to the main script in the appropriate section. In most cases this will involve creating a new entry in the `ExecuteParameter` function for your new feature.
|
If your feature requires more than just applying a registry file, add custom logic to the main script in the appropriate section. In most cases this will involve creating a new entry in the `Invoke-FeatureApply` function (in `Scripts/Features/InvokeChanges.ps1`) for your new feature. If your feature also requires custom undo logic (beyond a simple registry file import), add a corresponding entry to the `Invoke-FeatureUndo` function in the same file.
|
||||||
|
|
||||||
#### 2. Add Feature to Features.json
|
#### 2. Add Feature to Features.json
|
||||||
|
|
||||||
@@ -192,35 +217,39 @@ Add your feature to the `"Features"` array in `Config/Features.json`:
|
|||||||
"ToolTip": "Detailed explanation of what this feature does and its impact.",
|
"ToolTip": "Detailed explanation of what this feature does and its impact.",
|
||||||
"Category": "Privacy & Suggested Content",
|
"Category": "Privacy & Suggested Content",
|
||||||
"Priority": 1,
|
"Priority": 1,
|
||||||
"Action": "Disable",
|
|
||||||
"RegistryKey": "Disable_YourFeature.reg",
|
"RegistryKey": "Disable_YourFeature.reg",
|
||||||
"ApplyText": "Disabling your feature...",
|
"ApplyText": "Disabling your feature",
|
||||||
"UndoAction": "Enable",
|
"UndoLabel": "Short description for the undo",
|
||||||
|
"ApplyUndoText": "Enabling your feature",
|
||||||
"RegistryUndoKey": "Enable_YourFeature.reg",
|
"RegistryUndoKey": "Enable_YourFeature.reg",
|
||||||
"RequiresReboot": false,
|
"RequiresReboot": false,
|
||||||
|
"DisableWhenApplied": false,
|
||||||
"MinVersion": null,
|
"MinVersion": null,
|
||||||
"MaxVersion": null
|
"MaxVersion": null
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
**Field Descriptions**:
|
**Field Descriptions**:
|
||||||
- `FeatureId`: Unique identifier (must match parameter name in Win11Debloat.ps1 and Get.ps1)
|
|
||||||
- `Label`: Short description shown in the UI, written in a way to fit with the Action or UndoAction prefixed
|
- `FeatureId`: Unique identifier, this must match parameter name in the Win11Debloat.ps1 and Get.ps1 files.
|
||||||
- `ToolTip`: Detailed explanation of what the feature does, used for tooltips in the GUI
|
- `Label`: Short description shown in the UI and wiki documentation.
|
||||||
|
- `ToolTip`: Detailed explanation of what the feature does, used for tooltips in the GUI.
|
||||||
- `Category`: One of the predefined categories (see Categories array in Features.json), features without a category won't be loaded into the GUI.
|
- `Category`: One of the predefined categories (see Categories array in Features.json), features without a category won't be loaded into the GUI.
|
||||||
- `Priority`: Optional. The priority value (int) is used to sort features within a category. If this field is omitted the feature will be sorted based on the order in the Features.json file.
|
- `Priority`: Optional. The priority value (int) is used to sort features within a category. If this field is omitted the feature will be sorted based on the order in the Features.json file.
|
||||||
- `Action`: Action word for the feature (e.g., "Disable", "Enable", "Hide", "Show")
|
- `RegistryKey`: Filename of the registry file to apply (in Regfiles/ directory) or null if feature does not require registry changes.
|
||||||
- `RegistryKey`: Filename of the registry file to apply (in Regfiles/ directory) or null if feature does not require registry changes
|
- `ApplyText`: Message shown when applying the feature.
|
||||||
- `ApplyText`: Message shown when applying the feature
|
- `UndoLabel`: Short description for the undo shown in the UI.
|
||||||
- `UndoAction`: Action word for reverting (e.g., "Enable", "Show")
|
- `ApplyUndoText`: Message shown when undoing the feature.
|
||||||
- `RegistryUndoKey`: Filename of the registry file to revert changes or null if feature does not require registry changes
|
- `RegistryUndoKey`: Filename of the registry file to revert changes or null if feature does not require registry changes.
|
||||||
- `RequiresReboot`: Optional boolean. Set to `true` if the feature requires a system reboot to take effect
|
- `RequiresReboot`: Optional boolean. Set to `true` if the feature requires a system reboot to take effect.
|
||||||
- `MinVersion`: Minimum Windows build version (e.g., "22000") or null
|
- `DisableWhenApplied`: Optional boolean. Set to `true` if the feature has no supported undo method.
|
||||||
- `MaxVersion`: Maximum Windows version or null
|
- `MinVersion`: Minimum Windows build version (e.g., "22000") or null.
|
||||||
|
- `MaxVersion`: Maximum Windows version or null.
|
||||||
|
|
||||||
#### 3. Add Command-Line Parameter
|
#### 3. Add Command-Line Parameter
|
||||||
|
|
||||||
Add a corresponding parameter to both `Win11Debloat.ps1` AND `Scripts/Get.ps1`, the parameter name should match the FeatureId you have defined in `Features.json`. In most cases this will be a switch parameter, example:
|
Add a corresponding parameter to both `Win11Debloat.ps1` AND `Scripts/Get.ps1`, the parameter name should match the FeatureId you have defined in `Features.json`. In most cases this will be a switch parameter, example:
|
||||||
|
|
||||||
```powershell
|
```powershell
|
||||||
[switch]$YourFeatureId,
|
[switch]$YourFeatureId,
|
||||||
```
|
```
|
||||||
@@ -233,12 +262,14 @@ Add a corresponding parameter to both `Win11Debloat.ps1` AND `Scripts/Get.ps1`,
|
|||||||
The default preset (`Config/DefaultSettings.json`) defines which features are automatically applied when users run Win11Debloat in "Default Mode" or with the `-RunDefaults` parameter. This preset should include features that are widely considered to improve the Windows experience without breaking functionality.
|
The default preset (`Config/DefaultSettings.json`) defines which features are automatically applied when users run Win11Debloat in "Default Mode" or with the `-RunDefaults` parameter. This preset should include features that are widely considered to improve the Windows experience without breaking functionality.
|
||||||
|
|
||||||
**When to add a feature to the default preset:**
|
**When to add a feature to the default preset:**
|
||||||
|
|
||||||
- The feature removes obvious bloatware or distractions
|
- The feature removes obvious bloatware or distractions
|
||||||
- The feature enhances privacy without breaking core functionality
|
- The feature enhances privacy without breaking core functionality
|
||||||
- The feature is generally non-controversial and beneficial to most users
|
- The feature is generally non-controversial and beneficial to most users
|
||||||
- The change can be easily reverted if needed
|
- The change can be easily reverted if needed
|
||||||
|
|
||||||
**When NOT to add a feature to the default preset:**
|
**When NOT to add a feature to the default preset:**
|
||||||
|
|
||||||
- The feature significantly changes core Windows behavior
|
- The feature significantly changes core Windows behavior
|
||||||
- The feature might break applications or workflows for some users
|
- The feature might break applications or workflows for some users
|
||||||
- The feature is highly opinionated or preference-based
|
- The feature is highly opinionated or preference-based
|
||||||
@@ -254,10 +285,12 @@ To add your feature to the default preset, edit `Config/DefaultSettings.json` an
|
|||||||
```
|
```
|
||||||
|
|
||||||
**Field Descriptions**:
|
**Field Descriptions**:
|
||||||
|
|
||||||
- `Name`: Must exactly match the `FeatureId` from Features.json
|
- `Name`: Must exactly match the `FeatureId` from Features.json
|
||||||
- `Value`: Set to `true` to enable the feature in default mode
|
- `Value`: Set to `true` to enable the feature in default mode
|
||||||
|
|
||||||
**Example:**
|
**Example:**
|
||||||
|
|
||||||
```json
|
```json
|
||||||
{
|
{
|
||||||
"Version": "1.0",
|
"Version": "1.0",
|
||||||
@@ -283,6 +316,7 @@ To add your feature to the default preset, edit `Config/DefaultSettings.json` an
|
|||||||
To add a new category for organizing features:
|
To add a new category for organizing features:
|
||||||
|
|
||||||
- Add a new category entry to the `"Categories"` array in `Config/Features.json`:
|
- Add a new category entry to the `"Categories"` array in `Config/Features.json`:
|
||||||
|
|
||||||
```json
|
```json
|
||||||
{
|
{
|
||||||
"Name": "Your Category Name",
|
"Name": "Your Category Name",
|
||||||
@@ -320,17 +354,20 @@ UI Groups allow features to be grouped together in the GUI with a combobox (drop
|
|||||||
## Submitting a Pull Request
|
## Submitting a Pull Request
|
||||||
|
|
||||||
1. **Commit your changes** with clear, descriptive commit messages:
|
1. **Commit your changes** with clear, descriptive commit messages:
|
||||||
|
|
||||||
```powershell
|
```powershell
|
||||||
git add .
|
git add .
|
||||||
git commit -m "Add feature: Description of your changes"
|
git commit -m "Add feature: Description of your changes"
|
||||||
```
|
```
|
||||||
|
|
||||||
2. **Push to your fork**:
|
2. **Push to your fork**:
|
||||||
|
|
||||||
```powershell
|
```powershell
|
||||||
git push origin feature/your-feature-name
|
git push origin feature/your-feature-name
|
||||||
```
|
```
|
||||||
|
|
||||||
3. **Create a Pull Request** on GitHub:
|
3. **Create a Pull Request** on GitHub:
|
||||||
|
|
||||||
- Go to the original Win11Debloat repository
|
- Go to the original Win11Debloat repository
|
||||||
- Click "New Pull Request"
|
- Click "New Pull Request"
|
||||||
- Select your fork and branch
|
- Select your fork and branch
|
||||||
@@ -342,6 +379,7 @@ UI Groups allow features to be grouped together in the GUI with a combobox (drop
|
|||||||
# Questions?
|
# Questions?
|
||||||
|
|
||||||
If you have questions about contributing, feel free to:
|
If you have questions about contributing, feel free to:
|
||||||
|
|
||||||
- Open a [discussion](https://github.com/Raphire/Win11Debloat/discussions)
|
- Open a [discussion](https://github.com/Raphire/Win11Debloat/discussions)
|
||||||
- Comment on an existing issue
|
- Comment on an existing issue
|
||||||
- Ask in your pull request
|
- Ask in your pull request
|
||||||
2
.github/ISSUE_TEMPLATE/bug_report.yml
vendored
2
.github/ISSUE_TEMPLATE/bug_report.yml
vendored
@@ -1,6 +1,6 @@
|
|||||||
name: "🐞 Bug report"
|
name: "🐞 Bug report"
|
||||||
description: "Report an issue you encountered"
|
description: "Report an issue you encountered"
|
||||||
labels: ["bug"]
|
labels: ["bug", "unconfirmed"]
|
||||||
|
|
||||||
body:
|
body:
|
||||||
- type: markdown
|
- type: markdown
|
||||||
|
|||||||
5
.gitignore
vendored
5
.gitignore
vendored
@@ -1,6 +1,3 @@
|
|||||||
LastSettings
|
|
||||||
SavedSettings
|
|
||||||
LastUsedSettings.json
|
LastUsedSettings.json
|
||||||
CustomAppsList
|
|
||||||
Logs/*
|
Logs/*
|
||||||
Win11Debloat.log
|
Backups/*
|
||||||
690
Config/Apps.json
690
Config/Apps.json
File diff suppressed because it is too large
Load Diff
@@ -29,10 +29,6 @@
|
|||||||
"Name": "DisableStoreSearchSuggestions",
|
"Name": "DisableStoreSearchSuggestions",
|
||||||
"Value": true
|
"Value": true
|
||||||
},
|
},
|
||||||
{
|
|
||||||
"Name": "DisableSearchHighlights",
|
|
||||||
"Value": true
|
|
||||||
},
|
|
||||||
{
|
{
|
||||||
"Name": "DisableCopilot",
|
"Name": "DisableCopilot",
|
||||||
"Value": true
|
"Value": true
|
||||||
@@ -65,10 +61,6 @@
|
|||||||
"Name": "DisableDragTray",
|
"Name": "DisableDragTray",
|
||||||
"Value": true
|
"Value": true
|
||||||
},
|
},
|
||||||
{
|
|
||||||
"Name": "DisableFastStartup",
|
|
||||||
"Value": true
|
|
||||||
},
|
|
||||||
{
|
{
|
||||||
"Name": "Hide3dObjects",
|
"Name": "Hide3dObjects",
|
||||||
"Value": true
|
"Value": true
|
||||||
|
|||||||
1054
Config/Features.json
1054
Config/Features.json
File diff suppressed because it is too large
Load Diff
71
README.md
71
README.md
@@ -4,9 +4,9 @@
|
|||||||
[](https://github.com/Raphire/Win11Debloat/discussions)
|
[](https://github.com/Raphire/Win11Debloat/discussions)
|
||||||
[](https://github.com/Raphire/Win11Debloat/wiki/)
|
[](https://github.com/Raphire/Win11Debloat/wiki/)
|
||||||
|
|
||||||
Win11Debloat is a lightweight, easy to use PowerShell script that allows you to quickly declutter and customize 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!
|
Win11Debloat is a lightweight, easy to use PowerShell script that allows you to quickly declutter and customize your Windows experience, no installation required! You can use it to remove pre-installed 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 and power users will enjoy. Such as a powerful command-line interface, support for Windows Audit mode and the option to make changes to other Windows users. Please refer to our [wiki](https://github.com/Raphire/Win11Debloat/wiki/) for more details.
|
The script also includes many features that system administrators and power users will enjoy. Such as a powerful command-line interface, support for Windows Audit mode and the ability to make changes to other Windows users. Please refer to our [wiki](https://github.com/Raphire/Win11Debloat/wiki/) for more details.
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
@@ -97,23 +97,23 @@ Below is an overview of the key features and functionality offered by Win11Deblo
|
|||||||
#### AI Features
|
#### AI Features
|
||||||
|
|
||||||
- Disable & remove Microsoft Copilot.
|
- Disable & remove Microsoft Copilot.
|
||||||
- Disable Windows Recall. (W11 only)
|
- Disable Windows Recall.
|
||||||
- Disable Click to Do, AI text & image analysis tool. (W11 only)
|
- Disable Click to Do, AI text & image analysis tool.
|
||||||
- Prevent AI service (WSAIFabricSvc) from starting automatically. (W11 only)
|
- Prevent AI service (WSAIFabricSvc) from starting automatically.
|
||||||
- Disable AI Features in Edge. (W11 only)
|
- Disable AI Features in Edge.
|
||||||
- Disable AI Features in Paint. (W11 only)
|
- Disable AI Features in Paint.
|
||||||
- Disable AI Features in Notepad. (W11 only)
|
- Disable AI Features in Notepad.
|
||||||
|
|
||||||
#### System
|
#### System
|
||||||
|
|
||||||
- Disable the Drag Tray for sharing & moving files. (W11 only)
|
- Disable the Drag Tray for sharing & moving files.
|
||||||
- Restore the old Windows 10 style context menu. (W11 only)
|
- Restore the old Windows 10 style context menu.
|
||||||
- Turn off Enhance Pointer Precision, also known as mouse acceleration.
|
- Turn off Enhance Pointer Precision, also known as mouse acceleration.
|
||||||
- Disable the Sticky Keys keyboard shortcut. (W11 only)
|
- Disable the Sticky Keys keyboard shortcut.
|
||||||
- Disable Storage Sense automatic disk cleanup.
|
- Disable Storage Sense automatic disk cleanup.
|
||||||
- Disable fast start-up to ensure a full shutdown.
|
- Disable fast start-up to ensure a full shutdown.
|
||||||
- Disable BitLocker automatic device encryption.
|
- Disable BitLocker automatic device encryption.
|
||||||
- Disable network connectivity during Modern Standby to reduce battery drain. (W11 only)
|
- Disable network connectivity during Modern Standby to reduce battery drain.
|
||||||
|
|
||||||
#### Windows Update
|
#### Windows Update
|
||||||
|
|
||||||
@@ -129,49 +129,50 @@ Below is an overview of the key features and functionality offered by Win11Deblo
|
|||||||
|
|
||||||
#### Start Menu & Search
|
#### Start Menu & Search
|
||||||
|
|
||||||
- Remove or replace all pinned apps from the start menu. (W11 only)
|
- Remove or replace all pinned apps from the start menu.
|
||||||
- Hide the recommended section in the start menu. (W11 only)
|
- Hide the recommended section in the start menu.
|
||||||
- Hide the 'All Apps' section in the start menu. (W11 only)
|
- Hide the 'All Apps' section in the start menu.
|
||||||
- Disable the Phone Link mobile devices integration in the start menu. (W11 only)
|
- Disable the Phone Link mobile devices integration in the start menu.
|
||||||
- Disable Bing web search & Copilot integration in Windows search.
|
- Disable Bing web search & Copilot integration in Windows search.
|
||||||
- Disable Microsoft Store app suggestions in Windows search. (W11 only)
|
- Disable Microsoft Store app suggestions in Windows search.
|
||||||
- Disable Search Highlights (dynamic/branded content) in the taskbar search box. (W11 only)
|
- Disable Search Highlights (dynamic/branded content) in the taskbar search box.
|
||||||
- Disable local Windows search history.
|
- Disable local Windows search history.
|
||||||
|
|
||||||
#### Taskbar
|
#### Taskbar
|
||||||
|
|
||||||
- Align taskbar icons to the left. (W11 only)
|
- Align taskbar icons to the left.
|
||||||
- Hide or change the search icon/box on the taskbar. (W11 only)
|
- Hide or change the search icon/box on the taskbar.
|
||||||
- Hide the taskview button from the taskbar. (W11 only)
|
- Hide the taskview button from the taskbar.
|
||||||
- Disable widgets on the taskbar & lock screen.
|
- Disable widgets on the taskbar & lock screen.
|
||||||
- Hide the chat (meet now) icon from the taskbar. (W10 only)
|
- Hide the chat (meet now) icon from the taskbar.
|
||||||
- Enable the 'End Task' option in the taskbar right click menu. (W11 only)
|
- Enable the 'End Task' option in the taskbar right click menu.
|
||||||
- Enable the 'Last Active Click' behavior in the taskbar app area. This allows you to repeatedly click on an application's icon in the taskbar to switch focus between the open windows of that application.
|
- Enable the 'Last Active Click' behavior in the taskbar app area. This allows you to repeatedly click on an application's icon in the taskbar to switch focus between the open windows of that application.
|
||||||
- Choose how app icons are shown on the taskbar when using multiple monitors. (W11 only)
|
- Choose how app icons are shown on the taskbar when using multiple monitors.
|
||||||
- Choose combine mode for taskbar buttons and labels. (W11 only)
|
- Choose combine mode for taskbar buttons and labels.
|
||||||
|
|
||||||
#### File Explorer
|
#### File Explorer
|
||||||
|
|
||||||
- Change the default location that File Explorer opens to.
|
- Change the default location that File Explorer opens to.
|
||||||
- Show file extensions for known file types.
|
- Show file extensions for known file types.
|
||||||
- Show hidden files, folders and drives.
|
- Show hidden files, folders and drives.
|
||||||
- Hide the Home or Gallery section from the File Explorer navigation pane. (W11 only)
|
- Hide the Home or Gallery section from the File Explorer navigation pane.
|
||||||
- Hide duplicate removable drive entries from the File Explorer navigation pane, so only the entry under 'This PC' remains.
|
- Hide duplicate removable drive entries from the File Explorer navigation pane, so only the entry under 'This PC' remains.
|
||||||
- Add all common folders (Desktop, Downloads, etc.) back to 'This PC' in File Explorer. (W11 only)
|
- Add all common folders (Desktop, Downloads, etc.) back to 'This PC' in File Explorer.
|
||||||
- Hide the 3D objects, music or OneDrive folder from the File Explorer navigation pane. (W10 only)
|
- Hide the 3D objects, music or OneDrive folder from the File Explorer navigation pane.
|
||||||
- Hide the 'Include in library', 'Give access to' and 'Share' options from the context menu. (W10 only)
|
- Hide the 'Include in library', 'Give access to' and 'Share' options from the context menu.
|
||||||
|
- Change drive letter position or visibility in File Explorer.
|
||||||
|
|
||||||
#### Multi-tasking
|
#### Multi-tasking
|
||||||
|
|
||||||
- Disable window snapping. (W11 only)
|
- Disable window snapping.
|
||||||
- Disable Snap Assist suggestions when snapping a window. (W11 only)
|
- Disable Snap Assist suggestions when snapping a window.
|
||||||
- Disable Snap Layout suggestions when dragging windows to the top of screen and when hovering on the maximize button. (W11 only)
|
- Disable Snap Layout suggestions when dragging windows to the top of screen and when hovering on the maximize button.
|
||||||
- Change if tabs are shown when snapping or pressing Alt+Tab. (W11 only)
|
- Change if tabs are shown when snapping or pressing Alt+Tab.
|
||||||
|
|
||||||
#### Optional Windows Features
|
#### Optional Windows Features
|
||||||
|
|
||||||
- Enable Windows Sandbox, a lightweight desktop environment for safely running applications in isolation. (W11 only)
|
- Enable Windows Sandbox, a lightweight desktop environment for safely running applications in isolation.
|
||||||
- Enable Windows Subsystem for Linux which allows you to run a Linux environment directly on Windows. (W11 only)
|
- Enable Windows Subsystem for Linux which allows you to run a Linux environment directly on Windows.
|
||||||
|
|
||||||
#### Other
|
#### Other
|
||||||
|
|
||||||
|
|||||||
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
BIN
Regfiles/Hide_Drive_Letters.reg
Normal file
BIN
Regfiles/Hide_Drive_Letters.reg
Normal file
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
BIN
Regfiles/Show_Drive_Letters_First.reg
Normal file
BIN
Regfiles/Show_Drive_Letters_First.reg
Normal file
Binary file not shown.
BIN
Regfiles/Show_Drive_Letters_Last.reg
Normal file
BIN
Regfiles/Show_Drive_Letters_Last.reg
Normal file
Binary file not shown.
Binary file not shown.
Binary file not shown.
BIN
Regfiles/Show_Network_Drive_Letters_First.reg
Normal file
BIN
Regfiles/Show_Network_Drive_Letters_First.reg
Normal file
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
7
Regfiles/Start_AllApps_Category.reg
Normal file
7
Regfiles/Start_AllApps_Category.reg
Normal file
@@ -0,0 +1,7 @@
|
|||||||
|
Windows Registry Editor Version 5.00
|
||||||
|
|
||||||
|
[HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Start]
|
||||||
|
"AllAppsViewMode"=dword:00000000
|
||||||
|
|
||||||
|
[HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Policies\Explorer]
|
||||||
|
"NoStartMenuMorePrograms"=-
|
||||||
7
Regfiles/Start_AllApps_Grid.reg
Normal file
7
Regfiles/Start_AllApps_Grid.reg
Normal file
@@ -0,0 +1,7 @@
|
|||||||
|
Windows Registry Editor Version 5.00
|
||||||
|
|
||||||
|
[HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Start]
|
||||||
|
"AllAppsViewMode"=dword:00000001
|
||||||
|
|
||||||
|
[HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Policies\Explorer]
|
||||||
|
"NoStartMenuMorePrograms"=-
|
||||||
7
Regfiles/Start_AllApps_List.reg
Normal file
7
Regfiles/Start_AllApps_List.reg
Normal file
@@ -0,0 +1,7 @@
|
|||||||
|
Windows Registry Editor Version 5.00
|
||||||
|
|
||||||
|
[HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Start]
|
||||||
|
"AllAppsViewMode"=dword:00000002
|
||||||
|
|
||||||
|
[HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Policies\Explorer]
|
||||||
|
"NoStartMenuMorePrograms"=-
|
||||||
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user