mirror of
https://github.com/ChrisTitusTech/winutil
synced 2026-04-05 22:28:31 +00:00
Cleaned up typos, fixes grammatical errors and other related fixes (#4215)
* cleaned up typo, fixes, grammatical and other related fixes (#2) * typo in Lightshot app name * remove trailing comma in applications.json * consistent capitalization of Windows, WinGet - only user-facing text - includes update to devdocs-generator.ps1, so docs for tweaks modifying registry will have `Windows settings` rather than `windows settings` * various fixes for typos, style, punctuation and capitalization * capitalize 'AM' * Update README.md change formatting for GitHub UI interaction form code format (` `) to bold md Co-authored-by: Jay <65828559+Jay-o-Way@users.noreply.github.com> * typos and wording in docs --------- Co-authored-by: Jay <65828559+Jay-o-Way@users.noreply.github.com>
This commit is contained in:
Paweł Gwozdowski
@@ -24,7 +24,7 @@ toc: true
|
||||
|
||||
* 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 `main` branch, but I am very selective about these.
|
||||
* If you're doing code changes, then you can submit a PR to the `main` branch, but I am very selective about these.
|
||||
|
||||
> [!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!
|
||||
@@ -85,7 +85,7 @@ graph TD
|
||||
|
||||
### Testing your changes
|
||||
|
||||
* To test to see if your changes work as intended run following commands in a powershell terminal as admin:
|
||||
* To test to see if your changes work as intended, run the following commands in a PowerShell terminal as admin:
|
||||
|
||||
* Change the directory where you are running the commands to the forked project.
|
||||
* `cd {path to the folder with the compile.ps1}`
|
||||
@@ -110,6 +110,6 @@ graph TD
|
||||
{{< image src="images/Push-Commit" alt="Push Commit Image" >}}
|
||||
|
||||
### 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 not a 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.
|
||||
* 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.
|
||||
|
||||
@@ -13,7 +13,7 @@ irm https://github.com/ChrisTitusTech/Winutil/releases/latest/download/Winutil.p
|
||||
|
||||
If it still isn't working in your region, it may be due to temporary ISP or network filtering of GitHub content domains. This has been reported by some users in India in the past. See: [Times of India](https://timesofindia.indiatimes.com/gadgets-news/github-content-domain-blocked-for-these-indian-users-reports/articleshow/96687992.cms).
|
||||
|
||||
If you are still having issues, try using a **VPN**, or changing your **DNS provider** to one of following two providers:
|
||||
If you are still having issues, try using a **VPN**, or changing your **DNS provider** to one of the following two providers:
|
||||
|
||||
| Provider | Primary DNS | Secondary DNS |
|
||||
| :--------: | :---------: | :-----------: |
|
||||
@@ -44,7 +44,7 @@ irm "https://christitus.com/win" | iex
|
||||
```
|
||||
|
||||
> [!NOTE]
|
||||
> On Windows 11, you usually do not need the TLS 1.2 command. Use it only if you hit download or security protocol errors.
|
||||
> On Windows 11, you usually do not need the TLS 1.2 command. Use it only if you encounter download or security protocol errors.
|
||||
|
||||
### Execution Policy Error
|
||||
|
||||
@@ -59,7 +59,7 @@ This only changes the policy for the current PowerShell process and is safe for
|
||||
|
||||
### Interface Doesn't Appear
|
||||
|
||||
If Winutil downloads but the GUI does not open or appear, try these steps:
|
||||
If Winutil downloads, but the GUI does not open or appear, try these steps:
|
||||
|
||||
1. Check if your antivirus or Windows Defender is blocking the script — add an exclusion if necessary.
|
||||
2. Ensure you launched PowerShell / Terminal as **Administrator**.
|
||||
|
||||
@@ -14,7 +14,7 @@ Welcome to the official documentation for Winutil, your go-to utility for optimi
|
||||
|
||||
## Running the latest release of Winutil
|
||||
|
||||
* You will first need to start a Powershell terminal **as Admin**.
|
||||
* You will first need to start a PowerShell terminal **as Admin**.
|
||||
* Now you can run the following command:
|
||||
|
||||
```
|
||||
|
||||
@@ -145,7 +145,7 @@ The **Win11 Creator** is a specialized subsystem within Winutil that creates cus
|
||||
|
||||
- `Invoke-WinUtilISOScript.ps1`: Applies modifications to mounted install.wim
|
||||
- Removes provisioned AppX packages (40+ bloatware apps)
|
||||
- Injects drivers (optional) from current system
|
||||
- Injects drivers (optional) from the current system
|
||||
- Removes OneDrive setup files
|
||||
- Applies offline registry tweaks (hardware bypass, privacy, telemetry, OOBE)
|
||||
- Deletes telemetry scheduled task definitions
|
||||
@@ -167,7 +167,7 @@ Invoke-WinUtilISOMountAndVerify
|
||||
├─ Extract available editions (Home, Pro, Enterprise, etc.)
|
||||
└─ Store ISO path, drive letter, WIM path, image info in $sync
|
||||
↓
|
||||
User optionally enables Driver Injection checkbox
|
||||
User optionally enables the Driver Injection checkbox
|
||||
↓
|
||||
Invoke-WinUtilISOModify (runs in background runspace)
|
||||
├─ Create work directory: ~WinUtil_Win11ISO_[timestamp]
|
||||
@@ -183,7 +183,7 @@ Invoke-WinUtilISOModify (runs in background runspace)
|
||||
│ ├─ Pre-stage setup scripts from autounattend.xml to C:\Windows\Setup\Scripts\
|
||||
│ └─ Unload registry hives
|
||||
├─ DISM /Cleanup-Image /StartComponentCleanup /ResetBase (saves 300-800 MB)
|
||||
├─ Dismount and save modified install.wim (~10+ minutes, slowest step)
|
||||
├─ Dismount and save the modified install.wim (~10+ minutes, slowest step)
|
||||
├─ Export selected edition only (removes all other editions, saves 1-2 GB each)
|
||||
├─ Dismount source ISO
|
||||
└─ Report completion, enable export options
|
||||
@@ -218,7 +218,7 @@ Invoke-WinUtilISOCleanAndReset (optional)
|
||||
- Prevents redundant modifications
|
||||
|
||||
**Modification Safety**:
|
||||
- All registry changes are documented in script (reversible)
|
||||
- All registry changes are documented in a script (reversible)
|
||||
- Original ISO never modified; only working copy
|
||||
- Logged to `WinUtil_Win11ISO.log` for debugging
|
||||
- DISM handles image dismount with automatic cleanup on error
|
||||
@@ -256,7 +256,7 @@ The `Invoke-WinUtilISOScript` function applies **50+ offline registry tweaks**:
|
||||
|
||||
**System Features**:
|
||||
- Disable BitLocker and device encryption
|
||||
- Disable Chat icon from taskbar
|
||||
- Disable Chat icon from the Taskbar
|
||||
- Disable OneDrive folder backup
|
||||
- Disable Copilot
|
||||
- Disable Windows Update during OOBE (re-enabled at first login)
|
||||
@@ -287,7 +287,7 @@ Get-WinUtilCheckBoxes → Retrieves selected apps
|
||||
↓
|
||||
For each selected app:
|
||||
↓
|
||||
Check if WinGet/Choco installed
|
||||
Check if WinGet/Choco is installed
|
||||
↓
|
||||
Install-WinUtilWinget/Choco (if needed)
|
||||
↓
|
||||
@@ -333,7 +333,7 @@ Retrieve "OriginalState" from tweak definition
|
||||
↓
|
||||
Invoke-WPFUndoTweak → Restore original values
|
||||
↓
|
||||
Remove from applied tweaks log
|
||||
Remove from the applied tweaks log
|
||||
↓
|
||||
Update UI
|
||||
```
|
||||
@@ -525,7 +525,7 @@ $sync.form.Dispatcher.Invoke([action]{
|
||||
```
|
||||
|
||||
2. Recompile: `.\Compile.ps1`
|
||||
3. The app appears automatically in Install tab
|
||||
3. The app appears automatically in the Install tab
|
||||
|
||||
### Adding a New Tweak
|
||||
|
||||
@@ -550,7 +550,7 @@ $sync.form.Dispatcher.Invoke([action]{
|
||||
```
|
||||
|
||||
2. Recompile: `.\Compile.ps1`
|
||||
3. Tweak appears in Tweaks tab
|
||||
3. Tweak appears in the Tweaks tab
|
||||
|
||||
### Adding a New Function
|
||||
|
||||
|
||||
@@ -6,14 +6,14 @@ toc: true
|
||||
## General Questions
|
||||
|
||||
### Is Windows 10 still supported?
|
||||
No. Windows 10 is no longer supported by Winutil because it reached end of support on **October 14, 2025**.
|
||||
No. Windows 10 is no longer supported by Winutil because it reached the end of support on **October 14, 2025**.
|
||||
Winutil is focused on Windows 11.
|
||||
|
||||
### How do I uninstall Winutil?
|
||||
You do not need to uninstall Winutil. Because it runs as a PowerShell script, it is loaded into memory only while it is open. Once you close it, it is removed from memory and does not remain installed on your system.
|
||||
|
||||
### Is Winutil safe to use?
|
||||
Yes, Winutil is open source and the code is publicly available on GitHub. Thousands of users run it daily. However, like any system modification tool, you should:
|
||||
Yes, Winutil is open source, and the code is publicly available on GitHub. Thousands of users run it daily. However, like any system modification tool, you should:
|
||||
- Run it as Administrator (required)
|
||||
- Create a restore point before major changes
|
||||
- Understand what tweaks you're applying
|
||||
@@ -23,7 +23,7 @@ Yes, Winutil is open source and the code is publicly available on GitHub. Thousa
|
||||
No. Once you've applied tweaks or installed applications, you can close Winutil. Changes persist after closing. You only need to run Winutil again when you want to make additional changes or undo tweaks.
|
||||
|
||||
### Does Winutil require internet access?
|
||||
- **For downloading**: Yes, installing applications requires internet
|
||||
- **For downloading**: Yes, installing applications requires the internet
|
||||
- **For tweaks**: No, most tweaks work offline
|
||||
- **Initial run**: Yes, to run the latest script
|
||||
|
||||
@@ -55,7 +55,7 @@ Try these solutions in order:
|
||||
```
|
||||
|
||||
> [!NOTE]
|
||||
> On Windows 11, you usually do not need the TLS 1.2 command. Use it only if you hit download or security protocol errors.
|
||||
> On Windows 11, you usually do not need the TLS 1.2 command. Use it only if you encounter download or security protocol errors.
|
||||
|
||||
3. **Change DNS** to Cloudflare (1.1.1.1) or Google (8.8.8.8)
|
||||
|
||||
@@ -91,10 +91,10 @@ Alternatively, use System Restore if you created a restore point.
|
||||
- Run Disk Cleanup
|
||||
- Create Restore Point
|
||||
|
||||
**(Advanced Tweaks)** should only be ran by advance users.
|
||||
**(Advanced Tweaks)** should only be run by advanced users.
|
||||
|
||||
### Will tweaks survive Windows Updates?
|
||||
Most tweaks persist through updates, but some may be reset by major Windows feature updates. You may need to reapply certain tweaks afterward.
|
||||
Most tweaks persist through updates, but some may be reset by major Windows feature updates. You may need to reapply certain tweaks afterwards.
|
||||
|
||||
### Can I create my own tweak presets?
|
||||
Currently, Winutil uses predefined presets (Standard, Minimal). Custom presets aren't directly supported in the GUI, but you can script your preferred configuration.
|
||||
@@ -165,7 +165,7 @@ Troubleshooting steps:
|
||||
1. Check your internet connection
|
||||
2. Try installing just that one application
|
||||
3. Review error messages in the output panel
|
||||
4. Check if antivirus is blocking
|
||||
4. Check if the antivirus is blocking
|
||||
5. Try the WinGet Reinstall fix
|
||||
|
||||
### Network tweaks broke my internet connection
|
||||
@@ -241,7 +241,7 @@ Results may vary depending on your system.
|
||||
Use the **Desktop** preset, then additionally apply:
|
||||
- Disable GameDVR
|
||||
- Ultimate Performance power plan
|
||||
- Disable fullscreen optimizations (Advanced)
|
||||
- Disable full-screen optimizations (Advanced)
|
||||
- Set display for performance (Advanced)
|
||||
|
||||
### How much RAM does Winutil use?
|
||||
@@ -251,7 +251,7 @@ Winutil itself uses about 50-100 MB while running. Once closed, it is removed fr
|
||||
|
||||
### "Access Denied" errors
|
||||
- Ensure PowerShell is running as Administrator
|
||||
- Check if antivirus is blocking changes
|
||||
- Check if the antivirus is blocking changes
|
||||
- Verify you have ownership of files/registry keys
|
||||
|
||||
|
||||
|
||||
@@ -6,7 +6,7 @@ weight: 2
|
||||
Welcome to the official User Guide for **Winutil**, your all-in-one Windows toolkit.
|
||||
|
||||
> [!IMPORTANT]
|
||||
> Windows 10 is not supported by Winutil. Windows 10 reached end of support on **October 14, 2025**.
|
||||
> Windows 10 is not supported by Winutil. Windows 10 reached the end of support on **October 14, 2025**.
|
||||
|
||||
## What is Winutil?
|
||||
|
||||
|
||||
@@ -13,7 +13,7 @@ Install common **Windows features** by selecting the feature checkboxes and clic
|
||||
* Hyper-V Virtualization
|
||||
* Legacy Media (WMP, DirectPlay)
|
||||
* NFS - Network File System
|
||||
* Enable Daily Registry Backup Task 12:30am
|
||||
* Enable Daily Registry Backup Task 12:30 AM
|
||||
* Enable Legacy F8 Boot Recovery
|
||||
* Disable Legacy F8 Boot Recovery
|
||||
* Windows Subsystem for Linux
|
||||
|
||||
@@ -12,7 +12,7 @@ Winutil is a powerful Windows utility that helps you optimize, customize, and ma
|
||||
Before running Winutil, ensure your system meets these requirements:
|
||||
|
||||
> [!IMPORTANT]
|
||||
> Windows 10 is not supported by Winutil. Windows 10 reached end of support on **October 14, 2025**.
|
||||
> Windows 10 is not supported by Winutil. Windows 10 reached the end of support on **October 14, 2025**.
|
||||
|
||||
- **Operating System**: Windows 11
|
||||
- **PowerShell**: Version 5.1 or later (included by default in Windows 11)
|
||||
@@ -86,7 +86,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 Win11 iso files.
|
||||
- **Win11 Creator**: Allows user to debloat Windows 11 ISO files.
|
||||
|
||||
## Your First Actions
|
||||
|
||||
@@ -106,7 +106,7 @@ This gives you a rollback point if needed.
|
||||
|
||||
1. Navigate to the **Install** tab
|
||||
2. Browse categories or use the search bar
|
||||
3. Check applications you want to install
|
||||
3. Check the applications you want to install
|
||||
4. Click "Install/Upgrade Selected" at the bottom
|
||||
|
||||
### 3. Apply Basic Tweaks
|
||||
@@ -209,7 +209,7 @@ 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 you get any errors when running Winutil please refer to [Known Issues](/knownissues/) page
|
||||
|
||||
## Next Steps
|
||||
|
||||
|
||||
@@ -5,7 +5,7 @@ weight: 6
|
||||
|
||||
Winutil provides three update modes so you can choose how aggressively Windows Update is managed on your system:
|
||||
|
||||
- **Default (Out of Box) Settings**: Restores standard Windows Update behavior
|
||||
- **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
|
||||
|
||||
|
||||
@@ -59,7 +59,7 @@ Click **Run Windows ISO Modification and Creator** to start the customization pr
|
||||
- **Disable Copilot and search box suggestions**
|
||||
|
||||
**Optional: Driver Injection**
|
||||
- If enabled, injects all drivers from your current system into the install.wim and boot.wim — useful for offline installations on machines with missing drivers. This is an optional checkbox in Step 3.
|
||||
- If enabled, it injects all drivers from your current system into the install.wim and boot.wim — useful for offline installations on machines with missing drivers. This is an optional checkbox in Step 3.
|
||||
|
||||
A live log shows progress as each step completes. This stage usually takes **10–30 minutes** depending on disk speed. The WIM dismount near the end is the slowest part, so do not close Winutil while it is running.
|
||||
|
||||
@@ -67,7 +67,7 @@ A live log shows progress as each step completes. This stage usually takes **10
|
||||
|
||||
### Step 4 — Export Your Result
|
||||
|
||||
Once modification is complete, choose how to save your image:
|
||||
Once the modification is complete, choose how to save your image:
|
||||
|
||||
{{< tabs >}}
|
||||
|
||||
|
||||
Reference in New Issue
Block a user