Compare commits

..
94 Commits
Author SHA1 Message Date
Ivan LepekhaandGitHub af900dab3a feat(github): Create a discussion template for app suggestion (#4741)
* Create app suggestion discussion template

Add a discussion template for app suggestions with rules and input fields.

* Add application suggestion link to issue template

Added a link for suggesting applications to the issue template.

* Update app suggestion discussion template

* Add checkbox for WinGet application presence check

* Changed name of file, didn't change name of link XD
2026-06-22 18:22:59 -05:00
Chris TitusandGitHub 31425a5520 chore: Update generated dev docs (#4739) 2026-06-22 14:47:09 -05:00
GabiandGitHub 47f06e34e3 Deleted lastrun.json (#4714)
* Update Invoke-WPFtweaksbutton.ps1

* Update main.ps1

* Update tweaks.json

* Update tweaks.json

* Update tweaks.json
2026-06-22 14:46:38 -05:00
Chris TitusandGitHub ae4c787545 chore: Update generated dev docs (#4738) 2026-06-22 14:35:13 -05:00
NotDecidedandGitHub b2a258a45f Add option to disable lock screen in tweaks.json (#4721) 2026-06-22 14:34:11 -05:00
GabiandGitHub d7cc5981e0 allow uninstallation of edge trough install tab (#4716)
* unlock edge uninstall whenever the user trys to uninstall edge trough install tab

* Update Invoke-WPFUnInstall.ps1
2026-06-22 14:33:09 -05:00
GabiandGitHub 9bfba35788 Correct old infromation in CONTRIBUTING.md (#4709) 2026-06-22 14:30:23 -05:00
GabiandGitHub 51d7350e35 Fix Add-SelectedAppsMenuItem's spaces (#4707) 2026-06-22 14:28:39 -05:00
GabiandGitHub 652ea6368c Removed useless logic from main.ps1 (#4706) 2026-06-22 14:27:16 -05:00
GabiandGitHub 57be85b566 Added lightshot and KeePassXC to applications.json (#4702)
* Added lightshot to applications.json

* Added keepassxc to applications.json
2026-06-22 14:26:24 -05:00
4hm3dn3d41andGitHub 376156f072 Rework foss filtering (#4696)
* Replace FOSS highlight toggle with inline label

Remove the separate "Highlight FOSS" toggle and its theming logic, and instead append an inline "- FOSS" label to FOSS app entries. Changes: remove WPFToggleFOSSHighlight from app navigation and related event handlers, delete FOSSColor resource updates in theme code and button handler, simplify checkbox setup in Invoke-WPFUIElements by removing the special-case toggle logic, and update Initialize-InstallAppEntry to build a horizontal panel containing the app name plus a small green "- FOSS" TextBlock for FOSS items. This consolidates FOSS indication into the item UI and cleans up toggle/theme handling.

* Add inline FOSS label to app entries

Replace the separate StackPanel/TextBlock used for the FOSS indicator with an inline System.Windows.Documents.Run appended to the app name. The run is styled (green RGB(76,175,80) and FontSize=10) and the checkbox content assignment was moved outside the conditional so the appName (with optional FOSS run) is always used. Cleaned up related comments to reflect the FOSS label change.

* Add FOSS note type with green bullet

Added FOSS notes in the UI and FOSS labels with a green bullet instead of the text '#FOSS'

* Use larger circle glyph; remove italic text

Replaced the FOSS and list bullet glyphs with a larger circle for better visual consistency and removed the italic styling

* Update FOSS/bullet glyphs, colors and sizes

Updated FOSS/list bullet styling by switching glyphs from U+2B24 to U+25CF, increasing size (10→11.5), and adjusting bullet/text colors for better visibility and consistency across.
2026-06-22 14:23:09 -05:00
Chris TitusandGitHub cc40fdf42a chore: Update generated dev docs (#4737) 2026-06-22 14:21:05 -05:00
1b8a834d5d Simplify WPFTweaksRevertStartMenu (#4694)
Co-authored-by: Chris Titus <contact@christitus.com>
2026-06-22 14:20:31 -05:00
Chris TitusandGitHub 7ffb396786 chore: Update generated dev docs (#4736) 2026-06-22 14:17:57 -05:00
DiegoandGitHub 1d4fa15f7e Add pnpm package manager (#4681) 2026-06-22 14:17:50 -05:00
Paweł GwozdowskiandGitHub aefbf1a847 standardize console message punctuation and capitalization (#4680) 2026-06-22 14:17:23 -05:00
Chris TitusandGitHub edca5207ec chore: Update generated dev docs (#4735) 2026-06-22 14:17:10 -05:00
3307e88f2c Update tweaks.json (#4679)
Co-authored-by: Chris Titus <contact@christitus.com>
2026-06-22 14:16:28 -05:00
Paweł GwozdowskiandGitHub 36dc2e73ff Update applications.json (#4678) 2026-06-22 14:14:51 -05:00
Paweł GwozdowskiandGitHub c5ed3a9773 fix typos in .github folder (#4677)
* .yaml

* Update feature_request.yaml

* Update compile-check.yaml

* Update close-old-issues.yaml
2026-06-22 14:14:10 -05:00
Paweł GwozdowskiandGitHub d268bb721b correct "WinUtil" in docs (#4676)
* Update _index.md

* Update architecture.md

* Update faq.md

* Update KnownIssues.md

* Update _index.md

* Update _index.md

* Update _index.md

* Update _index.md

* Update _index.md

* Update _index.md

* Update _index.md

* Update hugo.toml
2026-06-22 14:13:16 -05:00
Chris TitusandGitHub b9e324b01a chore: Update generated dev docs (#4734) 2026-06-22 14:08:57 -05:00
910c9f698c feat: add advanced tweak to disable reserved storage (#4664)
Co-authored-by: Dev <dev@localhost>
2026-06-22 14:08:18 -05:00
Chris TitusandGitHub dbab51061d chore: Update generated dev docs (#4733) 2026-06-22 14:03:36 -05:00
GabiandGitHub 8eadd527ad Stop using temp varible (#4645)
* Update Invoke-WPFOOSU.ps1

* Update Invoke-WPFPanelAutologin.ps1
2026-06-22 14:03:00 -05:00
dependabot[bot]GitHubdependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
7745364e66 Bump actions/checkout from 6 to 7 (#4730)
Bumps [actions/checkout](https://github.com/actions/checkout) from 6 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v6...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-06-22 13:59:59 -05:00
GabiandGitHub ac0982f9f5 Removed Get-ComputerInfo from main.ps1 (#4634) 2026-06-22 13:59:37 -05:00
GabiandGitHub 298542e4f7 Removed icons from release-drafter.yml (#4590) 2026-06-22 13:52:59 -05:00
Chris TitusandGitHub 9d75eadf16 chore: Update generated dev docs (#4732) 2026-06-22 13:52:03 -05:00
36f39091ec Make WIndowsAI tweak more understandable in tweaks.json (#4684)
* Make WIndowsAI tweak more understandable in tweaks.json

* Update config/tweaks.json

why not

Co-authored-by: Breaking Changes <107767789+HopeItBuilds@users.noreply.github.com>

---------

Co-authored-by: Breaking Changes <107767789+HopeItBuilds@users.noreply.github.com>
2026-06-22 13:51:36 -05:00
GabiandGitHub 58a81b106c Added back VoidTools Everything to applications.json (#4693) 2026-06-11 23:15:05 -05:00
Paweł GwozdowskiandGitHub a280ddb1fa correct case of "WinUtil" in GUI / user-facing messages (#4675)
* WinUtil in .ps1

* WinUtil in GUI

* Update KnownIssues.md
2026-06-09 12:22:56 -05:00
Paweł GwozdowskiandGitHub 01c0e999c1 Update CODE_OF_CONDUCT.md (#4674) 2026-06-09 12:21:34 -05:00
Paweł GwozdowskiandGitHub 5efef2c0f3 Update SECURITY.md (#4673) 2026-06-09 12:21:05 -05:00
Chris TitusandGitHub ea1cff0724 Add 'Refactor' option to PR template 2026-06-08 10:19:47 -05:00
Chris TitusandGitHub 09569162a1 chore: Update generated dev docs (#4672) 2026-06-08 10:10:56 -05:00
Neac0andGitHub bced250ae1 Fix Remove Home and Gallery (#4654)
Fixes the deletion of "Home" and "Gallery" in File Explorer. Now it correctly deletes both.
2026-06-08 10:10:19 -05:00
Chris TitusandGitHub 80aa6af30a chore: Update generated dev docs (#4671) 2026-06-08 10:05:32 -05:00
5a233b3422 fix: add registry tracking to WPFTweaksRightClickMenu for drift detection (#4636)
* fix: correct false-positives and service tracking in drift detection

* Update Invoke-WPFtweaksbutton.ps1

* Update Invoke-WPFtweaksbutton.ps1

* Update Invoke-WPFtweaksbutton.ps1

---------

Co-authored-by: Dev <dev@localhost>
2026-06-08 10:04:20 -05:00
GabiandGitHub 01ef78915a Remove -NoUi (#4572)
* Made -NoUi not exit the window

* Update start.ps1

* Update main.ps1

* Update main.ps1

* Update Set-WinUtilProgressbar.ps1

* Update Invoke-WPFImpex.ps1

* Update Invoke-WPFUIThread.ps1

* Update start.ps1

* Update Invoke-WPFUIThread.ps1

* Update main.ps1

* Update main.ps1
2026-06-08 10:02:35 -05:00
Chris TitusandGitHub 7dfebba70f chore: Update generated dev docs (#4670) 2026-06-08 10:01:26 -05:00
0a018e0405 Update WPFTweaksRevertStartMenu (#4615)
* Update tweaks.json

* Update preset.json

* Update preset.json

* Update tweaks.json

* Update KnownIssues.md

---------

Co-authored-by: Chris Titus <contact@christitus.com>
2026-06-08 10:00:43 -05:00
Chris TitusandGitHub e50621a9dc chore: Update generated dev docs (#4669) 2026-06-08 09:49:20 -05:00
3ef100a083 Fixed bug merged in #4577 that breaks Taskbar Search Icon tweak (#4649)
Co-authored-by: gepardjaro <266757713+drzewjaro@users.noreply.github.com>
2026-06-08 09:48:41 -05:00
Chris TitusandGitHub eebb56ac5a chore: Update generated dev docs (#4668) 2026-06-08 09:45:11 -05:00
GabiandGitHub daf045390d fix dev branch not working (#4651)
* fix dev branch not working

* Update start.ps1
2026-06-08 09:44:14 -05:00
GabiandGitHub 6214012fd1 Added -NoRestart to WPFTweaksWindowsAI (#4639) 2026-06-08 09:43:20 -05:00
CodingWondersandGitHub 297b3079e5 Fix slop remains (#4640)
* Fix slop remains

Chris likes to vibe code. AI likes to use different types of dashes (em-dashes, en-dashes), instead of regular dashes (-).

On PowerShell 7 this appears to work. The parser doesn't care. But, what about PowerShell 5? It begins throwing errors about the ampersand. Loading it in the ISE reveals how it stops parsing the syntax correctly when it encounters em-dashes. Rather than displaying them as such, the ISE displays them as —.

Chris, if you want to vibe code, I don't mind. But at least use regular dashes.

Anyway, I won't fix the AI code. I just want to make it work on my beloved powershell 5.

* Apparently this file is important
2026-06-08 09:43:04 -05:00
Chris TitusandGitHub 9fdf944ef9 chore: Update generated dev docs (#4667) 2026-06-08 09:43:02 -05:00
GabiandGitHub 6b5a9bcb9b Added -Recurse for Onedrive Remove-Item command (#4642) 2026-06-08 09:42:25 -05:00
e4d305284b feat: detect reverted tweaks on startup (#4582)
Co-authored-by: vyas-devgna <vyas-devgna@users.noreply.github.com>
2026-06-04 15:28:37 -05:00
GabiandGitHub 78593cc58d Fixed irfanview's and openvpn's foss selection (#4546)
* Fixed irfanview's foss selection

* Update applications.json

* Update applications.json
2026-06-04 13:42:08 -05:00
GabiandGitHub e83033a122 Update KnownIssues.md (#4537)
* Update KnownIssues.md

* Update KnownIssues.md

* Update KnownIssues.md
2026-06-03 16:12:02 -05:00
Chris TitusandGitHub 5832f0df81 chore: Update generated dev docs (#4631) 2026-06-03 16:09:54 -05:00
GabiandGitHub 26f3284919 Show ctt logo instantly (#4603)
* Update main.ps1

* Delete functions/public/Show-CTTLogo.ps1

* Update main.ps1

* Update main.ps1
2026-06-03 16:09:44 -05:00
GabiandGitHub 1f8455e90d Removed WPFTweaksWidget's UndoScript (#4608) 2026-06-03 16:08:12 -05:00
Chris TitusandGitHub 62c43e6e82 chore: Update generated dev docs (#4630) 2026-06-03 16:07:49 -05:00
GabiandGitHub a1949ed917 Update feature.json (#4612) 2026-06-03 16:07:01 -05:00
Chris TitusandGitHub 74a3ddad1c chore: Update generated dev docs (#4629) 2026-06-03 16:06:49 -05:00
GabiandGitHub d7b0389a93 Removed WPFTweaksPowershell7Tele and added it to WPFTweaksTelemetry (#4613)
* Update tweaks.json

* Update preset.json
2026-06-03 16:06:03 -05:00
GabiandGitHub 23f197b644 Update main.ps1 (#4604) 2026-06-03 13:50:51 -05:00
Chris TitusandGitHub b2eeda9eb2 chore: Update generated dev docs (#4627) 2026-06-03 13:46:17 -05:00
GabiandGitHub ceec8aeb53 Update Invoke-WPFPanelAutologin.ps1 (#4596) 2026-06-03 13:45:16 -05:00
GabiandGitHub 6b125346cd Simplify Invoke-WPFFixesNetwork.ps1 (#4594)
* Update Invoke-WPFFixesNetwork.ps1

* Update Invoke-WPFFixesNetwork.ps1
2026-06-03 13:44:21 -05:00
Chris TitusandGitHub 5f8e493536 chore: Update generated dev docs (#4626) 2026-06-03 13:43:59 -05:00
GabiandGitHub 4db0248911 Simplify Invoke-WPFOOSU.ps1 (#4593)
* Simplify Invoke-WPFOOSU.ps1

* Update Invoke-WPFOOSU.ps1
2026-06-03 13:43:15 -05:00
GabiandGitHub 2bee0d6f2c Update Invoke-WinUtilSponsors.ps1 (#4589) 2026-06-03 13:36:42 -05:00
Chris TitusandGitHub 58df36841f chore: Update generated dev docs (#4625) 2026-06-03 13:35:59 -05:00
GabiandGitHub 5ba840f87f refactor WPFTweaksBlockAdobeNet (#4585)
* Update tweaks.json

* Update tweaks.json
2026-06-03 13:35:21 -05:00
GabiandGitHub fe2dd829b8 Removed RustDesk from applications.json (#4584) 2026-06-03 13:33:07 -05:00
AlfyusandGitHub 5cdb6c6e22 Italian README in ".github" (#4623)
* Create READMEITALIAN.md for Italian users

Added Italian translation for the README file, detailing the functionality and usage of WinUtil.

* Fix formatting in READMEITALIAN.md

* Rename READMEITALIAN.md to .github/READMEITALIAN.md
2026-06-03 13:29:51 -05:00
Chris TitusandGitHub 4bda00ec2d chore: Update generated dev docs (#4624) 2026-06-03 13:29:11 -05:00
462cc40a6a better explanation for toggle description (#4577)
* Update tweaks.json

* Update tweaks.json

* Update tweaks.json

* Update tweaks.json

* Update tweaks.json

---------

Co-authored-by: Chris Titus <contact@christitus.com>
2026-06-03 13:28:32 -05:00
GabiandGitHub 0e061692ba Made "Upgrade all applications" not exit after completion (#4575)
* Update Invoke-WPFInstallUpgrade.ps1

* Update Test-WinUtilPackageManager.ps1

* Update Test-WinUtilPackageManager.ps1
2026-06-03 13:23:46 -05:00
GabiandGitHub ffec7a8a8f Added nomacs to applications.json (#4566) 2026-06-03 13:18:29 -05:00
GabiandGitHub 6e4b1d26c6 Removed WPFTweaksDVR from preset.json (#4565) 2026-06-03 13:15:30 -05:00
Chris TitusandGitHub 32cec06ed6 chore: Update generated dev docs (#4622) 2026-06-03 13:15:11 -05:00
GabiandGitHub a24193ce18 Update tweaks.json (#4564) 2026-06-03 13:14:20 -05:00
PChaicotandGitHub 8f919be14b Add Playnite to applications.json (#4588) 2026-06-03 13:13:12 -05:00
GabiandGitHub ad5d103df9 Cleanup .gitignore (#4563)
* Update .gitignore

* Update .gitignore

* Update .gitignore

* Update .gitignore

* Update .gitignore
2026-06-03 13:11:49 -05:00
Chris TitusandGitHub b5160d9e24 chore: Update generated dev docs (#4621) 2026-06-03 13:09:04 -05:00
GabiandGitHub 614eb949db Remove OneDrive left overs (#4561)
* Update tweaks.json

* Update tweaks.json
2026-06-03 13:08:18 -05:00
GabiandGitHub d1edd5b2ba Delete overrides directory (#4554) 2026-06-03 13:07:34 -05:00
GabiandGitHub 333937d2fa Made Compile.ps1 not load the script into memory and use -Raw (#4536)
* Made Compile.ps1 not load the script into memory

* Update Compile.ps1

* Update Compile.ps1

* Update Compile.ps1
2026-06-03 13:04:04 -05:00
Chris TitusandGitHub 3ca87648b4 chore: Update generated dev docs (#4619) 2026-06-03 13:01:02 -05:00
Jarosław Drzewiecki de OgańczykandGitHub 4894a545f0 Fixed Json for Scrollbars Always Visible (#4528) 2026-06-03 13:00:22 -05:00
Jarosław Drzewiecki de OgańczykandGitHub 9f55bced01 Added Delivery Optimization tweak to Standard-Advanced Tweaks preset (#4548)
* Added Delivery Optimization tweak to Standard Tweaks preset

* Added Delivery Optimization tweak to Standard Tweaks preset and Advanced preset to match Gabi PR
2026-06-03 12:59:05 -05:00
Chris TitusandGitHub 56e0541113 chore: Update generated dev docs (#4618) 2026-06-03 12:59:00 -05:00
Jarosław Drzewiecki de OgańczykandGitHub 7607b92e21 Added Delivery Optimization disable tweak (#4527) 2026-06-03 12:58:23 -05:00
Sean (ANGRYxScotsman)andGitHub 153900a77b fix pics not loading in app page (#4614) 2026-06-03 12:57:33 -05:00
GabiandGitHub 691224f465 Rework README.md (#4586)
* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md
2026-06-03 12:56:58 -05:00
Chris TitusandGitHub 893dca4055 chore: Update generated dev docs (#4579) 2026-05-28 13:14:28 -05:00
GabiandGitHub 2ebc9bd6c4 fix WPFTweaksWindowsAI (#4578) 2026-05-28 13:13:54 -05:00
GabiandGitHub 076ef02b2c Rework contributing.md (#4567)
* Delete docs/assets/images/Complie.png

* Delete docs/assets/images/Commit-GHD.png

* Delete docs/assets/images/Discard-GHD.png

* Delete docs/assets/images/Push-Commit.png

* Delete docs/assets/images/Fork-Button-Dark.png

* Delete docs/assets/images/Fork-Button-Light.png

* Update CONTRIBUTING.md

* Update CONTRIBUTING.md

* Update CONTRIBUTING.md

* Update CONTRIBUTING.md

* Update CONTRIBUTING.md

* Update CONTRIBUTING.md
2026-05-28 12:32:27 -05:00
164 changed files with 1173 additions and 1240 deletions
+1 -1
View File
@@ -2,7 +2,7 @@
## Our Pledge
We as members, contributors, and leaders pledge to make participation in our
We, as members, contributors, and leaders, pledge to make participation in our
community a harassment-free experience for everyone, regardless of age, body
size, visible or invisible disability, ethnicity, sex characteristics, gender
identity and expression, level of experience, education, socio-economic status,
+117 -87
View File
@@ -1,119 +1,149 @@
# How to Contribute?
## Contributing Code
## Testing
### Before You Start
* Test the latest changes to WinUtil by running the pre-release and reporting issues you are encountering to help us continually improve WinUtil!
- Keep each pull request focused on a single feature or fix.
- Avoid unnecessary formatting changes or large unrelated edits.
- Document what changed and why in your PR description.
#### **Run the latest pre-release**
```ps1
irm https://christitus.com/windev | iex
```
---
!!! bug "Keep in mind"
## Basic Git Workflow
This is a pre-release and should be treated as such. It exists for developers to test the utility and report or fix bugs before they get added to the stable release. Don't use it in production!
### 1. Fork the Repository
## Issues
Go to the ChrisTitusTech/winutil repository on GitHub and click the Fork button in the top right corner.
* If you encounter any challenges or problems with the script, I kindly request that you submit them via the "Issues" tab on the GitHub repository. By filling out the provided template, you can provide specific details about the issue, allowing me (and others in the community) to promptly address any bugs or consider feature requests.
<img width="171" height="50" alt="{650A4723-F38A-44A4-9820-D232BC87C8A0}" src="https://github.com/user-attachments/assets/a214f27c-2fee-444a-920f-d87b14f5896f" />
## Contribute Code
---
* 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.
### 2. Clone Your Fork
* If you're doing code changes, then you can submit a PR to the `main` branch.
!!! warning "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!
Do not open a pull request that adds support for other languages to WinUtil for now, until we decide how we want to move forward with language support.
* When creating pull requests, it is essential to thoroughly document all changes made. This includes, but is not limited to, documenting any additions made to the `tweaks` section and corresponding `undo tweak`, so users are able to remove the newly added tweaks if necessary, and comprehensive documentation is required for all code changes. Document your changes and briefly explain why you made your changes in your Pull Request Description. Failure to adhere to this format may result in the denial of the pull request. Additionally, any code lacking sufficient documentation may also be denied.
* By following these guidelines, we can maintain a high standard of quality and ensure that the codebase remains organized and well-documented.
!!! note
When creating a function, please include "WPF" or "WinUtil" in the file name so it can be loaded into the runspace.
## Walk through
* This is a guide for beginners. If you are still having issues, look at the following official GitHub documentation:
* [Commit through WEB](https://docs.github.com/en/pull-requests/committing-changes-to-your-project/creating-and-editing-commits/about-commits)
* [Commit through GitHub Desktop](https://docs.github.com/en/desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project-in-github-desktop#about-commits)
* [Create a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request)
### Overview
``` mermaid
%%{init: {"flowchart": {"curve": "cardinal"}} }%%
graph TD
  A[Fork Project] --> B[Clone Repository];
  B --> C[Create New Branch];
  C --> D[Make Changes];
  D --> G[Test Changes];
  G --> H{Tests Passed?};
  H -->|Yes| E[Commit Changes];
  H -->|No| J[Fix Issues];
  J --> G;
  E --> F[Push Branch];
  F --> K[Create Pull Request];
  K --> L[Fill out PR template];
classDef default stroke:#333,stroke-width:4px,font-size:12pt;
```powershell
git clone https://github.com/YOUR_USERNAME/winutil.git
cd winutil
```
!!! info
This is a diagram to guide you through the process. It may vary depending on the type of change you're making.
---
### Fork the Repo
* Fork the WinUtil Repository [here](https://github.com/ChrisTitusTech/winutil) to create a copy that will be available in your repository list.
### 3. Create a Branch
![Fork Image](/docs/assets/images/Fork-Button-Dark.png#gh-dark-mode-only)
Never work directly on `main`.
![Fork Image](/docs/assets/images/Fork-Button-Light.png#only-light#gh-light-mode-only)
Create a branch related to your change:
### Clone the Fork
!!! tip
```powershell
git checkout -b feature-name
```
While you can make your changes directly through the Web, we recommend cloning the repo to your device using the application GitHub Desktop (available in WinUtil) to test your fork easily.
Example:
* Install GitHub Desktop if it is not already installed.
* Log in using the same GitHub account you used to fork WinUtil.
* Choose the fork under "Your Repositories" and press "clone {repo name}"
* Create a new branch and name it something relatable to your changes.
```powershell
git checkout -b add-firefox-tweak
```
* Now you can modify WinUtil to your liking using your preferred text editor.
---
### 4. Edit the Code
### Testing your changes
Open the project in your preferred text editor and make your changes.
* To test to see if your changes work as intended, run the following commands in a PowerShell terminal as admin:
Keep changes small and focused.
* Change the directory where you are running the commands to the forked project.
* `cd {path to the folder with the compile.ps1}`
* Run the following command to compile and run WinUtil:
* `.\Compile.ps1 -run`
---
![Compile](/docs/assets/images/Complie.png)
### 5. Test Your Changes
* After seeing that your changes work properly, feel free to commit the changes to the repository and make a PR. For help on that, follow the documentation below.
Open Powershell as Administrator.
### Committing the changes
* Before committing your changes, please discard changes made to the `winutil.ps1` file, like the following:
Go to the project folder:
![Push Commit Image](/docs/assets/images/Discard-GHD.png)
```powershell
cd path\to\winutil
```
* Now, commit your changes once you are happy with the result.
Run:
![Commit Image](/docs/assets/images/Commit-GHD.png)
```powershell
.\Compile.ps1 -Run
```
* Push the changes to upload them to your fork on github.com.
Verify:
![Push Commit Image](/docs/assets/images/Push-Commit.png)
- WinUtil launches correctly
- Your feature works
- Nothing else breaks
### 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 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.
If something fails, fix it before committing.
---
### 6. Review Your Changes
Check what changed:
```powershell
git status
```
Review the diff:
```powershell
git diff
```
Make sure you did not accidentally modify unrelated files.
---
### 7. Commit Your Changes
Stage files:
```powershell
git add .
```
Commit them:
```powershell
git commit -m "Add feature description"
```
Example:
```powershell
git commit -m "Add Firefox package tweak"
```
---
### 8. Push Your Branch
```powershell
git push origin branch-name
```
Example:
```powershell
git push origin add-firefox-tweak
```
---
### 9. Open a Pull Request
Go to your fork on GitHub.
GitHub will show a button to create a pull request.
<img width="1009" height="71" alt="{C8C6A3CC-79D4-44FD-A54C-4C5717F12730}" src="https://github.com/user-attachments/assets/0419d193-d4e7-47c0-87cf-b986742201a0" />
Before submitting:
- Explain what changed
- Explain why you changed it
- Make sure unrelated files are not included
Once submitted, maintainers will review your PR.
@@ -0,0 +1,28 @@
title: "[App Suggestion] "
body:
- type: input
attributes:
label: "Application Link"
description: "Provide a link where this application can downloaded officially"
- type: checkboxes
attributes:
label: "Rules Checklist"
description: "You should agree with next rules"
options:
- label: "This application is popular enough, so is not considered as niche"
required: true
- label: "This application is not considered bloatware"
required: true
- label: "This application is free to access"
required: true
- label: "This application should be included on majority of fresh installed systems"
required: true
- label: "This application is present on WinGet (check winstall.app or do 'winget search your-app' in terminal)"
required: true
- type: checkboxes
attributes:
label: "Check for denied applications"
options:
- label: "Yes, I checked PRs, issues and discussions for existing suggestions and their result"
required: true
+1 -1
View File
@@ -21,7 +21,7 @@ body:
- type: dropdown
id: affected_part
attributes:
label: What part of Winutil are you having issues with?
label: What part of WinUtil are you having issues with?
options:
- Program Install Tab
- Tweaks Tab
+4 -1
View File
@@ -2,4 +2,7 @@ blank_issues_enabled: false
contact_links:
- name: 💻 Community Discord
url: https://discord.gg/RUbZUZyByQ
about: Join our Community Discord server to chat with other users in the Winutil community.
about: Join our Community Discord server to chat with other users in the WinUtil community.
- name: Suggest an application
url: https://github.com/ChrisTitusTech/winutil/discussions/new?category=app-suggestion
about: If you want to suggest an application to be added, create a discussion with given template
+1 -1
View File
@@ -11,7 +11,7 @@ body:
## ⚠️ **IMPORTANT**
- 🛠️ **Supported environments only:** We only support Windows 11.
- 💡 For general questions, use the [Discussions section](https://github.com/Christitustech/winutil/discussions) or join our Community-driven [Discord Server](https://discord.gg/RUbZUZyByQ).
- 💡 For general questions, use the [Discussions section](https://github.com/ChrisTitusTech/winutil/discussions) or join our Community-driven [Discord Server](https://discord.gg/RUbZUZyByQ).
- type: textarea
id: proposed_solution
+1
View File
@@ -5,6 +5,7 @@
- [ ] New feature
- [ ] Bug fix
- [ ] Documentation update
- [ ] Refactor
- [ ] UI/UX improvement
<!-- This automatically adds labels to your PR based on the selections above. -->
+105
View File
@@ -0,0 +1,105 @@
# Chris Titus Tech's Windows Utility
[![Version](https://img.shields.io/github/v/release/ChrisTitusTech/winutil?color=%230567ff&label=Latest%20Release&style=for-the-badge)](https://github.com/ChrisTitusTech/winutil/releases/latest)
![GitHub Downloads (specific asset, all releases)](https://img.shields.io/github/downloads/ChrisTitusTech/winutil/winutil.ps1?label=Total%20Downloads&style=for-the-badge)
[![](https://dcbadge.limes.pink/api/server/https://discord.gg/RUbZUZyByQ?theme=default-inverted&style=for-the-badge)](https://discord.gg/RUbZUZyByQ)
[![Static Badge](https://img.shields.io/badge/Documentation-_?style=for-the-badge&logo=bookstack&color=grey)](https://winutil.christitus.com/)
Questa utility è una raccolta di attività Windows che eseguo personalmente su ogni sistema che utilizzo. È progettata per snellire le *installazioni*, rimuovere i componenti superflui tramite *ottimizzazioni*, risolvere problemi tramite la *configurazione*, e riparare *aggiornamenti* di Windows. Sono estremamente selettivo riguardo ai contributi per mantenere questo progetto pulito ed efficiente.
![screen-install](/docs/assets/images/Title-Screen.png)
## 💡 Come usarlo
Winutil deve essere eseguito con privilegi di amministratore, poiché apporta modifiche all'intero sistema. Per farlo, avvia PowerShell come amministratore. Ecco alcuni modi per procedere:
1. **Metodo del menu di Start:**
- Fai clic con il tasto destro sul menu Start.
- Scegli "Windows PowerShell (esegui come Amministratore)" (per Windows 10) o "Terminale (esegui come Amministratore)" (per Windows 11).
2. **Metodo tramite ricerca:**
- Premi il tasto Windows.
- Digita "PowerShell" o "Terminal" (per Windows 11).
- Premi `Ctrl + Shift + Invio` oppure fai clic con il tasto destro e seleziona "Esegui come amministratore" per avviarlo con privilegi elevati.
### Comando di avvio
#### Branch stabile (Consigliato)
```ps1
irm "https://christitus.com/win" | iex
```
#### Branch Sviluppatore
```ps1
irm "https://christitus.com/windev" | iex
```
### Automazione
Winutil supporta anche preset predefiniti che applicano automaticamente configurazioni comuni:
- `Standard`
- `Minimal`
- `Advanced`
Esempio:
```powershell
& ([ScriptBlock]::Create((irm "https://christitus.com/win"))) -Preset Standard
```
Per vedere esattamente cosa fa ogni preset, consulta:
https://github.com/ChrisTitusTech/winutil/blob/main/config/preset.json
In caso di problemi, consulta i [Problemi noti](https://winutil.christitus.com/knownissues/) o [Apri una segnalazione](https://github.com/ChrisTitusTech/winutil/issues)
## 🎓 Documentazione
### [Documentazione ufficiale di WinUtil](https://winutil.christitus.com/)
### [Tutorial su YouTube](https://www.youtube.com/watch?v=6UQZ5oQg8XA)
### [Articolo su ChrisTitus.com](https://christitus.com/windows-tool/)
## 🛠️ Build & Sviluppo
> [!NOTE]
> Winutil è uno script piuttosto esteso, per questo è suddiviso in più file che vengono combinati in un unico file `.ps1` tramite un compilatore personalizzato. Questo rende la manutenzione del progetto molto più semplice.
Ottieni una copia del codice sorgente. Puoi farlo tramite l'interfaccia di GitHub (**Code** > **Download ZIP**), oppure clonando (scaricando) la repo tramite git.
Se git è installato, esegui i seguenti comandi in una finestra PowerShell per clonare e accedere alla directory del progetto:
```ps1
git clone --depth 1 "https://github.com/ChrisTitusTech/winutil.git"
cd winutil
```
Per compilare il progetto, esegui lo script di compilazione in una finestra PowerShell (i permessi di amministratore NON sono richiesti):
```ps1
.\Compile.ps1
```
Troverai un nuovo file chiamato `winutil.ps1`, creato dallo script `Compile.ps1`. Ora puoi eseguirlo come amministratore e apparirà una nuova finestra. Goditi la tua versione compilata di WinUtil :)
> [!TIP]
> Per ulteriori informazioni sull'utilizzo di WinUtil e su come contribuire allo sviluppo, ti invitiamo a leggere le [Linee guida per i contributi](https://winutil.christitus.com/contributing/). Se non sai da dove iniziare o hai domande, puoi chiedere sul nostro [Server Discord della community](https://discord.gg/RUbZUZyByQ); i membri attivi del progetto risponderanno appena possibile.
## 💖 Supporto
- Per sostenere il progetto moralmente e mentalmente, non dimenticare di lasciare una ⭐️!
- Wrapper EXE a 10$ su https://www.cttstore.com/windows-toolbox
## 💖 Sponsor
Questi sono gli sponsor che aiutano a mantenere vivo il progetto con contributi mensili.
<!-- sponsors --><a href="https://github.com/dwelfusius"><img src="https:&#x2F;&#x2F;github.com&#x2F;dwelfusius.png" width="60px" alt="Avatar utente: " /></a><a href="https://github.com/mews-se"><img src="https:&#x2F;&#x2F;github.com&#x2F;mews-se.png" width="60px" alt="Avatar utente: Martin Stockzell" /></a><a href="https://github.com/jdiegmueller"><img src="https:&#x2F;&#x2F;github.com&#x2F;jdiegmueller.png" width="60px" alt="Avatar utente: Jason A. Diegmueller" /></a><a href="https://github.com/robertsandrock"><img src="https:&#x2F;&#x2F;github.com&#x2F;robertsandrock.png" width="60px" alt="Avatar utente: RMS" /></a><a href="https://github.com/paulsheets"><img src="https:&#x2F;&#x2F;github.com&#x2F;paulsheets.png" width="60px" alt="Avatar utente: Paul" /></a><a href="https://github.com/djones369"><img src="https:&#x2F;&#x2F;github.com&#x2F;djones369.png" width="60px" alt="Avatar utente: Dave J (WhamGeek)" /></a><a href="https://github.com/anthonymendez"><img src="https:&#x2F;&#x2F;github.com&#x2F;anthonymendez.png" width="60px" alt="Avatar utente: Anthony Mendez" /></a><a href="https://github.com/FatBastard0"><img src="https:&#x2F;&#x2F;github.com&#x2F;FatBastard0.png" width="60px" alt="Avatar utente: " /></a><a href="https://github.com/DursleyGuy"><img src="https:&#x2F;&#x2F;github.com&#x2F;DursleyGuy.png" width="60px" alt="Avatar utente: DursleyGuy" /></a><a href="https://github.com/DwayneTheRockLobster1"><img src="https:&#x2F;&#x2F;github.com&#x2F;DwayneTheRockLobster1.png" width="60px" alt="Avatar utente: " /></a><a href="https://github.com/KieraKujisawa"><img src="https:&#x2F;&#x2F;github.com&#x2F;KieraKujisawa.png" width="60px" alt="Avatar utente: Kiera Meredith" /></a><a href="https://github.com/andrewpayne68"><img src="https:&#x2F;&#x2F;github.com&#x2F;andrewpayne68.png" width="60px" alt="Avatar utente: Andrew P" /></a><!-- sponsors -->
## 🏅 Grazie a tutti i collaboratori
Un ringraziamento speciale per aver dedicato il vostro tempo ad aiutare Winutil a crescere. Grazie mille! Continuate così 🍻.
[![Contributori](https://contrib.rocks/image?repo=ChrisTitusTech/winutil)](https://github.com/ChrisTitusTech/winutil/graphs/contributors)
## 📊 Statistiche GitHub
![Alt](https://repobeats.axiom.co/api/embed/aad37eec9114c507f109d34ff8d38a59adc9503f.svg "Immagine analisi Repobeats")
+4 -2
View File
@@ -1,5 +1,7 @@
# Security Policy
If you find a security issue please make post it in the issues tab. If you think it should be private you can email me at contact@christitus.com.
If you find a security issue, please post it in the Issues tab. If you think it should be private, you can email me at contact@christitus.com.
For immediate response check out our discord server @ [![](https://dcbadge.limes.pink/api/server/https://discord.gg/RUbZUZyByQ?theme=default-inverted&style=for-the-badge)](https://discord.gg/RUbZUZyByQ)
For immediate response check out our Discord server:
[![](https://dcbadge.limes.pink/api/server/https://discord.gg/RUbZUZyByQ?theme=default-inverted&style=for-the-badge)](https://discord.gg/RUbZUZyByQ)
+4 -4
View File
@@ -1,18 +1,18 @@
tag-prefix: ''
categories:
- title: '🚀 Features'
- title: 'Features'
labels:
- 'feature'
- 'enhancement'
- 'new feature'
- title: '🐛 Bug Fixes'
- title: 'Bug Fixes'
labels:
- 'hotfix'
- 'bugfix'
- 'bug'
- title: '📚 Documentation'
- title: 'Documentation'
label: 'documentation'
- title: '🎨 UI/UX Improvements'
- title: 'UI/UX Improvements'
label: 'ui update'
change-template: '- $TITLE @$AUTHOR (#$NUMBER)'
template: |
+1 -1
View File
@@ -15,7 +15,7 @@ jobs:
contents: write
steps:
- name: Checkout
uses: actions/checkout@v6
uses: actions/checkout@v7
- name: Auto-approve PR
if: github.event.pull_request.user.login == 'github-actions[bot]'
@@ -9,7 +9,7 @@ jobs:
runs-on: ubuntu-latest
steps:
- name: Checkout repository
uses: actions/checkout@v6
uses: actions/checkout@v7
- name: Check if PR was merged
if: github.event.pull_request.merged == true
+3 -3
View File
@@ -17,11 +17,11 @@ jobs:
uses: actions/stale@v10
with:
# A list of labels to reference when looking through issues,
# and only when one (or even more) of these labels are found..
# and only when one (or even more) of these labels is found.
# then skip this issue, and never try to stale and/or close it.
exempt-issue-labels: "Keep Issue Open"
# Split it into two weeks, after one week the issue will be marked as stale,
# after another week have pasted without any update.. the issue will then be closed.
# Split it into two weeks, after one week, the issue will be marked as stale,
# after another week have passed without any update, the issue will then be closed.
days-before-issue-stale: 90
days-before-issue-close: 365
# NEVER mark PRs as Stale or Close + this workflow should never have write permissions on PRs, EVER!
+2 -2
View File
@@ -13,9 +13,9 @@ jobs:
runs-on: windows-latest
steps:
- name: Checkout Sources
uses: actions/checkout@v6
uses: actions/checkout@v7
- name: Compile and Syntaxcheck winutil.ps1
- name: Compile and Syntax check winutil.ps1
shell: pwsh
run: |
Set-ExecutionPolicy Bypass -Scope Process -Force; ./Compile.ps1
+1 -1
View File
@@ -39,7 +39,7 @@ jobs:
wget -O ${{ runner.temp }}/hugo.deb https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-amd64.deb \
&& sudo dpkg -i ${{ runner.temp }}/hugo.deb
- name: Checkout
uses: actions/checkout@v6
uses: actions/checkout@v7
with:
submodules: recursive
fetch-depth: 0
+1 -1
View File
@@ -17,7 +17,7 @@ jobs:
CERTIFICATE_BASE64: ${{ secrets.CERTIFICATE_BASE64 }}
steps:
- name: Checkout Repository
uses: actions/checkout@v6
uses: actions/checkout@v7
- name: Generate Dev Docs and Update JSON Links
shell: pwsh
+1 -1
View File
@@ -11,7 +11,7 @@ jobs:
steps:
- name: Checkout code
uses: actions/checkout@v6
uses: actions/checkout@v7
- name: Check if winutil.ps1 exists
id: check_existence
+1 -1
View File
@@ -12,7 +12,7 @@ jobs:
if: (github.event_name == 'schedule' && github.repository == 'ChrisTitusTech/winutil') || (github.event_name != 'schedule')
steps:
- name: Checkout 🛎️
uses: actions/checkout@v6
uses: actions/checkout@v7
with:
persist-credentials: false
+2 -2
View File
@@ -8,7 +8,7 @@ jobs:
name: PS Script Analyzer
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v6
- uses: actions/checkout@v7
- name: lint
uses: devblackops/github-action-psscriptanalyzer@master
with:
@@ -22,7 +22,7 @@ jobs:
steps:
- name: Checkout code
uses: actions/checkout@v6
uses: actions/checkout@v7
- name: Install Pester
run: |
+8 -21
View File
@@ -1,32 +1,19 @@
# Libraries
# winutil
System.Management.Automation.dll
Microsoft.PowerShell.ConsoleHost.dll
# Configuration folder
.vscode/
.idea/
.vs/
winutil.exe.config
winutil.ps1
binary/
# OS Specific
# general software/os specific
desktop.ini
.DS_Store
# Ignore Generated XAML Files
xaml/inputApp.xaml
xaml/inputFeatures.xaml
xaml/inputTweaks.xaml
.vscode/
.idea/
# Executables and Configs
pester.ps1
Microsoft.UI.Xaml*
winutil.ps1
*.psd*
# winutil-bin
winutil.exe.config
binary/
# Hugo Files
# hugo files
docs/public/
docs/.hugo_build.lock
docs/resources/
+10 -16
View File
@@ -2,23 +2,18 @@ param (
[switch]$Run
)
$OFS = "`r`n" # Makes it so we dont need to add -Raw to every Get-Content command
$OFS = "`r`n"
# Variable to sync between runspaces
$sync = [Hashtable]::Synchronized(@{})
$sync.configs = @{}
# Create the script in memory.
$script = [System.Collections.Generic.List[string]]::new()
$script = (Get-Content -Path scripts\start.ps1) -replace '#{replaceme}', (Get-Date -Format 'yy.MM.dd')
$script.Add(
((Get-Content -Path scripts\start.ps1) -replace '#{replaceme}', (Get-Date -Format 'yy.MM.dd'))
)
$script.Add((Get-ChildItem -Path functions -Recurse -File | Get-Content))
$script += Get-ChildItem -Path functions -Recurse -File | Get-Content -Raw
Get-ChildItem config | ForEach-Object {
$obj = Get-Content -Path $_.FullName | ConvertFrom-Json
$obj = Get-Content -Path $_.FullName -Raw | ConvertFrom-Json
if ($_.Name -eq "applications.json") {
$fixed = [ordered]@{}
@@ -31,17 +26,16 @@ Get-ChildItem config | ForEach-Object {
$json = $obj | ConvertTo-Json -Depth 10
$sync.configs[$_.BaseName] = $obj
$script.Add("`$sync.configs.$($_.BaseName) = @'`r`n$json`r`n'@ | ConvertFrom-Json")
$script += "`$sync.configs.$($_.BaseName) = @'`r`n$json`r`n'@ | ConvertFrom-Json"
}
# Read the entire XAML file as a single string, preserving line breaks
$xaml = Get-Content -Path xaml\inputXML.xaml
$script.Add('$inputXML = @''' + "`n" + $xaml + "`n" + '''@')
$xaml = Get-Content -Path xaml\inputXML.xaml -Raw
$script += "`$inputXML = @'`r`n$xaml`r`n'@"
$autounattendXml = Get-Content -Path tools\autounattend.xml
$script.Add("`$WinUtilAutounattendXml = @'`r`n$autounattendXml`r`n'@")
$autounattendXml = Get-Content -Path tools\autounattend.xml -Raw
$script += "`$WinUtilAutounattendXml = @'`r`n$autounattendXml`r`n'@"
$script.Add((Get-Content -Path scripts\main.ps1))
$script += Get-Content -Path scripts\main.ps1 -Raw
Set-Content -Path winutil.ps1 -Value $script
+48 -65
View File
@@ -1,105 +1,88 @@
# Chris Titus Tech's Windows Utility
[![Version](https://img.shields.io/github/v/release/ChrisTitusTech/winutil?color=%230567ff&label=Latest%20Release&style=for-the-badge)](https://github.com/ChrisTitusTech/winutil/releases/latest)
![GitHub Downloads (specific asset, all releases)](https://img.shields.io/github/downloads/ChrisTitusTech/winutil/winutil.ps1?label=Total%20Downloads&style=for-the-badge)
[![](https://dcbadge.limes.pink/api/server/https://discord.gg/RUbZUZyByQ?theme=default-inverted&style=for-the-badge)](https://discord.gg/RUbZUZyByQ)
[![Static Badge](https://img.shields.io/badge/Documentation-_?style=for-the-badge&logo=bookstack&color=grey)](https://winutil.christitus.com/)
![Downloads](https://img.shields.io/github/downloads/ChrisTitusTech/winutil/winutil.ps1?label=Total%20Downloads&style=for-the-badge)
[![Discord](https://dcbadge.limes.pink/api/server/https://discord.gg/RUbZUZyByQ?theme=default-inverted&style=for-the-badge)](https://discord.gg/RUbZUZyByQ)
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.
A curated compilation of Windows system tasks streamline **installs**, debloat with **tweaks**, troubleshoot with **config**, and configure **Windows updates**. Run it fresh on every new Windows install.
![screen-install](/docs/assets/images/Title-Screen.png)
![Title Screen](/docs/assets/images/Title-Screen.png)
## 💡 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:
## Quick Start
1. **Start menu Method:**
- Right-click on the start menu.
- Choose "Windows PowerShell (Admin)" (for Windows 10) or "Terminal (Admin)" (for Windows 11).
> **WinUtil must be run as Administrator** Because it performs system-wide changes.
2. **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)
Open PowerShell or Terminal as admin, then run:
**Stable Branch (recommended)**
```ps1
irm "https://christitus.com/win" | iex
```
#### Dev Branch
```ps1
irm "https://christitus.com/windev" | iex
irm https://christitus.com/win | iex
```
### Automation
**Development Branch**
```ps1
irm https://christitus.com/windev | iex
```
Winutil also supports predefined presets that apply common configurations automatically:
### How to open an admin terminal
- `Standard`
- `Minimal`
- `Advanced`
- **Start menu:** Right-click Start → *Windows PowerShell (Admin)* or *Terminal (Admin)*
- **Search:** Press the `Windows key`, and type `PowerShell` or `Terminal`, then `Ctrl + Shift + Enter`
Example:
---
## Automation / Presets
Apply a predefined configuration without manual selection:
```powershell
& ([ScriptBlock]::Create((irm "https://christitus.com/win"))) -Preset Standard
& ([ScriptBlock]::Create((irm https://christitus.com/win))) -Preset Standard
```
| Preset | Description |
|--------|-------------|
| `Standard` | Balanced defaults for most users |
| `Minimal` | Minimal changes to suit every user |
| `Advanced` | Deep tweaks for power users |
To view exactly what each preset does, see:
https://github.com/ChrisTitusTech/winutil/blob/main/config/preset.json
If you have Issues, refer to [Known Issues](https://winutil.christitus.com/knownissues/) or [Create Issue](https://github.com/ChrisTitusTech/winutil/issues)
---
## 🎓 Documentation
## Build & Develop
### [WinUtil Official Documentation](https://winutil.christitus.com/)
See https://github.com/ChrisTitusTech/winutil/blob/main/.github/CONTRIBUTING.md
### [YouTube Tutorial](https://www.youtube.com/watch?v=6UQZ5oQg8XA)
---
### [ChrisTitus.com Article](https://christitus.com/windows-tool/)
## Resources
## 🛠️ Build & Develop
- [Official Documentation](https://winutil.christitus.com/)
- [YouTube Tutorial](https://www.youtube.com/watch?v=6UQZ5oQg8XA)
- [ChrisTitus.com Article](https://christitus.com/windows-tool/)
- [Known Issues](https://winutil.christitus.com/knownissues/)
- [Report an Issue](https://github.com/ChrisTitusTech/winutil/issues)
> [!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.
## Support
If git is installed, run the following commands under a PowerShell window to clone and move into the project's directory:
```ps1
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):
```ps1
.\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](https://winutil.christitus.com/contributing/). If you don't know where to start, or have questions, you can ask over on our [Discord Community Server](https://discord.gg/RUbZUZyByQ), and active project members will answer when they can.
## 💖 Support
- To morally and mentally support the project, make sure to leave a ⭐️!
- Leave a ⭐ to show support!
- EXE Wrapper for $10 @ https://www.cttstore.com/windows-toolbox
## 💖 Sponsors
## Sponsors
These are the sponsors that help keep this project alive with monthly contributions.
<!-- sponsors --><a href="https://github.com/dwelfusius"><img src="https:&#x2F;&#x2F;github.com&#x2F;dwelfusius.png" width="60px" alt="User avatar: " /></a><a href="https://github.com/mews-se"><img src="https:&#x2F;&#x2F;github.com&#x2F;mews-se.png" width="60px" alt="User avatar: Martin Stockzell" /></a><a href="https://github.com/jdiegmueller"><img src="https:&#x2F;&#x2F;github.com&#x2F;jdiegmueller.png" width="60px" alt="User avatar: Jason A. Diegmueller" /></a><a href="https://github.com/robertsandrock"><img src="https:&#x2F;&#x2F;github.com&#x2F;robertsandrock.png" width="60px" alt="User avatar: RMS" /></a><a href="https://github.com/paulsheets"><img src="https:&#x2F;&#x2F;github.com&#x2F;paulsheets.png" width="60px" alt="User avatar: Paul" /></a><a href="https://github.com/djones369"><img src="https:&#x2F;&#x2F;github.com&#x2F;djones369.png" width="60px" alt="User avatar: Dave J (WhamGeek)" /></a><a href="https://github.com/anthonymendez"><img src="https:&#x2F;&#x2F;github.com&#x2F;anthonymendez.png" width="60px" alt="User avatar: Anthony Mendez" /></a><a href="https://github.com/FatBastard0"><img src="https:&#x2F;&#x2F;github.com&#x2F;FatBastard0.png" width="60px" alt="User avatar: " /></a><a href="https://github.com/DursleyGuy"><img src="https:&#x2F;&#x2F;github.com&#x2F;DursleyGuy.png" width="60px" alt="User avatar: DursleyGuy" /></a><a href="https://github.com/DwayneTheRockLobster1"><img src="https:&#x2F;&#x2F;github.com&#x2F;DwayneTheRockLobster1.png" width="60px" alt="User avatar: " /></a><a href="https://github.com/KieraKujisawa"><img src="https:&#x2F;&#x2F;github.com&#x2F;KieraKujisawa.png" width="60px" alt="User avatar: Kiera Meredith" /></a><a href="https://github.com/andrewpayne68"><img src="https:&#x2F;&#x2F;github.com&#x2F;andrewpayne68.png" width="60px" alt="User avatar: Andrew P" /></a><a href="https://github.com/ameaninglessname"><img src="https:&#x2F;&#x2F;github.com&#x2F;ameaninglessname.png" width="60px" alt="User avatar: CodingBot" /></a><!-- sponsors -->
<!-- sponsors --><a href="https://github.com/dwelfusius"><img src="https:&#x2F;&#x2F;github.com&#x2F;dwelfusius.png" width="60px" alt="User avatar: " /></a><a href="https://github.com/mews-se"><img src="https:&#x2F;&#x2F;github.com&#x2F;mews-se.png" width="60px" alt="User avatar: Martin Stockzell" /></a><a href="https://github.com/jdiegmueller"><img src="https:&#x2F;&#x2F;github.com&#x2F;jdiegmueller.png" width="60px" alt="User avatar: Jason A. Diegmueller" /></a><a href="https://github.com/robertsandrock"><img src="https:&#x2F;&#x2F;github.com&#x2F;robertsandrock.png" width="60px" alt="User avatar: RMS" /></a><a href="https://github.com/paulsheets"><img src="https:&#x2F;&#x2F;github.com&#x2F;paulsheets.png" width="60px" alt="User avatar: Paul" /></a><a href="https://github.com/djones369"><img src="https:&#x2F;&#x2F;github.com&#x2F;djones369.png" width="60px" alt="User avatar: Dave J (WhamGeek)" /></a><a href="https://github.com/anthonymendez"><img src="https:&#x2F;&#x2F;github.com&#x2F;anthonymendez.png" width="60px" alt="User avatar: Anthony Mendez" /></a><a href="https://github.com/FatBastard0"><img src="https:&#x2F;&#x2F;github.com&#x2F;FatBastard0.png" width="60px" alt="User avatar: " /></a><a href="https://github.com/DursleyGuy"><img src="https:&#x2F;&#x2F;github.com&#x2F;DursleyGuy.png" width="60px" alt="User avatar: DursleyGuy" /></a><a href="https://github.com/DwayneTheRockLobster1"><img src="https:&#x2F;&#x2F;github.com&#x2F;DwayneTheRockLobster1.png" width="60px" alt="User avatar: " /></a><a href="https://github.com/KieraKujisawa"><img src="https:&#x2F;&#x2F;github.com&#x2F;KieraKujisawa.png" width="60px" alt="User avatar: Kiera Meredith" /></a><a href="https://github.com/andrewpayne68"><img src="https:&#x2F;&#x2F;github.com&#x2F;andrewpayne68.png" width="60px" alt="User avatar: Andrew P" /></a><!-- sponsors -->
## 🏅 Thanks to all Contributors
Thanks a lot for spending your time helping Winutil grow. Thanks a lot! Keep rocking 🍻.
---
## Contributors
[![Contributors](https://contrib.rocks/image?repo=ChrisTitusTech/winutil)](https://github.com/ChrisTitusTech/winutil/graphs/contributors)
## 📊 GitHub Stats
![Alt](https://repobeats.axiom.co/api/embed/aad37eec9114c507f109d34ff8d38a59adc9503f.svg "Repobeats analytics image")
Thanks to everyone who has contributed time and effort to this project. Keep rocking 🍻
+63 -18
View File
@@ -545,7 +545,8 @@
"content": "IrfanView",
"description": "IrfanView is a lightweight, fast, and free image viewer and editor. Supports multiple formats, batch processing, and powerful plugins.",
"link": "https://irfanview.com/",
"winget": "IrfanSkiljan.IrfanView"
"winget": "IrfanSkiljan.IrfanView",
"foss": false
},
"itch": {
"category": "Games",
@@ -623,11 +624,20 @@
"category": "Utilities",
"choco": "jpegview",
"content": "JPEG View",
"description": "JPEGView is a lean, fast and highly configurable viewer/editor for JPEG, BMP, PNG, WEBP, TGA, GIF, JXL, HEIC, HEIF, AVIF and TIFF images with a minimal GUI.",
"description": "JPEGView is a lean, fast and highly configurable viewer/editor for JPEG, BMP, PNG, WEBP, TGA, GIF, JXL, HEIC, HEIF, AVIF, and TIFF images with a minimal GUI.",
"link": "https://github.com/sylikc/jpegview",
"winget": "sylikc.JPEGView",
"foss": true
},
"keepassxc": {
"category": "Utilities",
"choco": "keepassxc",
"content": "KeePassXC",
"description": "KeePassXC is a modern, secure, and open-source password manager that stores and manages your most sensitive information. You can run KeePassXC on Windows, macOS, and Linux systems. KeePassXC is for people with extremely high demands of secure personal data management. It saves many different types of information, such as usernames, passwords, URLs, attachments, and notes in an offline, encrypted file that can be stored in any location, including private and public cloud solutions. For easy identification and management, user-defined titles and icons can be specified for entries. In addition, entries are sorted into customizable groups. An integrated search function allows you to use advanced patterns to easily find any entry in your database. A customizable, fast, and easy-to-use password generator utility allows you to create passwords with any combination of characters or easy to remember passphrases.",
"link": "https://keepassxc.org/",
"winget": "KeePassXCTeam.KeePassXC",
"foss": true
},
"klite": {
"category": "Multimedia Tools",
"choco": "k-litecodecpack-standard",
@@ -646,6 +656,15 @@
"winget": "XBMCFoundation.Kodi",
"foss": true
},
"lightshot": {
"category": "Multimedia Tools",
"choco": "lightshot",
"content": "Lightshot",
"description": "The fastest way to take a customizable screenshot.",
"link": "https://app.prntscr.com/",
"winget": "Skillbrains.Lightshot",
"foss": false
},
"lazygit": {
"category": "Development",
"choco": "lazygit",
@@ -763,6 +782,15 @@
"winget": "MullvadVPN.MullvadBrowser",
"foss": true
},
"nomacs": {
"category": "Multimedia Tools",
"choco": "nomacs",
"content": "nomacs",
"description": "nomacs is a free, open-source image viewer, which supports multiple platforms. You can use it for viewing all common image formats, including RAW and .psd images.",
"link": "https://nomacs.org/",
"winget": "nomacs.nomacs",
"foss": true
},
"nanazip": {
"category": "Utilities",
"choco": "nanazip",
@@ -776,7 +804,7 @@
"category": "Selfhosted Tools",
"choco": "netbird",
"content": "NetBird",
"description": "NetBird is a open-source alternative comparable to TailScale that can be connected to a self-hosted server.",
"description": "NetBird is an open-source alternative comparable to TailScale that can be connected to a self-hosted server.",
"link": "https://netbird.io/",
"winget": "Netbird.Netbird",
"foss": true
@@ -835,6 +863,14 @@
"winget": "OpenJS.NodeJS.LTS",
"foss": true
},
"pnpm": {
"category": "Development",
"content": "pnpm",
"description": "pnpm is a fast and disk space efficient package manager for JavaScript and Node.js applications.",
"link": "https://pnpm.io/",
"winget": "pnpm.pnpm",
"foss": true
},
"notepadplus": {
"category": "Multimedia Tools",
"choco": "notepadplusplus",
@@ -892,8 +928,8 @@
"onlyoffice": {
"category": "Multimedia Tools",
"choco": "onlyoffice",
"content": "ONLYOffice Desktop",
"description": "ONLYOffice Desktop is a comprehensive office suite for document editing and collaboration.",
"content": "ONLYOFFICE Desktop",
"description": "ONLYOFFICE Desktop is a comprehensive office suite for document editing and collaboration.",
"link": "https://www.onlyoffice.com/desktop.aspx",
"winget": "ONLYOFFICE.DesktopEditors",
"foss": true
@@ -920,10 +956,10 @@
"category": "Pro Tools",
"choco": "openvpn-connect",
"content": "OpenVPN Connect",
"description": "OpenVPN Connect is an open-source VPN client that allows you to connect securely to a VPN server. It provides a secure and encrypted connection for protecting your online privacy.",
"description": "OpenVPN Connect is a VPN client that allows you to connect securely to a VPN server. It provides a secure and encrypted connection for protecting your online privacy.",
"link": "https://openvpn.net/",
"winget": "OpenVPNTechnologies.OpenVPNConnect",
"foss": true
"foss": false
},
"OVirtualBox": {
"category": "Utilities",
@@ -979,6 +1015,15 @@
"winget": "Giorgiotani.Peazip",
"foss": true
},
"playnite": {
"category": "Games",
"choco": "playnite",
"content": "Playnite",
"description": "Playnite is an open-source video game library manager with one simple goal: To provide a unified interface for all of your games.",
"link": "https://playnite.link/",
"winget": "Playnite.Playnite",
"foss": true
},
"plex": {
"category": "Selfhosted Tools",
"choco": "plexmediaserver",
@@ -1028,7 +1073,7 @@
"category": "Games",
"choco": "prismlauncher",
"content": "Prism Launcher",
"description": "Prism Launcher is an open-source Minecraft launcher with the ability to manage multiple instances, accounts and mods.",
"description": "Prism Launcher is an open-source Minecraft launcher with the ability to manage multiple instances, accounts, and mods.",
"link": "https://prismlauncher.org/",
"winget": "PrismLauncher.PrismLauncher",
"foss": true
@@ -1159,15 +1204,6 @@
"winget": "Rufus.Rufus",
"foss": true
},
"rustdesk": {
"category": "Pro Tools",
"choco": "rustdesk.portable",
"content": "RustDesk",
"description": "RustDesk is a free and open-source remote desktop application. It provides a secure way to connect to remote machines and access desktop environments.",
"link": "https://rustdesk.com/",
"winget": "RustDesk.RustDesk",
"foss": true
},
"rustlang": {
"category": "Development",
"choco": "rust",
@@ -1307,7 +1343,7 @@
"category": "Communications",
"choco": "teamspeak",
"content": "TeamSpeak 3",
"description": "TEAMSPEAK. YOUR TEAM. YOUR RULES. Use crystal clear sound to communicate with your team mates cross-platform with military-grade security, lag-free performance & unparalleled reliability and uptime.",
"description": "TEAMSPEAK. YOUR TEAM. YOUR RULES. Use crystal clear sound to communicate with your teammates cross-platform with military-grade security, lag-free performance & unparalleled reliability and uptime.",
"link": "https://www.teamspeak.com/",
"winget": "TeamSpeakSystems.TeamSpeakClient",
"foss": false
@@ -1411,6 +1447,15 @@
"winget": "Unity.UnityHub",
"foss": false
},
"everything": {
"category": "Utilities",
"choco": "everything",
"content": "VoidTools Everything",
"description": "Everything is a search engine that locates files and folders by filename instantly for Windows. Unlike Windows search Everything initially displays every file and folder on your computer (hence the name Everything). You type in a search filter to limit what files and folders are displayed.",
"link": "https://www.voidtools.com/",
"winget": "voidtools.Everything",
"foss": false
},
"vc2015_32": {
"category": "Microsoft Tools",
"choco": "vcredist2015",
+5 -6
View File
@@ -73,12 +73,11 @@
"Order": "5",
"Description": "Show the selected applications"
},
"WPFToggleFOSSHighlight": {
"Content": "Highlight FOSS",
"WPFInstallFOSSInfo": {
"Content": "Free and Open Source Software",
"Category": "__Selection",
"Type": "Toggle",
"Checked": true,
"Order": "6",
"Description": "Toggle the green highlight for FOSS applications"
"Type": "Note",
"Order": "0",
"Description": "Information about the #FOSS label on application entries"
}
}
-3
View File
@@ -29,9 +29,6 @@
"feature": [
"Microsoft-Hyper-V-All"
],
"InvokeScript": [
"bcdedit /set hypervisorschedulertype classic"
],
"link": "https://winutil.christitus.com/dev/features/features/hyperv"
},
"WPFFeatureslegacymedia": {
+4 -6
View File
@@ -4,16 +4,15 @@
"WPFTweaksConsumerFeatures",
"WPFTweaksDisableExplorerAutoDiscovery",
"WPFTweaksWPBT",
"WPFTweaksDVR",
"WPFTweaksDeBloat",
"WPFTweaksLocation",
"WPFTweaksServices",
"WPFTweaksTelemetry",
"WPFTweaksDeliveryOptimization",
"WPFTweaksDiskCleanup",
"WPFTweaksDeleteTempFiles",
"WPFTweaksEndTaskOnTaskbar",
"WPFTweaksRestorePoint",
"WPFTweaksPowershell7Tele"
"WPFTweaksRestorePoint"
],
"Minimal": [
"WPFTweaksConsumerFeatures",
@@ -27,11 +26,11 @@
"WPFTweaksConsumerFeatures",
"WPFTweaksDisableExplorerAutoDiscovery",
"WPFTweaksWPBT",
"WPFTweaksDVR",
"WPFTweaksDeBloat",
"WPFTweaksLocation",
"WPFTweaksServices",
"WPFTweaksTelemetry",
"WPFTweaksDeliveryOptimization",
"WPFTweaksDeleteTempFiles",
"WPFTweaksEndTaskOnTaskbar",
"WPFTweaksDisableStoreSearch",
@@ -39,7 +38,6 @@
"WPFTweaksWidget",
"WPFTweaksRemoveOneDrive",
"WPFTweaksWindowsAI",
"WPFTweaksRightClickMenu",
"WPFTweaksPowershell7Tele"
"WPFTweaksRightClickMenu"
]
}
+167 -170
View File
@@ -75,51 +75,23 @@
Write-Host \"Removed widgets\"
"
],
"UndoScript": [
"
Write-Host \"Restoring widgets AppxPackages\"
Add-AppxPackage -Register \"C:\\Program Files\\WindowsApps\\Microsoft.WidgetsPlatformRuntime*\\AppxManifest.xml\" -DisableDevelopmentMode
Add-AppxPackage -Register \"C:\\Program Files\\WindowsApps\\MicrosoftWindows.Client.WebExperience*\\AppxManifest.xml\" -DisableDevelopmentMode
Invoke-WinUtilExplorerUpdate -action \"restart\"
"
],
"link": "https://winutil.christitus.com/dev/tweaks/essential-tweaks/widget"
},
"WPFTweaksRevertStartMenu": {
"Content": "Start Menu Previous Layout - Enable",
"Description": "Bring back the old Start Menu layout from before the gradual rollout of the new one in 25H2.",
"Description": "Bring back the old Start Menu layout from before the gradual rollout of the new one in 25H2. On newer versions of Windows !!THIS TWEAK WILL NOT WORK!!",
"category": "Essential Tweaks",
"panel": "1",
"InvokeScript": [
"
Invoke-WebRequest https://github.com/thebookisclosed/ViVe/releases/download/v0.3.4/ViVeTool-v0.3.4-IntelAmd.zip -OutFile ViVeTool.zip
Expand-Archive ViVeTool.zip
Remove-Item ViVeTool.zip
Start-Process 'ViVeTool\\ViVeTool.exe' -ArgumentList '/disable /id:47205210' -Wait -NoNewWindow
Remove-Item ViVeTool -Recurse
Write-Host 'Old start menu reverted. Please restart your computer to take effect.'
"
],
"UndoScript": [
"
Invoke-WebRequest https://github.com/thebookisclosed/ViVe/releases/download/v0.3.4/ViVeTool-v0.3.4-IntelAmd.zip -OutFile ViVeTool.zip
Expand-Archive ViVeTool.zip
Remove-Item ViVeTool.zip
Start-Process 'ViVeTool\\ViVeTool.exe' -ArgumentList '/enable /id:47205210' -Wait -NoNewWindow
Remove-Item ViVeTool -Recurse
Write-Host 'New start menu reverted. Please restart your computer to take effect.'
"
"registry": [
{
"Path": "HKLM:\\SYSTEM\\ControlSet001\\Control\\FeatureManagement\\Overrides\\8\\3036241548",
"Name": "EnabledState",
"Value": "1",
"Type": "DWord",
"OriginalValue": "<RemoveEntry>"
}
],
"link": "https://winutil.christitus.com/dev/tweaks/essential-tweaks/revertstartmenu",
"link": "https://winutil.christitus.com/dev/tweaks/essential-tweaks/revertstartmenu"
},
"WPFTweaksDisableStoreSearch": {
@@ -458,7 +430,7 @@
},
"WPFTweaksConsumerFeatures": {
"Content": "ConsumerFeatures - Disable",
"Description": "Windows will not automatically install any games, third-party apps, or application links from the Windows Store for the signed-in user. Some default Apps will be inaccessible (eg. Phone Link).",
"Description": "Windows will not automatically install any games, third-party apps, or application links from the Windows Store for the signed-in user. Some default Apps will be inaccessible (e.g. Phone Link).",
"category": "Essential Tweaks",
"panel": "1",
"registry": [
@@ -574,6 +546,9 @@
# Disable (Windows Error Reporting Manager) Service
Set-Service -Name wermgr -StartupType Disabled
# Disable PowerShell 7 telemetry
[Environment]::SetEnvironmentVariable('POWERSHELL_TELEMETRY_OPTOUT', '1', 'Machine')
Remove-ItemProperty -Path \"HKCU:\\Software\\Microsoft\\Siuf\\Rules\" -Name PeriodInNanoSeconds
"
],
@@ -587,10 +562,29 @@
# Enable (Windows Error Reporting Manager) Service
Set-Service -Name wermgr -StartupType Automatic
# Enable PowerShell 7 telemetry
[Environment]::SetEnvironmentVariable('POWERSHELL_TELEMETRY_OPTOUT', '', 'Machine')
"
],
"link": "https://winutil.christitus.com/dev/tweaks/essential-tweaks/telemetry"
},
"WPFTweaksDeliveryOptimization": {
"Content": "Delivery Optimization - Disable",
"Description": "Stops Windows from using your bandwidth to upload updates to other PCs on the internet or local network.",
"category": "Essential Tweaks",
"panel": "1",
"registry": [
{
"Path": "HKLM:\\SOFTWARE\\Policies\\Microsoft\\Windows\\DeliveryOptimization",
"Name": "DODownloadMode",
"Value": "0",
"Type": "DWord",
"OriginalValue": "<RemoveEntry>"
}
],
"link": "https://winutil.christitus.com/dev/tweaks/essential-tweaks/deliveryoptimization"
},
"WPFTweaksRemoveEdge": {
"Content": "Microsoft Edge - Remove",
"Description": "Unblocks Microsoft Edge uninstaller restrictions then uses that uninstaller to remove Microsoft Edge.",
@@ -651,13 +645,20 @@
# Some of OneDrive files use explorer, and OneDrive uses FileCoAuth
Write-Host \"Removing leftover OneDrive Files...\"
Stop-Process -Name FileCoAuth,Explorer
Remove-Item \"$Env:LocalAppData\\Microsoft\\OneDrive\" -Recurse -Force
Remove-Item \"C:\\ProgramData\\Microsoft OneDrive\" -Recurse -Force
# Grant back permission to access OneDrive folder
icacls $Env:OneDrive /grant \"Administrators:(D,DC)\"
if (-not (Get-ChildItem -Path $Env:OneDrive)) {
Remove-Item -Path $Env:OneDrive -Recurse
[Environment]::SetEnvironmentVariable('OneDrive', $null, 'User')
}
# Disable OneSyncSvc
Set-Service -Name OneSyncSvc -StartupType Disabled
"
@@ -673,7 +674,7 @@
],
"link": "https://winutil.christitus.com/dev/tweaks/z--advanced-tweaks---caution/removeonedrive"
},
"WPFTweaksRemoveHome": {
"WPFTweaksRemoveHomeAndGallery": {
"Content": "File Explorer Home and Gallery - Disable",
"Description": "Removes the Home and Gallery from Explorer and sets This PC as default.",
"category": "z__Advanced Tweaks - CAUTION",
@@ -686,6 +687,13 @@
"Type": "DWord",
"OriginalValue": "<RemoveEntry>"
},
{
"Path": "HKCU:\\Software\\Classes\\CLSID\\{e88865ea-0e1c-4e20-9aa6-edcd0212c87c}",
"Name": "System.IsPinnedToNameSpaceTree",
"Value": "0",
"Type": "DWord",
"OriginalValue": "<RemoveEntry>"
},
{
"Path": "HKCU:\\Software\\Microsoft\\Windows\\CurrentVersion\\Explorer\\Advanced",
"Name": "LaunchTo",
@@ -694,7 +702,7 @@
"OriginalValue": "<RemoveEntry>"
}
],
"link": "https://winutil.christitus.com/dev/tweaks/z--advanced-tweaks---caution/removehome"
"link": "https://winutil.christitus.com/dev/tweaks/z--advanced-tweaks---caution/removehomeandgallery"
},
"WPFTweaksDisplay": {
"Content": "Visual Effects - Set to Best Performance",
@@ -859,6 +867,19 @@
],
"link": "https://winutil.christitus.com/dev/tweaks/essential-tweaks/debloat"
},
"WPFTweaksReservedStorage": {
"Content": "Disable Reserved Storage",
"Description": "Disables Windows Reserved Storage (7-10 GB held for updates/temp files). Recommended only on small drives. Re-enable before major Windows feature updates to avoid installation failures.",
"category": "z__Advanced Tweaks - CAUTION",
"panel": "1",
"InvokeScript": [
"DISM /Online /Set-ReservedStorageState /State:Disabled"
],
"UndoScript": [
"DISM /Online /Set-ReservedStorageState /State:Enabled"
],
"link": "https://winutil.christitus.com/dev/tweaks/z--advanced-tweaks---caution/reservedstorage"
},
"WPFTweaksRestorePoint": {
"Content": "Restore Point - Create",
"Description": "Creates a restore point at runtime in case a revert is needed from WinUtil modifications.",
@@ -902,19 +923,6 @@
],
"link": "https://winutil.christitus.com/dev/tweaks/essential-tweaks/endtaskontaskbar"
},
"WPFTweaksPowershell7Tele": {
"Content": "PowerShell 7 Telemetry - Disable",
"Description": "Creates an Environment Variable called 'POWERSHELL_TELEMETRY_OPTOUT' with a value of '1' which will tell PowerShell 7 to not send Telemetry Data.",
"category": "Essential Tweaks",
"panel": "1",
"InvokeScript": [
"[Environment]::SetEnvironmentVariable('POWERSHELL_TELEMETRY_OPTOUT', '1', 'Machine')"
],
"UndoScript": [
"[Environment]::SetEnvironmentVariable('POWERSHELL_TELEMETRY_OPTOUT', '', 'Machine')"
],
"link": "https://winutil.christitus.com/dev/tweaks/essential-tweaks/powershell7tele"
},
"WPFTweaksStorage": {
"Content": "Storage Sense - Disable",
"Description": "Storage Sense deletes temp files automatically.",
@@ -932,8 +940,8 @@
"link": "https://winutil.christitus.com/dev/tweaks/z--advanced-tweaks---caution/storage"
},
"WPFTweaksWindowsAI": {
"Content": "Windows AI - Disable",
"Description": "Removes or disables all ai features and packages",
"Content": "Windows AI - Disable And Remove",
"Description": "Removes and disables all AI features/packages",
"category": "z__Advanced Tweaks - CAUTION",
"panel": "1",
"registry": [
@@ -947,7 +955,7 @@
{
"Path": "HKLM:\\SOFTWARE\\Policies\\WindowsNotepad",
"Name": "DisableAIFeatures",
"Value": 1,
"Value": "1",
"Type": "DWord",
"OriginalValue": "<RemoveEntry>"
}
@@ -959,12 +967,12 @@
New-Item \"HKLM:\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Appx\\AppxAllUserStore\\EndOfLife\\$Sid\\$Appx\" -Force
Get-AppxPackage -AllUsers *Copilot* | Remove-AppxPackage -AllUsers
Get-AppxPackage -AllUsers \"*Copilot*\" | Remove-AppxPackage -AllUsers
Get-AppxPackage -AllUsers Microsoft.MicrosoftOfficeHub | Remove-AppxPackage -AllUsers
Remove-AppxPackage $Appx
Set-Service -Name WSAIFabricSvc -StartupType Disabled
Disable-WindowsOptionalFeature -FeatureName Recall -Online
Disable-WindowsOptionalFeature -FeatureName Recall -Online -NoRestart
Write-Host \"Windows AI Disabled\"
"
@@ -1058,25 +1066,21 @@
"panel": "1",
"InvokeScript": [
"
$hostsUrl = \"https://github.com/Ruddernation-Designs/Adobe-URL-Block-List/raw/refs/heads/master/hosts\"
$hosts = \"$Env:SystemRoot\\System32\\drivers\\etc\\hosts\"
$hostsUrl = Invoke-RestMethod -Uri https://github.com/Ruddernation-Designs/Adobe-URL-Block-List/raw/refs/heads/master/hosts
Add-Content -Path \"$Env:SystemRoot\\System32\\drivers\\etc\\hosts\" -Value $hostsUrl
Move-Item $hosts \"$hosts.bak\"
Invoke-WebRequest $hostsUrl -OutFile $hosts
ipconfig /flushdns
Write-Host \"Added Adobe url block list from host file\"
Write-Host 'Added Adobe url block list from host file'
"
],
"UndoScript": [
"
$hosts = \"$Env:SystemRoot\\System32\\drivers\\etc\\hosts\"
Set-Content \"$Env:SystemRoot\\System32\\drivers\\etc\\hosts\" (
(Get-Content \"$Env:SystemRoot\\System32\\drivers\\etc\\hosts\") -join \"`n\" -replace '(?s)#New Ver.*', ''
)
Remove-Item $hosts
Move-Item \"$hosts.bak\" $hosts
ipconfig /flushdns
Write-Host \"Removed Adobe url block list from host file\"
Write-Host 'Removed Adobe url block list from host file'
"
],
"link": "https://winutil.christitus.com/dev/tweaks/z--advanced-tweaks---caution/blockadobenet"
@@ -1088,18 +1092,12 @@
"panel": "1",
"InvokeScript": [
"
New-Item -Path \"HKCU:\\Software\\Classes\\CLSID\\{86ca1aa0-34aa-4e8b-a509-50c905bae2a2}\" -Name \"InprocServer32\" -force -value \"\"
Write-Host Restarting explorer.exe ...
Stop-Process -Name \"explorer\" -Force
New-Item -Path \"HKCU:\\Software\\Classes\\CLSID\\{86ca1aa0-34aa-4e8b-a509-50c905bae2a2}\" -Name InprocServer32 -Value \"\" -Force
Stop-Process -Name explorer
"
],
"UndoScript": [
"
Remove-Item -Path \"HKCU:\\Software\\Classes\\CLSID\\{86ca1aa0-34aa-4e8b-a509-50c905bae2a2}\" -Recurse -Confirm:$false -Force
# Restarting Explorer in the Undo Script might not be necessary, as the Registry change without restarting Explorer does work, but just to make sure.
Write-Host Restarting explorer.exe ...
Stop-Process -Name \"explorer\" -Force
"
"Remove-Item -Path \"HKCU:\\Software\\Classes\\CLSID\\{86ca1aa0-34aa-4e8b-a509-50c905bae2a2}\" -Recurse"
],
"link": "https://winutil.christitus.com/dev/tweaks/z--advanced-tweaks---caution/rightclickmenu"
},
@@ -1221,27 +1219,64 @@
],
"link": "https://winutil.christitus.com/dev/tweaks/z--advanced-tweaks---caution/disablefso"
},
"WPFToggleDisableCrossDeviceResume": {
"Content": "Cross-Device Resume",
"Description": "This tweak controls the Resume function in Windows 11 24H2 and later, which allows you to resume an activity from a mobile device and vice-versa.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
"registry": [
{
"Path": "HKCU:\\Software\\Microsoft\\Windows\\CurrentVersion\\CrossDeviceResume\\Configuration",
"Name": "IsResumeAllowed",
"Value": "1",
"Type": "DWord",
"OriginalValue": "0",
"DefaultState": "true"
"WPFTweaksDisableExplorerAutoDiscovery": {
"Content": "File Explorer Automatic Folder Discovery - Disable",
"Description": "Windows Explorer automatically tries to guess the type of the folder based on its contents, slowing down the browsing experience. WARNING! Will disable File Explorer grouping.",
"category": "Essential Tweaks",
"panel": "1",
"InvokeScript": [
"
# Previously detected folders
$bags = \"HKCU:\\Software\\Classes\\Local Settings\\Software\\Microsoft\\Windows\\Shell\\Bags\"
# Folder types lookup table
$bagMRU = \"HKCU:\\Software\\Classes\\Local Settings\\Software\\Microsoft\\Windows\\Shell\\BagMRU\"
# Flush Explorer view database
Remove-Item -Path $bags -Recurse -Force
Write-Host \"Removed $bags\"
Remove-Item -Path $bagMRU -Recurse -Force
Write-Host \"Removed $bagMRU\"
# Every folder
$allFolders = \"HKCU:\\Software\\Classes\\Local Settings\\Software\\Microsoft\\Windows\\Shell\\Bags\\AllFolders\\Shell\"
if (!(Test-Path $allFolders)) {
New-Item -Path $allFolders -Force
Write-Host \"Created $allFolders\"
}
# Generic view
New-ItemProperty -Path $allFolders -Name \"FolderType\" -Value \"NotSpecified\" -PropertyType String -Force
Write-Host \"Set FolderType to NotSpecified\"
Write-Host Please sign out and back in, or restart your computer to apply the changes!
"
],
"link": "https://winutil.christitus.com/dev/tweaks/customize-preferences/disablecrossdeviceresume"
"UndoScript": [
"
# Previously detected folders
$bags = \"HKCU:\\Software\\Classes\\Local Settings\\Software\\Microsoft\\Windows\\Shell\\Bags\"
# Folder types lookup table
$bagMRU = \"HKCU:\\Software\\Classes\\Local Settings\\Software\\Microsoft\\Windows\\Shell\\BagMRU\"
# Flush Explorer view database
Remove-Item -Path $bags -Recurse -Force
Write-Host \"Removed $bags\"
Remove-Item -Path $bagMRU -Recurse -Force
Write-Host \"Removed $bagMRU\"
Write-Host Please sign out and back in, or restart your computer to apply the changes!
"
],
"link": "https://winutil.christitus.com/dev/tweaks/essential-tweaks/disableexplorerautodiscovery"
},
"WPFToggleDetailedBSoD": {
"Content": "BSoD Verbose Mode",
"Description": "If enabled, you will see a detailed Blue Screen of Death (BSOD) with more information.",
"Description": "Gives more information when you blue screen.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -1267,7 +1302,7 @@
},
"WPFToggleBatteryPercentage": {
"Content": "System Tray Battery Percentage",
"Description": "If enabled, Shows numeric battery percentage next to the battery icon in the system tray.",
"Description": "Shows numeric battery percentage next to the battery icon in the system tray.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -1285,7 +1320,7 @@
},
"WPFToggleDarkMode": {
"Content": "Dark Theme for Windows",
"Description": "Enable/Disable Dark Mode.",
"Description": "Dark Mode for the system and applications.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -1327,7 +1362,7 @@
},
"WPFToggleShowExt": {
"Content": "File Explorer File Extensions",
"Description": "If enabled, File extensions (e.g., .txt, .jpg) are visible.",
"Description": "Shows .file extensions in Explorer (.exe, .png, etc.)",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -1355,7 +1390,7 @@
},
"WPFToggleHiddenFiles": {
"Content": "File Explorer Hidden Files",
"Description": "If enabled, Hidden Files will be shown.",
"Description": "Reveals hidden files in Explorer.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -1383,7 +1418,7 @@
},
"WPFToggleVerboseLogon": {
"Content": "Logon Verbose Mode",
"Description": "Show detailed messages during the login process for troubleshooting and diagnostics.",
"Description": "Show detailed messages during startup/shutdown.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -1401,7 +1436,7 @@
},
"WPFToggleNewOutlook": {
"Content": "Microsoft Outlook New Version",
"Description": "If disabled, it removes the new Outlook toggle, disables the new Outlook migration, and ensures the classic Outlook application is used.",
"Description": "This will ensures the classic Outlook application is used.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -1462,7 +1497,7 @@
},
"WPFToggleMultiplaneOverlay": {
"Content": "Multiplane Overlay",
"Description": "Enable or disable the Multiplane Overlay, which can sometimes cause issues with graphics cards.",
"Description": "Multiplane Overlay compose multiple image layers, which can sometimes cause issues with graphics cards.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -1488,7 +1523,7 @@
},
"WPFToggleMouseAcceleration": {
"Content": "Mouse Acceleration",
"Description": "If enabled, the Cursor movement is affected by the speed of your physical mouse movements.",
"Description": "Makes it so Cursor movement is affected by the speed of your physical mouse movements.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -1548,7 +1583,7 @@
},
"WPFToggleStandbyFix": {
"Content": "S0 Sleep Network Connectivity",
"Description": "Enable or disable network connectivity during S0 Sleep.",
"Description": "Toggles network connectivity during S0 Sleep which is low power idle in modern laptops.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -1566,7 +1601,7 @@
},
"WPFToggleS3Sleep": {
"Content": "S3 Sleep",
"Description": "Toggles between Modern Standby and S3 Sleep.",
"Description": "Toggles between Modern Standby and S3 Sleep, which cuts off power to the CPU while continuing to refresh the memory.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -1584,7 +1619,7 @@
},
"WPFToggleHideSettingsHome": {
"Content": "Settings Home Page",
"Description": "Enable or disable the Home Page in the Windows Settings app.",
"Description": "Toggles the Home Page in the Windows Settings app.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -1602,7 +1637,7 @@
},
"WPFToggleBingSearch": {
"Content": "Start Menu Bing Search",
"Description": "If enabled, Bing web search results will be included in your Start Menu search.",
"Description": "Toggles Bing web search results in Windows Search.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -1620,7 +1655,7 @@
},
"WPFToggleLoginBlur": {
"Content": "Logon Screen Acrylic Blur",
"Description": "If disabled, the acrylic blur effect will be removed on the Windows 10/11 login screen background.",
"Description": "Toggles the acrylic blur effect on login screen background.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -1636,9 +1671,26 @@
],
"link": "https://winutil.christitus.com/dev/tweaks/customize-preferences/loginblur"
},
"WPFTweaksDisableLockscreen": {
"Content": "Lock Screen - Disable",
"Description": "Skips the lock screen entirely and goes directly to the sign-in screen on boot and wake.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
"registry": [
{
"Path": "HKLM:\\SOFTWARE\\Policies\\Microsoft\\Windows\\Personalization",
"Name": "NoLockScreen",
"Value": "1",
"Type": "DWord",
"OriginalValue": "<RemoveEntry>"
}
],
"link": "https://winutil.christitus.com/dev/tweaks/customize-preferences/disablelockscreen"
},
"WPFToggleStartMenuRecommendations": {
"Content": "Start Menu Recommendations",
"Description": "If disabled, then you will not see recommendations in the Start Menu. WARNING: This will also disable Windows Spotlight on your Lock Screen as a side effect.",
"Description": "Toggles the recommendations section in the Start Menu. WARNING: This will also disable Windows Spotlight on your Lock Screen as a side effect.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -1682,7 +1734,7 @@
},
"WPFToggleStickyKeys": {
"Content": "Sticky Keys",
"Description": "If enabled, Sticky Keys is activated. Sticky keys is an accessibility feature of some graphical user interfaces which assists users who have physical disabilities or help users reduce repetitive strain injury.",
"Description": "Toggles the Sticky Keys, which activate when clicking shift rapidly.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -1700,7 +1752,7 @@
},
"WPFToggleTaskbarAlignment": {
"Content": "Taskbar Centered Icons",
"Description": "[Windows 11] If enabled, the Taskbar Items will be shown on the Center, otherwise the Taskbar Items will be shown on the Left.",
"Description": "Toggles the Taskbar alignment either to the left or center.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -1728,7 +1780,7 @@
},
"WPFToggleTaskbarSearch": {
"Content": "Taskbar Search Icon",
"Description": "If enabled, Search Button will be on the Taskbar.",
"Description": "Toggles the Search Button on the Taskbar.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -1746,7 +1798,7 @@
},
"WPFToggleTaskView": {
"Content": "Taskbar Task View Icon",
"Description": "If enabled, Task View Button in Taskbar will be shown.",
"Description": "Toggles the Task View Button in the Taskbar.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -1764,7 +1816,7 @@
},
"WPFToggleGameMode": {
"Content": "Game Mode",
"Description": "If enabled, Windows prioritizes gaming performance by allocating system resources. Disable for audio/video production to prevent interference.",
"Description": "Toggles Windows prioritizes gaming performance by allocating system resources to games.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -1790,7 +1842,7 @@
},
"WPFToggleLongPaths": {
"Content": "Enable Long Paths",
"Description": "Enables support for file paths longer than 260 characters.",
"Description": "Toggles support for file paths longer than 260 characters in Explorer.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -1836,60 +1888,5 @@
"Type": "Button",
"ButtonWidth": "300",
"link": "https://winutil.christitus.com/dev/tweaks/performance-plans---not-for-laptops/removeultperf"
},
"WPFTweaksDisableExplorerAutoDiscovery": {
"Content": "File Explorer Automatic Folder Discovery - Disable",
"Description": "Windows Explorer automatically tries to guess the type of the folder based on its contents, slowing down the browsing experience. WARNING! Will disable File Explorer grouping.",
"category": "Essential Tweaks",
"panel": "1",
"InvokeScript": [
"
# Previously detected folders
$bags = \"HKCU:\\Software\\Classes\\Local Settings\\Software\\Microsoft\\Windows\\Shell\\Bags\"
# Folder types lookup table
$bagMRU = \"HKCU:\\Software\\Classes\\Local Settings\\Software\\Microsoft\\Windows\\Shell\\BagMRU\"
# Flush Explorer view database
Remove-Item -Path $bags -Recurse -Force
Write-Host \"Removed $bags\"
Remove-Item -Path $bagMRU -Recurse -Force
Write-Host \"Removed $bagMRU\"
# Every folder
$allFolders = \"HKCU:\\Software\\Classes\\Local Settings\\Software\\Microsoft\\Windows\\Shell\\Bags\\AllFolders\\Shell\"
if (!(Test-Path $allFolders)) {
New-Item -Path $allFolders -Force
Write-Host \"Created $allFolders\"
}
# Generic view
New-ItemProperty -Path $allFolders -Name \"FolderType\" -Value \"NotSpecified\" -PropertyType String -Force
Write-Host \"Set FolderType to NotSpecified\"
Write-Host Please sign out and back in, or restart your computer to apply the changes!
"
],
"UndoScript": [
"
# Previously detected folders
$bags = \"HKCU:\\Software\\Classes\\Local Settings\\Software\\Microsoft\\Windows\\Shell\\Bags\"
# Folder types lookup table
$bagMRU = \"HKCU:\\Software\\Classes\\Local Settings\\Software\\Microsoft\\Windows\\Shell\\BagMRU\"
# Flush Explorer view database
Remove-Item -Path $bags -Recurse -Force
Write-Host \"Removed $bags\"
Remove-Item -Path $bagMRU -Recurse -Force
Write-Host \"Removed $bagMRU\"
Write-Host Please sign out and back in, or restart your computer to apply the changes!
"
],
"link": "https://winutil.christitus.com/dev/tweaks/essential-tweaks/disableexplorerautodiscovery"
}
}
Binary file not shown.

Before

Width:  |  Height:  |  Size: 194 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 12 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 6.8 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 14 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 22 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 77 KiB

Before

Width:  |  Height:  |  Size: 139 KiB

After

Width:  |  Height:  |  Size: 139 KiB

Before

Width:  |  Height:  |  Size: 139 KiB

After

Width:  |  Height:  |  Size: 139 KiB

Before

Width:  |  Height:  |  Size: 139 KiB

After

Width:  |  Height:  |  Size: 139 KiB

Before

Width:  |  Height:  |  Size: 139 KiB

After

Width:  |  Height:  |  Size: 139 KiB

Before

Width:  |  Height:  |  Size: 139 KiB

After

Width:  |  Height:  |  Size: 139 KiB

+119 -88
View File
@@ -2,121 +2,152 @@
toc: true
---
# How to Contribute?
## Contributing Code
## Testing
### Before You Start
* Test the latest changes to WinUtil by running the pre-release and reporting issues you are encountering to help us continually improve WinUtil!
- Keep each pull request focused on a single feature or fix.
- Avoid unnecessary formatting changes or large unrelated edits.
- Document what changed and why in your PR description.
#### Run the latest pre-release
---
```ps1
irm https://christitus.com/windev | iex
## Basic Git Workflow
### 1. Fork the Repository
Go to the ChrisTitusTech/winutil repository on GitHub and click the Fork button in the top right corner.
<img width="171" height="50" alt="{650A4723-F38A-44A4-9820-D232BC87C8A0}" src="https://github.com/user-attachments/assets/a214f27c-2fee-444a-920f-d87b14f5896f" />
---
### 2. Clone Your Fork
```bash
git clone https://github.com/YOUR_USERNAME/winutil.git
cd winutil
```
> [!IMPORTANT]
> **Keep in mind** That this is a pre-release and should be treated as such. It exists for developers to test the utility and report or fix bugs before they get added to the stable release. Don't use it in production!
---
## Issues
### 3. Create a Branch
* If you encounter any challenges or problems with the script, I kindly request that you submit them via the "Issues" tab on the GitHub repository. By filling out the provided template, you can provide specific details about the issue, allowing me (and others in the community) to promptly address any bugs or consider feature requests.
Never work directly on `main`.
## Contribute Code
Create a branch related to your change:
* 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 the `main` branch.
> [!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!
> [!IMPORTANT]
> Do not open a pull request that adds support for other languages to WinUtil for now, until we decide how we want to move forward with language support.
* When creating pull requests, it is essential to thoroughly document all changes made. This includes, but is not limited to, documenting any additions made to the `tweaks` section and corresponding `undo tweak`, so users are able to remove the newly added tweaks if necessary, and comprehensive documentation is required for all code changes. Document your changes and briefly explain why you made your changes in your Pull Request Description. Failure to adhere to this format may result in the denial of the pull request. Additionally, any code lacking sufficient documentation may also be denied.
* By following these guidelines, we can maintain a high standard of quality and ensure that the codebase remains organized and well-documented.
> [!NOTE]
>
> When creating a function, please include "WPF" or "WinUtil" in the file name so it can be loaded into the runspace.
## Walk through
* This is a guide for beginners. If you are still having issues, look at the following official GitHub documentation:
* [Commit through WEB](https://docs.github.com/en/pull-requests/committing-changes-to-your-project/creating-and-editing-commits/about-commits)
* [Commit through GitHub Desktop](https://docs.github.com/en/desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project-in-github-desktop#about-commits)
* [Create a Pull Request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request)
### Overview
```mermaid
%%{init: {"flowchart": {"curve": "cardinal"}} }%%
graph TD
A[Fork Project] --> B[Clone Repository];
B --> C[Create New Branch];
C --> D[Make Changes];
D --> G[Test Changes];
G --> H{Tests Passed?};
H -->|Yes| E[Commit Changes];
H -->|No| J[Fix Issues];
J --> G;
E --> F[Push Branch];
F --> K[Create Pull Request];
K --> L[Fill out PR template];
classDef default stroke:#333,stroke-width:4px,font-size:12pt;
```bash
git checkout -b feature-name
```
> [!NOTE]
>
> This is a diagram to guide you through the process. It may vary depending on the type of change you're making.
Example:
### Fork the Repo
* Fork the WinUtil Repository [here](https://github.com/ChrisTitusTech/winutil) to create a copy that will be available in your repository list.
```bash
git checkout -b add-firefox-tweak
```
{{< image src="images/Fork-Button" alt="Fork Image" >}}
---
### Clone the Fork
> [!TIP]
>
> While you can make your changes directly through the Web, we recommend cloning the repo to your device using the application GitHub Desktop (available in WinUtil) to test your fork easily.
### 4. Edit the Code
* Install GitHub Desktop if it is not already installed.
* Log in using the same GitHub account you used to fork WinUtil.
* Choose the fork under "Your Repositories" and press "clone {repo name}"
* Create a new branch and name it something relatable to your changes.
Open the project in your preferred text editor and make your changes.
* Now you can modify WinUtil to your liking using your preferred text editor.
Keep changes small and focused.
---
### Testing your changes
### 5. Test Your Changes
* To test to see if your changes work as intended, run the following commands in a PowerShell terminal as admin:
Open PowerShell as Administrator.
* Change the directory where you are running the commands to the forked project.
* `cd {path to the folder with the compile.ps1}`
* Run the following command to compile and run WinUtil:
* `.\Compile.ps1 -run`
Go to the project folder:
{{< image src="images/Complie" alt="Compile" >}}
```powershell
cd path\to\winutil
```
* After seeing that your changes work properly, feel free to commit the changes to the repository and make a PR. For help on that, follow the documentation below.
Run:
### Committing the changes
* Before committing your changes, please discard changes made to the `winutil.ps1` file, like the following:
```powershell
.\Compile.ps1 -Run
```
{{< image src="images/Discard-GHD" alt="Push Commit Image" >}}
Verify:
* Now, commit your changes once you are happy with the result.
- WinUtil launches correctly
- Your feature works
- Nothing else breaks
{{< image src="images/Commit-GHD" alt="Commit Image" >}}
If something fails, fix it before committing.
* Push the changes to upload them to your fork on github.com.
---
{{< image src="images/Push-Commit" alt="Push Commit Image" >}}
### 6. Review Your Changes
### 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 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.
Check what changed:
```bash
git status
```
Review the diff:
```bash
git diff
```
Make sure you did not accidentally modify unrelated files.
---
### 7. Commit Your Changes
Stage files:
```bash
git add .
```
Commit them:
```bash
git commit -m "Add feature description"
```
Example:
```bash
git commit -m "Add Firefox package tweak"
```
---
### 8. Push Your Branch
```bash
git push origin branch-name
```
Example:
```bash
git push origin add-firefox-tweak
```
---
### 9. Open a Pull Request
Go to your fork on GitHub.
GitHub will show a button to create a pull request.
<img width="1009" height="71" alt="{C8C6A3CC-79D4-44FD-A54C-4C5717F12730}" src="https://github.com/user-attachments/assets/0419d193-d4e7-47c0-87cf-b986742201a0" />
Before submitting:
- Explain what changed
- Explain why you changed it
- Make sure unrelated files are not included
Once submitted, maintainers will review your PR.
+11 -14
View File
@@ -5,31 +5,28 @@ toc: true
### Download not working
If `https://christitus.com/win` is not working, or you want to download the code from GitHub directly, you can use the direct download link:
If you run WinUtil and get an error like:
```
irm https://github.com/ChrisTitusTech/Winutil/releases/latest/download/Winutil.ps1 | iex
```
`< : The term '<' is not recognized as the name of a cmdlet, function, script file, or operable program.`
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 the following two providers:
| Provider | Primary DNS | Secondary DNS |
| :--------: | :---------: | :-----------: |
| Cloudflare | `1.1.1.1` | `1.0.0.1` |
| Google | `8.8.8.8` | `8.8.4.4` |
try using a **VPN** and if that doesn't work than report the issue to https://github.com/ChrisTitusTech/winutil/issues
### Script Won't Run
If you run WinUtil and get the error:
`"WinUtil is unable to run on your system, powershell execution is restricted by security policies,"`
`"WinUtil is unable to run on your system. PowerShell execution is restricted by security policies"`
this means that your PowerShell session is in **Constrained Language Mode**, which prevents WinUtil from running.
### Ultimate Performance Plan Not Working
The Ultimate Performance power plan may not work on some laptops who do not fully support this power plan.
The Ultimate Performance power plan may not work on some laptops that do not fully support this power plan.
In these cases, the power plan may fail to apply, This is expected behavior on unsupported hardware.
### Revert start menu tweak not working
Revert start menu tweak stops working starting with **Windows 11 update KB5089573** (released in May 2026).
In this update, Microsoft completely removed the old Start Menu code from Windows, so we aren't able to bring it back.
+7 -7
View File
@@ -1,20 +1,20 @@
---
title: Welcome to Winutil Documentation!
title: Welcome to WinUtil Documentation!
toc: false
width: full
---
<div style="display: flex; justify-content: center; align-items: center; width: 100%; flex-wrap: wrap; gap: 5px;margin-top:30px;" >
<a href="https://github.com/ChrisTitusTech/Winutil/releases/latest"><img src="https://img.shields.io/github/v/release/ChrisTitusTech/Winutil?color=%230567ff&label=Latest%20Release&style=for-the-badge" alt="Version" style="height: 28px; width: auto; min-width: 10px; object-fit: contain; margin: 0;"></a>
<img src="https://img.shields.io/github/downloads/ChrisTitusTech/Winutil/Winutil.ps1?label=Total%20Downloads&style=for-the-badge" alt="GitHub Downloads" style="height: 28px; width: auto; min-width: 10px; object-fit: contain; margin: 0;">
<a href="https://github.com/ChrisTitusTech/winutil/releases/latest"><img src="https://img.shields.io/github/v/release/ChrisTitusTech/winutil?color=%230567ff&label=Latest%20Release&style=for-the-badge" alt="Version" style="height: 28px; width: auto; min-width: 10px; object-fit: contain; margin: 0;"></a>
<img src="https://img.shields.io/github/downloads/ChrisTitusTech/winutil/winutil.ps1?label=Total%20Downloads&style=for-the-badge" alt="GitHub Downloads" style="height: 28px; width: auto; min-width: 10px; object-fit: contain; margin: 0;">
<a href="https://discord.gg/RUbZUZyByQ"><img src="https://dcbadge.limes.pink/api/server/https://discord.gg/RUbZUZyByQ" alt="Discord Community Server" style="height: 28px; width: auto; min-width: 10px; object-fit: contain; margin: 0;"></a>
</div>
Welcome to the official documentation for Winutil, your go-to utility for optimizing and managing your Windows environment. Whether youre an IT professional, power user, or regular user, Winutil provides a comprehensive set of tools to enhance your Windows experience.
Welcome to the official documentation for WinUtil, your go-to utility for optimizing and managing your Windows environment. Whether youre an IT professional, power user, or regular user, WinUtil provides a comprehensive set of tools to enhance your Windows experience.
{{< image src="images/Title-Screen" alt="Winutil title screen" >}}
{{< image src="images/Title-Screen" alt="WinUtil title screen" >}}
## Running the latest release of Winutil
## Running the latest release of WinUtil
* You will first need to start a PowerShell terminal **as Admin**.
* Now you can run the following command:
@@ -25,4 +25,4 @@ irm "https://christitus.com/win" | iex
> [!IMPORTANT]
> Winutil is updated frequently as of the time of writing. Consequently, features and functionalities may evolve, and the documentation may not always reflect the most current images or information.
> WinUtil is updated frequently as of the time of writing. Consequently, features and functionalities may evolve, and the documentation may not always reflect the most current images or information.
+2 -2
View File
@@ -6,7 +6,7 @@ toc: true
## Overview
Winutil is a PowerShell-based Windows utility with a WPF (Windows Presentation Foundation) GUI. This document explains the architecture, code structure, and how different components work together.
WinUtil is a PowerShell-based Windows utility with a WPF (Windows Presentation Foundation) GUI. This document explains the architecture, code structure, and how different components work together.
## High-Level Architecture
@@ -74,7 +74,7 @@ winutil/
1. Reads all function files from `/functions/`
2. Includes configuration JSON files
3. Embeds XAML GUI definition
4. Combines into single script
4. Combines into a single script
5. Outputs `winutil.ps1`
**Why**: Makes distribution easier (single file) and improves load time.
@@ -3,7 +3,7 @@ title: "Legacy F8 Boot Recovery - Disable"
description: ""
---
```json {filename="config/feature.json",linenos=inline,linenostart=110}
```json {filename="config/feature.json",linenos=inline,linenostart=107}
"WPFFeatureDisableLegacyRecovery": {
"Content": "Legacy F8 Boot Recovery - Disable",
"Description": "Disables Advanced Boot Options screen that lets you start Windows in advanced troubleshooting modes.",
@@ -3,7 +3,7 @@ title: "Legacy F8 Boot Recovery - Enable"
description: ""
---
```json {filename="config/feature.json",linenos=inline,linenostart=99}
```json {filename="config/feature.json",linenos=inline,linenostart=96}
"WPFFeatureEnableLegacyRecovery": {
"Content": "Legacy F8 Boot Recovery - Enable",
"Description": "Enables Advanced Boot Options screen that lets you start Windows in advanced troubleshooting modes.",
@@ -3,7 +3,7 @@ title: "Registry Backup (Daily Task 12:30am) - Enable"
description: ""
---
```json {filename="config/feature.json",linenos=inline,linenostart=82}
```json {filename="config/feature.json",linenos=inline,linenostart=79}
"WPFFeatureRegBackup": {
"Content": "Registry Backup (Daily Task 12:30am) - Enable",
"Description": "Enables daily registry backup, previously disabled by Microsoft in Windows 10 1803.",
@@ -3,7 +3,7 @@ title: "Windows Sandbox - Enable"
description: ""
---
```json {filename="config/feature.json",linenos=inline,linenostart=121}
```json {filename="config/feature.json",linenos=inline,linenostart=118}
"WPFFeaturesSandbox": {
"Content": "Windows Sandbox - Enable",
"Description": "Windows Sandbox is a lightweight virtual machine that provides a temporary desktop environment to safely run applications and programs in isolation.",
@@ -12,7 +12,4 @@ description: ""
"feature": [
"Microsoft-Hyper-V-All"
],
"InvokeScript": [
"bcdedit /set hypervisorschedulertype classic"
],
```
@@ -3,7 +3,7 @@ title: "Legacy Media Components (WMP, DirectPlay) - Enable"
description: ""
---
```json {filename="config/feature.json",linenos=inline,linenostart=37}
```json {filename="config/feature.json",linenos=inline,linenostart=34}
"WPFFeatureslegacymedia": {
"Content": "Legacy Media Components (WMP, DirectPlay) - Enable",
"Description": "Enables legacy programs from previous versions of Windows.",
+1 -1
View File
@@ -3,7 +3,7 @@ title: "Network File System (NFS) - Enable"
description: ""
---
```json {filename="config/feature.json",linenos=inline,linenostart=63}
```json {filename="config/feature.json",linenos=inline,linenostart=60}
"WPFFeaturenfs": {
"Content": "Network File System (NFS) - Enable",
"Description": "Network File System (NFS) is a mechanism for storing files on a network.",
+1 -1
View File
@@ -3,7 +3,7 @@ title: "Windows Subsystem for Linux (WSL) - Enable"
description: ""
---
```json {filename="config/feature.json",linenos=inline,linenostart=51}
```json {filename="config/feature.json",linenos=inline,linenostart=48}
"WPFFeaturewsl": {
"Content": "Windows Subsystem for Linux (WSL) - Enable",
"Description": "Windows Subsystem for Linux is an optional feature of Windows that allows Linux programs to run natively on Windows without the need for a separate virtual machine or dual booting.",
+2 -10
View File
@@ -5,15 +5,7 @@ description: ""
```powershell {filename="functions/public/Invoke-WPFPanelAutologin.ps1",linenos=inline,linenostart=1}
function Invoke-WPFPanelAutologin {
<#
.SYNOPSIS
Enables autologin using Sysinternals Autologon.exe
#>
# Official Microsoft recommendation: https://learn.microsoft.com/en-us/sysinternals/downloads/autologon
Invoke-WebRequest -Uri "https://live.sysinternals.com/Autologon.exe" -OutFile "$env:temp\autologin.exe"
cmd /c "$env:temp\autologin.exe" /accepteula
Invoke-WebRequest -Uri https://live.sysinternals.com/Autologon.exe -OutFile "$winutildir\autologin.exe"
Start-Process -FilePath "$winutildir\autologin.exe" -ArgumentList /accepteula
}
```
+3 -34
View File
@@ -5,39 +5,8 @@ description: ""
```powershell {filename="functions/public/Invoke-WPFFixesNetwork.ps1",linenos=inline,linenostart=1}
function Invoke-WPFFixesNetwork {
<#
.SYNOPSIS
Resets various network configurations
#>
Write-Host "Resetting Network with netsh"
Set-WinUtilTaskbaritem -state "Normal" -value 0.01 -overlay "logo"
# Reset WinSock catalog to a clean state
Start-Process -NoNewWindow -FilePath "netsh" -ArgumentList "winsock", "reset"
Set-WinUtilTaskbaritem -state "Normal" -value 0.35 -overlay "logo"
# Resets WinHTTP proxy setting to DIRECT
Start-Process -NoNewWindow -FilePath "netsh" -ArgumentList "winhttp", "reset", "proxy"
Set-WinUtilTaskbaritem -state "Normal" -value 0.7 -overlay "logo"
# Removes all user configured IP settings
Start-Process -NoNewWindow -FilePath "netsh" -ArgumentList "int", "ip", "reset"
Set-WinUtilTaskbaritem -state "None" -overlay "checkmark"
Write-Host "Process complete. Please reboot your computer."
$ButtonType = [System.Windows.MessageBoxButton]::OK
$MessageboxTitle = "Network Reset "
$Messageboxbody = ("Stock settings loaded.`n Please reboot your computer")
$MessageIcon = [System.Windows.MessageBoxImage]::Information
[System.Windows.MessageBox]::Show($Messageboxbody, $MessageboxTitle, $ButtonType, $MessageIcon)
Write-Host "=========================================="
Write-Host "-- Network Configuration has been Reset --"
Write-Host "=========================================="
netsh winsock reset
netsh int ip reset
Write-Host "Network Configuration has been Reset. Please restart your computer."
}
```
@@ -3,7 +3,7 @@ title: "Computer Management"
description: ""
---
```json {filename="config/feature.json",linenos=inline,linenostart=196}
```json {filename="config/feature.json",linenos=inline,linenostart=193}
"WPFPanelComputer": {
"Content": "Computer Management",
"category": "Legacy Windows Panels",
@@ -3,7 +3,7 @@ title: "Control Panel"
description: ""
---
```json {filename="config/feature.json",linenos=inline,linenostart=185}
```json {filename="config/feature.json",linenos=inline,linenostart=182}
"WPFPanelControl": {
"Content": "Control Panel",
"category": "Legacy Windows Panels",
@@ -3,7 +3,7 @@ title: "Network Connections"
description: ""
---
```json {filename="config/feature.json",linenos=inline,linenostart=207}
```json {filename="config/feature.json",linenos=inline,linenostart=204}
"WPFPanelNetwork": {
"Content": "Network Connections",
"category": "Legacy Windows Panels",
@@ -3,7 +3,7 @@ title: "Power Panel"
description: ""
---
```json {filename="config/feature.json",linenos=inline,linenostart=218}
```json {filename="config/feature.json",linenos=inline,linenostart=215}
"WPFPanelPower": {
"Content": "Power Panel",
"category": "Legacy Windows Panels",
@@ -3,7 +3,7 @@ title: "Printer Panel"
description: ""
---
```json {filename="config/feature.json",linenos=inline,linenostart=229}
```json {filename="config/feature.json",linenos=inline,linenostart=226}
"WPFPanelPrinter": {
"Content": "Printer Panel",
"category": "Legacy Windows Panels",
@@ -3,7 +3,7 @@ title: "Region"
description: ""
---
```json {filename="config/feature.json",linenos=inline,linenostart=240}
```json {filename="config/feature.json",linenos=inline,linenostart=237}
"WPFPanelRegion": {
"Content": "Region",
"category": "Legacy Windows Panels",
@@ -3,7 +3,7 @@ title: "Windows Restore"
description: ""
---
```json {filename="config/feature.json",linenos=inline,linenostart=251}
```json {filename="config/feature.json",linenos=inline,linenostart=248}
"WPFPanelRestore": {
"Content": "Windows Restore",
"category": "Legacy Windows Panels",
@@ -3,7 +3,7 @@ title: "Sound Settings"
description: ""
---
```json {filename="config/feature.json",linenos=inline,linenostart=262}
```json {filename="config/feature.json",linenos=inline,linenostart=259}
"WPFPanelSound": {
"Content": "Sound Settings",
"category": "Legacy Windows Panels",
@@ -3,7 +3,7 @@ title: "System Properties"
description: ""
---
```json {filename="config/feature.json",linenos=inline,linenostart=273}
```json {filename="config/feature.json",linenos=inline,linenostart=270}
"WPFPanelSystem": {
"Content": "System Properties",
"category": "Legacy Windows Panels",
@@ -3,7 +3,7 @@ title: "Time and Date"
description: ""
---
```json {filename="config/feature.json",linenos=inline,linenostart=284}
```json {filename="config/feature.json",linenos=inline,linenostart=281}
"WPFPanelTimedate": {
"Content": "Time and Date",
"category": "Legacy Windows Panels",
@@ -6,13 +6,13 @@ description: ""
```powershell {filename="functions/private/Invoke-WinUtilInstallPSProfile.ps1",linenos=inline,linenostart=1}
function Invoke-WinUtilInstallPSProfile {
if (-not (Get-Command wt)) {
Write-Host "Windows Terminal not found installing..."
Write-Host "Windows Terminal not found. Installing..."
Install-WinUtilWinget
winget install Microsoft.WindowsTerminal --source winget --silent
}
if (-not (Get-Command pwsh)) {
Write-Host "Powershell 7 not found installing..."
Write-Host "PowerShell 7 not found. Installing..."
Install-WinUtilWinget
winget install Microsoft.PowerShell --source winget --silent
}
@@ -3,10 +3,10 @@ title: "System Tray Battery Percentage"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1268}
```json {filename="config/tweaks.json",linenos=inline,linenostart=1303}
"WPFToggleBatteryPercentage": {
"Content": "System Tray Battery Percentage",
"Description": "If enabled, Shows numeric battery percentage next to the battery icon in the system tray.",
"Description": "Shows numeric battery percentage next to the battery icon in the system tray.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -3,10 +3,10 @@ title: "Start Menu Bing Search"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1603}
```json {filename="config/tweaks.json",linenos=inline,linenostart=1638}
"WPFToggleBingSearch": {
"Content": "Start Menu Bing Search",
"Description": "If enabled, Bing web search results will be included in your Start Menu search.",
"Description": "Toggles Bing web search results in Windows Search.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -3,10 +3,10 @@ title: "Dark Theme for Windows"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1286}
```json {filename="config/tweaks.json",linenos=inline,linenostart=1321}
"WPFToggleDarkMode": {
"Content": "Dark Theme for Windows",
"Description": "Enable/Disable Dark Mode.",
"Description": "Dark Mode for the system and applications.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -3,10 +3,10 @@ title: "BSoD Verbose Mode"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1242}
```json {filename="config/tweaks.json",linenos=inline,linenostart=1277}
"WPFToggleDetailedBSoD": {
"Content": "BSoD Verbose Mode",
"Description": "If enabled, you will see a detailed Blue Screen of Death (BSOD) with more information.",
"Description": "Gives more information when you blue screen.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -1,23 +1,22 @@
---
title: "Cross-Device Resume"
title: "Lock Screen - Disable"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1224}
"WPFToggleDisableCrossDeviceResume": {
"Content": "Cross-Device Resume",
"Description": "This tweak controls the Resume function in Windows 11 24H2 and later, which allows you to resume an activity from a mobile device and vice-versa.",
```json {filename="config/tweaks.json",linenos=inline,linenostart=1674}
"WPFTweaksDisableLockscreen": {
"Content": "Lock Screen - Disable",
"Description": "Skips the lock screen entirely and goes directly to the sign-in screen on boot and wake.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
"registry": [
{
"Path": "HKCU:\\Software\\Microsoft\\Windows\\CurrentVersion\\CrossDeviceResume\\Configuration",
"Name": "IsResumeAllowed",
"Path": "HKLM:\\SOFTWARE\\Policies\\Microsoft\\Windows\\Personalization",
"Name": "NoLockScreen",
"Value": "1",
"Type": "DWord",
"OriginalValue": "0",
"DefaultState": "true"
"OriginalValue": "<RemoveEntry>"
}
],
```
@@ -3,10 +3,10 @@ title: "Game Mode"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1765}
```json {filename="config/tweaks.json",linenos=inline,linenostart=1817}
"WPFToggleGameMode": {
"Content": "Game Mode",
"Description": "If enabled, Windows prioritizes gaming performance by allocating system resources. Disable for audio/video production to prevent interference.",
"Description": "Toggles Windows prioritizes gaming performance by allocating system resources to games.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -3,10 +3,10 @@ title: "File Explorer Hidden Files"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1356}
```json {filename="config/tweaks.json",linenos=inline,linenostart=1391}
"WPFToggleHiddenFiles": {
"Content": "File Explorer Hidden Files",
"Description": "If enabled, Hidden Files will be shown.",
"Description": "Reveals hidden files in Explorer.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -3,10 +3,10 @@ title: "Settings Home Page"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1585}
```json {filename="config/tweaks.json",linenos=inline,linenostart=1620}
"WPFToggleHideSettingsHome": {
"Content": "Settings Home Page",
"Description": "Enable or disable the Home Page in the Windows Settings app.",
"Description": "Toggles the Home Page in the Windows Settings app.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -3,10 +3,10 @@ title: "Logon Screen Acrylic Blur"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1621}
```json {filename="config/tweaks.json",linenos=inline,linenostart=1656}
"WPFToggleLoginBlur": {
"Content": "Logon Screen Acrylic Blur",
"Description": "If disabled, the acrylic blur effect will be removed on the Windows 10/11 login screen background.",
"Description": "Toggles the acrylic blur effect on login screen background.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -3,10 +3,10 @@ title: "Enable Long Paths"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1791}
```json {filename="config/tweaks.json",linenos=inline,linenostart=1843}
"WPFToggleLongPaths": {
"Content": "Enable Long Paths",
"Description": "Enables support for file paths longer than 260 characters.",
"Description": "Toggles support for file paths longer than 260 characters in Explorer.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -3,10 +3,10 @@ title: "Mouse Acceleration"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1489}
```json {filename="config/tweaks.json",linenos=inline,linenostart=1524}
"WPFToggleMouseAcceleration": {
"Content": "Mouse Acceleration",
"Description": "If enabled, the Cursor movement is affected by the speed of your physical mouse movements.",
"Description": "Makes it so Cursor movement is affected by the speed of your physical mouse movements.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -3,10 +3,10 @@ title: "Multiplane Overlay"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1463}
```json {filename="config/tweaks.json",linenos=inline,linenostart=1498}
"WPFToggleMultiplaneOverlay": {
"Content": "Multiplane Overlay",
"Description": "Enable or disable the Multiplane Overlay, which can sometimes cause issues with graphics cards.",
"Description": "Multiplane Overlay compose multiple image layers, which can sometimes cause issues with graphics cards.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -3,10 +3,10 @@ title: "Microsoft Outlook New Version"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1402}
```json {filename="config/tweaks.json",linenos=inline,linenostart=1437}
"WPFToggleNewOutlook": {
"Content": "Microsoft Outlook New Version",
"Description": "If disabled, it removes the new Outlook toggle, disables the new Outlook migration, and ensures the classic Outlook application is used.",
"Description": "This will ensures the classic Outlook application is used.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -3,7 +3,7 @@ title: "Num Lock on Startup"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1523}
```json {filename="config/tweaks.json",linenos=inline,linenostart=1558}
"WPFToggleNumLock": {
"Content": "Num Lock on Startup",
"Description": "Toggle the Num Lock key state when your computer starts.",
@@ -3,10 +3,10 @@ title: "S3 Sleep"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1567}
```json {filename="config/tweaks.json",linenos=inline,linenostart=1602}
"WPFToggleS3Sleep": {
"Content": "S3 Sleep",
"Description": "Toggles between Modern Standby and S3 Sleep.",
"Description": "Toggles between Modern Standby and S3 Sleep, which cuts off power to the CPU while continuing to refresh the memory.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -3,10 +3,10 @@ title: "File Explorer File Extensions"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1328}
```json {filename="config/tweaks.json",linenos=inline,linenostart=1363}
"WPFToggleShowExt": {
"Content": "File Explorer File Extensions",
"Description": "If enabled, File extensions (e.g., .txt, .jpg) are visible.",
"Description": "Shows .file extensions in Explorer (.exe, .png, etc.)",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -3,10 +3,10 @@ title: "S0 Sleep Network Connectivity"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1549}
```json {filename="config/tweaks.json",linenos=inline,linenostart=1584}
"WPFToggleStandbyFix": {
"Content": "S0 Sleep Network Connectivity",
"Description": "Enable or disable network connectivity during S0 Sleep.",
"Description": "Toggles network connectivity during S0 Sleep which is low power idle in modern laptops.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -3,10 +3,10 @@ title: "Start Menu Recommendations"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1639}
```json {filename="config/tweaks.json",linenos=inline,linenostart=1691}
"WPFToggleStartMenuRecommendations": {
"Content": "Start Menu Recommendations",
"Description": "If disabled, then you will not see recommendations in the Start Menu. WARNING: This will also disable Windows Spotlight on your Lock Screen as a side effect.",
"Description": "Toggles the recommendations section in the Start Menu. WARNING: This will also disable Windows Spotlight on your Lock Screen as a side effect.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -3,10 +3,10 @@ title: "Sticky Keys"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1683}
```json {filename="config/tweaks.json",linenos=inline,linenostart=1735}
"WPFToggleStickyKeys": {
"Content": "Sticky Keys",
"Description": "If enabled, Sticky Keys is activated. Sticky keys is an accessibility feature of some graphical user interfaces which assists users who have physical disabilities or help users reduce repetitive strain injury.",
"Description": "Toggles the Sticky Keys, which activate when clicking shift rapidly.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -3,10 +3,10 @@ title: "Taskbar Task View Icon"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1747}
```json {filename="config/tweaks.json",linenos=inline,linenostart=1799}
"WPFToggleTaskView": {
"Content": "Taskbar Task View Icon",
"Description": "If enabled, Task View Button in Taskbar will be shown.",
"Description": "Toggles the Task View Button in the Taskbar.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -3,10 +3,10 @@ title: "Taskbar Centered Icons"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1701}
```json {filename="config/tweaks.json",linenos=inline,linenostart=1753}
"WPFToggleTaskbarAlignment": {
"Content": "Taskbar Centered Icons",
"Description": "[Windows 11] If enabled, the Taskbar Items will be shown on the Center, otherwise the Taskbar Items will be shown on the Left.",
"Description": "Toggles the Taskbar alignment either to the left or center.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -3,10 +3,10 @@ title: "Taskbar Search Icon"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1729}
```json {filename="config/tweaks.json",linenos=inline,linenostart=1781}
"WPFToggleTaskbarSearch": {
"Content": "Taskbar Search Icon",
"Description": "If enabled, Search Button will be on the Taskbar.",
"Description": "Toggles the Search Button on the Taskbar.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -3,10 +3,10 @@ title: "Logon Verbose Mode"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1384}
```json {filename="config/tweaks.json",linenos=inline,linenostart=1419}
"WPFToggleVerboseLogon": {
"Content": "Logon Verbose Mode",
"Description": "Show detailed messages during the login process for troubleshooting and diagnostics.",
"Description": "Show detailed messages during startup/shutdown.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
@@ -3,10 +3,10 @@ title: "ConsumerFeatures - Disable"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=459}
```json {filename="config/tweaks.json",linenos=inline,linenostart=431}
"WPFTweaksConsumerFeatures": {
"Content": "ConsumerFeatures - Disable",
"Description": "Windows will not automatically install any games, third-party apps, or application links from the Windows Store for the signed-in user. Some default Apps will be inaccessible (eg. Phone Link).",
"Description": "Windows will not automatically install any games, third-party apps, or application links from the Windows Store for the signed-in user. Some default Apps will be inaccessible (e.g. Phone Link).",
"category": "Essential Tweaks",
"panel": "1",
"registry": [
@@ -3,7 +3,7 @@ title: "Unwanted Pre-Installed Apps - Remove"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=821}
```json {filename="config/tweaks.json",linenos=inline,linenostart=829}
"WPFTweaksDeBloat": {
"Content": "Unwanted Pre-Installed Apps - Remove",
"Description": "This will remove a bunch of Windows pre-installed applications which most people dont want on their system.",
@@ -3,7 +3,7 @@ title: "Temporary Files - Remove"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1119}
```json {filename="config/tweaks.json",linenos=inline,linenostart=1117}
"WPFTweaksDeleteTempFiles": {
"Content": "Temporary Files - Remove",
"Description": "Erases TEMP Folders.",
@@ -0,0 +1,27 @@
---
title: "Delivery Optimization - Disable"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=572}
"WPFTweaksDeliveryOptimization": {
"Content": "Delivery Optimization - Disable",
"Description": "Stops Windows from using your bandwidth to upload updates to other PCs on the internet or local network.",
"category": "Essential Tweaks",
"panel": "1",
"registry": [
{
"Path": "HKLM:\\SOFTWARE\\Policies\\Microsoft\\Windows\\DeliveryOptimization",
"Name": "DODownloadMode",
"Value": "0",
"Type": "DWord",
"OriginalValue": "<RemoveEntry>"
}
],
```
## Registry Changes
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -3,7 +3,7 @@ title: "BitLocker - Disable"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=610}
```json {filename="config/tweaks.json",linenos=inline,linenostart=604}
"WPFTweaksDisableBitLocker": {
"Content": "BitLocker - Disable",
"Description": "Disables BitLocker.",
@@ -3,7 +3,7 @@ title: "File Explorer Automatic Folder Discovery - Disable"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1840}
```json {filename="config/tweaks.json",linenos=inline,linenostart=1222}
"WPFTweaksDisableExplorerAutoDiscovery": {
"Content": "File Explorer Automatic Folder Discovery - Disable",
"Description": "Windows Explorer automatically tries to guess the type of the folder based on its contents, slowing down the browsing experience. WARNING! Will disable File Explorer grouping.",
@@ -3,7 +3,7 @@ title: "Microsoft Store Recommended Search Results - Disable"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=125}
```json {filename="config/tweaks.json",linenos=inline,linenostart=97}
"WPFTweaksDisableStoreSearch": {
"Content": "Microsoft Store Recommended Search Results - Disable",
"Description": "Will not display recommended Microsoft Store apps when searching for apps in the Start menu.",
@@ -3,7 +3,7 @@ title: "Disk Cleanup - Run"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1106}
```json {filename="config/tweaks.json",linenos=inline,linenostart=1104}
"WPFTweaksDiskCleanup": {
"Content": "Disk Cleanup - Run",
"Description": "Runs Disk Cleanup on Drive C: and removes old Windows Updates.",
@@ -3,7 +3,7 @@ title: "End Task With Right Click - Enable"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=889}
```json {filename="config/tweaks.json",linenos=inline,linenostart=910}
"WPFTweaksEndTaskOnTaskbar": {
"Content": "End Task With Right Click - Enable",
"Description": "Enables option to end task when right clicking a program in the taskbar.",
@@ -3,7 +3,7 @@ title: "Location Tracking - Disable"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=138}
```json {filename="config/tweaks.json",linenos=inline,linenostart=110}
"WPFTweaksLocation": {
"Content": "Location Tracking - Disable",
"Description": "Disables Location Tracking.",
@@ -1,18 +0,0 @@
---
title: "PowerShell 7 Telemetry - Disable"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=905}
"WPFTweaksPowershell7Tele": {
"Content": "PowerShell 7 Telemetry - Disable",
"Description": "Creates an Environment Variable called 'POWERSHELL_TELEMETRY_OPTOUT' with a value of '1' which will tell PowerShell 7 to not send Telemetry Data.",
"category": "Essential Tweaks",
"panel": "1",
"InvokeScript": [
"[Environment]::SetEnvironmentVariable('POWERSHELL_TELEMETRY_OPTOUT', '1', 'Machine')"
],
"UndoScript": [
"[Environment]::SetEnvironmentVariable('POWERSHELL_TELEMETRY_OPTOUT', '', 'Machine')"
],
```
@@ -3,7 +3,7 @@ title: "Restore Point - Create"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=862}
```json {filename="config/tweaks.json",linenos=inline,linenostart=883}
"WPFTweaksRestorePoint": {
"Content": "Restore Point - Create",
"Description": "Creates a restore point at runtime in case a revert is needed from WinUtil modifications.",
@@ -3,38 +3,9 @@ title: "Start Menu Previous Layout - Enable"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=90}
"WPFTweaksRevertStartMenu": {
"Content": "Start Menu Previous Layout - Enable",
"Description": "Bring back the old Start Menu layout from before the gradual rollout of the new one in 25H2.",
"category": "Essential Tweaks",
"panel": "1",
"InvokeScript": [
"
Invoke-WebRequest https://github.com/thebookisclosed/ViVe/releases/download/v0.3.4/ViVeTool-v0.3.4-IntelAmd.zip -OutFile ViVeTool.zip
Expand-Archive ViVeTool.zip
Remove-Item ViVeTool.zip
## Registry Changes
Start-Process 'ViVeTool\\ViVeTool.exe' -ArgumentList '/disable /id:47205210' -Wait -NoNewWindow
Applications and System Components store and retrieve configuration data to modify Windows settings, so we can use the registry to change many settings in one place.
Remove-Item ViVeTool -Recurse
Write-Host 'Old start menu reverted. Please restart your computer to take effect.'
"
],
"UndoScript": [
"
Invoke-WebRequest https://github.com/thebookisclosed/ViVe/releases/download/v0.3.4/ViVeTool-v0.3.4-IntelAmd.zip -OutFile ViVeTool.zip
Expand-Archive ViVeTool.zip
Remove-Item ViVeTool.zip
Start-Process 'ViVeTool\\ViVeTool.exe' -ArgumentList '/enable /id:47205210' -Wait -NoNewWindow
Remove-Item ViVeTool -Recurse
Write-Host 'New start menu reverted. Please restart your computer to take effect.'
"
],
```
You can find information about the registry on [Wikipedia](https://en.wikipedia.org/wiki/Windows_Registry) and [Microsoft's Website](https://learn.microsoft.com/en-us/windows/win32/sysinfo/registry).
@@ -3,7 +3,7 @@ title: "Services - Set to Manual"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=175}
```json {filename="config/tweaks.json",linenos=inline,linenostart=147}
"WPFTweaksServices": {
"Content": "Services - Set to Manual",
"Description": "Sets some services to Manual startup and adjusts the SvcHostSplitThresholdInKB registry value to better match system memory, which can significantly reduce the number of svchost.exe processes.",

Some files were not shown because too many files have changed in this diff Show More