Compare commits

...

13 Commits

Author SHA1 Message Date
ChrisTitusTech 1fc2aa3743 Update sponsors in README 2026-05-29 16:42:58 +00:00
Chris Titus 893dca4055 chore: Update generated dev docs (#4579) 2026-05-28 13:14:28 -05:00
Gabi 2ebc9bd6c4 fix WPFTweaksWindowsAI (#4578) 2026-05-28 13:13:54 -05:00
Gabi 076ef02b2c Rework contributing.md (#4567)
* Delete docs/assets/images/Complie.png

* Delete docs/assets/images/Commit-GHD.png

* Delete docs/assets/images/Discard-GHD.png

* Delete docs/assets/images/Push-Commit.png

* Delete docs/assets/images/Fork-Button-Dark.png

* Delete docs/assets/images/Fork-Button-Light.png

* Update CONTRIBUTING.md

* Update CONTRIBUTING.md

* Update CONTRIBUTING.md

* Update CONTRIBUTING.md

* Update CONTRIBUTING.md

* Update CONTRIBUTING.md
2026-05-28 12:32:27 -05:00
Gabi c99114e9e1 Added -Preset for automation (#4539)
* Update start.ps1

* Update main.ps1

* Update start.ps1

* Update start.ps1

* Update main.ps1

* Update main.ps1

* Update _index.md

* Update _index.md

* Update _index.md

* Update README.md

* Update main.ps1

* Update start.ps1

* Update main.ps1

* Update main.ps1

* Update start.ps1

* Update main.ps1

* Update main.ps1

* Update main.ps1

* Update main.ps1
2026-05-26 15:22:28 -05:00
Gabi 9b72c1e2de Added advanced preset to tweaks (#4538)
* Update preset.json

* Update Invoke-WPFButton.ps1

* Update inputXML.xaml
2026-05-26 15:21:12 -05:00
Chris Titus b379574574 chore: Update generated dev docs (#4558) 2026-05-26 15:17:54 -05:00
Sean (ANGRYxScotsman) 565597a906 Update documentation and images across multiple pages (#4549)
* Update CONTRIBUTING.md

* updated the apps page and pics

* updated tweaks tab pic

* updated features page with pic

* updated update page with pic

* update win 11 page with pic

* update pics for app page

* deleted old pics

* fix favicon from not showing

* added forums link in help

* Update hugo.toml

* updated title screen pic and added it to the main screen

* Update _index.md

* added the recommended section to the user guild tweeks

* Update _index.md

* added the new advance preset

* clean up pages

* fix links

* fixed wikipedia link

* Update _index.md
2026-05-26 15:17:26 -05:00
Gabi 62ccf80856 Cleanup gitignore (#4526)
* Clean Up .gitignore

* Update .gitignore

* Clean Up .gitignore

* Update .gitignore

* Update .gitignore

* Update .gitignore
2026-05-26 15:14:35 -05:00
Gabi 70cdacb9f9 replaced some choco "na" packages with there package name in applications.json (#4523) 2026-05-26 15:08:58 -05:00
Gabi 459d0fd1b2 Fixed Get-WinUtilToggleStatus.ps1 displaying incorrect infromation for tweaks (#4522)
* Fixed Get-WinUtilToggleStatus.ps1 displaying incorrect infromation of tweaks

* Update Get-WinUtilToggleStatus.ps1

* Update Get-WinUtilToggleStatus.ps1

* Update Get-WinUtilToggleStatus.ps1

* Update Get-WinUtilToggleStatus.ps1
2026-05-26 15:05:25 -05:00
Chris Titus 48e94f71bc chore: Update generated dev docs (#4555) 2026-05-26 15:01:09 -05:00
Gabi 2582f094ff Powerplan fix (#4521)
* Update Invoke-WPFUltimatePerformance.ps1

* Update Invoke-WPFButton.ps1

* Update Invoke-WPFUltimatePerformance.ps1

* Update KnownIssues.md

* Update KnownIssues.md

* Update Invoke-WPFUltimatePerformance.ps1

* Update Invoke-WPFUltimatePerformance.ps1

* Update Invoke-WPFUltimatePerformance.ps1

* Update tweaks.json
2026-05-26 15:00:33 -05:00
107 changed files with 510 additions and 471 deletions
+117 -87
View File
@@ -1,119 +1,149 @@
# How to Contribute?
## Contributing Code
## Testing
### Before You Start
* Test the latest changes to WinUtil by running the pre-release and reporting issues you are encountering to help us continually improve WinUtil!
- Keep each pull request focused on a single feature or fix.
- Avoid unnecessary formatting changes or large unrelated edits.
- Document what changed and why in your PR description.
#### **Run the latest pre-release**
```ps1
irm https://christitus.com/windev | iex
```
---
!!! bug "Keep in mind"
## Basic Git Workflow
This is a pre-release and should be treated as such. It exists for developers to test the utility and report or fix bugs before they get added to the stable release. Don't use it in production!
### 1. Fork the Repository
## Issues
Go to the ChrisTitusTech/winutil repository on GitHub and click the Fork button in the top right corner.
* If you encounter any challenges or problems with the script, I kindly request that you submit them via the "Issues" tab on the GitHub repository. By filling out the provided template, you can provide specific details about the issue, allowing me (and others in the community) to promptly address any bugs or consider feature requests.
<img width="171" height="50" alt="{650A4723-F38A-44A4-9820-D232BC87C8A0}" src="https://github.com/user-attachments/assets/a214f27c-2fee-444a-920f-d87b14f5896f" />
## Contribute Code
---
* Pull requests are now handled directly on the **MAIN branch**. This was done since we can now select specific releases to launch via releases in GitHub.
### 2. Clone Your Fork
* If you're doing code changes, then you can submit a PR to the `main` branch.
!!! warning "Important"
Do not use a code formatter, make massive amounts of line changes, or make multiple feature changes. EACH FEATURE CHANGE SHOULD BE IT'S OWN PULL REQUEST!
Do not open a pull request that adds support for other languages to WinUtil for now, until we decide how we want to move forward with language support.
* When creating pull requests, it is essential to thoroughly document all changes made. This includes, but is not limited to, documenting any additions made to the `tweaks` section and corresponding `undo tweak`, so users are able to remove the newly added tweaks if necessary, and comprehensive documentation is required for all code changes. Document your changes and briefly explain why you made your changes in your Pull Request Description. Failure to adhere to this format may result in the denial of the pull request. Additionally, any code lacking sufficient documentation may also be denied.
* By following these guidelines, we can maintain a high standard of quality and ensure that the codebase remains organized and well-documented.
!!! note
When creating a function, please include "WPF" or "WinUtil" in the file name so it can be loaded into the runspace.
## Walk through
* This is a guide for beginners. If you are still having issues, look at the following official GitHub documentation:
* [Commit through WEB](https://docs.github.com/en/pull-requests/committing-changes-to-your-project/creating-and-editing-commits/about-commits)
* [Commit through GitHub Desktop](https://docs.github.com/en/desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project-in-github-desktop#about-commits)
* [Create a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request)
### Overview
``` mermaid
%%{init: {"flowchart": {"curve": "cardinal"}} }%%
graph TD
  A[Fork Project] --> B[Clone Repository];
  B --> C[Create New Branch];
  C --> D[Make Changes];
  D --> G[Test Changes];
  G --> H{Tests Passed?};
  H -->|Yes| E[Commit Changes];
  H -->|No| J[Fix Issues];
  J --> G;
  E --> F[Push Branch];
  F --> K[Create Pull Request];
  K --> L[Fill out PR template];
classDef default stroke:#333,stroke-width:4px,font-size:12pt;
```powershell
git clone https://github.com/YOUR_USERNAME/winutil.git
cd winutil
```
!!! info
This is a diagram to guide you through the process. It may vary depending on the type of change you're making.
---
### Fork the Repo
* Fork the WinUtil Repository [here](https://github.com/ChrisTitusTech/winutil) to create a copy that will be available in your repository list.
### 3. Create a Branch
![Fork Image](/docs/assets/images/Fork-Button-Dark.png#gh-dark-mode-only)
Never work directly on `main`.
![Fork Image](/docs/assets/images/Fork-Button-Light.png#only-light#gh-light-mode-only)
Create a branch related to your change:
### Clone the Fork
!!! tip
```powershell
git checkout -b feature-name
```
While you can make your changes directly through the Web, we recommend cloning the repo to your device using the application GitHub Desktop (available in WinUtil) to test your fork easily.
Example:
* Install GitHub Desktop if it is not already installed.
* Log in using the same GitHub account you used to fork WinUtil.
* Choose the fork under "Your Repositories" and press "clone {repo name}"
* Create a new branch and name it something relatable to your changes.
```powershell
git checkout -b add-firefox-tweak
```
* Now you can modify WinUtil to your liking using your preferred text editor.
---
### 4. Edit the Code
### Testing your changes
Open the project in your preferred text editor and make your changes.
* To test to see if your changes work as intended, run the following commands in a PowerShell terminal as admin:
Keep changes small and focused.
* Change the directory where you are running the commands to the forked project.
* `cd {path to the folder with the compile.ps1}`
* Run the following command to compile and run WinUtil:
* `.\Compile.ps1 -run`
---
![Compile](/docs/assets/images/Complie.png)
### 5. Test Your Changes
* After seeing that your changes work properly, feel free to commit the changes to the repository and make a PR. For help on that, follow the documentation below.
Open Pwsh (Not Powershell) as Administrator.
### Committing the changes
* Before committing your changes, please discard changes made to the `winutil.ps1` file, like the following:
Go to the project folder:
![Push Commit Image](/docs/assets/images/Discard-GHD.png)
```powershell
cd path\to\winutil
```
* Now, commit your changes once you are happy with the result.
Run:
![Commit Image](/docs/assets/images/Commit-GHD.png)
```powershell
.\Compile.ps1 -Run
```
* Push the changes to upload them to your fork on github.com.
Verify:
![Push Commit Image](/docs/assets/images/Push-Commit.png)
- WinUtil launches correctly
- Your feature works
- Nothing else breaks
### Making a PR
* To make a PR on your repo under a new branch linking to the main branch, a button will show and say Preview and Create pull request. Click that button and fill in all the information that is provided on the template. Once all the information is filled in correctly, check your PR to make sure there is no WinUtil.ps1 file attached to the PR. Once everything is good, make the PR and wait for Chris (the maintainer) to accept or deny your PR. Once it is accepted by Chris, you will be able to see your changes in the "/windev" build.
* If you do not see your feature in the main "/win" build, that is fine. All new changes go into the /windev build to make sure everything is working OK before going fully public.
* Congratulations! You just submitted your first PR. Thank you so much for contributing to WinUtil.
If something fails, fix it before committing.
---
### 6. Review Your Changes
Check what changed:
```powershell
git status
```
Review the diff:
```powershell
git diff
```
Make sure you did not accidentally modify unrelated files.
---
### 7. Commit Your Changes
Stage files:
```powershell
git add .
```
Commit them:
```powershell
git commit -m "Add feature description"
```
Example:
```powershell
git commit -m "Add Firefox package tweak"
```
---
### 8. Push Your Branch
```powershell
git push origin branch-name
```
Example:
```powershell
git push origin add-firefox-tweak
```
---
### 9. Open a Pull Request
Go to your fork on GitHub.
GitHub will show a button to create a pull request.
<img width="1009" height="71" alt="{C8C6A3CC-79D4-44FD-A54C-4C5717F12730}" src="https://github.com/user-attachments/assets/0419d193-d4e7-47c0-87cf-b986742201a0" />
Before submitting:
- Explain what changed
- Explain why you changed it
- Make sure unrelated files are not included
Once submitted, maintainers will review your PR.
+9 -34
View File
@@ -1,20 +1,15 @@
### VSCode ###
# Libraries
System.Management.Automation.dll
Microsoft.PowerShell.ConsoleHost.dll
# Configuration folder
.vscode/
.idea/
### Visual Studio ###
# Visual Studio user-specific files
.vs/
winutil.pdb
### Windows ###
# Folder config file
[Dd]esktop.ini
# OS Specific
desktop.ini
.DS_Store
# Ignore Generated XAML Files
xaml/inputApp.xaml
@@ -22,33 +17,13 @@ xaml/inputFeatures.xaml
xaml/inputTweaks.xaml
# Executables and Configs
winget.msixbundle
pester.ps1
*.psd*
ooshutup10.cfg
winutil.exe.config
Microsoft.UI.Xaml*
license1.xml
winutil.ps1
*.psd*
# Libraries
System.Management.Automation.dll
Microsoft.PowerShell.ConsoleHost.dll
# Compressed files
*.zip
### MacOS ###
# General
.DS_Store
True
test.ps1
winutil.ps1
# temporary excludes for docs
.github/site/
# winutil-bin
winutil.exe.config
binary/
# Hugo Files
+18 -1
View File
@@ -35,6 +35,23 @@ irm "https://christitus.com/win" | iex
irm "https://christitus.com/windev" | iex
```
### Automation
Winutil also supports predefined presets that apply common configurations automatically:
- `Standard`
- `Minimal`
- `Advanced`
Example:
```powershell
& ([ScriptBlock]::Create((irm "https://christitus.com/win"))) -Preset Standard
```
To view exactly what each preset does, see:
https://github.com/ChrisTitusTech/winutil/blob/main/config/preset.json
If you have Issues, refer to [Known Issues](https://winutil.christitus.com/knownissues/) or [Create Issue](https://github.com/ChrisTitusTech/winutil/issues)
## 🎓 Documentation
@@ -76,7 +93,7 @@ You'll see a new file named `winutil.ps1`, which was created by `Compile.ps1` sc
These are the sponsors that help keep this project alive with monthly contributions.
<!-- sponsors --><a href="https://github.com/dwelfusius"><img src="https:&#x2F;&#x2F;github.com&#x2F;dwelfusius.png" width="60px" alt="User avatar: " /></a><a href="https://github.com/mews-se"><img src="https:&#x2F;&#x2F;github.com&#x2F;mews-se.png" width="60px" alt="User avatar: Martin Stockzell" /></a><a href="https://github.com/jdiegmueller"><img src="https:&#x2F;&#x2F;github.com&#x2F;jdiegmueller.png" width="60px" alt="User avatar: Jason A. Diegmueller" /></a><a href="https://github.com/robertsandrock"><img src="https:&#x2F;&#x2F;github.com&#x2F;robertsandrock.png" width="60px" alt="User avatar: RMS" /></a><a href="https://github.com/paulsheets"><img src="https:&#x2F;&#x2F;github.com&#x2F;paulsheets.png" width="60px" alt="User avatar: Paul" /></a><a href="https://github.com/djones369"><img src="https:&#x2F;&#x2F;github.com&#x2F;djones369.png" width="60px" alt="User avatar: Dave J (WhamGeek)" /></a><a href="https://github.com/anthonymendez"><img src="https:&#x2F;&#x2F;github.com&#x2F;anthonymendez.png" width="60px" alt="User avatar: Anthony Mendez" /></a><a href="https://github.com/FatBastard0"><img src="https:&#x2F;&#x2F;github.com&#x2F;FatBastard0.png" width="60px" alt="User avatar: " /></a><a href="https://github.com/DursleyGuy"><img src="https:&#x2F;&#x2F;github.com&#x2F;DursleyGuy.png" width="60px" alt="User avatar: DursleyGuy" /></a><a href="https://github.com/DwayneTheRockLobster1"><img src="https:&#x2F;&#x2F;github.com&#x2F;DwayneTheRockLobster1.png" width="60px" alt="User avatar: " /></a><a href="https://github.com/KieraKujisawa"><img src="https:&#x2F;&#x2F;github.com&#x2F;KieraKujisawa.png" width="60px" alt="User avatar: Kiera Meredith" /></a><a href="https://github.com/andrewpayne68"><img src="https:&#x2F;&#x2F;github.com&#x2F;andrewpayne68.png" width="60px" alt="User avatar: Andrew P" /></a><!-- sponsors -->
<!-- sponsors --><a href="https://github.com/dwelfusius"><img src="https:&#x2F;&#x2F;github.com&#x2F;dwelfusius.png" width="60px" alt="User avatar: " /></a><a href="https://github.com/mews-se"><img src="https:&#x2F;&#x2F;github.com&#x2F;mews-se.png" width="60px" alt="User avatar: Martin Stockzell" /></a><a href="https://github.com/jdiegmueller"><img src="https:&#x2F;&#x2F;github.com&#x2F;jdiegmueller.png" width="60px" alt="User avatar: Jason A. Diegmueller" /></a><a href="https://github.com/robertsandrock"><img src="https:&#x2F;&#x2F;github.com&#x2F;robertsandrock.png" width="60px" alt="User avatar: RMS" /></a><a href="https://github.com/paulsheets"><img src="https:&#x2F;&#x2F;github.com&#x2F;paulsheets.png" width="60px" alt="User avatar: Paul" /></a><a href="https://github.com/djones369"><img src="https:&#x2F;&#x2F;github.com&#x2F;djones369.png" width="60px" alt="User avatar: Dave J (WhamGeek)" /></a><a href="https://github.com/anthonymendez"><img src="https:&#x2F;&#x2F;github.com&#x2F;anthonymendez.png" width="60px" alt="User avatar: Anthony Mendez" /></a><a href="https://github.com/FatBastard0"><img src="https:&#x2F;&#x2F;github.com&#x2F;FatBastard0.png" width="60px" alt="User avatar: " /></a><a href="https://github.com/DursleyGuy"><img src="https:&#x2F;&#x2F;github.com&#x2F;DursleyGuy.png" width="60px" alt="User avatar: DursleyGuy" /></a><a href="https://github.com/DwayneTheRockLobster1"><img src="https:&#x2F;&#x2F;github.com&#x2F;DwayneTheRockLobster1.png" width="60px" alt="User avatar: " /></a><a href="https://github.com/KieraKujisawa"><img src="https:&#x2F;&#x2F;github.com&#x2F;KieraKujisawa.png" width="60px" alt="User avatar: Kiera Meredith" /></a><a href="https://github.com/andrewpayne68"><img src="https:&#x2F;&#x2F;github.com&#x2F;andrewpayne68.png" width="60px" alt="User avatar: Andrew P" /></a><a href="https://github.com/ameaninglessname"><img src="https:&#x2F;&#x2F;github.com&#x2F;ameaninglessname.png" width="60px" alt="User avatar: CodingBot" /></a><!-- sponsors -->
## 🏅 Thanks to all Contributors
Thanks a lot for spending your time helping Winutil grow. Thanks a lot! Keep rocking 🍻.
+5 -5
View File
@@ -505,7 +505,7 @@
},
"heroiclauncher": {
"category": "Games",
"choco": "na",
"choco": "heroic-games-launcher",
"content": "Heroic Games Launcher",
"description": "Heroic Games Launcher is an open-source alternative game launcher for Epic Games Store.",
"link": "https://heroicgameslauncher.com/",
@@ -702,7 +702,7 @@
},
"modrinth": {
"category": "Games",
"choco": "na",
"choco": "modrinth-app",
"content": "Modrinth App",
"description": "Modrinth App is a desktop application for managing Minecraft mods and modpacks.",
"link": "https://modrinth.com/app",
@@ -945,7 +945,7 @@
},
"processexplorer": {
"category": "Microsoft Tools",
"choco": "na",
"choco": "procexp",
"content": "Process Explorer",
"description": "Process Explorer is a task manager and system monitor.",
"link": "https://learn.microsoft.com/sysinternals/downloads/process-explorer",
@@ -1413,7 +1413,7 @@
},
"vc2015_32": {
"category": "Microsoft Tools",
"choco": "na",
"choco": "vcredist2015",
"content": "Visual C++ 2015-2022 32-bit",
"description": "Visual C++ 2015-2022 32-bit redistributable package installs runtime components of Visual C++ libraries required to run 32-bit applications.",
"link": "https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads",
@@ -1422,7 +1422,7 @@
},
"vc2015_64": {
"category": "Microsoft Tools",
"choco": "na",
"choco": "vcredist2015",
"content": "Visual C++ 2015-2022 64-bit",
"description": "Visual C++ 2015-2022 64-bit redistributable package installs runtime components of Visual C++ libraries required to run 64-bit applications.",
"link": "https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads",
+20
View File
@@ -21,5 +21,25 @@
"WPFTweaksWPBT",
"WPFTweaksServices",
"WPFTweaksTelemetry"
],
"Advanced": [
"WPFTweaksActivity",
"WPFTweaksConsumerFeatures",
"WPFTweaksDisableExplorerAutoDiscovery",
"WPFTweaksWPBT",
"WPFTweaksDVR",
"WPFTweaksDeBloat",
"WPFTweaksLocation",
"WPFTweaksServices",
"WPFTweaksTelemetry",
"WPFTweaksDeleteTempFiles",
"WPFTweaksEndTaskOnTaskbar",
"WPFTweaksDisableStoreSearch",
"WPFTweaksRevertStartMenu",
"WPFTweaksWidget",
"WPFTweaksRemoveOneDrive",
"WPFTweaksWindowsAI",
"WPFTweaksRightClickMenu",
"WPFTweaksPowershell7Tele"
]
}
+5 -5
View File
@@ -947,7 +947,7 @@
{
"Path": "HKLM:\\SOFTWARE\\Policies\\WindowsNotepad",
"Name": "DisableAIFeatures",
"Value": 1,
"Value": "1",
"Type": "DWord",
"OriginalValue": "<RemoveEntry>"
}
@@ -1823,19 +1823,19 @@
},
"WPFAddUltPerf": {
"Content": "Ultimate Performance Profile - Enable",
"category": "Performance Plans",
"category": "Performance Plans - NOT FOR LAPTOPS",
"panel": "2",
"Type": "Button",
"ButtonWidth": "300",
"link": "https://winutil.christitus.com/dev/tweaks/performance-plans/addultperf"
"link": "https://winutil.christitus.com/dev/tweaks/performance-plans---not-for-laptops/addultperf"
},
"WPFRemoveUltPerf": {
"Content": "Ultimate Performance Profile - Disable",
"category": "Performance Plans",
"category": "Performance Plans - NOT FOR LAPTOPS",
"panel": "2",
"Type": "Button",
"ButtonWidth": "300",
"link": "https://winutil.christitus.com/dev/tweaks/performance-plans/removeultperf"
"link": "https://winutil.christitus.com/dev/tweaks/performance-plans---not-for-laptops/removeultperf"
},
"WPFTweaksDisableExplorerAutoDiscovery": {
"Content": "File Explorer Automatic Folder Discovery - Disable",
Binary file not shown.

Before

Width:  |  Height:  |  Size: 9.6 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 194 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 12 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 12 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 6.8 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 14 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 22 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 164 KiB

After

Width:  |  Height:  |  Size: 139 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 92 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 139 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 228 KiB

After

Width:  |  Height:  |  Size: 139 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 139 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 139 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 77 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 14 MiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 4.2 MiB

After

Width:  |  Height:  |  Size: 173 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 67 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 9.6 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 196 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 198 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 20 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 20 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 12 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 14 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 170 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 170 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 149 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 55 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 7.8 KiB

+119 -81
View File
@@ -2,114 +2,152 @@
toc: true
---
# How to Contribute?
## Contributing Code
## Testing
### Before You Start
* Test the latest changes to Winutil by running the pre-release and reporting issues you are encountering to help us continually improve Winutil!
- Keep each pull request focused on a single feature or fix.
- Avoid unnecessary formatting changes or large unrelated edits.
- Document what changed and why in your PR description.
#### **Run the latest pre-release**
```
irm https://christitus.com/windev | iex
```
---
> [!WARNING]
> This is a pre-release and should be treated as such. It exists for developers to test the utility and report or fix bugs before they get added to the stable release. Don't use it in production!
## Basic Git Workflow
## Issues
### 1. Fork the Repository
* If you encounter any challenges or problems with the script, I kindly request that you submit them via the "Issues" tab on the GitHub repository. By filling out the provided template, you can provide specific details about the issue, allowing me (and others in the community) to promptly address any bugs or consider feature requests.
Go to the ChrisTitusTech/winutil repository on GitHub and click the Fork button in the top right corner.
## Contribute Code
<img width="171" height="50" alt="{650A4723-F38A-44A4-9820-D232BC87C8A0}" src="https://github.com/user-attachments/assets/a214f27c-2fee-444a-920f-d87b14f5896f" />
* Pull requests are now handled directly on the **MAIN branch**. This was done since we can now select specific releases to launch via releases in GitHub.
---
* If you're doing code changes, then you can submit a PR to the `main` branch, but I am very selective about these.
### 2. Clone Your Fork
> [!IMPORTANT]
> Do not use a code formatter, make massive amounts of line changes, or make multiple feature changes. EACH FEATURE CHANGE SHOULD BE IT'S OWN PULL REQUEST!
* When creating pull requests, it is essential to thoroughly document all changes made. This includes, but is not limited to, documenting any additions made to the `tweaks` section and corresponding `undo tweak`, so users are able to remove the newly added tweaks if necessary, and comprehensive documentation is required for all code changes. Document your changes and briefly explain why you made your changes in your Pull Request Description. Failure to adhere to this format may result in the denial of the pull request. Additionally, any code lacking sufficient documentation may also be denied.
* By following these guidelines, we can maintain a high standard of quality and ensure that the codebase remains organized and well-documented.
> [!NOTE]
> When creating a function, please include "WPF" or "Winutil" in the file name so it can be loaded into the runspace.
## Walk through
* This is a guide for beginners. If you are still having issues, look at the following official GitHub documentation:
* [Commit through WEB](https://docs.github.com/en/pull-requests/committing-changes-to-your-project/creating-and-editing-commits/about-commits)
* [Commit through GitHub Desktop](https://docs.github.com/en/desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project-in-github-desktop#about-commits)
* [Create a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request)
### Overview
``` mermaid
%%{init: {"flowchart": {"curve": "cardinal"}} }%%
graph TD
  A[Fork Project] --> B[Clone Repository];
  B --> C[Create New Branch];
  C --> D[Make Changes];
  D --> G[Test Changes];
  G --> H{Tests Passed?};
  H -->|Yes| E[Commit Changes];
  H -->|No| J[Fix Issues];
  J --> G;
  E --> F[Push Branch];
  F --> K[Create Pull Request];
  K --> L[Fill out PR template];
classDef default stroke:#333,stroke-width:4px,font-size:12pt;
```bash
git clone https://github.com/YOUR_USERNAME/winutil.git
cd winutil
```
> [!NOTE]
> This is a diagram to guide you through the process. It may vary depending on the type of change you're making.
### Fork the Repo
* Fork the Winutil Repository [here](https://github.com/ChrisTitusTech/Winutil) to create a copy that will be available in your repository list.
---
{{< image src="images/Fork-Button" alt="Fork Image" >}}
### 3. Create a Branch
### Clone the Fork
Never work directly on `main`.
> [!TIP]
> While you can make your changes directly through the Web, we recommend cloning the repo to your device using the application GitHub Desktop (available in Winutil) to test your fork easily.
Create a branch related to your change:
* Install GitHub Desktop if it is not already installed.
* Log in using the same GitHub account you used to fork Winutil.
* Choose the fork under "Your Repositories" and press "clone {repo name}"
* Create a new branch and name it something relatable to your changes.
```bash
git checkout -b feature-name
```
* Now you can modify Winutil to your liking using your preferred text editor.
Example:
```bash
git checkout -b add-firefox-tweak
```
### Testing your changes
---
* To test to see if your changes work as intended, run the following commands in a PowerShell terminal as admin:
### 4. Edit the Code
* Change the directory where you are running the commands to the forked project.
* `cd {path to the folder with the compile.ps1}`
* Run the following command to compile and run Winutil:
* `.\Compile.ps1 -run`
Open the project in your preferred text editor and make your changes.
{{< image src="images/Compile" alt="Compile" >}}
Keep changes small and focused.
* After seeing that your changes work properly, feel free to commit the changes to the repository and make a PR. For help on that, follow the documentation below.
---
### Committing the changes
* Before committing your changes, please discard changes made to the `Winutil.ps1` file, like the following:
### 5. Test Your Changes
{{< image src="images/Discard-GHD" alt="Push Commit Image" >}}
Open PowerShell as Administrator.
* Now, commit your changes once you are happy with the result.
Go to the project folder:
{{< image src="images/Commit-GHD" alt="Commit Image" >}}
```powershell
cd path\to\winutil
```
* Push the changes to upload them to your fork on github.com.
Run:
{{< image src="images/Push-Commit" alt="Push Commit Image" >}}
```powershell
.\Compile.ps1 -Run
```
### Making a PR
* To make a PR on your repo under a new branch linking to the main branch, a button will show and say Preview and Create pull request. Click that button and fill in all the information that is provided on the template. Once all the information is filled in correctly, check your PR to make sure there is no Winutil.ps1 file attached to the PR. Once everything is good, make the PR and wait for Chris (the maintainer) to accept or deny your PR. Once it is accepted by Chris, you will be able to see your changes in the "/windev" build.
* If you do not see your feature in the main "/win" build, that is fine. All new changes go into the /windev build to make sure everything is working OK before going fully public.
* Congratulations! You just submitted your first PR. Thank you so much for contributing to Winutil.
Verify:
- WinUtil launches correctly
- Your feature works
- Nothing else breaks
If something fails, fix it before committing.
---
### 6. Review Your Changes
Check what changed:
```bash
git status
```
Review the diff:
```bash
git diff
```
Make sure you did not accidentally modify unrelated files.
---
### 7. Commit Your Changes
Stage files:
```bash
git add .
```
Commit them:
```bash
git commit -m "Add feature description"
```
Example:
```bash
git commit -m "Add Firefox package tweak"
```
---
### 8. Push Your Branch
```bash
git push origin branch-name
```
Example:
```bash
git push origin add-firefox-tweak
```
---
### 9. Open a Pull Request
Go to your fork on GitHub.
GitHub will show a button to create a pull request.
<img width="1009" height="71" alt="{C8C6A3CC-79D4-44FD-A54C-4C5717F12730}" src="https://github.com/user-attachments/assets/0419d193-d4e7-47c0-87cf-b986742201a0" />
Before submitting:
- Explain what changed
- Explain why you changed it
- Make sure unrelated files are not included
Once submitted, maintainers will review your PR.
+6
View File
@@ -27,3 +27,9 @@ If you run WinUtil and get the error:
`"WinUtil is unable to run on your system, powershell execution is restricted by security policies,"`
this means that your PowerShell session is in **Constrained Language Mode**, which prevents WinUtil from running.
### Ultimate Performance Plan Not Working
The Ultimate Performance power plan may not work on some laptops who do not fully support this power plan.
In these cases, the power plan may fail to apply, This is expected behavior on unsupported hardware.
+2
View File
@@ -12,6 +12,8 @@ width: full
Welcome to the official documentation for Winutil, your go-to utility for optimizing and managing your Windows environment. Whether youre an IT professional, power user, or regular user, Winutil provides a comprehensive set of tools to enhance your Windows experience.
{{< image src="images/Title-Screen" alt="Winutil title screen" >}}
## Running the latest release of Winutil
* You will first need to start a PowerShell terminal **as Admin**.
+1 -1
View File
@@ -654,7 +654,7 @@ Outputs `winutil.ps1` in the root directory.
- [Contributing Guide](../../contributing/) - How to contribute code
- [User Guide](../../userguide/) - End-user documentation
- [Win11 Creator Guide](../../userguide/win11Creator/) - Building customized Windows 11 ISOs
- [Win11 Creator Guide](../../userguide/win11creator/) - Building customized Windows 11 ISOs
- [FAQ](../../faq/) - Common questions
## Additional Resources
@@ -26,4 +26,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -26,4 +26,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -50,4 +50,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -34,4 +34,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -26,4 +26,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -34,4 +34,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -36,4 +36,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -26,4 +26,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -26,4 +26,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -26,4 +26,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -42,4 +42,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -34,4 +34,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -50,4 +50,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -34,4 +34,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -26,4 +26,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -8,4 +8,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -36,4 +36,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -26,4 +26,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -52,4 +52,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -26,4 +26,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -26,4 +26,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -36,4 +36,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -26,4 +26,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -26,4 +26,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -38,4 +38,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -24,4 +24,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -24,4 +24,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -37,4 +37,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -45,4 +45,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -35,4 +35,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -127,4 +127,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -24,4 +24,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -1,42 +0,0 @@
---
title: "Ultimate Performance Profile - Enable"
description: ""
---
```powershell {filename="functions/public/Invoke-WPFUltimatePerformance.ps1",linenos=inline,linenostart=1}
function Invoke-WPFUltimatePerformance {
param(
[switch]$Do
)
if ($Do) {
if (-not (powercfg /list | Select-String "ChrisTitus - Ultimate Power Plan")) {
if (-not (powercfg /list | Select-String "8c5e7fda-e8bf-4a96-9a85-a6e23a8c635c")) {
powercfg /restoredefaultschemes
if (-not (powercfg /list | Select-String "8c5e7fda-e8bf-4a96-9a85-a6e23a8c635c")) {
Write-Host "Failed to restore High Performance plan. Default plans do not include high performance. If you are on a laptop, do NOT use High Performance or Ultimate Performance plans." -ForegroundColor Red
return
}
}
$guid = ((powercfg /duplicatescheme 8c5e7fda-e8bf-4a96-9a85-a6e23a8c635c) -split '\s+')[3]
powercfg /changename $guid "ChrisTitus - Ultimate Power Plan"
powercfg /setacvalueindex $guid SUB_PROCESSOR IDLEDISABLE 1
powercfg /setacvalueindex $guid 54533251-82be-4824-96c1-47b60b740d00 4d2b0152-7d5c-498b-88e2-34345392a2c5 1
powercfg /setacvalueindex $guid SUB_PROCESSOR PROCTHROTTLEMIN 100
powercfg /setactive $guid
Write-Host "ChrisTitus - Ultimate Power Plan plan installed and activated." -ForegroundColor Green
} else {
Write-Host "ChrisTitus - Ultimate Power Plan plan is already installed." -ForegroundColor Red
return
}
} else {
if (powercfg /list | Select-String "ChrisTitus - Ultimate Power Plan") {
powercfg /setactive SCHEME_BALANCED
powercfg /delete ((powercfg /list | Select-String "ChrisTitus - Ultimate Power Plan").ToString().Split()[3])
Write-Host "ChrisTitus - Ultimate Power Plan plan was removed." -ForegroundColor Red
} else {
Write-Host "ChrisTitus - Ultimate Power Plan plan is not installed." -ForegroundColor Yellow
}
}
}
```
@@ -1,42 +0,0 @@
---
title: "Ultimate Performance Profile - Disable"
description: ""
---
```powershell {filename="functions/public/Invoke-WPFUltimatePerformance.ps1",linenos=inline,linenostart=1}
function Invoke-WPFUltimatePerformance {
param(
[switch]$Do
)
if ($Do) {
if (-not (powercfg /list | Select-String "ChrisTitus - Ultimate Power Plan")) {
if (-not (powercfg /list | Select-String "8c5e7fda-e8bf-4a96-9a85-a6e23a8c635c")) {
powercfg /restoredefaultschemes
if (-not (powercfg /list | Select-String "8c5e7fda-e8bf-4a96-9a85-a6e23a8c635c")) {
Write-Host "Failed to restore High Performance plan. Default plans do not include high performance. If you are on a laptop, do NOT use High Performance or Ultimate Performance plans." -ForegroundColor Red
return
}
}
$guid = ((powercfg /duplicatescheme 8c5e7fda-e8bf-4a96-9a85-a6e23a8c635c) -split '\s+')[3]
powercfg /changename $guid "ChrisTitus - Ultimate Power Plan"
powercfg /setacvalueindex $guid SUB_PROCESSOR IDLEDISABLE 1
powercfg /setacvalueindex $guid 54533251-82be-4824-96c1-47b60b740d00 4d2b0152-7d5c-498b-88e2-34345392a2c5 1
powercfg /setacvalueindex $guid SUB_PROCESSOR PROCTHROTTLEMIN 100
powercfg /setactive $guid
Write-Host "ChrisTitus - Ultimate Power Plan plan installed and activated." -ForegroundColor Green
} else {
Write-Host "ChrisTitus - Ultimate Power Plan plan is already installed." -ForegroundColor Red
return
}
} else {
if (powercfg /list | Select-String "ChrisTitus - Ultimate Power Plan") {
powercfg /setactive SCHEME_BALANCED
powercfg /delete ((powercfg /list | Select-String "ChrisTitus - Ultimate Power Plan").ToString().Split()[3])
Write-Host "ChrisTitus - Ultimate Power Plan plan was removed." -ForegroundColor Red
} else {
Write-Host "ChrisTitus - Ultimate Power Plan plan is not installed." -ForegroundColor Yellow
}
}
}
```
@@ -101,4 +101,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -24,4 +24,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -24,4 +24,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -30,4 +30,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -31,4 +31,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -31,4 +31,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -107,4 +107,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -136,4 +136,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -24,4 +24,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -49,4 +49,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -31,4 +31,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -24,4 +24,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -30,4 +30,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -24,4 +24,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -20,7 +20,7 @@ description: ""
{
"Path": "HKLM:\\SOFTWARE\\Policies\\WindowsNotepad",
"Name": "DisableAIFeatures",
"Value": 1,
"Value": "1",
"Type": "DWord",
"OriginalValue": "<RemoveEntry>"
}
@@ -48,4 +48,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -31,4 +31,4 @@ description: ""
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://www.wikiwand.com/en/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
+12 -12
View File
@@ -49,19 +49,19 @@ New to Winutil? Follow the guides below in order to get up and running quickly:
## Main Features
### 🚀 Application Installation
### Application Installation
Browse and install hundreds of popular applications with a single click. No more hunting for download links or dealing with installer bloat.
**[Read the Applications Guide →](application/)**
### ⚙️ System Tweaks
### System Tweaks
Apply optimizations for performance, privacy, and usability. Choose from preset configurations or customize individual tweaks.
**[Read the Tweaks Guide →](tweaks/)**
### 🛠️ Config & Fixes
### Config & Fixes
Quick fixes for common Windows problems:
- Reset network settings
@@ -71,7 +71,7 @@ Quick fixes for common Windows problems:
**[Read the Features Guide →](features/)**
### 🔄 Update Management
### Update Management
Take control of Windows Updates with options to:
- Enable/disable updates
@@ -81,7 +81,7 @@ Take control of Windows Updates with options to:
**[Read the Updates Guide →](updates/)**
### 🤖 Automation
### Automation
Automate Winutil configurations for:
- Multiple PC setups
@@ -91,7 +91,7 @@ Automate Winutil configurations for:
**[Read the Automation Guide →](automation/)**
### 💿 Windows 11 Creator
### Windows 11 Creator
Build a custom Windows 11 ISO with bloatware removed, telemetry disabled, and hardware requirement checks bypassed. You can then export it as an ISO file or write it directly to a USB drive.
@@ -126,12 +126,12 @@ Before using Winutil:
Need help?
- **📖 Documentation**: You're reading it! Use the navigation menu
- **FAQ**: Check [Frequently Asked Questions](../faq/)
- **🐛 Known Issues**: Review [Known Issues](../knownissues/)
- **💬 Discord**: Join the [community Discord](https://discord.gg/RUbZUZyByQ)
- **🐙 GitHub**: Report bugs on [GitHub Issues](https://github.com/ChrisTitusTech/winutil/issues)
- **📺 YouTube**: Watch [video tutorials](https://www.youtube.com/watch?v=6UQZ5oQg8XA)
- **Documentation**: You're reading it. Use the navigation menu.
- **FAQ**: Check [Frequently Asked Questions](../faq/)
- **Known Issues**: Review [Known Issues](../knownissues/)
- **Discord**: Join the [community Discord](https://discord.gg/RUbZUZyByQ)
- **GitHub**: Report bugs on [GitHub Issues](https://github.com/ChrisTitusTech/winutil/issues)
- **YouTube**: Watch [video tutorials](https://www.youtube.com/watch?v=6UQZ5oQg8XA)
## Contributing
+22 -6
View File
@@ -5,6 +5,8 @@ prev: /userguide/getting-started/
next: /userguide/tweaks/
---
Use the Applications tab to install, upgrade, uninstall, and review supported apps from one place. Winutil relies on package manager support for these actions, so the available results depend on what WinGet can detect and manage on your system.
{{< tabs >}}
{{< tab name="Installation & Updates" selected=true >}}
@@ -12,30 +14,44 @@ next: /userguide/tweaks/
* For programs not currently installed, this action will install them.
* For programs already installed, this action will update them to the latest version.
* Click the `Install/Upgrade Selected` button to start the installation or upgrade process.
{{< image src="images/Install/Installation" alt="Install or upgrade selected applications" >}}
{{< /tab >}}
{{< tab name="Upgrade All" >}}
* Simply press the `Upgrade All` button.
* This will upgrade all applicable programs that are installed without the need for individual selection.
* This upgrades every supported installed program without individual selection.
{{< image src="images/Install/install-apps" alt="Upgrade all applications" >}}
{{< /tab >}}
{{< tab name="Uninstall" >}}
* Select the programs you wish to uninstall.
* Click the `Uninstall Selected` button to remove the selected programs.
* Click the `Uninstall Selected` button to remove them.
{{< image src="images/Install/uninstall-apps" alt="Uninstall selected applications" >}}
{{< /tab >}}
{{< tab name="Get Installed" >}}
{{< tab name="Show Installed Apps" >}}
* Click the `Show Installed Apps` button.
* This scans for and selects installed applications supported by WinGet.
{{< image src="images/Install/show-installed-apps" alt="Show installed apps" >}}
{{< /tab >}}
{{< tab name="Clear Selection" >}}
* Click the `Clear Selection` button.
* This will unselect all checked programs.
* This clears all current selections.
{{< image src="images/Install/clear-selection-apps" alt="Clear app selections" >}}
{{< /tab >}}
{{< /tabs >}}
{{< image src="images/Install-Tab" alt="Install Image" >}}
> [!TIP]
> If you have trouble finding an application, press `Ctrl + F` and search for its name. The list filters as you type.
> [!NOTE]
> `Show Installed Apps` only selects software that WinGet can identify. Apps installed outside supported package sources may not appear.
> [!IMPORTANT]
> Before uninstalling or upgrading apps, close any running programs first. Some packages may still prompt for input or fail if their source is unavailable.
+17 -2
View File
@@ -2,12 +2,27 @@
title: Automation
weight: 7
prev: /userguide/updates/
next: /userguide/win11Creator/
next: /userguide/win11creator/
---
Use Automation to run Winutil from an exported configuration file.
To create a config file:
Winutil supports predefined presets that apply common configurations automatically:
- `Standard`
- `Minimal`
- `Advanced`
Example:
```powershell
& ([ScriptBlock]::Create((irm "https://christitus.com/win"))) -Preset Standard
```
To view exactly what each preset does, see:
https://github.com/ChrisTitusTech/winutil/blob/main/config/preset.json
To create you're own config file:
1. Open Winutil.
2. Click the gear icon in the top-right corner.
+10
View File
@@ -7,10 +7,16 @@ next: /userguide/updates/
Use the **Features** and **Fixes** sections to install optional Windows components and run common repair tasks.
This page maps to the **Config** tab in Winutil. Some actions complete immediately, while others may prompt, download files from Microsoft, or require a restart before the change is fully available.
{{< image src="images/config-tab-new" alt="Config tab with features and fixes" >}}
## Windows Features
Install common **Windows features** by selecting the feature checkboxes and clicking **Install Features**.
If a feature depends on Windows installation media or optional downloads, Windows may take longer to finish or request a reboot.
* All .NET Frameworks (2, 3, 4)
* Hyper-V Virtualization
* Legacy Media (WMP, DirectPlay)
@@ -25,6 +31,8 @@ Install common **Windows features** by selecting the feature checkboxes and clic
Use these one-click fixes for common system problems.
Use these when you have a specific issue to correct, not as a routine cleanup step.
* Set Up Autologin
* Reset Windows Update
* Reset Network
@@ -46,3 +54,5 @@ Open old-school Windows panels directly from Winutil. Available panels include:
## Remote Access
Enable an OpenSSH server on your Windows machine for remote access.
Only enable this if you intend to use remote shell access. After turning it on, verify your firewall rules and account permissions before exposing the machine to other devices.
@@ -7,7 +7,7 @@ next: /userguide/application/
## Welcome to Winutil!
Winutil is a powerful Windows utility that helps you optimize, customize, and maintain your system. This guide walks you through everything you need to get started.
Winutil helps you install apps, apply system tweaks, run common fixes, and manage Windows settings from one place. This guide covers the safest way to get started and the first actions most users take.
## System Requirements
@@ -72,7 +72,7 @@ irm "https://christitus.com/windev" | iex
The first time you run Winutil, it may take a few moments to:
- Run the latest version
- Download the latest version
- Initialize the interface
- Load all features and settings
@@ -88,7 +88,7 @@ Winutil opens with a clean, tabbed interface:
- **Tweaks**: Apply system optimizations and customizations
- **Config**: Access system tools and utilities
- **Updates**: Manage Windows updates
- **Win11 Creator**: Allows user to debloat Windows 11 ISO files.
- **Win11 Creator**: Build a customized Windows 11 ISO from an official Microsoft image.
## Your First Actions
@@ -116,10 +116,13 @@ This gives you a rollback point if needed.
For a better Windows experience with minimal risk:
1. Go to the **Tweaks** tab
2. Select the **Standard** for a balanced configuration
2. Select the **Standard** preset for a balanced configuration
3. Review the selected tweaks
4. Click **Run Tweaks**
> [!NOTE]
> Some tweaks, fixes, and update changes may require a restart or sign-out before the full effect is visible.
## Common Tasks
### Installing Applications
@@ -188,6 +191,7 @@ Winutil offers several preset configurations:
- **Minimal**: Minimal changes that keep most Windows features
- **Standard**: A good middle ground for most users
- **Advanced**: Selects a focused set of safer advanced tweaks.
## Safety Tips
@@ -211,7 +215,14 @@ Winutil offers several preset configurations:
### Script Won't Download
If you get any errors when running Winutil please refer to [Known Issues](/knownissues/) page
If the launch command fails:
- Make sure PowerShell or Terminal is running as Administrator.
- Confirm the PC has internet access and can reach `christitus.com`.
- Retry from a normal PowerShell session rather than a restricted enterprise shell profile.
- If the command starts and then closes immediately, reopen Terminal as Administrator and run it again so you can read the error output.
If it still fails, check the [Known Issues](/knownissues/) page.
## Next Steps
@@ -243,5 +254,3 @@ If you need assistance:
| Fix network | Config tab | Fixes -> Reset Network |
| Change DNS | Tweaks tab | DNS section |
| Open Control Panel | Config tab | Legacy Windows Panels |
Happy optimizing!
+23 -6
View File
@@ -5,23 +5,40 @@ prev: /userguide/application/
next: /userguide/features/
---
{{< image src="images/Tweaks-Tab" alt="Image of Tweaks Tab" >}}
{{< image src="images/tweaks-tab-new" alt="Image of Tweaks Tab" >}}
Use the Tweaks tab to apply recommended Windows changes, review optional presets, and adjust a few supporting settings such as DNS and power plans. Start with a preset unless you already know which individual tweaks you want.
### Recommended Selections
Use the quick-selection buttons at the top of the Tweaks tab to speed up setup:
* **Standard**: Selects the recommended baseline set of tweaks for most users.
* **Minimal**: Selects a smaller, lower-impact set of common tweaks.
* **Advanced**: Selects a focused set of safer advanced tweaks. This preset intentionally skips restore point creation and cleanup tasks to avoid long runtime.
* **Clear**: Clears all currently selected tweaks.
* **Get Installed Tweaks**: Best-effort detection for tweaks already applied on your system.
### Run Tweaks
* **Open the Tweaks tab**: Navigate to the **Tweaks** tab in the application.
* **Select Tweaks**: Choose the tweaks you want to apply. You can use the presets available at the top for convenience.
* **Run Tweaks**: After selecting the desired tweaks, click **Run Tweaks** at the bottom of the screen.
> [!NOTE]
> To see what each preset includes, view [preset.json](https://github.com/ChrisTitusTech/winutil/blob/main/config/preset.json).
> [!IMPORTANT]
> Some tweaks take effect immediately, while others may require Explorer to restart, a sign-out, or a full reboot.
### Undo Tweaks
* **Open the Tweaks tab**: Go to the **Tweaks** tab located next to **Install**.
* **Select Tweaks to Remove**: Choose the tweaks you want to disable or remove.
* **Undo Tweaks**: Click **Undo Selected Tweaks** at the bottom of the screen to apply the changes.
### Essential Tweaks
Essential Tweaks are modifications and optimizations that are generally safe for most users to implement. These tweaks are designed to enhance system performance, improve privacy, and reduce unnecessary system activities. They are considered low-risk and are recommended for users who want to ensure their system runs smoothly and efficiently without delving too deeply into complex configurations. The goal of Essential Tweaks is to provide noticeable improvements with minimal risk, making them suitable for a wide range of users, including those who may not have advanced technical knowledge.
Essential Tweaks are the safest starting point for most systems. They focus on lower-risk changes that improve usability, reduce noise, and avoid the more invasive changes found in advanced options.
### Advanced Tweaks (CAUTION)
Advanced Tweaks are intended for experienced users who have a solid understanding of their system and the potential implications of making deep-level changes. These tweaks involve more significant alterations to the operating system and can provide substantial customization. However, they also carry a higher risk of causing system instability or unintended side effects if not implemented correctly. Users who choose to apply Advanced Tweaks should proceed with caution, ensuring they have adequate knowledge and backups in place to recover if something goes wrong. These tweaks are not recommended for novice users or those unfamiliar with the inner workings of their operating system.
Advanced Tweaks are for users who understand the side effects of deeper Windows changes. Create a restore point first, review each item, and avoid treating the full advanced list as a one-click baseline.
### O&O ShutUp10++
[O&O ShutUp10++](https://www.oo-software.com/en/shutup10) can be launched from Winutil with one click. It is a free privacy tool for Windows that helps users manage telemetry, update behavior, and app permission settings.
@@ -31,7 +48,7 @@ Advanced Tweaks are intended for experienced users who have a solid understandin
### DNS
The utility provides a convenient DNS selection feature, allowing users to choose between various DNS providers for both IPv4 and IPv6. This enables users to optimize their internet connection for speed, security, and privacy according to their specific needs. Here are the available options:
Use the DNS section to switch both IPv4 and IPv6 DNS providers without editing adapter settings manually. Choose the option that best matches your priority: speed, filtering, or privacy.
* **Default**: Uses the default DNS settings configured by your ISP or network.
* **DHCP**: Automatically acquires DNS settings from the DHCP server.
@@ -46,11 +63,11 @@ The utility provides a convenient DNS selection feature, allowing users to choos
### Customize Preferences
The Customize Preferences section allows users to personalize their Windows experience by toggling visual and functional settings.
Use Customize Preferences for smaller visual and behavior changes that do not fit the main tweak presets.
### Performance Plans
The Performance Plans section allows users to manage the Ultimate Performance Profile for maximum performance.
Use Performance Plans to enable or remove the Ultimate Performance power profile.
#### Add and activate the Ultimate Performance Profile:
* Enables and activates the Ultimate Performance Profile to enhance system performance by minimizing latency and increasing efficiency.
+4
View File
@@ -7,6 +7,10 @@ next: /userguide/automation/
Winutil provides three update modes so you can choose how aggressively Windows Update is managed on your system:
Changing modes adjusts system-wide Windows Update behavior. After switching modes, give Windows a moment to apply the policy and plan for a restart if the new state does not appear immediately.
{{< image src="images/updates-tab-new" alt="Updates tab in Winutil" >}}
- **Default (Out of the Box) Settings**: Restores standard Windows Update behavior
- **Security (Recommended) Settings**: Prioritizes stability while still receiving security updates
- **Disable ALL Updates**: Turns off Windows Update entirely and should only be used with extreme caution
+8 -32
View File
@@ -8,9 +8,14 @@ prev: /userguide/automation/
Winutil includes a built-in **Win11 Creator** tool that lets you take an official Windows 11 ISO and produce a customized, debloated version. The resulting image can remove telemetry, bypass hardware requirement checks, and enable local account setup out of the box. You can export the result as a new ISO file or write it directly to a USB drive.
{{< image src="images/win11creator-tab-new" alt="Win11 Creator tab in Winutil" >}}
> [!IMPORTANT]
> You need an **official Windows 11 ISO** from [Microsoft's website](https://www.microsoft.com/en-us/software-download/windows11) before starting. Custom, modified, or non-official ISOs are not supported. The process uses ~1015 GB of temporary disk space, so make sure you have room.
> [!NOTE]
> This workflow is intended for fresh Windows installs, not in-place upgrades of an existing installation.
---
### Step 1 — Select Your Official Windows 11 ISO
@@ -130,39 +135,10 @@ When you install Windows 11 from your modified ISO:
---
Below is a list of free and open-source tools for downloading, creating, and flashing Windows ISOs.
## Additional Resources
## Download Windows ISOs
| Tool | Description | Website |
|------|-------------|---------|
| **[UUP Dump](https://uupdump.net/)** | Download Windows UUP files directly from Microsoft's servers and convert them into a clean ISO — great for getting the latest builds | [uupdump.net](https://uupdump.net/) |
| **[Microsoft Media Creation Tool](https://www.microsoft.com/en-us/software-download/windows11)** | Microsoft's official tool for downloading and creating Windows 11 installation media | [microsoft.com](https://www.microsoft.com/en-us/software-download/windows11) |
## Customize Windows ISOs
| Tool | Description | Website |
|------|-------------|---------|
| **[MicroWin](https://github.com/CodingWonders/microwin)** | A C# desktop app for building stripped-down, customized Windows ISOs — the original predecessor to Winutil's old MicroWin feature | [github.com](https://github.com/CodingWonders/microwin) |
| **[Tiny11 Builder](https://github.com/ntdevlabs/tiny11builder)** | PowerShell script that strips a Windows 11 ISO down to the bare minimum — removes bloatware and bypasses hardware requirements | [github.com](https://github.com/ntdevlabs/tiny11builder) |
| **[NTLite](https://www.ntlite.com/)** | Remove Windows components, integrate drivers and updates, and build a custom ISO before installation | [ntlite.com](https://www.ntlite.com/) |
## Flash ISOs to USB
| Tool | Description | Website |
|------|-------------|---------|
| **[Rufus](https://rufus.ie/)** | The go-to tool for creating bootable Windows USB drives. Supports bypassing Windows 11 TPM/Secure Boot requirements and downloading ISOs directly | [rufus.ie](https://rufus.ie/) |
| **[Ventoy](https://www.ventoy.net/)** | Install once, then just copy any ISO files onto the USB — supports booting multiple ISOs from a single drive without re-flashing | [ventoy.net](https://www.ventoy.net/) |
| **[balenaEtcher](https://etcher.balena.io/)** | Simple, beginner-friendly ISO flasher with a clean interface | [etcher.balena.io](https://etcher.balena.io/) |
---
> [!TIP]
> Already have a Windows 11 ISO? Skip the third-party tools and use Winutil's built-in **[Win11 Creator](#using-winutils-win11-creator)** at the top of this page.
- Download official Windows 11 media from [Microsoft](https://www.microsoft.com/en-us/software-download/windows11).
- If you prefer to write a finished ISO with another tool, common choices include [Rufus](https://rufus.ie/) or [Ventoy](https://www.ventoy.net/).
> [!NOTE]
> Always download Windows ISOs from official Microsoft sources or trusted tools like Rufus/UUP Dump to avoid tampered images.
+7
View File
@@ -55,6 +55,13 @@ pageRef = "KnownIssues.md"
weight = 2
parent = "help"
[[menu.main]]
identifier = "forums"
name = "Forums"
url = "https://forum.christitus.com/"
weight = 3
parent = "help"
[[menu.main]]
name = "Store"
url = "https://christitus.com/downloads/"
+3
View File
@@ -0,0 +1,3 @@
<svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 32 32">
<image href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAAAXNSR0IArs4c6QAACMVJREFUWEeVVwtQVOcV/u69y0uWBJ9YETaA8vCx+AABLWqMiGLEx/jG2um0sR0F2hibGh9RSaeZTtVUE5tIM2lDodM4HRFQJGmgCKiIxEe0jkAiSEBkwxsWdt3dezvfei/ZoFb7z9zZ3bv3nvOd75zz/ecX8N0SAPCS1E8FgAMAP7Xl+t3l9iNfaUdb/C6qNnlPVi+nLdcHdQDcAXioIOwAbOpFIHyR62kgNJuaYzfVLu3z3gMAFgC0L2sPE6EXgOcBDAfgqTruBdAHYEB90RXIUDCPc0w73gB8AAxTg+gB0KnatWm0EyWdj0fkzkXovCWiMb8ZQAcAE4B2AHzxSUA0NhkIbdGxXg1mNIDR8BgzAlFvTsT51HwA9QDaaE+jibSPAhAmLMjZJgWtTnI0F99UqnadQ8e1OgBNAO67ACGFpJKMaM7pmHbo2BfAGAD+0OkDBeOOGHHyz2cLojvsH4/8JYAvVZt9GgAi9gMwVYjP3Kqb9Eqik19b/wNHQ94NpTrjHHpu16ovtapAmB4CYU3QOanWHI+D6GkQJv8iRpySNlvwCR4pCBCUgbZOe9bo3QCqANwlq0MBGIX441t1k7Yscq1rxdo74Lhz4rpyeX8ZBpq+cmGkW80r80uqx0HUGRD6kyjJuH2O4BvuR8eaLXnA1OHI8tsL4BKABgC9Q1MwSZy5f7M0c98GuLzoZEOBoljb++XanGrl6u8qYGklENYHO2U4IAYiZMMMcdqv48URRn9BFFw7zInB0X7jjvxPYwaAKwC+AWB2LULSFwyPUbHi8rLtkm/E+KEgBoH0t/bItX+tVKozKiD3W2FYES5Of+NFcUyUQRBEFuIjS7FbrPbybVmo/YhFeEsF7yxCTXyYw3EAIuA5coYw/c2FYuimqYLHCC9XGgcVSYFiP/1SAe6VfCulNK4R9QHPPdax7HDILWWNcvWBf+P+uQsAbqr0d5E9DQBRM4+s3GAAEwEEwMt/vDBzT6Q4cWOo6Pac+1BGbLk/LIPpfLcu5e4CQR/IAAaXosiyfL+yRb7y1nU0fVYHyOykrwEwdfeYf4qRKwNsnx/o9foISZJCu7u7CYjd4QX9C+PFmLdnSiHrv5cWW27cJZgq+3Qb62cLPi9QyJxL7qrrdVzccRWNp2sAmfrBbun18/Nrb21tvQagEQALeJAByiSFKDhiypR5qVtTd5WUfP7F6YKCW1arlUqoFwKWGHVLCue6smA7GXcZ3zoBxLoCcNRkNcilPy5W8yxNNRoDVq9eE9Xe1lZz9OiRIwBq1Fa2aAxwD6AEh4WFhSXs2buPvaqYTK1tO3/zeo7NZrMJgS8bdYsLFj0GQL9uY/2s7wGo+0edXLKhkHKbsmlzfEJCwhxJkqQLFy+UvH/svfdUIaKeDCohhWQkgEkTJkxYsm9/xnZSabVaH6Ru2/YXi6W/RzAsm6xLzF/yTAC++qRWLl5/hmqZnv5qUvSs6Km0V1FeVn78+AfHAFwF0OIKgAwQwGQVwK/4gsVisaWlbv2bxWLpEAzJEbrEvKT/E4CSlpa+eFZM7CTaKy87V5GZefx9VQdYiP2uW6YGIGnf/gxXAH+3WCxtgiE5/NkBnKiRi9edpdNtqemJsbGxEUMAfKF2wvdSMIIaEBQUtPhAxm9fEwRBVBk4YbFYWhG4LES3OC9ZEL5TOFtuXBVMleZHivDrT27Ln68nALfUtPRFMTGxoQRwrrS07MMPM/+kpoAMDBYha4BKGOrr67vg4MHDb3h4enrabDbH7l07C1paWhrgHThct+72BsHNi+lyLltuXCVMlb26lIY5gt7AtnVKtuP6Hy4pl16n6Pjs2rN3aUR4BAUOnxYVnc3OzvqzWoTcXQcBcAxjGwYBiD106J09Y/z8uDsqOdnZl4uKCkmZXZi2d4Y0Y2e04DbMCcKWF1+K+xUUooUUIoXq03qxWS5a9imsHWZvb++xBw8eTtb7+FAjlCNH/5hZXVV1CsB/1HnA6qqEVDJ/ANN/9sqWLfPmzZ9HJyaTqWfP7t1nBwbMHCAEDJ8ySozOMIqBS0PsRctOo+mzNinlm7Ww9T+Qr/3+ulL78R3AQeEZtmFjSkxS0tIpfK+rq6tzx2uvvm21WskMZwxK8aASEog2lIT7+/u/yEL08vJyIr9x80bTsXePXjCbzZyQrM4t2G+uNyytXeiu6UXYT8NQl90OmX+Boua9cGFCxMZNP4py0+n4Wyk6W/ivnJzsLABUQsqymRuk6xzHBzm7BQCIXLdu/fqlLy9LZDE+FCVTT37+qS/Ly8rrZNlBIIyAMsthVRtGnh8fEDBu7Zq1kcbIaQZJkpw7Y/O9e81vHdj3rtls5hzAvYAjHtEqrgA0FtiOwaIoGlPT0jdHRUVHaZWvKIrS3NzUXlCQf6Xy4sUaWZY5XHIs048dOy5g5aqV06OiooPd3d1Z1M6a7Ozs6Hzn8KGP6uvrzwO4rY52lHfnyD90fmcxknZON8Gim9vkTSmbkufPmx/v5uamGYUsy3JDQ4PpVO7Jm42Nd/tWrFgVGhsXF+Lp6ck0aku529BwNzPzgxONjY2X1byz9cga58lHzgV8kYCcOVSVkekICQ+PmL5y5aqXwsLDJ0iSxP8f7nqyLNtsdtnDw33wHg23t7d1lhQXVxQWnimz2+0sOM5/bDs6d1L/JAC0y7zRoHZOYDuyOwyRkdMik5evmBsSEhKk5dc14u7urp7S0tKqwjOnz/f3999Rxy5qPnPOomPkrJnBw80jc5tqkCCYDva7VmAPh04gYNasmGnJycvnBgQGBoiiKJrNfb3lZeXVeXm55/v6+uiYZwpGzGLVDjacHQcj14A/CYCWDo0N5pZKR7UkkLEcXhISEqcaDIFjT57MvdzR0cYhg9FyUKVjbWynY+2M+cix7n8B0EDwk2wwLRoQqibBcIrifzwxccJha7pG/ETHz8LA0Ge0nVM7xLJGmCKyxNyyuHhpET/TYfZpDDwOqAaEkWtHeTpjtEMjftpJGv8FiVSZj/q1694AAAAASUVORK5CYII=" width="32" height="32"/>
</svg>

After

Width:  |  Height:  |  Size: 3.2 KiB

Some files were not shown because too many files have changed in this diff Show More