mirror of
https://github.com/ChrisTitusTech/winutil
synced 2026-04-05 14:18:31 +00:00
Compare commits
7 Commits
edfed488e8
...
2dbf3d71c0
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
2dbf3d71c0 | ||
|
|
ef226ac272 | ||
|
|
1f7f653568 | ||
|
|
9bd5a2541d | ||
|
|
c2dbcda2d5 | ||
|
|
0bd333dd47 | ||
|
|
6188447348 |
@@ -76,7 +76,7 @@ You'll see a new file named `winutil.ps1`, which's created by `Compile.ps1` scri
|
||||
|
||||
These are the sponsors that help keep this project alive with monthly contributions.
|
||||
|
||||
<!-- sponsors --><a href="https://github.com/dwelfusius"><img src="https://github.com/dwelfusius.png" width="60px" alt="User avatar: " /></a><a href="https://github.com/mews-se"><img src="https://github.com/mews-se.png" width="60px" alt="User avatar: Martin Stockzell" /></a><a href="https://github.com/jdiegmueller"><img src="https://github.com/jdiegmueller.png" width="60px" alt="User avatar: Jason A. Diegmueller" /></a><a href="https://github.com/robertsandrock"><img src="https://github.com/robertsandrock.png" width="60px" alt="User avatar: RMS" /></a><a href="https://github.com/KenichiQaz"><img src="https://github.com/KenichiQaz.png" width="60px" alt="User avatar: Stefan" /></a><a href="https://github.com/paulsheets"><img src="https://github.com/paulsheets.png" width="60px" alt="User avatar: Paul" /></a><a href="https://github.com/djones369"><img src="https://github.com/djones369.png" width="60px" alt="User avatar: Dave J (WhamGeek)" /></a><a href="https://github.com/anthonymendez"><img src="https://github.com/anthonymendez.png" width="60px" alt="User avatar: Anthony Mendez" /></a><a href="https://github.com/FatBastard0"><img src="https://github.com/FatBastard0.png" width="60px" alt="User avatar: " /></a><a href="https://github.com/DursleyGuy"><img src="https://github.com/DursleyGuy.png" width="60px" alt="User avatar: DursleyGuy" /></a><a href="https://github.com/DwayneTheRockLobster1"><img src="https://github.com/DwayneTheRockLobster1.png" width="60px" alt="User avatar: " /></a><a href="https://github.com/KieraKujisawa"><img src="https://github.com/KieraKujisawa.png" width="60px" alt="User avatar: Kiera Meredith" /></a><a href="https://github.com/partybrasil"><img src="https://github.com/partybrasil.png" width="60px" alt="User avatar: Miguel Diaz" /></a><a href="https://github.com/andrewpayne68"><img src="https://github.com/andrewpayne68.png" width="60px" alt="User avatar: Andrew P" /></a><a href="https://github.com/nathanzilgo"><img src="https://github.com/nathanzilgo.png" width="60px" alt="User avatar: Nathan Fernandes Pedroza" /></a><a href="https://github.com/EnzoFerroni"><img src="https://github.com/EnzoFerroni.png" width="60px" alt="User avatar: Enzo Ferroni" /></a><!-- sponsors -->
|
||||
<!-- sponsors --><a href="https://github.com/dwelfusius"><img src="https://github.com/dwelfusius.png" width="60px" alt="User avatar: " /></a><a href="https://github.com/mews-se"><img src="https://github.com/mews-se.png" width="60px" alt="User avatar: Martin Stockzell" /></a><a href="https://github.com/jdiegmueller"><img src="https://github.com/jdiegmueller.png" width="60px" alt="User avatar: Jason A. Diegmueller" /></a><a href="https://github.com/robertsandrock"><img src="https://github.com/robertsandrock.png" width="60px" alt="User avatar: RMS" /></a><a href="https://github.com/KenichiQaz"><img src="https://github.com/KenichiQaz.png" width="60px" alt="User avatar: Stefan" /></a><a href="https://github.com/paulsheets"><img src="https://github.com/paulsheets.png" width="60px" alt="User avatar: Paul" /></a><a href="https://github.com/djones369"><img src="https://github.com/djones369.png" width="60px" alt="User avatar: Dave J (WhamGeek)" /></a><a href="https://github.com/anthonymendez"><img src="https://github.com/anthonymendez.png" width="60px" alt="User avatar: Anthony Mendez" /></a><a href="https://github.com/FatBastard0"><img src="https://github.com/FatBastard0.png" width="60px" alt="User avatar: " /></a><a href="https://github.com/DursleyGuy"><img src="https://github.com/DursleyGuy.png" width="60px" alt="User avatar: DursleyGuy" /></a><a href="https://github.com/DwayneTheRockLobster1"><img src="https://github.com/DwayneTheRockLobster1.png" width="60px" alt="User avatar: " /></a><a href="https://github.com/KieraKujisawa"><img src="https://github.com/KieraKujisawa.png" width="60px" alt="User avatar: Kiera Meredith" /></a><a href="https://github.com/partybrasil"><img src="https://github.com/partybrasil.png" width="60px" alt="User avatar: Miguel Diaz" /></a><a href="https://github.com/andrewpayne68"><img src="https://github.com/andrewpayne68.png" width="60px" alt="User avatar: Andrew P" /></a><a href="https://github.com/EnzoFerroni"><img src="https://github.com/EnzoFerroni.png" width="60px" alt="User avatar: Enzo Ferroni" /></a><!-- sponsors -->
|
||||
|
||||
## 🏅 Thanks to all Contributors
|
||||
Thanks a lot for spending your time helping Winutil grow. Thanks a lot! Keep rocking 🍻.
|
||||
|
||||
@@ -263,7 +263,7 @@
|
||||
"content": "Citrix Workspace app",
|
||||
"description": "a secure, unified client application that provides instant access to virtual desktops, SaaS, web, and Windows apps from any device (Windows, macOS, Linux, iOS, Android) or browser.",
|
||||
"link": "https://www.citrix.com/downloads/workspace-app/",
|
||||
"winget": "Citrix.Workspace",
|
||||
"winget": "Citrix.Workspace"
|
||||
},
|
||||
"calibre": {
|
||||
"category": "Document",
|
||||
@@ -2093,6 +2093,42 @@
|
||||
"winget": "Proton.ProtonAuthenticator",
|
||||
"foss": true
|
||||
},
|
||||
"protonmail": {
|
||||
"category": "Communications",
|
||||
"choco": "na",
|
||||
"content": "Proton Mail",
|
||||
"description": "Proton Mail is an end-to-end encrypted email service by Proton, protecting your privacy with zero-access encryption.",
|
||||
"link": "https://proton.me/mail",
|
||||
"winget": "Proton.ProtonMail",
|
||||
"foss": true
|
||||
},
|
||||
"protondrive": {
|
||||
"category": "Utilities",
|
||||
"choco": "na",
|
||||
"content": "Proton Drive",
|
||||
"description": "Proton Drive is an end-to-end encrypted Swiss vault for your files that protects your data.",
|
||||
"link": "https://proton.me/drive",
|
||||
"winget": "Proton.ProtonDrive",
|
||||
"foss": true
|
||||
},
|
||||
"protonpass": {
|
||||
"category": "Utilities",
|
||||
"choco": "na",
|
||||
"content": "Proton Pass",
|
||||
"description": "Proton Pass is a cloud-based password manager with end-to-end encryption and unique email aliases.",
|
||||
"link": "https://proton.me/pass",
|
||||
"winget": "Proton.ProtonPass",
|
||||
"foss": true
|
||||
},
|
||||
"protonvpn": {
|
||||
"category": "Pro Tools",
|
||||
"choco": "protonvpn",
|
||||
"content": "Proton VPN",
|
||||
"description": "Proton VPN is a no-logs VPN service that protects your privacy online with features like Secure Core and Tor over VPN.",
|
||||
"link": "https://protonvpn.com/",
|
||||
"winget": "Proton.ProtonVPN",
|
||||
"foss": true
|
||||
},
|
||||
"processmonitor": {
|
||||
"category": "Microsoft Tools",
|
||||
"choco": "procexp",
|
||||
@@ -3444,5 +3480,23 @@
|
||||
"content": "NASM",
|
||||
"link": "https://nasm.us",
|
||||
"foss": true
|
||||
},
|
||||
"Ruby": {
|
||||
"category": "Development",
|
||||
"choco": "ruby",
|
||||
"winget": "RubyInstallerTeam.RubyWithDevkit.3.4",
|
||||
"description": "A Ruby language execution environment with a MSYS2 installation.",
|
||||
"content": "Ruby",
|
||||
"link": "https://rubyinstaller.org/",
|
||||
"foss": true
|
||||
},
|
||||
"Lua": {
|
||||
"category": "Development",
|
||||
"choco": "lua",
|
||||
"winget": "rjpcomputing.luaforwindows",
|
||||
"description": "A 'batteries included environment' for the Lua scripting language on Windows.",
|
||||
"content": "Lua",
|
||||
"link": "https://github.com/rjpcomputing/luaforwindows",
|
||||
"foss": true
|
||||
}
|
||||
}
|
||||
|
||||
@@ -1650,7 +1650,7 @@
|
||||
"panel": "1",
|
||||
"registry": [
|
||||
{
|
||||
"Path": "KCU:\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\GameDVR",
|
||||
"Path": "HKCU:\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\GameDVR",
|
||||
"Name": "AppCaptureEnabled",
|
||||
"Value": "0",
|
||||
"Type": "DWord",
|
||||
|
||||
@@ -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.
|
||||
|
||||
@@ -11,7 +11,7 @@ description: ""
|
||||
"panel": "1",
|
||||
"registry": [
|
||||
{
|
||||
"Path": "KCU:\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\GameDVR",
|
||||
"Path": "HKCU:\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\GameDVR",
|
||||
"Name": "AppCaptureEnabled",
|
||||
"Value": "0",
|
||||
"Type": "DWord",
|
||||
|
||||
@@ -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)!
|
||||
|
||||
@@ -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
|
||||
|
||||
|
||||
@@ -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
|
||||
|
||||
|
||||
Reference in New Issue
Block a user