jlammi/winutil
1
0
Fork 0
mirror of https://github.com/ChrisTitusTech/winutil synced 2026-04-05 22:28:31 +00:00
Code Issues Packages Projects Releases Wiki Activity

updated docs (#4203)

Browse Source 
* updated docs

* Update KnownIssues.md

* Update faq.md

* Update _index.md

* Update _index.md

* Update _index.md

* Update faq.md

* Update faq.md

* Update faq.md
This commit is contained in:
Sean (ANGRYxScotsman)
2026-03-26 02:17:09 +00:00
committed by GitHub
parent edfed488e8
commit 6188447348
4 changed files with 58 additions and 87 deletions
Download Patch File Download Diff File Expand all files Collapse all files

38
docs/content/KnownIssues.md
View File

@@ -27,3 +27,41 @@ If your PowerShell session is running in **Constrained Language Mode**, some scr
$ExecutionContext.SessionState.LanguageMode
```
If it returns `ConstrainedLanguage`, you may need to switch to `FullLanguage` mode or run the script in a session with administrative privileges. Be aware that some security policies may enforce Constrained Language Mode, especially in corporate or managed environments.
**If the download fails**:
1. Try the direct GitHub link:
```powershell
irm https://github.com/ChrisTitusTech/Winutil/releases/latest/download/Winutil.ps1 | iex
```
2. Force TLS 1.2:
```powershell
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
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.
### Execution Policy Error
If you see an execution policy error when running the downloaded script, you can allow the current session to run unsigned scripts with this command:
```powershell
Set-ExecutionPolicy Unrestricted -Scope Process -Force
irm "https://christitus.com/win" | iex
```
This only changes the policy for the current PowerShell process and is safe for one-off runs.
### Interface Doesn't Appear
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**.
3. Close and reopen PowerShell, then run the launch command again.
4. If the script still doesn't show, try running the script in a visible PowerShell window (avoid background/silent shells) to observe output and errors.

38
docs/content/faq.md
View File

@@ -17,7 +17,7 @@ Yes, Winutil is open source and the code is publicly available on GitHub. Thousa
- Run it as Administrator (required)
- Create a restore point before major changes
- Understand what tweaks you're applying
- Download only from official sources
- Run only from [official source](https://github.com/ChrisTitusTech/winutil/)
### Do I need to keep running Winutil?
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.
@@ -25,7 +25,7 @@ No. Once you've applied tweaks or installed applications, you can close Winutil.
### Does Winutil require internet access?
- **For downloading**: Yes, installing applications requires internet
- **For tweaks**: No, most tweaks work offline
- **Initial run**: Yes, to download the latest script
- **Initial run**: Yes, to run the latest script
### How often is Winutil updated?
Winutil is actively maintained with frequent updates. New features, bug fixes, and application additions are released regularly. The script auto-downloads the latest version each time you run it.
@@ -91,19 +91,13 @@ Alternatively, use System Restore if you created a restore point.
- Run Disk Cleanup
- Create Restore Point
**Caution needed (Advanced Tweaks)**:
- Remove Microsoft Store
- Disable Windows Defender
- Remove all bloatware
- Disable system services
Start with Essential Tweaks. Only use Advanced Tweaks if you understand the implications.
**(Advanced Tweaks)** should only be ran by advance 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.
### Can I create my own tweak presets?
Currently, Winutil uses predefined presets (Desktop, Laptop, Minimal, Standard). Custom presets aren't directly supported in the GUI, but you can script your preferred configuration.
Currently, Winutil uses predefined presets (Standard, Minimal). Custom presets aren't directly supported in the GUI, but you can script your preferred configuration.
### What's the difference between Essential and Advanced tweaks?
- **Essential Tweaks**: Safe for most users, improve performance/privacy with minimal risk
@@ -128,9 +122,10 @@ Yes! Check the boxes for all applications you want, then click "Install Selected
No. WinGet and Chocolatey install clean versions of applications without bundled offers, toolbars, or bloatware.
### Can I uninstall applications through Winutil?
Winutil focuses on installation. To uninstall:
- Use Windows Settings > Apps > Installed Apps
- Or use the application's built-in uninstaller
Winutil primarily focuses on installing and managing applications rather than providing a full GUI for uninstalling every program. To remove applications you can:
- Use Windows Settings > Apps > Installed apps to uninstall programs.
- Use package manager commands in PowerShell (for example `winget uninstall <package>` or `choco uninstall <package>`).
- Some packages installed by Winutil (AppX/MSIX) include removal helpers; check the app entry or use Winutil's remove helpers when available.
### Will installed apps auto-update?
Applications with built-in update mechanisms will auto-update. You can also update them via WinGet/Chocolatey commands or through Winutil's "Upgrade Selected" feature.
@@ -146,7 +141,7 @@ Generally, **no**. Security updates are important. However, you might:
### How do I re-enable updates after disabling them?
1. Open Winutil
2. Go to the **Updates** tab
3. Click **Enable Updates**
3. Click **Default Updates**
4. Updates will resume normally
### What's the difference between "Security Updates Only" and "Disable Updates"?
@@ -228,12 +223,6 @@ It disables:
- Usage statistics
- Error reporting (optional)
### Is it safe to disable Windows Defender?
**Generally not recommended**. Only disable Defender if:
- You have alternative antivirus installed
- You understand the security risks
- You're in a controlled/isolated environment
### Will removing Microsoft Store affect security updates?
No, Windows security updates are independent of the Microsoft Store.
@@ -246,7 +235,7 @@ Tweaks can improve performance by:
- Cleaning temporary files
- Optimizing startup programs
Results vary depending on your system and which tweaks you apply.
Results may vary depending on your system.
### What's the best preset for gaming?
Use the **Desktop** preset, then additionally apply:
@@ -265,8 +254,6 @@ Winutil itself uses about 50-100 MB while running. Once closed, it is removed fr
- Check if antivirus is blocking changes
- Verify you have ownership of files/registry keys
### WinGet configuration prompt won't go away
Type `Y` and press Enter in the PowerShell window. This only happens on first use and configures WinGet for your system.
## Still Need Help?
@@ -277,8 +264,3 @@ Can't find your answer? Try these resources:
- **[Discord Community](https://discord.gg/RUbZUZyByQ)** - Get help from other users
- **[GitHub Issues](https://github.com/ChrisTitusTech/winutil/issues)** - Report bugs
- **[YouTube Tutorial](https://www.youtube.com/watch?v=6UQZ5oQg8XA)** - Video walkthrough
---
**Last Updated**: January 2026
**Found this helpful?** Consider starring the project on [GitHub](https://github.com/ChrisTitusTech/winutil)!

1
docs/content/userguide/features/_index.md
View File

@@ -28,7 +28,6 @@ Use these one-click fixes for common system problems.
* Reset Network
* System Corruption Scan
* WinGet Reinstall
* Remove Adobe Creative Cloud
## Legacy Windows Panels

68
docs/content/userguide/getting-started/_index.md
View File

@@ -48,41 +48,34 @@ There are several ways to open PowerShell with admin rights:
### Step 2: Run the Launch Command
Once PowerShell is open with administrator privileges, run one of these commands:
With PowerShell running as Administrator, run one of the following commands depending on the release channel you want.
**Stable Release (Recommended for most users)**
**Stable release (recommended)**
```powershell
irm "https://christitus.com/win" | iex
```
**Development Branch (For testing latest features)**
**Development branch (bleeding edge — for testing only)**
```powershell
irm "https://christitus.com/windev" | iex
```
> [!NOTE]
> The `irm` command downloads the script, and `iex` executes it. This is safe when downloading from the official source.
> - The `irm` command downloads the script, and `iex` executes it. This is safe when downloading from the official source.
> - The development branch may contain experimental changes and should only be used for testing on non-production systems.
### Step 3: Wait for Winutil to Load
The first time you run Winutil, it may take a few moments to:
- Download the latest version
- Run the latest version
- Initialize the interface
- Load all features and settings
## First Time Setup
### Configure WinGet (If Prompted)
On your first run, you may be prompted to configure WinGet (Windows Package Manager). This is normal.
1. When prompted, type `Y` and press Enter
2. Accept the terms and conditions
3. This only needs to be done once
### Understanding the Interface
Winutil opens with a clean, tabbed interface:
@@ -93,6 +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.
## Your First Actions
@@ -120,7 +114,7 @@ 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 **"Desktop" preset** for a balanced configuration
2. Select the **Standard** for a balanced configuration
3. Review the selected tweaks
4. Click **Run Tweaks**
@@ -177,7 +171,7 @@ For common Windows issues:
For improved privacy and speed:
1. Go to the **Config** tab or the **Tweaks** tab
1. Go to the **Tweaks** tab
2. Find the DNS section
3. Select a provider:
- **Cloudflare**: Fast and privacy-focused
@@ -215,49 +209,7 @@ Winutil offers several preset configurations:
### Script Won't Download
**If the download fails**:
1. Try the direct GitHub link:
```powershell
irm https://github.com/ChrisTitusTech/Winutil/releases/latest/download/Winutil.ps1 | iex
```
2. Force TLS 1.2:
```powershell
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
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.
### Execution Policy Error
If you get an execution policy error:
```powershell
Set-ExecutionPolicy Unrestricted -Scope Process -Force
irm "https://christitus.com/win" | iex
```
### Download Blocked (India/Certain Regions)
If downloads are blocked in your region:
1. Use a VPN service
2. Change DNS to Cloudflare (1.1.1.1) or Google (8.8.8.8)
3. Try again
### Interface Doesn't Appear
If Winutil downloads but doesn't open:
1. Check if antivirus is blocking it
2. Ensure you ran PowerShell as administrator
3. Try closing and reopening PowerShell
4. Check Windows Defender exclusions
If you get any errors when running winutil please refer to [Known Issues](/knownissues/) page
## Next Steps