* 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>
6.8 KiB
title, weight
| title | weight |
|---|---|
| Getting Started | 2 |
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.
System Requirements
Before running Winutil, ensure your system meets these requirements:
Important
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)
- Administrator Access: Required for system-level changes
- Internet Connection: Required for downloading applications and updates
- .NET Framework: Version 4.5 or later (usually pre-installed)
Installation
Winutil doesn't require traditional installation. It runs directly from PowerShell as a script.
Step 1: Open PowerShell as Administrator
There are several ways to open PowerShell with admin rights:
Method 1: Start Menu (Recommended)
- Right-click the Windows Start button
- Select "Terminal (Admin)"
Method 2: Search Method
- Press the
Windowskey - Type "PowerShell" or "Terminal"
- Press
Ctrl + Shift + Enterto launch as administrator - Or right-click and select "Run as administrator"
Method 3: Run Dialog
- Press
Windows + R - Type
powershell - Press
Ctrl + Shift + Enter
Step 2: Run the Launch Command
With PowerShell running as Administrator, run one of the following commands depending on the release channel you want.
Stable release (recommended)
irm "https://christitus.com/win" | iex
Development branch (bleeding edge — for testing only)
irm "https://christitus.com/windev" | iex
Note
- The
irmcommand downloads the script, andiexexecutes 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:
- Run the latest version
- Initialize the interface
- Load all features and settings
First Time Setup
Understanding the Interface
Winutil opens with a clean, tabbed interface:
Main Tabs:
- Install: Browse and install applications
- 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.
Your First Actions
Here are some recommended first steps for new users:
1. Create a Restore Point
Before making any changes, create a system restore point:
- Go to the Tweaks tab
- Find "Create Restore Point" under Essential Tweaks
- Check the box and click Run Tweaks
This gives you a rollback point if needed.
2. Install Essential Applications
- Navigate to the Install tab
- Browse categories or use the search bar
- Check the applications you want to install
- Click "Install/Upgrade Selected" at the bottom
3. Apply Basic Tweaks
For a better Windows experience with minimal risk:
- Go to the Tweaks tab
- Select the Standard for a balanced configuration
- Review the selected tweaks
- Click Run Tweaks
Common Tasks
Installing Applications
Single Application:
- Open the Install tab
- Search for the application name
- Check the box next to it
- Click "Install/Upgrade Selected"
Multiple Applications:
- Check multiple application boxes
- All checked apps will install in sequence
- Progress is shown in the bottom panel
Applying Tweaks
Essential Tweaks (Safe for all users):
- Go to the Tweaks tab
- Select from the Essential Tweaks section
- Click Run Tweaks
Advanced Tweaks (Use with caution):
- Only modify if you understand the implications
- Always create a restore point first
- Review documentation for each tweak
Undoing Tweaks:
- Select the same tweaks you applied
- Click Undo Selected Tweaks
- The system reverts to the previous state
Using Quick Fixes
For common Windows issues:
- Go to the Config tab
- Navigate to the Fixes section
- Select the appropriate fix:
- Reset Network: Fixes network connectivity issues
- Reset Windows Update: Resolves update problems
- System Corruption Scan: Repairs corrupted system files
- WinGet Reinstall: Fixes package manager issues
Changing DNS Servers
For improved privacy and speed:
- Go to the Tweaks tab
- Find the DNS section
- Select a provider:
- Cloudflare: Fast and privacy-focused
- Google: Reliable and widely used
- Quad9: Security-focused with malware blocking
- AdGuard: Blocks ads and trackers
- Click Apply
Understanding Presets
Winutil offers several preset configurations:
- Minimal: Minimal changes that keep most Windows features
- Standard: A good middle ground for most users
Safety Tips
✅ DO:
- Create restore points before major changes
- Read tweak descriptions before applying
- Start with Essential Tweaks
- Keep Windows up to date
- Back up important data
❌ DON'T:
- Apply all tweaks at once without understanding them
- Skip creating restore points
- Use Advanced Tweaks without research
- Disable security features unless necessary
- Run on production systems without testing
Troubleshooting First Run
Script Won't Download
If you get any errors when running Winutil please refer to Known Issues page
Next Steps
Now that you're set up, explore these guides:
- Applications Guide - Learn about installing, upgrading, and uninstalling software
- Tweaks Guide - Understand system optimizations
- FAQ - Common questions and answers
Getting Help
If you need assistance:
- Documentation: Browse this documentation site
- Known Issues: Check the Known Issues page
- Discord: Join the community Discord server
- GitHub Issues: Report bugs on GitHub
- YouTube: Watch video tutorials
Quick Reference Card
| Task | Location | Action |
|---|---|---|
| Install or upgrade apps | Install tab | Check boxes -> Install/Upgrade Selected |
| Uninstall apps | Install tab | Check boxes -> Uninstall Selected |
| Apply tweaks | Tweaks tab | Select tweaks -> Run Tweaks |
| Undo tweaks | Tweaks tab | Select tweaks -> Undo Selected Tweaks |
| Create restore point | Tweaks tab | Essential Tweaks section |
| Fix network | Config tab | Fixes -> Reset Network |
| Change DNS | Tweaks tab | DNS section |
| Open Control Panel | Config tab | Legacy Windows Panels |
Happy optimizing!