mirror of https://github.com/ChrisTitusTech/winutil.git synced 2026-03-30 20:48:08 -04:00

Go to file

Gabi 24c6706ab2 Update Invoke-WinUtilSSHServer.ps1 (#4254 ) * Update Invoke-WinUtilSSHServer.ps1 * fix: correct ssh-agent restart, use USERPROFILE path, add sshd_config idempotency check * Cleanup for Invoke-WinUtilSSHServer.ps1 * Update Invoke-WinUtilSSHServer.ps1 * Merge branch 'ChrisTitusTech:main' into patch-2 * Update Invoke-WinUtilSSHServer.ps1 * Update Invoke-WinUtilSSHServer.ps1 * Merge branch 'main' into patch-2 * Update Invoke-WinUtilSSHServer.ps1 * typo		2026-03-27 08:26:36 -05:00
.github	Cleaned up typos, fixes grammatical errors and other related fixes (#4215 )	2026-03-26 15:26:21 -05:00
config	Cleaned up typos, fixes grammatical errors and other related fixes (#4215 )	2026-03-26 15:26:21 -05:00
docs	chore: Update generated dev docs (#4264 )	2026-03-26 15:26:48 -05:00
functions	Update Invoke-WinUtilSSHServer.ps1 (#4254 )	2026-03-27 08:26:36 -05:00
lint	Code Formatting of Repo - Add Preprocessing to Compilation Process - Introduction of Dev/Build Tools to WinUtil (Although very simple at the moment) (#2383 )	2024-08-06 15:35:17 -05:00
overrides	[DOCS] Remove old Announcement about not adding any new applications to the app list (#3269 )	2025-03-19 13:56:00 -05:00
pester	Update configs.Tests.ps1	2024-08-28 15:33:44 -05:00
scripts	added doc link to settings menu (#4156 )	2026-03-06 08:29:20 -06:00
tools	Cleaned up typos, fixes grammatical errors and other related fixes (#4215 )	2026-03-26 15:26:21 -05:00
xaml	added doc link to settings menu (#4156 )	2026-03-06 08:29:20 -06:00
.gitattributes	Fix New Line Character for 'winutil.ps1' File (#2150 )	2024-06-28 16:23:41 -05:00
.gitignore	Remove microwin (#3999 )	2026-02-06 10:29:10 -06:00
Compile.ps1	Win11 ISO Creator (#4110 )	2026-02-24 15:28:49 -06:00
LICENSE	Update LICENSE	2024-08-30 09:48:21 -05:00
README.md	Cleaned up typos, fixes grammatical errors and other related fixes (#4215 )	2026-03-26 15:26:21 -05:00
sign.bat	add signing shortcut	2025-05-23 11:26:48 -05:00
windev.ps1	Update windev.ps1 (#3886 )	2026-01-09 11:31:42 -06:00

README.md

Chris Titus Tech's Windows Utility

This utility is a compilation of Windows tasks I perform on each Windows system I use. It is meant to streamline installs, debloat with tweaks, troubleshoot with config, and fix Windows updates. I am extremely picky about any contributions to keep this project clean and efficient.

💡 Usage

Winutil must be run in Admin mode because it performs system-wide tweaks. To achieve this, run PowerShell as an administrator. Here are a few ways to do it:

Start menu Method:
- Right-click on the start menu.
- Choose "Windows PowerShell (Admin)" (for Windows 10) or "Terminal (Admin)" (for Windows 11).
Search and Launch Method:
- Press the Windows key.
- Type "PowerShell" or "Terminal" (for Windows 11).
- Press Ctrl + Shift + Enter or Right-click and choose "Run as administrator" to launch it with administrator privileges.

Launch Command

Stable Branch (Recommended)

irm "https://christitus.com/win" | iex

Dev Branch

irm "https://christitus.com/windev" | iex

If you have Issues, refer to Known Issues or Create Issue

🎓 Documentation

WinUtil Official Documentation

YouTube Tutorial

ChrisTitus.com Article

🛠️ Build & Develop

Note

Winutil is a relatively large script, so it's split into multiple files which're combined into a single .ps1 file using a custom compiler. This makes maintaining the project a lot easier.

Get a copy of the source code. This can be done using GitHub UI (Code > Download ZIP), or by cloning (downloading) the repo using git.

If git is installed, run the following commands under a PowerShell window to clone and move into the project's directory:

git clone --depth 1 "https://github.com/ChrisTitusTech/winutil.git"
cd winutil

To build the project, run the Compile Script under a PowerShell window (admin permissions IS NOT required):

.\Compile.ps1

You'll see a new file named winutil.ps1, which was created by Compile.ps1 script. Now you can run it as admin, and a new window will pop up. Enjoy your own compiled version of WinUtil :)

Tip

For more info on using WinUtil and how to develop for it, please consider reading the Contribution Guidelines. If you don't know where to start, or have questions, you can ask over on our Discord Community Server, and active project members will answer when they can.