Compare commits

...
74 Commits
Author SHA1 Message Date
GabiandGitHub 9fed8d1c4c Reapply font scaling after theme change (#4782) 2026-07-04 00:29:22 -05:00
Chris TitusandGitHub 4ae3549b8a chore: Update generated dev docs (#4806) 2026-07-04 00:21:28 -05:00
Ivan LepekhaandGitHub e72ac75d13 feat(github): Add version context for issues (#4803)
* 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

* Add WinUtil version input to bug report template

Added input field for WinUtil version in bug report template.

* whoops :^)

* Someone forgot that label is single value parameter

* GH Wiki is a liar

* GH Docs are looking awful
2026-07-04 00:21:26 -05:00
LKmXrandGitHub 9846dd7b49 Fix Multiplane Overlay toggle (#4768)
* Fix MPO values

DisableOverlays should be 0

* Update tweaks.json
2026-07-04 00:20:48 -05:00
eduardodepaivaandGitHub 466d32e690 Add MiniTool Partition Wizard and fix Everything sorting. (#4766) 2026-07-04 00:10:40 -05:00
Chris TitusandGitHub dce1536be0 chore: Update generated dev docs (#4805) 2026-07-04 00:06:25 -05:00
894d62ca68 Added WPFToggleWindowSnapping to tweaks.json (#4748)
* Added WPFToggleWindowSnapping to tweaks.json

* Update tweaks.json

* Update tweaks.json

* Update tweaks.json

* Update tweaks.json

* Update tweaks.json

* Add Window Snapping tweak docs

---------

Co-authored-by: Chris Titus <contact@christitus.com>
2026-07-04 00:05:56 -05:00
27e590577b fix: make tweak/feature link (?) follow font scaling (#4700)
* Update Invoke-WPFUIElements.ps1

* Update Invoke-WPFUIElements.ps1

* Update Invoke-WPFUIElements.ps1

Update Invoke-WPFUIElements.ps1

* Fix tweak link margin scaling

---------

Co-authored-by: Chris Titus <contact@christitus.com>
2026-07-03 23:51:11 -05:00
Chris TitusandGitHub 8147903ff2 chore: Update generated dev docs (#4801) 2026-07-02 15:26:16 -05:00
GabiandGitHub 7a72c73906 Talk about "PowerShell 7 from the Microsoft Store" inside of KnownIssues.md (#4758)
* Talk about "PowerShell 7 from the Microsoft Store" inside of KnownIssues.md

* Update Invoke-WinUtilInstallPSProfile.ps1

* Update KnownIssues.md

* Update KnownIssues.md

* Update KnownIssues.md
2026-07-02 15:25:08 -05:00
Chris TitusandGitHub 32891ada55 Fix DHCP DNS reset handling (#4800) 2026-07-02 15:24:14 -05:00
Chris TitusandGitHub e2d6f8534e chore: Update generated dev docs (#4798) 2026-07-02 13:29:34 -05:00
299b68e82d Added winget uninstall of Copilot. Line 968 Remove-AppxPackage is not working when Copilot is installed back after Windows Updates and the only option that works is using winget (#4797)
Co-authored-by: gepardjaro <192244662+gepardjaro@users.noreply.github.com>
2026-07-02 13:28:57 -05:00
de6652adc0 Remove local file preference storage and cleanup Invoke-WinutilThemeChange (#4617)
* Remove local file preference storage

* Update main.ps1

* Update main.ps1

* Update Set-Preferences.ps1

* Update main.ps1

* Update Set-Preferences.ps1

* Update main.ps1

* Delete functions/private/Set-Preferences.ps1

* simplify Invoke-WinutilThemeChange.ps1

* fix foss highlight in Invoke-WinutilThemeChange.ps1

* Update Invoke-WinutilThemeChange.ps1

* Update Invoke-WinutilThemeChange.ps1

* Update main.ps1

---------

Co-authored-by: Chris Titus <contact@christitus.com>
2026-07-02 13:04:50 -05:00
727ba52a4d Deleted Test-WinUtilPackageManager.ps1 + custom winget and choco installs + remove winget/choco enums and exeptions (#4606)
* Update Invoke-WPFGetInstalled.ps1

* Update Install-WinUtilWinget.ps1

* Update Install-WinUtilChoco.ps1

* Update Install-WinUtilChoco.ps1

* Update Install-WinUtilWinget.ps1

* Delete functions/private/Test-WinUtilPackageManager.ps1

* Update Install-WinUtilChoco.ps1

* Update Install-WinUtilWinget.ps1

* Update Install-WinUtilChoco.ps1

* Update Invoke-WPFGetInstalled.ps1

* Update Invoke-WPFGetInstalled.ps1

* Update Install-WinUtilChoco.ps1

* Update Install-WinUtilWinget.ps1

* Update Install-WinUtilWinget.ps1

* Update Install-WinUtilChoco.ps1

* Update Install-WinUtilWinget.ps1

* Update Install-WinUtilChoco.ps1

* Update Install-WinUtilWinget.ps1

* Update Install-WinUtilChoco.ps1

* Update Install-WinUtilChoco.ps1

* Update Install-WinUtilChoco.ps1

* Update Install-WinUtilChoco.ps1

* Update Install-WinUtilWinget.ps1

* Fixed lastrun.json

* refactor: remove PackageManagers enum and unused custom exception classes

* Update Invoke-WPFUIElements.ps1

* Update Get-WinUtilSelectedPackages.ps1

* Update Set-Preferences.ps1

* Update main.ps1

* Complete package manager enum removal

Use string package-manager preferences throughout the remaining helpers and focused tests. Restore the existing Winget install flow and package-manager probe helper so PR 4606 keeps the current WinGet repair method.

* Fix string keyed package split

---------

Co-authored-by: Chris Titus <contact@christitus.com>
2026-07-02 12:50:57 -05:00
d45c62e470 Cleanup start.ps1 (#4587)
* Update start.ps1

* Update start.ps1

* Update start.ps1

* Update start.ps1

* Update start.ps1

* Update start.ps1

* Update start.ps1

* Update start.ps1

* Update start.ps1

* Fix startup logging regression

---------

Co-authored-by: Chris Titus <contact@christitus.com>
2026-07-02 12:20:38 -05:00
Chris Titus 492d5b57d7 cleanup 2026-07-02 12:06:36 -05:00
Chris TitusandGitHub 58d37bb461 Clean up analyzer warnings across app search and ISO workflows (#4794)
* Clean up analyzer warnings

* Align analyzer warning cleanup policy

* Run PSScriptAnalyzer directly in unittests workflow

* Bind lazy-rendered buttons to click handlers

* Remove WinUtil performance tracing

* Fix Win11 ISO creator temp directory reuse
2026-07-02 12:05:25 -05:00
Sean (ANGRYxScotsman)andGitHub b72bfb03ba Update pre-release.yaml (#4746) 2026-07-02 11:01:18 -05:00
Chris Titus cc2be2d5e8 cleanup 2026-07-02 10:21:41 -05:00
Chris TitusandGitHub 93dc23dd66 Speed up runspace and tab initialization (#4793)
* Add startup performance tracing

* Lazy initialize non-default tabs

* Render install app entries incrementally

* Defer and cache toggle status checks

* Clean up runspace invocation ownership

* Defer GUI runspace pool startup

* Defer status taskbar asset rendering

* Record final speed verification

* Fix deferred install render timer callback

* Add dispatcher smoke coverage for install rendering

* Replace install render timer with dispatcher callbacks

* Gate performance tracing behind compile switch

* Clean up analyzer warnings in speed changes

* Speed up runspace and tab initialization
2026-07-01 23:34:59 -05:00
GabiandGitHub 916dc761ba remove useless xaml changes (#4632) 2026-07-01 21:59:43 -05:00
Chris TitusandGitHub 2cb20893fc Expand Pester coverage across install, tweaks, and UI workflows (#4792)
* Harden Pester CI and discard runspace return values

* Add prioritized test backlog

* Add WinUtil action logging

* Add config integrity tests

* Add XAML control wiring tests

* Add registry and service helper tests

* Add package manager tests

* Add runspace behavior tests

* Add tweak orchestration tests

* Add install workflow tests

* Add update profile tests

* Add AppX removal tests

* Log package installer output

* Add UI state helper tests

* Pin Pester test runner version

* Expand Win11 Creator tests

* Add preferences and theme tests

* Add search filter tests

* Add compile contract tests

* Use single WinUtil session log

* Remove installer output logging helper

* Handle locked WinUtil transcript log

* Avoid appending to active transcript log

* Log install uninstall package identities
2026-07-01 21:49:15 -05:00
Chris TitusandGitHub c3b4f85fce Handle Microsoft Store winget sources (#4790) 2026-07-01 17:15:44 -05:00
Chris TitusandGitHub 104c763132 Fix Win11 Creator product-key validation failures (#4791)
* feat: Enhance Win11 Creator with edition ID handling and update autounattend.xml generation

* Strengthen Pester coverage for config and function files
2026-07-01 17:15:26 -05:00
Chris Titus 8062815655 Merge branch 'main' of https://github.com/ChrisTitusTech/winutil 2026-07-01 13:03:33 -05:00
Chris Titus 58be808823 feat: Add AGENTS.md and SPEC.md for project guidelines and instructions 2026-07-01 13:03:30 -05:00
Chris TitusandGitHub 77dc64cbea chore: Update generated dev docs (#4787) 2026-07-01 12:24:30 -05:00
Sean (ANGRYxScotsman)andGitHub 72d47ba020 Update preset configuration (#4744)
* Update preset.json

* Update preset.json
2026-07-01 12:22:17 -05:00
GabiandGitHub b6b479685a Stop hardcoding C:\ (#4725)
* Stop hardcoding C:\

* Update tweaks.json
2026-07-01 12:21:21 -05:00
Chris TitusandGitHub c7dfbeb7fe chore: Update generated dev docs (#4786) 2026-07-01 12:14:00 -05:00
GabiandGitHub 7c71a39f7a Feature/appx removal tab (#4729)
* feat: add config-driven AppX package removal tab

- Add config/appx.json with curated list of removable AppX packages

- Add AppX Removal tab (WPFTab6) with Select All, Clear, and Remove buttons

- Reuse existing Invoke-WPFUIElements engine for minimal code footprint

- Add Invoke-WPFAppxRemoval.ps1 for background runspace package removal

- Add theme colors for the new tab button in light and dark modes

* yep

* yep

* yep

* yep

* Update inputXML.xaml

* Update Invoke-WPFButton.ps1

* Update Invoke-WPFButton.ps1

* Update Invoke-WPFSelectedCheckboxesUpdate.ps1

* Update appx.json

* Update appx.json

* Update appx.json

* Update tweaks.json

* Update appx.json

* Update appx.json

* Update appx.json

* Update Invoke-WPFAppxRemoval.ps1

* Update Invoke-WPFButton.ps1

* Delete functions/public/Invoke-WPFAppxRemoval.ps1

* Revert "Update Invoke-WPFButton.ps1"

This reverts commit d8705cc08e.

* Revert "Delete functions/public/Invoke-WPFAppxRemoval.ps1"

This reverts commit 9e45d1ad99.

* Update Invoke-WPFAppxRemoval.ps1

* Update Invoke-WPFAppxRemoval.ps1

* Update Invoke-WPFAppxRemoval.ps1

* Update Invoke-WPFButton.ps1

* yep

* Update appx.json

* Update appx.json

* Update tweaks.json

* Update start.ps1

* Update preset.json

* Update tweaks.json

* yep

* yep

* yep

* yep

* yep

* yep

* Update Invoke-WPFAppxRemoval.ps1

* Update Update-WinUtilSelections.ps1

* Update Update-WinUtilSelections.ps1

* yep

* Update Invoke-WPFAppxRemoval.ps1

* yep

* yep

* Update Invoke-WPFAppxRemoval.ps1

* Update appx.json

* Update Invoke-WPFAppxRemoval.ps1

* Update Invoke-WPFAppxRemoval.ps1

* Update appx.json

* Update Invoke-WPFGetInstalled.ps1

* Update Invoke-WPFAppxRemoval.ps1

* yep

* yep

* Update Invoke-WPFSelectedCheckboxesUpdate.ps1

* yep

* yep

* Update Invoke-WPFAppxRemoval.ps1

* Update Invoke-WPFAppxRemoval.ps1

* yep

* Update Invoke-WPFAppxRemoval.ps1

* Update Invoke-WPFAppxRemoval.ps1

* Update appx.json

* Update Invoke-WPFImpex.ps1

* Update Invoke-WPFImpex.ps1

* Update Invoke-WPFAppxRemoval.ps1

* Update preset.json

* Update preset.json

* Update Invoke-WPFSelectedCheckboxesUpdate.ps1

* Update Invoke-WPFAppxRemoval.ps1

* Update tweaks.json

* Update Invoke-WPFAppxRemoval.ps1

* Update Invoke-WPFAppxRemoval.ps1

* Update Invoke-WPFAppxRemoval.ps1

* Update Invoke-WPFAppxRemoval.ps1

* yep

* yep

* Update Invoke-WPFAppxRemoval.ps1

* yep

* Delete functions/private/Find-AppxByNameOrDescription.ps1

* yep

* Update Invoke-WPFButton.ps1

* Update main.ps1

* Update Invoke-WPFTab.ps1

* yep

* yep

* Update themes.json
2026-07-01 12:13:32 -05:00
dependabot[bot]GitHubdependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
0c42b9e458 chore(deps): bump actions/cache from 5 to 6 (#4775)
Bumps [actions/cache](https://github.com/actions/cache) from 5 to 6.
- [Release notes](https://github.com/actions/cache/releases)
- [Changelog](https://github.com/actions/cache/blob/main/RELEASES.md)
- [Commits](https://github.com/actions/cache/compare/v5...v6)

---
updated-dependencies:
- dependency-name: actions/cache
  dependency-version: '6'
  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-29 12:03:27 -05:00
Chris TitusandGitHub 26f89adf95 chore: Update generated dev docs (#4779) 2026-06-29 10:34:21 -05:00
GabiandGitHub 5003f14e0a update edge uninstall (#4666)
* yep

* Update tweaks.json

* Update tweaks.json

* Update tweaks.json

* Update tweaks.json

* Update tweaks.json

* Update tweaks.json
2026-06-29 10:33:31 -05:00
Chris TitusandGitHub 8b6098b36a chore: Update generated dev docs (#4778) 2026-06-29 10:32:35 -05:00
GabiandGitHub 1f0756336f Update tweaks.json (#4774) 2026-06-29 10:32:01 -05:00
Chris TitusandGitHub 0f39648de6 chore: Update generated dev docs (#4763) 2026-06-26 19:34:10 -04:00
GabiandGitHub 7f0d2183e3 fix import not working (#4762) 2026-06-26 18:33:38 -05:00
Sean (ANGRYxScotsman)andGitHub 6ae24d071d Fix doc gen (#4743)
* edit 1

* Update devdocs-generator.ps1
2026-06-23 12:08:21 -05:00
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
197 changed files with 7504 additions and 1329 deletions
+1 -1
View File
@@ -2,7 +2,7 @@
## Our Pledge ## 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 community a harassment-free experience for everyone, regardless of age, body
size, visible or invisible disability, ethnicity, sex characteristics, gender size, visible or invisible disability, ethnicity, sex characteristics, gender
identity and expression, level of experience, education, socio-economic status, identity and expression, level of experience, education, socio-economic status,
+1 -1
View File
@@ -55,7 +55,7 @@ Keep changes small and focused.
### 5. Test Your Changes ### 5. Test Your Changes
Open Pwsh (Not Powershell) as Administrator. Open Powershell as Administrator.
Go to the project folder: Go to the project folder:
@@ -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
+9 -1
View File
@@ -18,10 +18,18 @@ body:
- label: Yes, I did - label: Yes, I did
required: true required: true
- type: input
id: winutil_version
attributes:
label: "Version of WinUtil"
description: "Provide a version that you are using when issue submitted (it can be found in right corner of app)"
validations:
required: true
- type: dropdown - type: dropdown
id: affected_part id: affected_part
attributes: attributes:
label: What part of Winutil are you having issues with? label: What part of WinUtil are you having issues with?
options: options:
- Program Install Tab - Program Install Tab
- Tweaks Tab - Tweaks Tab
+4 -1
View File
@@ -2,4 +2,7 @@ blank_issues_enabled: false
contact_links: contact_links:
- name: 💻 Community Discord - name: 💻 Community Discord
url: https://discord.gg/RUbZUZyByQ 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** ## ⚠️ **IMPORTANT**
- 🛠️ **Supported environments only:** We only support Windows 11. - 🛠️ **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 - type: textarea
id: proposed_solution id: proposed_solution
+4 -2
View File
@@ -1,5 +1,7 @@
# Security Policy # 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: '' tag-prefix: ''
categories: categories:
- title: '🚀 Features' - title: 'Features'
labels: labels:
- 'feature' - 'feature'
- 'enhancement' - 'enhancement'
- 'new feature' - 'new feature'
- title: '🐛 Bug Fixes' - title: 'Bug Fixes'
labels: labels:
- 'hotfix' - 'hotfix'
- 'bugfix' - 'bugfix'
- 'bug' - 'bug'
- title: '📚 Documentation' - title: 'Documentation'
label: 'documentation' label: 'documentation'
- title: '🎨 UI/UX Improvements' - title: 'UI/UX Improvements'
label: 'ui update' label: 'ui update'
change-template: '- $TITLE @$AUTHOR (#$NUMBER)' change-template: '- $TITLE @$AUTHOR (#$NUMBER)'
template: | template: |
+1 -1
View File
@@ -15,7 +15,7 @@ jobs:
contents: write contents: write
steps: steps:
- name: Checkout - name: Checkout
uses: actions/checkout@v6 uses: actions/checkout@v7
- name: Auto-approve PR - name: Auto-approve PR
if: github.event.pull_request.user.login == 'github-actions[bot]' if: github.event.pull_request.user.login == 'github-actions[bot]'
@@ -9,7 +9,7 @@ jobs:
runs-on: ubuntu-latest runs-on: ubuntu-latest
steps: steps:
- name: Checkout repository - name: Checkout repository
uses: actions/checkout@v6 uses: actions/checkout@v7
- name: Check if PR was merged - name: Check if PR was merged
if: github.event.pull_request.merged == true if: github.event.pull_request.merged == true
+3 -3
View File
@@ -17,11 +17,11 @@ jobs:
uses: actions/stale@v10 uses: actions/stale@v10
with: with:
# A list of labels to reference when looking through issues, # 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. # then skip this issue, and never try to stale and/or close it.
exempt-issue-labels: "Keep Issue Open" exempt-issue-labels: "Keep Issue Open"
# Split it into two weeks, after one week the issue will be marked as stale, # 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. # after another week have passed without any update, the issue will then be closed.
days-before-issue-stale: 90 days-before-issue-stale: 90
days-before-issue-close: 365 days-before-issue-close: 365
# NEVER mark PRs as Stale or Close + this workflow should never have write permissions on PRs, EVER! # 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 runs-on: windows-latest
steps: steps:
- name: Checkout Sources - 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 shell: pwsh
run: | run: |
Set-ExecutionPolicy Bypass -Scope Process -Force; ./Compile.ps1 Set-ExecutionPolicy Bypass -Scope Process -Force; ./Compile.ps1
+3 -3
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 \ 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 && sudo dpkg -i ${{ runner.temp }}/hugo.deb
- name: Checkout - name: Checkout
uses: actions/checkout@v6 uses: actions/checkout@v7
with: with:
submodules: recursive submodules: recursive
fetch-depth: 0 fetch-depth: 0
@@ -81,7 +81,7 @@ jobs:
run: "cd docs && [[ -f package-lock.json || -f npm-shrinkwrap.json ]] && npm ci || true" run: "cd docs && [[ -f package-lock.json || -f npm-shrinkwrap.json ]] && npm ci || true"
- name: Cache Restore - name: Cache Restore
id: cache-restore id: cache-restore
uses: actions/cache/restore@v5 uses: actions/cache/restore@v6
with: with:
path: | path: |
${{ runner.temp }}/hugo_cache ${{ runner.temp }}/hugo_cache
@@ -97,7 +97,7 @@ jobs:
--cacheDir "${{ runner.temp }}/hugo_cache" --cacheDir "${{ runner.temp }}/hugo_cache"
- name: Cache Save - name: Cache Save
id: cache-save id: cache-save
uses: actions/cache/save@v5 uses: actions/cache/save@v6
with: with:
path: | path: |
${{ runner.temp }}/hugo_cache ${{ runner.temp }}/hugo_cache
+2 -2
View File
@@ -17,7 +17,7 @@ jobs:
CERTIFICATE_BASE64: ${{ secrets.CERTIFICATE_BASE64 }} CERTIFICATE_BASE64: ${{ secrets.CERTIFICATE_BASE64 }}
steps: steps:
- name: Checkout Repository - name: Checkout Repository
uses: actions/checkout@v6 uses: actions/checkout@v7
- name: Generate Dev Docs and Update JSON Links - name: Generate Dev Docs and Update JSON Links
shell: pwsh shell: pwsh
@@ -37,7 +37,7 @@ jobs:
with: with:
token: ${{ secrets.AUTO_MERGE }} token: ${{ secrets.AUTO_MERGE }}
commit-message: 'chore: Update documentation links in JSON configs' commit-message: 'chore: Update documentation links in JSON configs'
title: 'chore: Update Generated Dev Docs' title: 'chore: Update documentation links in JSON configs'
body: 'Automated update of documentation links in JSON configs from pre-release build' body: 'Automated update of documentation links in JSON configs from pre-release build'
branch: docs-update branch: docs-update
delete-branch: true delete-branch: true
+1 -1
View File
@@ -11,7 +11,7 @@ jobs:
steps: steps:
- name: Checkout code - name: Checkout code
uses: actions/checkout@v6 uses: actions/checkout@v7
- name: Check if winutil.ps1 exists - name: Check if winutil.ps1 exists
id: check_existence 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') if: (github.event_name == 'schedule' && github.repository == 'ChrisTitusTech/winutil') || (github.event_name != 'schedule')
steps: steps:
- name: Checkout 🛎️ - name: Checkout 🛎️
uses: actions/checkout@v6 uses: actions/checkout@v7
with: with:
persist-credentials: false persist-credentials: false
+23 -12
View File
@@ -8,32 +8,43 @@ jobs:
name: PS Script Analyzer name: PS Script Analyzer
runs-on: ubuntu-latest runs-on: ubuntu-latest
steps: steps:
- uses: actions/checkout@v6 - uses: actions/checkout@v7
- name: lint - name: Install PSScriptAnalyzer
uses: devblackops/github-action-psscriptanalyzer@master run: |
with: Set-PSRepository -Name PSGallery -InstallationPolicy Trusted
sendComment: false Install-Module -Name PSScriptAnalyzer -RequiredVersion 1.20.0 -Scope CurrentUser -Force
settingsPath: lint/PSScriptAnalyser.ps1 Import-Module PSScriptAnalyzer -RequiredVersion 1.20.0 -Force
failOnErrors: false Get-Module PSScriptAnalyzer | Select-Object Name, Version, Path
failOnWarnings: false shell: pwsh
failOnInfos: false - name: Run PSScriptAnalyzer
run: |
$results = Invoke-ScriptAnalyzer -Path . -Settings ./lint/PSScriptAnalyser.ps1 -Recurse
if ($results) {
$results | Format-Table -AutoSize | Out-String -Width 4096 | Write-Host
} else {
Write-Host "PSScriptAnalyzer found no diagnostics."
}
shell: pwsh
test: test:
runs-on: windows-latest runs-on: windows-latest
steps: steps:
- name: Checkout code - name: Checkout code
uses: actions/checkout@v6 uses: actions/checkout@v7
- name: Install Pester - name: Install Pester
run: | run: |
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
Install-Module -Name Pester -Force -SkipPublisherCheck -AllowClobber Install-Module -Name Pester -RequiredVersion 5.8.0 -Force -SkipPublisherCheck -AllowClobber
Import-Module Pester -RequiredVersion 5.8.0 -Force
Get-Module Pester | Select-Object Name, Version, Path
shell: pwsh shell: pwsh
- name: Run Pester tests - name: Run Pester tests
run: | run: |
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
Invoke-Pester -Path 'pester/*.Tests.ps1' -Output Detailed Import-Module Pester -RequiredVersion 5.8.0 -Force
Invoke-Pester -Path 'pester/*.Tests.ps1' -Output Detailed -CI
shell: pwsh shell: pwsh
env: env:
+1
View File
@@ -5,6 +5,7 @@ Microsoft.PowerShell.ConsoleHost.dll
winutil.exe.config winutil.exe.config
winutil.ps1 winutil.ps1
binary/ binary/
testResults.xml
# general software/os specific # general software/os specific
desktop.ini desktop.ini
+193
View File
@@ -0,0 +1,193 @@
# AGENTS.md
Drop-in operating instructions for coding agents. Read this file before every task.
**Working code only. Finish the job. Plausibility is not correctness.**
This repository follows the AGENTS.md convention: these instructions are for Codex, Claude Code, Cursor, Windsurf, Copilot, Aider, Devin, Amp, and other coding agents that read `AGENTS.md`.
## 0. Non-Negotiables
These rules override everything else in this file when in conflict:
1. **Do not edit `winutil.ps1` directly.** It is generated build output. Change source files and compile.
2. **Do not commit `winutil.ps1`.** It is ignored locally and generated by GitHub Actions for releases.
3. **Never fabricate.** Do not invent file paths, function names, command output, test results, commit hashes, or API behavior. Read the file or run the command.
4. **Disagree when the premise is wrong.** Say what is wrong before acting on it.
5. **Stop when genuinely ambiguous.** If two interpretations would produce materially different diffs, ask before editing.
6. **Touch only what the task requires.** No drive-by refactors, formatting sweeps, or unrelated cleanup.
7. **Verify before saying done.** A plausible-looking diff is not proof.
## 1. Project Context
WinUtil is a Windows PowerShell utility with a WPF interface. The repository is maintained as modular source, but the distributed artifact is one compiled PowerShell script.
### Stack
- Language: Windows PowerShell / PowerShell.
- UI: WPF via `xaml/inputXML.xaml`.
- Configuration: JSON files under `config/`.
- Tests: Pester tests under `pester/`.
- Lint: PowerShell Script Analyzer with settings in `lint/PSScriptAnalyser.ps1`.
- Docs: Hugo site under `docs/`.
- Release artifact: generated root `winutil.ps1`.
### Key Commands
- Compile:
```powershell
.\Compile.ps1
```
- Compile and run GUI:
```powershell
.\Compile.ps1 -Run
```
- Run tests:
```powershell
Import-Module Pester -RequiredVersion 5.8.0 -Force
Invoke-Pester -Path 'pester/*.Tests.ps1' -Output Detailed
```
- Run Script Analyzer with project settings when available:
```powershell
Invoke-ScriptAnalyzer -Path . -Settings .\lint\PSScriptAnalyser.ps1 -Recurse
```
Prefer the narrowest useful verification while iterating. Use the full relevant check before finishing.
## 2. Source Of Truth
Make durable changes only in files consumed by `Compile.ps1` or in documentation/test files:
- `scripts/start.ps1` for startup/bootstrap code.
- `functions/public/*.ps1` for UI-facing and user-facing workflows.
- `functions/private/*.ps1` for internal helpers.
- `config/*.json` for applications, tweaks, features, DNS, presets, navigation, themes, and related declarative data.
- `xaml/inputXML.xaml` for the WPF UI layout.
- `tools/autounattend.xml` for the embedded unattended Windows setup template.
- `scripts/main.ps1` for the final entrypoint and GUI initialization logic appended during compile.
- `pester/*.Tests.ps1` for automated checks.
- `docs/` for Hugo documentation.
If behavior changes require the compiled script to change, update these source files and run `.\Compile.ps1` only to verify generation.
## 3. Build Model
`Compile.ps1` combines the repository sources into `winutil.ps1` in this order:
1. Read `scripts/start.ps1` and replace `#{replaceme}` with the current `yy.MM.dd` build date.
2. Append every file under `functions/` recursively.
3. Convert each `config/*.json` file into embedded `$sync.configs` objects.
4. Special-case `config/applications.json` so keys receive the `WPFInstall` prefix in compiled config.
5. Embed `xaml/inputXML.xaml` into `$inputXML`.
6. Embed `tools/autounattend.xml` into `$WinUtilAutounattendXml`.
7. Append `scripts/main.ps1`.
8. Write the result to root `winutil.ps1`.
Because the final script is concatenated, do not rely on runtime module imports or source-relative dot-sourcing unless the compiled script will also contain the required code/data.
## 4. Before Editing
- State the plan in one or two sentences before editing. For non-trivial work, include the verification you intend to run.
- Read the files you will touch and the files that call them.
- Match existing patterns even when a different greenfield design would be cleaner.
- Surface assumptions when they affect behavior, compatibility, or user data.
- If two approaches have meaningful tradeoffs, name them before choosing. Trivial tasks can proceed directly.
## 5. Coding Guidelines
- Prefer the minimum code that solves the stated problem.
- Keep PowerShell functions in one function file when practical, with the file name matching the primary function name.
- Use approved PowerShell verb-noun names and follow the existing `WPF` / `WinUtil` naming conventions.
- Keep UI event handler names aligned with XAML element names. A button named `WPFExampleButton` is typically handled by `Invoke-WPFExampleButton`.
- Use `$sync` for shared state and UI references, consistent with the existing runspace model.
- Update WPF controls through the UI dispatcher when running work in a background runspace.
- Keep config-driven features in JSON when they fit the existing schema instead of hard-coding lists in PowerShell.
- Preserve undo/original-state data for tweaks so users can reverse changes.
- Do not add abstractions, configurability, hooks, or "future extensibility" unless the task needs them now.
- Clean up orphans created by your own changes, such as unused variables or functions made obsolete by the edit.
- Avoid broad formatting-only edits, especially in JSON config files, XAML, docs, and generated output.
## 6. Runtime And Safety Rules
- WinUtil performs system-level Windows changes. Treat registry, services, AppX removal, package manager, Windows Update, ISO, and unattended setup changes as high-risk.
- Prefer existing helper functions for WinGet, Chocolatey, registry, services, progress, and UI updates.
- Keep tweaks reversible where the schema supports it by including original values or original states.
- Never modify a user's original ISO in-place; follow existing copy/mount/export patterns.
- Avoid storing credentials, secrets, or machine-specific paths in repo files.
- Preserve logging and user feedback patterns for long-running or destructive operations.
## 7. Surgical Changes
- Do not improve adjacent code, comments, formatting, imports, or docs unless required.
- Do not refactor working code because you are already in the file.
- Do not delete pre-existing dead code unless asked; mention it in the summary if relevant.
- Keep diffs reviewable. Every changed line should trace to the user's request.
- If a change starts spreading across unrelated areas, pause and reassess the plan.
## 8. Verification
Define success in terms that can be checked, then check it.
- For compile/build changes, run `.\Compile.ps1`.
- For GUI behavior changes, run `.\Compile.ps1 -Run` when practical and verify the affected path manually.
- For config changes, run the compile check and relevant Pester tests.
- For function changes, run the relevant Pester tests or add/update focused tests when practical.
- For docs-only changes, proofread the changed files and skip runtime tests unless docs generation is affected.
- Read command output. Do not report tests as passing unless they actually passed.
- If verification fails, fix the cause rather than weakening the test.
If a check cannot be run, say exactly why and what residual risk remains.
## 9. Generated Files And Git Hygiene
- Treat local `winutil.ps1` changes as disposable compile output.
- Never stage or commit `winutil.ps1`, `docs/public/`, `docs/resources/`, `binary/`, editor folders, or other ignored build artifacts.
- Do not remove `.gitignore` rules that keep generated artifacts out of Git.
- Before finishing, check `git status --short` and separate your changes from pre-existing user changes.
- Do not revert user changes unless explicitly asked.
- Commit messages, when requested, should be descriptive: short subject under 72 characters, body explaining why when needed.
## 10. Documentation Expectations
- Update `docs/content/` when user-facing behavior changes.
- Update developer docs when architecture, build flow, config schema, or contribution workflow changes.
- Keep README changes brief and high-level.
- Put detailed user and developer documentation under `docs/`.
- Keep `SPEC.md` aligned with build/runtime contract changes.
## 11. Communication Style
- Be direct and concise. Start with the answer or action.
- No flattery, filler, ceremonial closings, or fake certainty.
- Use bullets only when they improve scanning.
- Report what changed, how it was verified, and anything not done.
- If the user asks for a review, lead with findings and file/line references.
## 12. When To Ask
Ask before proceeding when:
- The request has two plausible interpretations and the choice materially changes behavior or files touched.
- The change affects release generation, generated artifacts, migrations, or high-risk Windows behavior in a way the user did not specify.
- You need credentials, secrets, production resources, or access you do not have.
- The user's stated goal conflicts with the literal request.
Proceed without asking when:
- The task is trivial and reversible.
- Ambiguity can be resolved by reading the code or running a local command.
- The user already answered the question in this session.
## 13. Project Learnings
When the user corrects an agent approach, add or tighten one concrete rule here before ending the session. Keep this section short and prune rules that no longer matter.
- Keep `winutil.ps1` generated-only: change source files, compile to verify, and never stage the generated script.
- Keep WinUtil runtime logging in the existing timestamped `%LocalAppData%\winutil\logs\winutil_*.log` session file; do not create a separate root `winutil.log`.
- Import Pester 5.8.0 before running tests so `Invoke-Pester -Output Detailed -CI` does not resolve to Windows' inbox Pester 3.4.0.
- Keep package install/uninstall process launches simple unless explicitly requested; do not add a separate stdout/stderr process logging helper for winget or Chocolatey.
- When the active log file is owned by `Start-Transcript`, do not call `Add-Content` against that file; write to host output so the transcript captures the line in the same log file without recording a terminating-error diagnostic.
- Log install/uninstall package names and package-manager IDs before queuing background runspace work; do not rely on runspace host output for the package identity.
- For Win11 Creator, start each new ISO modification in a fresh `WinUtil_Win11ISO_*` temp directory; existing-work detection is only for resuming/exporting already modified media.
- For Script Analyzer cleanup, fix actionable source warnings first and do not globally suppress accepted convention warnings such as plural names, `ShouldProcess` on UI helpers, `$global:sync`, or compile-time cross-file false positives.
- For DNS DHCP reset, keep the cmdlet reset and explicitly set IPv4 and IPv6 DNS source to DHCP.
+3 -1
View File
@@ -10,7 +10,9 @@ $sync.configs = @{}
$script = (Get-Content -Path scripts\start.ps1) -replace '#{replaceme}', (Get-Date -Format 'yy.MM.dd') $script = (Get-Content -Path scripts\start.ps1) -replace '#{replaceme}', (Get-Date -Format 'yy.MM.dd')
$script += Get-ChildItem -Path functions -Recurse -File | Get-Content -Raw $script += Get-ChildItem -Path functions -Recurse -File | ForEach-Object {
Get-Content -Path $_.FullName -Raw
}
Get-ChildItem config | ForEach-Object { Get-ChildItem config | ForEach-Object {
$obj = Get-Content -Path $_.FullName -Raw | ConvertFrom-Json $obj = Get-Content -Path $_.FullName -Raw | ConvertFrom-Json
+105
View File
@@ -0,0 +1,105 @@
# SPEC.md
## Project Contract
WinUtil is a Windows PowerShell utility with a WPF interface. The repository is maintained as modular source files, but the released artifact is a single generated `winutil.ps1` script.
The compiled `winutil.ps1` is not source code for editing or review. It is generated by `Compile.ps1` and produced during release automation. All durable changes must be made to the source files that feed the compiler.
## Goals
- Provide a single-script Windows utility that can be launched from PowerShell.
- Keep development modular enough for contributors to work on functions, config, UI, docs, and tooling independently.
- Make install, tweak, feature, repair, update, and ISO workflows discoverable from the WPF UI.
- Keep common lists and options declarative in JSON config where possible.
- Preserve a repeatable compile process so local builds and GitHub Actions builds produce the distributable script from the same inputs.
## Non-Goals
- `winutil.ps1` is not hand-maintained.
- The project is not structured as a PowerShell module at runtime.
- The GUI is not a separate packaged desktop application in this repository's normal release path.
- Generated files should not be reviewed as source changes.
## Repository Layout
- `Compile.ps1`: build script that creates `winutil.ps1`.
- `scripts/start.ps1`: startup/bootstrap segment used at the beginning of the compiled script.
- `scripts/main.ps1`: main entrypoint appended at the end of the compiled script.
- `functions/public/`: public/UI-facing PowerShell functions.
- `functions/private/`: internal helper PowerShell functions.
- `config/`: JSON configuration consumed at compile time and embedded into `$sync.configs`.
- `xaml/inputXML.xaml`: WPF UI markup embedded into the compiled script.
- `tools/autounattend.xml`: unattended setup XML embedded for Windows ISO workflows.
- `pester/`: Pester tests for config and function checks.
- `lint/PSScriptAnalyser.ps1`: PowerShell Script Analyzer settings.
- `docs/`: Hugo documentation site.
- `winutil.ps1`: ignored generated build artifact.
## Compile Specification
`Compile.ps1` must produce a standalone root `winutil.ps1` by combining all required project files.
The compile flow is:
1. Initialize shared state with `$sync = [Hashtable]::Synchronized(@{})` and `$sync.configs = @{}`.
2. Read `scripts/start.ps1`.
3. Replace `#{replaceme}` in startup code with the current `yy.MM.dd` build date.
4. Append raw content from all files under `functions/` recursively.
5. For every file in `config/`, parse JSON and embed it into `$sync.configs.<basename>`.
6. Special-case `config/applications.json` so application keys are emitted with the `WPFInstall` prefix.
7. Embed `xaml/inputXML.xaml` as `$inputXML`.
8. Embed `tools/autounattend.xml` as `$WinUtilAutounattendXml`.
9. Append `scripts/main.ps1`.
10. Write the combined script to `winutil.ps1`.
11. If `-Run` is supplied, execute the generated script.
The generated script must have everything it needs from repository sources embedded or appended by this process.
## Runtime Model
- WinUtil runs in PowerShell on Windows and uses WPF for the UI.
- Shared mutable state is stored in `$sync`, including configs, UI element references, runspace state, selections, and progress.
- Long-running operations should use runspaces or existing async patterns so the UI remains responsive.
- UI updates from background work must be dispatched back to the WPF UI thread.
- Declarative features such as apps, tweaks, presets, DNS providers, and navigation should stay in `config/*.json` unless code is required.
## UI And Event Contract
- UI layout lives in `xaml/inputXML.xaml`.
- Named WPF controls are discovered and stored in `$sync`.
- Button/action wiring follows existing naming conventions, where an element named like `WPFThingButton` maps to a function named like `Invoke-WPFThingButton`.
- When adding controls, ensure the XAML name, config key, and PowerShell function names line up with the existing event system.
## Configuration Contract
Config files must remain valid JSON and compile cleanly through `ConvertFrom-Json`.
`config/applications.json` defines installable applications. Each application entry should include the fields expected by tests and UI code, such as package manager IDs, category, display content, description, and link.
`config/tweaks.json` defines Windows tweaks. Registry and service changes should include original values or original states when applicable so undo workflows can restore user systems.
Preset and navigation files should reference valid config keys. Avoid renaming config keys unless all presets, UI references, docs, and code paths are updated together.
## Safety Requirements
- Registry, service, package manager, Windows Update, AppX removal, and ISO operations can affect the host system. Changes must be explicit, reversible where practical, and consistent with existing logging and confirmation patterns.
- Tweak changes should include undo metadata when the schema supports it.
- Package installation should prefer existing WinGet and Chocolatey helper functions.
- ISO workflows must not modify the user's original ISO file; they should work on copied/mounted content following existing patterns.
## Testing And CI
Expected validation for source changes:
- `.\Compile.ps1` verifies the compiler can generate `winutil.ps1`.
- `.\Compile.ps1 -Run` compiles and launches the generated utility for manual GUI verification.
- `Install-Module -Name Pester -RequiredVersion 5.8.0 -Scope CurrentUser -Force -SkipPublisherCheck` installs the supported Pester version.
- `Import-Module Pester -RequiredVersion 5.8.0 -Force; Invoke-Pester -Path 'pester/*.Tests.ps1' -Output Detailed -CI` runs the Pester suite.
- GitHub Actions also runs a compile check and PowerShell Script Analyzer with `lint/PSScriptAnalyser.ps1`.
The generated `winutil.ps1` may appear locally after compile. It remains ignored build output and must not be committed.
## Release Artifact
GitHub Actions is responsible for producing the release `winutil.ps1` from repository sources. A release should be considered valid only if the generated script came from the compile process, not from direct manual edits to `winutil.ps1`.
+134 -9
View File
@@ -161,6 +161,15 @@
"winget": "Cemu.Cemu", "winget": "Cemu.Cemu",
"foss": true "foss": true
}, },
"chatgpt": {
"category": "Development",
"choco": "na",
"content": "ChatGPT Desktop",
"description": "The official ChatGPT desktop app for Windows, distributed through the Microsoft Store.",
"link": "https://apps.microsoft.com/detail/9nt1r1c2hh7j",
"winget": "msstore:9NT1R1C2HH7J",
"foss": false
},
"chatterino": { "chatterino": {
"category": "Communications", "category": "Communications",
"choco": "chatterino", "choco": "chatterino",
@@ -188,6 +197,33 @@
"winget": "Hibbiki.Chromium", "winget": "Hibbiki.Chromium",
"foss": true "foss": true
}, },
"cinebenchr23": {
"category": "Pro Tools",
"choco": "na",
"content": "Cinebench R23",
"description": "Cinebench R23 is a benchmark tool for comparing CPU rendering performance across systems.",
"link": "https://www.maxon.net/en/cinebench",
"winget": "Maxon.CinebenchR23",
"foss": false
},
"claude": {
"category": "Development",
"choco": "claude",
"content": "Claude Desktop",
"description": "Anthropic's Claude desktop application for focused AI-assisted work and chat.",
"link": "https://claude.ai/download",
"winget": "Anthropic.Claude",
"foss": false
},
"claude-code": {
"category": "Development",
"choco": "claude-code",
"content": "Claude Code",
"description": "Anthropic's agentic coding tool for terminal and IDE development workflows.",
"link": "https://code.claude.com/",
"winget": "Anthropic.ClaudeCode",
"foss": false
},
"cmake": { "cmake": {
"category": "Development", "category": "Development",
"choco": "cmake", "choco": "cmake",
@@ -197,6 +233,15 @@
"winget": "Kitware.CMake", "winget": "Kitware.CMake",
"foss": true "foss": true
}, },
"codex": {
"category": "Development",
"choco": "codex",
"content": "Codex",
"description": "Codex CLI is an OpenAI coding agent that runs locally in your terminal.",
"link": "https://developers.openai.com/codex/cli",
"winget": "OpenAI.Codex",
"foss": true
},
"cpuz": { "cpuz": {
"category": "Pro Tools", "category": "Pro Tools",
"choco": "cpu-z", "choco": "cpu-z",
@@ -314,6 +359,15 @@
"winget": "Microsoft.DotNet.DesktopRuntime.10", "winget": "Microsoft.DotNet.DesktopRuntime.10",
"foss": true "foss": true
}, },
"dropbox": {
"category": "Utilities",
"choco": "dropbox",
"content": "Dropbox",
"description": "Dropbox is a cloud storage client for syncing files, sharing content, and keeping documents available across devices.",
"link": "https://www.dropbox.com/desktop",
"winget": "Dropbox.Dropbox",
"foss": false
},
"eaapp": { "eaapp": {
"category": "Games", "category": "Games",
"choco": "ea-app", "choco": "ea-app",
@@ -539,6 +593,15 @@
"winget": "DuongDieuPhap.ImageGlass", "winget": "DuongDieuPhap.ImageGlass",
"foss": true "foss": true
}, },
"internetdownloadmanager": {
"category": "Utilities",
"choco": "internet-download-manager",
"content": "Internet Download Manager",
"description": "Internet Download Manager is a download manager for accelerating, resuming, and scheduling file downloads.",
"link": "https://www.internetdownloadmanager.com/",
"winget": "Tonec.InternetDownloadManager",
"foss": false
},
"irfanview": { "irfanview": {
"category": "Multimedia Tools", "category": "Multimedia Tools",
"choco": "irfanview", "choco": "irfanview",
@@ -624,11 +687,20 @@
"category": "Utilities", "category": "Utilities",
"choco": "jpegview", "choco": "jpegview",
"content": "JPEG View", "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", "link": "https://github.com/sylikc/jpegview",
"winget": "sylikc.JPEGView", "winget": "sylikc.JPEGView",
"foss": true "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": { "klite": {
"category": "Multimedia Tools", "category": "Multimedia Tools",
"choco": "k-litecodecpack-standard", "choco": "k-litecodecpack-standard",
@@ -647,6 +719,15 @@
"winget": "XBMCFoundation.Kodi", "winget": "XBMCFoundation.Kodi",
"foss": true "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": { "lazygit": {
"category": "Development", "category": "Development",
"choco": "lazygit", "choco": "lazygit",
@@ -701,6 +782,15 @@
"winget": "Element.Element", "winget": "Element.Element",
"foss": true "foss": true
}, },
"minitoolpartitionwizard": {
"category": "Utilities",
"choco": "minitoolpartitionwizard",
"content": "MiniTool Partition Wizard",
"description": "Comprehensive free partition manager that performs advanced operations Windows natively cannot, such as merging partitions, converting file systems, and organizing disk capacity.",
"link": "https://www.partitionwizard.com/",
"winget": "MiniTool.PartitionWizard.Free",
"foss": false
},
"modrinth": { "modrinth": {
"category": "Games", "category": "Games",
"choco": "modrinth-app", "choco": "modrinth-app",
@@ -768,7 +858,7 @@
"category": "Multimedia Tools", "category": "Multimedia Tools",
"choco": "nomacs", "choco": "nomacs",
"content": "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.", "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/", "link": "https://nomacs.org/",
"winget": "nomacs.nomacs", "winget": "nomacs.nomacs",
"foss": true "foss": true
@@ -786,7 +876,7 @@
"category": "Selfhosted Tools", "category": "Selfhosted Tools",
"choco": "netbird", "choco": "netbird",
"content": "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/", "link": "https://netbird.io/",
"winget": "Netbird.Netbird", "winget": "Netbird.Netbird",
"foss": true "foss": true
@@ -845,6 +935,14 @@
"winget": "OpenJS.NodeJS.LTS", "winget": "OpenJS.NodeJS.LTS",
"foss": true "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": { "notepadplus": {
"category": "Multimedia Tools", "category": "Multimedia Tools",
"choco": "notepadplusplus", "choco": "notepadplusplus",
@@ -902,8 +1000,8 @@
"onlyoffice": { "onlyoffice": {
"category": "Multimedia Tools", "category": "Multimedia Tools",
"choco": "onlyoffice", "choco": "onlyoffice",
"content": "ONLYOffice Desktop", "content": "ONLYOFFICE Desktop",
"description": "ONLYOffice Desktop is a comprehensive office suite for document editing and collaboration.", "description": "ONLYOFFICE Desktop is a comprehensive office suite for document editing and collaboration.",
"link": "https://www.onlyoffice.com/desktop.aspx", "link": "https://www.onlyoffice.com/desktop.aspx",
"winget": "ONLYOFFICE.DesktopEditors", "winget": "ONLYOFFICE.DesktopEditors",
"foss": true "foss": true
@@ -930,7 +1028,7 @@
"category": "Pro Tools", "category": "Pro Tools",
"choco": "openvpn-connect", "choco": "openvpn-connect",
"content": "OpenVPN Connect", "content": "OpenVPN Connect",
"description": "OpenVPN Connect is an 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/", "link": "https://openvpn.net/",
"winget": "OpenVPNTechnologies.OpenVPNConnect", "winget": "OpenVPNTechnologies.OpenVPNConnect",
"foss": false "foss": false
@@ -993,7 +1091,7 @@
"category": "Games", "category": "Games",
"choco": "playnite", "choco": "playnite",
"content": "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.", "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/", "link": "https://playnite.link/",
"winget": "Playnite.Playnite", "winget": "Playnite.Playnite",
"foss": true "foss": true
@@ -1047,7 +1145,7 @@
"category": "Games", "category": "Games",
"choco": "prismlauncher", "choco": "prismlauncher",
"content": "Prism Launcher", "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/", "link": "https://prismlauncher.org/",
"winget": "PrismLauncher.PrismLauncher", "winget": "PrismLauncher.PrismLauncher",
"foss": true "foss": true
@@ -1259,6 +1357,15 @@
"winget": "SlackTechnologies.Slack", "winget": "SlackTechnologies.Slack",
"foss": false "foss": false
}, },
"startallback": {
"category": "Utilities",
"choco": "StartAllBack",
"content": "StartAllBack",
"description": "StartAllBack restores and improves Windows taskbar, Start menu, File Explorer, and shell UI behavior.",
"link": "https://www.startallback.com/",
"winget": "StartIsBack.StartAllBack",
"foss": false
},
"steam": { "steam": {
"category": "Games", "category": "Games",
"choco": "steam-client", "choco": "steam-client",
@@ -1317,7 +1424,7 @@
"category": "Communications", "category": "Communications",
"choco": "teamspeak", "choco": "teamspeak",
"content": "TeamSpeak 3", "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/", "link": "https://www.teamspeak.com/",
"winget": "TeamSpeakSystems.TeamSpeakClient", "winget": "TeamSpeakSystems.TeamSpeakClient",
"foss": false "foss": false
@@ -1421,6 +1528,15 @@
"winget": "Unity.UnityHub", "winget": "Unity.UnityHub",
"foss": false "foss": false
}, },
"everything": {
"category": "Utilities",
"choco": "everything",
"content": "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": { "vc2015_32": {
"category": "Microsoft Tools", "category": "Microsoft Tools",
"choco": "vcredist2015", "choco": "vcredist2015",
@@ -1538,6 +1654,15 @@
"winget": "Waterfox.Waterfox", "winget": "Waterfox.Waterfox",
"foss": true "foss": true
}, },
"whatsapp": {
"category": "Communications",
"choco": "na",
"content": "WhatsApp Desktop",
"description": "WhatsApp Desktop is the official Windows desktop messaging app from Meta, distributed through the Microsoft Store.",
"link": "https://apps.microsoft.com/detail/9nksqgp7f2nh",
"winget": "msstore:9NKSQGP7F2NH",
"foss": false
},
"wingetui": { "wingetui": {
"category": "Utilities", "category": "Utilities",
"choco": "wingetui", "choco": "wingetui",
+5 -6
View File
@@ -73,12 +73,11 @@
"Order": "5", "Order": "5",
"Description": "Show the selected applications" "Description": "Show the selected applications"
}, },
"WPFToggleFOSSHighlight": { "WPFInstallFOSSInfo": {
"Content": "Highlight FOSS", "Content": "Free and Open Source Software",
"Category": "__Selection", "Category": "__Selection",
"Type": "Toggle", "Type": "Note",
"Checked": true, "Order": "0",
"Order": "6", "Description": "Information about the #FOSS label on application entries"
"Description": "Toggle the green highlight for FOSS applications"
} }
} }
+233
View File
@@ -0,0 +1,233 @@
{
"WPFAppxMicrosoft_WindowsFeedbackHub": {
"Category": "Microsoft Apps",
"Content": "Feedback Hub",
"Description": "Allows users to submit bug reports, feature suggestions, and diagnostic data directly to Microsoft.",
"Panel": "0",
"PackageId": "Microsoft.WindowsFeedbackHub"
},
"WPFAppxMicrosoft_GetHelp": {
"Category": "Microsoft Apps",
"Content": "Get Help",
"Description": "Provides access to automated troubleshooting guides, support documentation, and direct Microsoft customer assistance.",
"Panel": "0",
"PackageId": "Microsoft.GetHelp"
},
"WPFAppxMicrosoft_OutlookForWindows": {
"Category": "Microsoft Apps",
"Content": "Outlook for Windows",
"Description": "Provides modern email management, calendar scheduling, and contact organization features.",
"Panel": "0",
"PackageId": "Microsoft.OutlookForWindows"
},
"WPFAppxMSTeams": {
"Category": "Microsoft Apps",
"Content": "Microsoft Teams",
"Description": "Facilitates instant messaging, video conferencing, file sharing, and workspace collaboration.",
"Panel": "0",
"PackageId": "MSTeams"
},
"WPFAppxClipchamp_Clipchamp": {
"Category": "Utilities & Productivity",
"Content": "Clipchamp",
"Description": "Provides a user-friendly video editor with built-in templates, effects, and timeline editing tools.",
"Panel": "0",
"PackageId": "Clipchamp.Clipchamp"
},
"WPFAppxMicrosoft_MicrosoftOfficeHub": {
"Category": "Microsoft Apps",
"Content": "Microsoft 365",
"Description": "Serves as a centralized launcher and dashboard for accessing cloud-based Microsoft 365 apps and recent documents.",
"Panel": "0",
"PackageId": "Microsoft.MicrosoftOfficeHub"
},
"WPFAppxMicrosoft_ZuneMusic": {
"Category": "Utilities & Productivity",
"Content": "Media Player",
"Description": "Plays local audio and video files with modern playlist management and casting capabilities.",
"Panel": "0",
"PackageId": "Microsoft.ZuneMusic"
},
"WPFAppxMicrosoft_BingSearch": {
"Category": "Bing & Web Services",
"Content": "Bing Search",
"Description": "Integrates Microsoft Bing search capabilities and web services directly into the operating system.",
"Panel": "1",
"PackageId": "Microsoft.BingSearch"
},
"WPFAppxMicrosoftCorporationII_QuickAssist": {
"Category": "Utilities & Productivity",
"Content": "Quick Assist",
"Description": "Enables secure remote technical support and screen sharing over an internet connection.",
"Panel": "0",
"PackageId": "MicrosoftCorporationII.QuickAssist"
},
"WPFAppxMicrosoft_WindowsDevHome": {
"Category": "Developer Tools",
"Content": "Dev Home",
"Description": "Provides a specialized dashboard for software developer environment setups, repository syncing, and hardware widgets.",
"Panel": "1",
"PackageId": "Microsoft.Windows.DevHome"
},
"WPFAppxMicrosoft_WindowsCrossDevice": {
"Category": "Microsoft Ecosystem",
"Content": "Mobile Devices",
"Description": "Manages system-level background connectivity with paired mobile devices. Removing this may disable cross-device features such as phone screen mirroring, file transfer, and mobile hotspot handoff integrated into Windows Settings.",
"Panel": "0",
"PackageId": "MicrosoftWindows.CrossDevice"
},
"WPFAppxMicrosoft_Todos": {
"Category": "Utilities & Productivity",
"Content": "To Do",
"Description": "Creates, tracks, and synchronizes personal tasks, smart lists, and daily reminders.",
"Panel": "0",
"PackageId": "Microsoft.Todos"
},
"WPFAppxMicrosoft_PowerAutomateDesktop": {
"Category": "Developer Tools",
"Content": "Power Automate",
"Description": "Automates repetitive workflows and desktop tasks using low-code visual scripting.",
"Panel": "1",
"PackageId": "Microsoft.PowerAutomateDesktop"
},
"WPFAppxMicrosoft_YourPhone": {
"Category": "Microsoft Ecosystem",
"Content": "Phone Link",
"Description": "Synchronizes text messages, phone notifications, photos, and calls from a mobile device to the desktop.",
"Panel": "0",
"PackageId": "Microsoft.YourPhone"
},
"WPFAppxMicrosoft_MicrosoftStickyNotes": {
"Category": "Utilities & Productivity",
"Content": "Sticky Notes",
"Description": "Creates quick, floating text notes on the desktop that automatically sync across devices.",
"Panel": "0",
"PackageId": "Microsoft.MicrosoftStickyNotes"
},
"WPFAppxMicrosoft_WindowsSoundRecorder": {
"Category": "Utilities & Productivity",
"Content": "Sound Recorder",
"Description": "Records and trims live audio inputs with simple microphone adjustment controls.",
"Panel": "0",
"PackageId": "Microsoft.WindowsSoundRecorder"
},
"WPFAppxMicrosoft_WindowsAlarms": {
"Category": "Utilities & Productivity",
"Content": "Clock",
"Description": "Features world clocks, alarms, countdown timers, stopwatches, and dedicated focus session tracking.",
"Panel": "0",
"PackageId": "Microsoft.WindowsAlarms"
},
"WPFAppxMicrosoft_Paint": {
"Category": "Utilities & Productivity",
"Content": "Paint",
"Description": "Provides built-in digital sketching, basic image editing, and pixel-level graphic manipulation tools.",
"Panel": "0",
"PackageId": "Microsoft.Paint"
},
"WPFAppxMicrosoft_WindowsNotepad": {
"Category": "Utilities & Productivity",
"Content": "Notepad",
"Description": "Provides a lightweight text editor with multi-tab support for plain text files and code snippets.",
"Panel": "0",
"PackageId": "Microsoft.WindowsNotepad"
},
"WPFAppxMicrosoft_ScreenSketch": {
"Category": "Utilities & Productivity",
"Content": "Snipping Tool",
"Description": "Captures screenshots or screen recordings with built-in markup, image cropping, and optical character recognition (OCR).",
"Panel": "0",
"PackageId": "Microsoft.ScreenSketch"
},
"WPFAppxMicrosoft_Copilot": {
"Category": "Bing & Web Services",
"Content": "Copilot",
"Description": "Launches the Microsoft AI companion for contextual answers, creative writing assistance, and intelligent web search.",
"Panel": "1",
"PackageId": "Microsoft.Copilot"
},
"WPFAppxMicrosoft_WindowsCalculator": {
"Category": "Utilities & Productivity",
"Content": "Calculator",
"Description": "Performs standard arithmetic, scientific operations, programming calculations, and unit conversions.",
"Panel": "0",
"PackageId": "Microsoft.WindowsCalculator"
},
"WPFAppxMicrosoft_WindowsCamera": {
"Category": "Utilities & Productivity",
"Content": "Camera",
"Description": "Captures photographs and records video files via connected webcams or imaging hardware.",
"Panel": "0",
"PackageId": "Microsoft.WindowsCamera"
},
"WPFAppxMicrosoft_WindowsPhotos": {
"Category": "Utilities & Productivity",
"Content": "Photos",
"Description": "Organizes, views, and crops local images with basic color adjustment and album creation tools.",
"Panel": "0",
"PackageId": "Microsoft.Windows.Photos"
},
"WPFAppxMicrosoft_BingNews": {
"Category": "Bing & Web Services",
"Content": "News",
"Description": "Aggregates breaking news headlines, personalized article feeds, and world current events.",
"Panel": "1",
"PackageId": "Microsoft.BingNews"
},
"WPFAppxMicrosoft_BingWeather": {
"Category": "Bing & Web Services",
"Content": "Weather",
"Description": "Displays local real-time weather tracking, radar maps, and historical meteorological forecasts.",
"Panel": "1",
"PackageId": "Microsoft.BingWeather"
},
"WPFAppxMicrosoft_GamingApp": {
"Category": "Xbox & Gaming",
"Content": "Xbox App",
"Description": "Serves as the primary gaming library manager, social community interface, and PC Game Pass dashboard.",
"Panel": "1",
"PackageId": "Microsoft.GamingApp"
},
"WPFAppxMicrosoft_XboxGamingOverlay": {
"Category": "Xbox & Gaming",
"Content": "Xbox Game Bar",
"Description": "Provides customizable in-game status widgets, audio balancing sliders, system monitoring tools, and gameplay recording.",
"Panel": "1",
"PackageId": "Microsoft.XboxGamingOverlay"
},
"WPFAppxMicrosoft_XboxIdentityProvider": {
"Category": "Xbox & Gaming",
"Content": "Xbox Identity Provider",
"Description": "Manages Xbox network user authentication and background account validation for connected titles. Warning: removing this may break Microsoft account sign-in for non-Xbox games and apps that rely on this authentication pipeline.",
"Panel": "1",
"PackageId": "Microsoft.XboxIdentityProvider"
},
"WPFAppxMicrosoft_XboxSpeechToTextOverlay": {
"Category": "Xbox & Gaming",
"Content": "Xbox Speech To Text Overlay",
"Description": "Provides system-level live accessibility captions and voice-to-text translation for gaming chat networks.",
"Panel": "1",
"PackageId": "Microsoft.XboxSpeechToTextOverlay"
},
"WPFAppxMicrosoft_Xbox_TCUI": {
"Category": "Xbox & Gaming",
"Content": "Xbox TCUI",
"Description": "Provides core account connection UI modules for single sign-on flows within game titles. Warning: removing this may break Microsoft account authentication in games and apps that do not otherwise require the Xbox app.",
"Panel": "1",
"PackageId": "Microsoft.Xbox.TCUI"
},
"WPFAppxMicrosoft_StartExperiencesApp": {
"Category": "Bing & Web Services",
"Content": "Start Experiences App",
"Description": "Powers the Windows Widgets board, delivering a personalized feed of news, weather, sports, and finance content.",
"Panel": "1",
"PackageId": "Microsoft.StartExperiencesApp"
},
"WPFAppxMicrosoft_MicrosoftSolitaireCollection": {
"Category": "Xbox & Gaming",
"Content": "Solitaire Collection",
"Description": "Bundles built-in card game modes including Klondike, Spider, FreeCell, Pyramid, and TriPeaks alongside daily challenges.",
"Panel": "1",
"PackageId": "Microsoft.MicrosoftSolitaireCollection"
}
}
+21 -3
View File
@@ -4,7 +4,6 @@
"WPFTweaksConsumerFeatures", "WPFTweaksConsumerFeatures",
"WPFTweaksDisableExplorerAutoDiscovery", "WPFTweaksDisableExplorerAutoDiscovery",
"WPFTweaksWPBT", "WPFTweaksWPBT",
"WPFTweaksDeBloat",
"WPFTweaksLocation", "WPFTweaksLocation",
"WPFTweaksServices", "WPFTweaksServices",
"WPFTweaksTelemetry", "WPFTweaksTelemetry",
@@ -16,17 +15,16 @@
], ],
"Minimal": [ "Minimal": [
"WPFTweaksConsumerFeatures", "WPFTweaksConsumerFeatures",
"WPFTweaksDeBloat",
"WPFTweaksWPBT", "WPFTweaksWPBT",
"WPFTweaksServices", "WPFTweaksServices",
"WPFTweaksTelemetry" "WPFTweaksTelemetry"
], ],
"Advanced": [ "Advanced": [
"WPFTweaksRestorePoint",
"WPFTweaksActivity", "WPFTweaksActivity",
"WPFTweaksConsumerFeatures", "WPFTweaksConsumerFeatures",
"WPFTweaksDisableExplorerAutoDiscovery", "WPFTweaksDisableExplorerAutoDiscovery",
"WPFTweaksWPBT", "WPFTweaksWPBT",
"WPFTweaksDeBloat",
"WPFTweaksLocation", "WPFTweaksLocation",
"WPFTweaksServices", "WPFTweaksServices",
"WPFTweaksTelemetry", "WPFTweaksTelemetry",
@@ -39,5 +37,25 @@
"WPFTweaksRemoveOneDrive", "WPFTweaksRemoveOneDrive",
"WPFTweaksWindowsAI", "WPFTweaksWindowsAI",
"WPFTweaksRightClickMenu" "WPFTweaksRightClickMenu"
],
"AppxDefault": [
"WPFAppxMicrosoft_WindowsFeedbackHub",
"WPFAppxMicrosoft_GetHelp",
"WPFAppxMicrosoft_MicrosoftOfficeHub",
"WPFAppxMicrosoft_WindowsCalculator",
"WPFAppxClipchamp_Clipchamp",
"WPFAppxMicrosoft_WindowsAlarms",
"WPFAppxMicrosoftCorporationII_QuickAssist",
"WPFAppxMicrosoft_WindowsSoundRecorder",
"WPFAppxMicrosoft_MicrosoftStickyNotes",
"WPFAppxMicrosoft_Todos",
"WPFAppxMicrosoft_MicrosoftSolitaireCollection",
"WPFAppxMicrosoft_PowerAutomateDesktop",
"WPFAppxMicrosoft_WindowsDevHome",
"WPFAppxMicrosoft_BingWeather",
"WPFAppxMicrosoft_StartExperiencesApp",
"WPFAppxMicrosoft_BingNews",
"WPFAppxMicrosoft_Copilot",
"WPFAppxMicrosoft_BingSearch"
] ]
} }
+4
View File
@@ -65,11 +65,13 @@
"ButtonConfigBackgroundColor": "#F7F7F7", "ButtonConfigBackgroundColor": "#F7F7F7",
"ButtonUpdatesBackgroundColor": "#F7F7F7", "ButtonUpdatesBackgroundColor": "#F7F7F7",
"ButtonWin11ISOBackgroundColor": "#F7F7F7", "ButtonWin11ISOBackgroundColor": "#F7F7F7",
"ButtonAppxBackgroundColor": "#F7F7F7",
"ButtonInstallForegroundColor": "#232629", "ButtonInstallForegroundColor": "#232629",
"ButtonTweaksForegroundColor": "#232629", "ButtonTweaksForegroundColor": "#232629",
"ButtonConfigForegroundColor": "#232629", "ButtonConfigForegroundColor": "#232629",
"ButtonUpdatesForegroundColor": "#232629", "ButtonUpdatesForegroundColor": "#232629",
"ButtonWin11ISOForegroundColor": "#232629", "ButtonWin11ISOForegroundColor": "#232629",
"ButtonAppxForegroundColor": "#232629",
"ButtonBackgroundColor": "#F5F5F5", "ButtonBackgroundColor": "#F5F5F5",
"ButtonBackgroundPressedColor": "#1A1A1A", "ButtonBackgroundPressedColor": "#1A1A1A",
"ButtonBackgroundMouseoverColor": "#C2C2C2", "ButtonBackgroundMouseoverColor": "#C2C2C2",
@@ -105,11 +107,13 @@
"ButtonConfigBackgroundColor": "#444444", "ButtonConfigBackgroundColor": "#444444",
"ButtonUpdatesBackgroundColor": "#555555", "ButtonUpdatesBackgroundColor": "#555555",
"ButtonWin11ISOBackgroundColor": "#666666", "ButtonWin11ISOBackgroundColor": "#666666",
"ButtonAppxBackgroundColor": "#777777",
"ButtonInstallForegroundColor": "#F7F7F7", "ButtonInstallForegroundColor": "#F7F7F7",
"ButtonTweaksForegroundColor": "#F7F7F7", "ButtonTweaksForegroundColor": "#F7F7F7",
"ButtonConfigForegroundColor": "#F7F7F7", "ButtonConfigForegroundColor": "#F7F7F7",
"ButtonUpdatesForegroundColor": "#F7F7F7", "ButtonUpdatesForegroundColor": "#F7F7F7",
"ButtonWin11ISOForegroundColor": "#F7F7F7", "ButtonWin11ISOForegroundColor": "#F7F7F7",
"ButtonAppxForegroundColor": "#F7F7F7",
"ButtonBackgroundColor": "#1E3747", "ButtonBackgroundColor": "#1E3747",
"ButtonBackgroundPressedColor": "#F7F7F7", "ButtonBackgroundPressedColor": "#F7F7F7",
"ButtonBackgroundMouseoverColor": "#3B4252", "ButtonBackgroundMouseoverColor": "#3B4252",
+90 -128
View File
@@ -79,39 +79,18 @@
}, },
"WPFTweaksRevertStartMenu": { "WPFTweaksRevertStartMenu": {
"Content": "Start Menu Previous Layout - Enable", "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. On newer versions of windows !!THIS TWEAK WILL NOT WORK!!", "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", "category": "Essential Tweaks",
"panel": "1", "panel": "1",
"InvokeScript": [ "registry": [
" {
Invoke-WebRequest https://github.com/thebookisclosed/ViVe/releases/download/v0.3.4/ViVeTool-v0.3.4-IntelAmd.zip -OutFile ViVeTool.zip "Path": "HKLM:\\SYSTEM\\ControlSet001\\Control\\FeatureManagement\\Overrides\\8\\3036241548",
"Name": "EnabledState",
Expand-Archive ViVeTool.zip "Value": "1",
Remove-Item ViVeTool.zip "Type": "DWord",
"OriginalValue": "<RemoveEntry>"
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.'
Write-Host 'On newer versions of windows !!THIS TWEAK WILL NOT WORK!!.'
"
], ],
"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.'
"
],
"link": "https://winutil.christitus.com/dev/tweaks/essential-tweaks/revertstartmenu",
"link": "https://winutil.christitus.com/dev/tweaks/essential-tweaks/revertstartmenu" "link": "https://winutil.christitus.com/dev/tweaks/essential-tweaks/revertstartmenu"
}, },
"WPFTweaksDisableStoreSearch": { "WPFTweaksDisableStoreSearch": {
@@ -450,7 +429,7 @@
}, },
"WPFTweaksConsumerFeatures": { "WPFTweaksConsumerFeatures": {
"Content": "ConsumerFeatures - Disable", "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", "category": "Essential Tweaks",
"panel": "1", "panel": "1",
"registry": [ "registry": [
@@ -607,15 +586,25 @@
}, },
"WPFTweaksRemoveEdge": { "WPFTweaksRemoveEdge": {
"Content": "Microsoft Edge - Remove", "Content": "Microsoft Edge - Remove",
"Description": "Unblocks Microsoft Edge uninstaller restrictions then uses that uninstaller to remove Microsoft Edge.", "Description": "Uninstalls Microsoft Edge by creating dummy MicrosoftEdge.exe file in the legacy Edge folder. This tricks Windows into unlocking the official Edge uninstaller allowing for a system-level removal.",
"category": "z__Advanced Tweaks - CAUTION", "category": "z__Advanced Tweaks - CAUTION",
"panel": "1", "panel": "1",
"InvokeScript": [ "InvokeScript": [
"Invoke-WinUtilRemoveEdge" "
$Path = Resolve-Path -Path \"$Env:ProgramFiles (x86)\\Microsoft\\Edge\\Application\\*\\Installer\\setup.exe\" | Select-Object -Last 1
if (Test-Path $Path) {
New-Item -Path \"$Env:SystemRoot\\SystemApps\\Microsoft.MicrosoftEdge_8wekyb3d8bbwe\\MicrosoftEdge.exe\" -Force
Start-Process -FilePath $Path -ArgumentList \"--uninstall --system-level --force-uninstall --delete-profile\" -Wait
Write-Host \"Microsoft Edge was removed\"
} else {
Write-Host \"Microsoft Edge is not installed\"
}
"
], ],
"UndoScript": [ "UndoScript": [
" "
Write-Host 'Installing Microsoft Edge...' Write-Host \"Installing Microsoft Edge...\"
winget install Microsoft.Edge --source winget winget install Microsoft.Edge --source winget
" "
], ],
@@ -661,7 +650,7 @@
icacls $Env:OneDrive /deny \"Administrators:(D,DC)\" icacls $Env:OneDrive /deny \"Administrators:(D,DC)\"
Write-Host \"Uninstalling OneDrive...\" Write-Host \"Uninstalling OneDrive...\"
Start-Process 'C:\\Windows\\System32\\OneDriveSetup.exe' -ArgumentList '/uninstall' -Wait Start-Process '$Env:SystemRoot\\System32\\OneDriveSetup.exe' -ArgumentList '/uninstall' -Wait
# Some of OneDrive files use explorer, and OneDrive uses FileCoAuth # Some of OneDrive files use explorer, and OneDrive uses FileCoAuth
Write-Host \"Removing leftover OneDrive Files...\" Write-Host \"Removing leftover OneDrive Files...\"
@@ -669,7 +658,7 @@
Stop-Process -Name FileCoAuth,Explorer Stop-Process -Name FileCoAuth,Explorer
Remove-Item \"$Env:LocalAppData\\Microsoft\\OneDrive\" -Recurse -Force Remove-Item \"$Env:LocalAppData\\Microsoft\\OneDrive\" -Recurse -Force
Remove-Item \"C:\\ProgramData\\Microsoft OneDrive\" -Recurse -Force Remove-Item \"$Env:ProgramData\\Microsoft OneDrive\" -Recurse -Force
# Grant back permission to access OneDrive folder # Grant back permission to access OneDrive folder
icacls $Env:OneDrive /grant \"Administrators:(D,DC)\" icacls $Env:OneDrive /grant \"Administrators:(D,DC)\"
@@ -823,69 +812,18 @@
], ],
"link": "https://winutil.christitus.com/dev/tweaks/z--advanced-tweaks---caution/display" "link": "https://winutil.christitus.com/dev/tweaks/z--advanced-tweaks---caution/display"
}, },
"WPFTweaksXboxRemoval": { "WPFTweaksReservedStorage": {
"Content": "Xbox & Gaming Components - Remove", "Content": "Disable Reserved Storage",
"Description": "Removes Xbox services, the Xbox app, Game Bar, and related authentication components.", "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", "category": "z__Advanced Tweaks - CAUTION",
"panel": "1", "panel": "1",
"registry": [
{
"Path": "HKCU:\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\GameDVR",
"Name": "AppCaptureEnabled",
"Value": "0",
"Type": "DWord",
"OriginalValue": "1"
}
],
"appx": [
"Microsoft.XboxIdentityProvider",
"Microsoft.XboxSpeechToTextOverlay",
"Microsoft.GamingApp",
"Microsoft.Xbox.TCUI",
"Microsoft.XboxGamingOverlay"
],
"link": "https://winutil.christitus.com/dev/tweaks/z--advanced-tweaks---caution/xboxremoval"
},
"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.",
"category": "Essential Tweaks",
"panel": "1",
"appx": [
"Microsoft.WindowsFeedbackHub",
"Microsoft.BingNews",
"Microsoft.BingSearch",
"Microsoft.BingWeather",
"Clipchamp.Clipchamp",
"Microsoft.Todos",
"Microsoft.PowerAutomateDesktop",
"Microsoft.MicrosoftSolitaireCollection",
"Microsoft.WindowsSoundRecorder",
"Microsoft.MicrosoftStickyNotes",
"Microsoft.Windows.DevHome",
"Microsoft.Paint",
"Microsoft.OutlookForWindows",
"Microsoft.WindowsAlarms",
"Microsoft.StartExperiencesApp",
"Microsoft.GetHelp",
"Microsoft.ZuneMusic",
"MicrosoftCorporationII.QuickAssist",
"MSTeams"
],
"InvokeScript": [ "InvokeScript": [
" "DISM /Online /Set-ReservedStorageState /State:Disabled"
$TeamsPath = \"$Env:LocalAppData\\Microsoft\\Teams\\Update.exe\"
if (Test-Path $TeamsPath) {
Write-Host \"Uninstalling Teams\"
Start-Process $TeamsPath -ArgumentList -uninstall -wait
Write-Host \"Deleting Teams directory\"
Remove-Item $TeamsPath -Recurse -Force
}
"
], ],
"link": "https://winutil.christitus.com/dev/tweaks/essential-tweaks/debloat" "UndoScript": [
"DISM /Online /Set-ReservedStorageState /State:Enabled"
],
"link": "https://winutil.christitus.com/dev/tweaks/z--advanced-tweaks---caution/reservedstorage"
}, },
"WPFTweaksRestorePoint": { "WPFTweaksRestorePoint": {
"Content": "Restore Point - Create", "Content": "Restore Point - Create",
@@ -947,8 +885,8 @@
"link": "https://winutil.christitus.com/dev/tweaks/z--advanced-tweaks---caution/storage" "link": "https://winutil.christitus.com/dev/tweaks/z--advanced-tweaks---caution/storage"
}, },
"WPFTweaksWindowsAI": { "WPFTweaksWindowsAI": {
"Content": "Windows AI - Disable", "Content": "Windows AI - Disable And Remove",
"Description": "Removes or disables all ai features and packages", "Description": "Removes and disables all AI features/packages",
"category": "z__Advanced Tweaks - CAUTION", "category": "z__Advanced Tweaks - CAUTION",
"panel": "1", "panel": "1",
"registry": [ "registry": [
@@ -974,9 +912,13 @@
New-Item \"HKLM:\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Appx\\AppxAllUserStore\\EndOfLife\\$Sid\\$Appx\" -Force 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
winget uninstall -e --name \"Copilot\" --silent --force --accept-source-agreements 2>$null
Get-AppxPackage -AllUsers Microsoft.MicrosoftOfficeHub | Remove-AppxPackage -AllUsers Get-AppxPackage -AllUsers Microsoft.MicrosoftOfficeHub | Remove-AppxPackage -AllUsers
if ($Appx) {
Remove-AppxPackage $Appx Remove-AppxPackage $Appx
}
Set-Service -Name WSAIFabricSvc -StartupType Disabled Set-Service -Name WSAIFabricSvc -StartupType Disabled
Disable-WindowsOptionalFeature -FeatureName Recall -Online -NoRestart Disable-WindowsOptionalFeature -FeatureName Recall -Online -NoRestart
@@ -1025,7 +967,7 @@
], ],
"InvokeScript": [ "InvokeScript": [
" "
$RazerPath = \"C:\\Windows\\Installer\\Razer\" $RazerPath = \"$Env:SystemRoot\\Installer\\Razer\"
if (Test-Path $RazerPath) { if (Test-Path $RazerPath) {
Remove-Item $RazerPath\\* -Recurse -Force Remove-Item $RazerPath\\* -Recurse -Force
@@ -1038,7 +980,7 @@
], ],
"UndoScript": [ "UndoScript": [
" "
icacls \"C:\\Windows\\Installer\\Razer\" /remove:d Everyone icacls \"$Env:SystemRoot\\Installer\\Razer\" /remove:d Everyone
" "
], ],
"link": "https://winutil.christitus.com/dev/tweaks/z--advanced-tweaks---caution/razerblock" "link": "https://winutil.christitus.com/dev/tweaks/z--advanced-tweaks---caution/razerblock"
@@ -1097,29 +1039,14 @@
"Description": "Restores the classic context menu when right-clicking in File Explorer, replacing the simplified Windows 11 version.", "Description": "Restores the classic context menu when right-clicking in File Explorer, replacing the simplified Windows 11 version.",
"category": "z__Advanced Tweaks - CAUTION", "category": "z__Advanced Tweaks - CAUTION",
"panel": "1", "panel": "1",
"registry": [
{
"Path": "HKCU:\\Software\\Classes\\CLSID\\{86ca1aa0-34aa-4e8b-a509-50c905bae2a2}\\InprocServer32",
"Name": "(default)",
"Value": "",
"Type": "String",
"OriginalValue": "<RemoveEntry>"
}
],
"InvokeScript": [ "InvokeScript": [
" "
New-Item -Path \"HKCU:\\Software\\Classes\\CLSID\\{86ca1aa0-34aa-4e8b-a509-50c905bae2a2}\" -Name \"InprocServer32\" -force -value \"\" New-Item -Path \"HKCU:\\Software\\Classes\\CLSID\\{86ca1aa0-34aa-4e8b-a509-50c905bae2a2}\" -Name InprocServer32 -Value \"\" -Force
Write-Host Restarting explorer.exe ... Stop-Process -Name explorer
Stop-Process -Name \"explorer\" -Force
" "
], ],
"UndoScript": [ "UndoScript": [
" "Remove-Item -Path \"HKCU:\\Software\\Classes\\CLSID\\{86ca1aa0-34aa-4e8b-a509-50c905bae2a2}\" -Recurse"
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
"
], ],
"link": "https://winutil.christitus.com/dev/tweaks/z--advanced-tweaks---caution/rightclickmenu" "link": "https://winutil.christitus.com/dev/tweaks/z--advanced-tweaks---caution/rightclickmenu"
}, },
@@ -1384,7 +1311,7 @@
}, },
"WPFToggleShowExt": { "WPFToggleShowExt": {
"Content": "File Explorer File Extensions", "Content": "File Explorer File Extensions",
"Description": "Shows .file extensions in explorer (.exe, .png, etc)", "Description": "Shows .file extensions in Explorer (.exe, .png, etc.)",
"category": "Customize Preferences", "category": "Customize Preferences",
"panel": "2", "panel": "2",
"Type": "Toggle", "Type": "Toggle",
@@ -1412,7 +1339,7 @@
}, },
"WPFToggleHiddenFiles": { "WPFToggleHiddenFiles": {
"Content": "File Explorer Hidden Files", "Content": "File Explorer Hidden Files",
"Description": "reveals hidden files in explorer", "Description": "Reveals hidden files in Explorer.",
"category": "Customize Preferences", "category": "Customize Preferences",
"panel": "2", "panel": "2",
"Type": "Toggle", "Type": "Toggle",
@@ -1535,10 +1462,10 @@
{ {
"Path": "HKLM:\\SYSTEM\\CurrentControlSet\\Control\\GraphicsDrivers", "Path": "HKLM:\\SYSTEM\\CurrentControlSet\\Control\\GraphicsDrivers",
"Name": "DisableOverlays", "Name": "DisableOverlays",
"Value": "1", "Value": "0",
"Type": "DWord", "Type": "DWord",
"OriginalValue": "0", "OriginalValue": "1",
"DefaultState": "false" "DefaultState": "true"
} }
], ],
"link": "https://winutil.christitus.com/dev/tweaks/customize-preferences/multiplaneoverlay" "link": "https://winutil.christitus.com/dev/tweaks/customize-preferences/multiplaneoverlay"
@@ -1603,6 +1530,24 @@
], ],
"link": "https://winutil.christitus.com/dev/tweaks/customize-preferences/numlock" "link": "https://winutil.christitus.com/dev/tweaks/customize-preferences/numlock"
}, },
"WPFToggleWindowSnapping": {
"Content": "Window Snapping",
"Description": "Toggles the window snapping feature when dragging windows.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
"registry": [
{
"Path": "HKCU:\\Control Panel\\Desktop",
"Name": "WindowArrangementActive",
"Value": "1",
"Type": "String",
"OriginalValue": "0",
"DefaultState": "true"
}
],
"link": "https://winutil.christitus.com/dev/tweaks/customize-preferences/windowsnapping"
},
"WPFToggleStandbyFix": { "WPFToggleStandbyFix": {
"Content": "S0 Sleep Network Connectivity", "Content": "S0 Sleep Network Connectivity",
"Description": "Toggles network connectivity during S0 Sleep which is low power idle in modern laptops.", "Description": "Toggles network connectivity during S0 Sleep which is low power idle in modern laptops.",
@@ -1623,7 +1568,7 @@
}, },
"WPFToggleS3Sleep": { "WPFToggleS3Sleep": {
"Content": "S3 Sleep", "Content": "S3 Sleep",
"Description": "Toggles between Modern Standby and S3 Sleep which cuts of power to cpu while continuing to refreshes the memory.", "Description": "Toggles between Modern Standby and S3 Sleep, which cuts off power to the CPU while continuing to refresh the memory.",
"category": "Customize Preferences", "category": "Customize Preferences",
"panel": "2", "panel": "2",
"Type": "Toggle", "Type": "Toggle",
@@ -1659,7 +1604,7 @@
}, },
"WPFToggleBingSearch": { "WPFToggleBingSearch": {
"Content": "Start Menu Bing Search", "Content": "Start Menu Bing Search",
"Description": "Toggles Bing web search results in windows search", "Description": "Toggles Bing web search results in Windows Search.",
"category": "Customize Preferences", "category": "Customize Preferences",
"panel": "2", "panel": "2",
"Type": "Toggle", "Type": "Toggle",
@@ -1693,6 +1638,23 @@
], ],
"link": "https://winutil.christitus.com/dev/tweaks/customize-preferences/loginblur" "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": { "WPFToggleStartMenuRecommendations": {
"Content": "Start Menu Recommendations", "Content": "Start Menu Recommendations",
"Description": "Toggles the recommendations section 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.",
@@ -1739,7 +1701,7 @@
}, },
"WPFToggleStickyKeys": { "WPFToggleStickyKeys": {
"Content": "Sticky Keys", "Content": "Sticky Keys",
"Description": "Toggles the stick keys which active when clicking shift rapidly", "Description": "Toggles the Sticky Keys, which activate when clicking shift rapidly.",
"category": "Customize Preferences", "category": "Customize Preferences",
"panel": "2", "panel": "2",
"Type": "Toggle", "Type": "Toggle",
@@ -1757,7 +1719,7 @@
}, },
"WPFToggleTaskbarAlignment": { "WPFToggleTaskbarAlignment": {
"Content": "Taskbar Centered Icons", "Content": "Taskbar Centered Icons",
"Description": "Toggles the taskbar alignment either to the left or center", "Description": "Toggles the Taskbar alignment either to the left or center.",
"category": "Customize Preferences", "category": "Customize Preferences",
"panel": "2", "panel": "2",
"Type": "Toggle", "Type": "Toggle",
@@ -1847,7 +1809,7 @@
}, },
"WPFToggleLongPaths": { "WPFToggleLongPaths": {
"Content": "Enable Long Paths", "Content": "Enable Long Paths",
"Description": "Toggles support for file paths longer than 260 characters in explorer.", "Description": "Toggles support for file paths longer than 260 characters in Explorer.",
"category": "Customize Preferences", "category": "Customize Preferences",
"panel": "2", "panel": "2",
"Type": "Toggle", "Type": "Toggle",
+20 -5
View File
@@ -15,18 +15,33 @@ try using a **VPN** and if that doesn't work than report the issue to https://gi
If you run WinUtil and get the error: 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. this means that your PowerShell session is in **Constrained Language Mode**, which prevents WinUtil from running.
### Ultimate Performance Plan Not Working ### 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. In these cases, the power plan may fail to apply, This is expected behavior on unsupported hardware.
### Revet start menu tweak not working ### Revert start menu tweak not working
Revet start menu tweak stops working starting with **Windows 11 update KB5089573** (released in May 2026). 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 In this update, Microsoft completely removed the old Start Menu code from Windows, so we aren't able to bring it back.
### Issues with PowerShell 7 or Class not registered Error
Installing PowerShell 7 from the Microsoft Store (MSIX package) is known to cause issues with DISM cmdlets such as `Get-WindowsOptionalFeature` and `Enable-WindowsOptionalFeature`, resulting in a `Class not registered` COM error.
This might also make it so running the "pre-installed app removal" will take a indefinite amount of time
Instead, install PowerShell 7 using one of the following methods:
**winget (recommended):**
```powershell
winget install --id Microsoft.PowerShell --source winget --installer-type wix
```
**Direct MSI from GitHub Releases:** Download the `.msi` installer from the [PowerShell GitHub Releases](https://github.com/PowerShell/PowerShell/releases) page.
For more details see https://github.com/PowerShell/PowerShell/issues/13866
+7 -7
View File
@@ -1,20 +1,20 @@
--- ---
title: Welcome to Winutil Documentation! title: Welcome to WinUtil Documentation!
toc: false toc: false
width: full width: full
--- ---
<div style="display: flex; justify-content: center; align-items: center; width: 100%; flex-wrap: wrap; gap: 5px;margin-top:30px;" > <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> <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;"> <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> <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> </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**. * You will first need to start a PowerShell terminal **as Admin**.
* Now you can run the following command: * Now you can run the following command:
@@ -25,4 +25,4 @@ irm "https://christitus.com/win" | iex
> [!IMPORTANT] > [!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.
+5 -3
View File
@@ -6,7 +6,7 @@ toc: true
## Overview ## 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 ## High-Level Architecture
@@ -74,7 +74,7 @@ winutil/
1. Reads all function files from `/functions/` 1. Reads all function files from `/functions/`
2. Includes configuration JSON files 2. Includes configuration JSON files
3. Embeds XAML GUI definition 3. Embeds XAML GUI definition
4. Combines into single script 4. Combines into a single script
5. Outputs `winutil.ps1` 5. Outputs `winutil.ps1`
**Why**: Makes distribution easier (single file) and improves load time. **Why**: Makes distribution easier (single file) and improves load time.
@@ -578,7 +578,9 @@ Tests are in `/pester/`:
Run tests: Run tests:
```powershell ```powershell
Invoke-Pester Install-Module -Name Pester -RequiredVersion 5.8.0 -Scope CurrentUser -Force -SkipPublisherCheck
Import-Module Pester -RequiredVersion 5.8.0 -Force
Invoke-Pester -Path 'pester/*.Tests.ps1' -Output Detailed -CI
``` ```
## Build Process ## Build Process
+2 -2
View File
@@ -5,7 +5,7 @@ description: ""
```powershell {filename="functions/public/Invoke-WPFPanelAutologin.ps1",linenos=inline,linenostart=1} ```powershell {filename="functions/public/Invoke-WPFPanelAutologin.ps1",linenos=inline,linenostart=1}
function Invoke-WPFPanelAutologin { function Invoke-WPFPanelAutologin {
Invoke-WebRequest -Uri https://live.sysinternals.com/Autologon.exe -OutFile "$Env:Temp\autologin.exe" Invoke-WebRequest -Uri https://live.sysinternals.com/Autologon.exe -OutFile "$winutildir\autologin.exe"
Start-Process -FilePath "$Env:Temp\autologin.exe" -ArgumentList /accepteula Start-Process -FilePath "$winutildir\autologin.exe" -ArgumentList /accepteula
} }
``` ```
+1 -1
View File
@@ -7,6 +7,6 @@ description: ""
function Invoke-WPFFixesNetwork { function Invoke-WPFFixesNetwork {
netsh winsock reset netsh winsock reset
netsh int ip reset netsh int ip reset
Write-Host "Network Configuration has been Reset Please restart your computer." Write-Host "Network Configuration has been Reset. Please restart your computer."
} }
``` ```
@@ -6,15 +6,15 @@ description: ""
```powershell {filename="functions/private/Invoke-WinUtilInstallPSProfile.ps1",linenos=inline,linenostart=1} ```powershell {filename="functions/private/Invoke-WinUtilInstallPSProfile.ps1",linenos=inline,linenostart=1}
function Invoke-WinUtilInstallPSProfile { function Invoke-WinUtilInstallPSProfile {
if (-not (Get-Command wt)) { if (-not (Get-Command wt)) {
Write-Host "Windows Terminal not found installing..." Write-Host "Windows Terminal not found. Installing..."
Install-WinUtilWinget Install-WinUtilWinget
winget install Microsoft.WindowsTerminal --source winget --silent winget install Microsoft.WindowsTerminal --source winget --silent
} }
if (-not (Get-Command pwsh)) { if (-not (Get-Command pwsh)) {
Write-Host "Powershell 7 not found installing..." Write-Host "PowerShell 7 not found. Installing..."
Install-WinUtilWinget Install-WinUtilWinget
winget install Microsoft.PowerShell --source winget --silent winget install Microsoft.PowerShell --source winget --installer-type wix --silent
} }
wt new-tab pwsh -NoExit -Command "irm https://github.com/ChrisTitusTech/powershell-profile/raw/main/setup.ps1 | iex" wt new-tab pwsh -NoExit -Command "irm https://github.com/ChrisTitusTech/powershell-profile/raw/main/setup.ps1 | iex"
@@ -3,7 +3,7 @@ title: "System Tray Battery Percentage"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1325} ```json {filename="config/tweaks.json",linenos=inline,linenostart=1252}
"WPFToggleBatteryPercentage": { "WPFToggleBatteryPercentage": {
"Content": "System Tray Battery Percentage", "Content": "System Tray Battery Percentage",
"Description": "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.",
@@ -3,10 +3,10 @@ title: "Start Menu Bing Search"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1660} ```json {filename="config/tweaks.json",linenos=inline,linenostart=1605}
"WPFToggleBingSearch": { "WPFToggleBingSearch": {
"Content": "Start Menu Bing Search", "Content": "Start Menu Bing Search",
"Description": "Toggles Bing web search results in windows search", "Description": "Toggles Bing web search results in Windows Search.",
"category": "Customize Preferences", "category": "Customize Preferences",
"panel": "2", "panel": "2",
"Type": "Toggle", "Type": "Toggle",
@@ -3,7 +3,7 @@ title: "Dark Theme for Windows"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1343} ```json {filename="config/tweaks.json",linenos=inline,linenostart=1270}
"WPFToggleDarkMode": { "WPFToggleDarkMode": {
"Content": "Dark Theme for Windows", "Content": "Dark Theme for Windows",
"Description": "Dark Mode for the system and applications.", "Description": "Dark Mode for the system and applications.",
@@ -3,7 +3,7 @@ title: "BSoD Verbose Mode"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1299} ```json {filename="config/tweaks.json",linenos=inline,linenostart=1226}
"WPFToggleDetailedBSoD": { "WPFToggleDetailedBSoD": {
"Content": "BSoD Verbose Mode", "Content": "BSoD Verbose Mode",
"Description": "Gives more information when you blue screen.", "Description": "Gives more information when you blue screen.",
@@ -0,0 +1,28 @@
---
title: "Lock Screen - Disable"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1641}
"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>"
}
],
```
## 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: "Game Mode"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1822} ```json {filename="config/tweaks.json",linenos=inline,linenostart=1784}
"WPFToggleGameMode": { "WPFToggleGameMode": {
"Content": "Game Mode", "Content": "Game Mode",
"Description": "Toggles Windows prioritizes gaming performance by allocating system resources to games.", "Description": "Toggles Windows prioritizes gaming performance by allocating system resources to games.",
@@ -3,10 +3,10 @@ title: "File Explorer Hidden Files"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1413} ```json {filename="config/tweaks.json",linenos=inline,linenostart=1340}
"WPFToggleHiddenFiles": { "WPFToggleHiddenFiles": {
"Content": "File Explorer Hidden Files", "Content": "File Explorer Hidden Files",
"Description": "reveals hidden files in explorer", "Description": "Reveals hidden files in Explorer.",
"category": "Customize Preferences", "category": "Customize Preferences",
"panel": "2", "panel": "2",
"Type": "Toggle", "Type": "Toggle",
@@ -3,7 +3,7 @@ title: "Settings Home Page"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1642} ```json {filename="config/tweaks.json",linenos=inline,linenostart=1587}
"WPFToggleHideSettingsHome": { "WPFToggleHideSettingsHome": {
"Content": "Settings Home Page", "Content": "Settings Home Page",
"Description": "Toggles the Home Page in the Windows Settings app.", "Description": "Toggles the Home Page in the Windows Settings app.",
@@ -3,7 +3,7 @@ title: "Logon Screen Acrylic Blur"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1678} ```json {filename="config/tweaks.json",linenos=inline,linenostart=1623}
"WPFToggleLoginBlur": { "WPFToggleLoginBlur": {
"Content": "Logon Screen Acrylic Blur", "Content": "Logon Screen Acrylic Blur",
"Description": "Toggles the acrylic blur effect on login screen background.", "Description": "Toggles the acrylic blur effect on login screen background.",
@@ -3,10 +3,10 @@ title: "Enable Long Paths"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1848} ```json {filename="config/tweaks.json",linenos=inline,linenostart=1810}
"WPFToggleLongPaths": { "WPFToggleLongPaths": {
"Content": "Enable Long Paths", "Content": "Enable Long Paths",
"Description": "Toggles support for file paths longer than 260 characters in explorer.", "Description": "Toggles support for file paths longer than 260 characters in Explorer.",
"category": "Customize Preferences", "category": "Customize Preferences",
"panel": "2", "panel": "2",
"Type": "Toggle", "Type": "Toggle",
@@ -3,7 +3,7 @@ title: "Mouse Acceleration"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1546} ```json {filename="config/tweaks.json",linenos=inline,linenostart=1473}
"WPFToggleMouseAcceleration": { "WPFToggleMouseAcceleration": {
"Content": "Mouse Acceleration", "Content": "Mouse Acceleration",
"Description": "Makes it so 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.",
@@ -3,7 +3,7 @@ title: "Multiplane Overlay"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1520} ```json {filename="config/tweaks.json",linenos=inline,linenostart=1447}
"WPFToggleMultiplaneOverlay": { "WPFToggleMultiplaneOverlay": {
"Content": "Multiplane Overlay", "Content": "Multiplane Overlay",
"Description": "Multiplane Overlay compose multiple image layers, which can sometimes cause issues with graphics cards.", "Description": "Multiplane Overlay compose multiple image layers, which can sometimes cause issues with graphics cards.",
@@ -22,10 +22,10 @@ description: ""
{ {
"Path": "HKLM:\\SYSTEM\\CurrentControlSet\\Control\\GraphicsDrivers", "Path": "HKLM:\\SYSTEM\\CurrentControlSet\\Control\\GraphicsDrivers",
"Name": "DisableOverlays", "Name": "DisableOverlays",
"Value": "1", "Value": "0",
"Type": "DWord", "Type": "DWord",
"OriginalValue": "0", "OriginalValue": "1",
"DefaultState": "false" "DefaultState": "true"
} }
], ],
``` ```
@@ -3,7 +3,7 @@ title: "Microsoft Outlook New Version"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1459} ```json {filename="config/tweaks.json",linenos=inline,linenostart=1386}
"WPFToggleNewOutlook": { "WPFToggleNewOutlook": {
"Content": "Microsoft Outlook New Version", "Content": "Microsoft Outlook New Version",
"Description": "This will ensures the classic Outlook application is used.", "Description": "This will ensures the classic Outlook application is used.",
@@ -3,7 +3,7 @@ title: "Num Lock on Startup"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1580} ```json {filename="config/tweaks.json",linenos=inline,linenostart=1507}
"WPFToggleNumLock": { "WPFToggleNumLock": {
"Content": "Num Lock on Startup", "Content": "Num Lock on Startup",
"Description": "Toggle the Num Lock key state when your computer starts.", "Description": "Toggle the Num Lock key state when your computer starts.",
@@ -3,10 +3,10 @@ title: "S3 Sleep"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1624} ```json {filename="config/tweaks.json",linenos=inline,linenostart=1569}
"WPFToggleS3Sleep": { "WPFToggleS3Sleep": {
"Content": "S3 Sleep", "Content": "S3 Sleep",
"Description": "Toggles between Modern Standby and S3 Sleep which cuts of power to cpu while continuing to refreshes the memory.", "Description": "Toggles between Modern Standby and S3 Sleep, which cuts off power to the CPU while continuing to refresh the memory.",
"category": "Customize Preferences", "category": "Customize Preferences",
"panel": "2", "panel": "2",
"Type": "Toggle", "Type": "Toggle",
@@ -3,6 +3,25 @@ title: "Scrollbars Always Visible"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1428}
"WPFToggleScrollbars": {
"Content": "Scrollbars Always Visible",
"Description": "If enabled, scrollbars will always be visible. If disabled, Windows will automatically hide scrollbars when not in use.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
"registry": [
{
"Path": "HKCU:\\Control Panel\\Accessibility",
"Name": "DynamicScrollbars",
"Value": "0",
"Type": "DWord",
"OriginalValue": "1",
"DefaultState": "false",
"link": "https://winutil.christitus.com/dev/tweaks/customize-preferences/scrollbars"
}
],
```
## Registry Changes ## Registry Changes
@@ -3,10 +3,10 @@ title: "File Explorer File Extensions"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1385} ```json {filename="config/tweaks.json",linenos=inline,linenostart=1312}
"WPFToggleShowExt": { "WPFToggleShowExt": {
"Content": "File Explorer File Extensions", "Content": "File Explorer File Extensions",
"Description": "Shows .file extensions in explorer (.exe, .png, etc)", "Description": "Shows .file extensions in Explorer (.exe, .png, etc.)",
"category": "Customize Preferences", "category": "Customize Preferences",
"panel": "2", "panel": "2",
"Type": "Toggle", "Type": "Toggle",
@@ -3,7 +3,7 @@ title: "S0 Sleep Network Connectivity"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1606} ```json {filename="config/tweaks.json",linenos=inline,linenostart=1551}
"WPFToggleStandbyFix": { "WPFToggleStandbyFix": {
"Content": "S0 Sleep Network Connectivity", "Content": "S0 Sleep Network Connectivity",
"Description": "Toggles network connectivity during S0 Sleep which is low power idle in modern laptops.", "Description": "Toggles network connectivity during S0 Sleep which is low power idle in modern laptops.",
@@ -3,7 +3,7 @@ title: "Start Menu Recommendations"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1696} ```json {filename="config/tweaks.json",linenos=inline,linenostart=1658}
"WPFToggleStartMenuRecommendations": { "WPFToggleStartMenuRecommendations": {
"Content": "Start Menu Recommendations", "Content": "Start Menu Recommendations",
"Description": "Toggles the recommendations section 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.",
@@ -3,10 +3,10 @@ title: "Sticky Keys"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1740} ```json {filename="config/tweaks.json",linenos=inline,linenostart=1702}
"WPFToggleStickyKeys": { "WPFToggleStickyKeys": {
"Content": "Sticky Keys", "Content": "Sticky Keys",
"Description": "Toggles the stick keys which active when clicking shift rapidly", "Description": "Toggles the Sticky Keys, which activate when clicking shift rapidly.",
"category": "Customize Preferences", "category": "Customize Preferences",
"panel": "2", "panel": "2",
"Type": "Toggle", "Type": "Toggle",
@@ -3,7 +3,7 @@ title: "Taskbar Task View Icon"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1804} ```json {filename="config/tweaks.json",linenos=inline,linenostart=1766}
"WPFToggleTaskView": { "WPFToggleTaskView": {
"Content": "Taskbar Task View Icon", "Content": "Taskbar Task View Icon",
"Description": "Toggles the Task View Button in the Taskbar.", "Description": "Toggles the Task View Button in the Taskbar.",
@@ -3,10 +3,10 @@ title: "Taskbar Centered Icons"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1758} ```json {filename="config/tweaks.json",linenos=inline,linenostart=1720}
"WPFToggleTaskbarAlignment": { "WPFToggleTaskbarAlignment": {
"Content": "Taskbar Centered Icons", "Content": "Taskbar Centered Icons",
"Description": "Toggles the taskbar alignment either to the left or center", "Description": "Toggles the Taskbar alignment either to the left or center.",
"category": "Customize Preferences", "category": "Customize Preferences",
"panel": "2", "panel": "2",
"Type": "Toggle", "Type": "Toggle",
@@ -3,7 +3,7 @@ title: "Taskbar Search Icon"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1786} ```json {filename="config/tweaks.json",linenos=inline,linenostart=1748}
"WPFToggleTaskbarSearch": { "WPFToggleTaskbarSearch": {
"Content": "Taskbar Search Icon", "Content": "Taskbar Search Icon",
"Description": "Toggles the Search Button on the Taskbar.", "Description": "Toggles the Search Button on the Taskbar.",
@@ -3,7 +3,7 @@ title: "Logon Verbose Mode"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1441} ```json {filename="config/tweaks.json",linenos=inline,linenostart=1368}
"WPFToggleVerboseLogon": { "WPFToggleVerboseLogon": {
"Content": "Logon Verbose Mode", "Content": "Logon Verbose Mode",
"Description": "Show detailed messages during startup/shutdown.", "Description": "Show detailed messages during startup/shutdown.",
@@ -0,0 +1,29 @@
---
title: "Window Snapping"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1533}
"WPFToggleWindowSnapping": {
"Content": "Window Snapping",
"Description": "Toggles the window snapping feature when dragging windows.",
"category": "Customize Preferences",
"panel": "2",
"Type": "Toggle",
"registry": [
{
"Path": "HKCU:\\Control Panel\\Desktop",
"Name": "WindowArrangementActive",
"Value": "1",
"Type": "String",
"OriginalValue": "0",
"DefaultState": "true"
}
],
```
## 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,10 +3,10 @@ title: "ConsumerFeatures - Disable"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=451} ```json {filename="config/tweaks.json",linenos=inline,linenostart=430}
"WPFTweaksConsumerFeatures": { "WPFTweaksConsumerFeatures": {
"Content": "ConsumerFeatures - Disable", "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", "category": "Essential Tweaks",
"panel": "1", "panel": "1",
"registry": [ "registry": [
@@ -1,46 +0,0 @@
---
title: "Unwanted Pre-Installed Apps - Remove"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=849}
"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.",
"category": "Essential Tweaks",
"panel": "1",
"appx": [
"Microsoft.WindowsFeedbackHub",
"Microsoft.BingNews",
"Microsoft.BingSearch",
"Microsoft.BingWeather",
"Clipchamp.Clipchamp",
"Microsoft.Todos",
"Microsoft.PowerAutomateDesktop",
"Microsoft.MicrosoftSolitaireCollection",
"Microsoft.WindowsSoundRecorder",
"Microsoft.MicrosoftStickyNotes",
"Microsoft.Windows.DevHome",
"Microsoft.Paint",
"Microsoft.OutlookForWindows",
"Microsoft.WindowsAlarms",
"Microsoft.StartExperiencesApp",
"Microsoft.GetHelp",
"Microsoft.ZuneMusic",
"MicrosoftCorporationII.QuickAssist",
"MSTeams"
],
"InvokeScript": [
"
$TeamsPath = \"$Env:LocalAppData\\Microsoft\\Teams\\Update.exe\"
if (Test-Path $TeamsPath) {
Write-Host \"Uninstalling Teams\"
Start-Process $TeamsPath -ArgumentList -uninstall -wait
Write-Host \"Deleting Teams directory\"
Remove-Item $TeamsPath -Recurse -Force
}
"
],
```
@@ -3,7 +3,7 @@ title: "Temporary Files - Remove"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1139} ```json {filename="config/tweaks.json",linenos=inline,linenostart=1066}
"WPFTweaksDeleteTempFiles": { "WPFTweaksDeleteTempFiles": {
"Content": "Temporary Files - Remove", "Content": "Temporary Files - Remove",
"Description": "Erases TEMP Folders.", "Description": "Erases TEMP Folders.",
@@ -3,7 +3,7 @@ title: "Delivery Optimization - Disable"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=592} ```json {filename="config/tweaks.json",linenos=inline,linenostart=571}
"WPFTweaksDeliveryOptimization": { "WPFTweaksDeliveryOptimization": {
"Content": "Delivery Optimization - Disable", "Content": "Delivery Optimization - Disable",
"Description": "Stops Windows from using your bandwidth to upload updates to other PCs on the internet or local network.", "Description": "Stops Windows from using your bandwidth to upload updates to other PCs on the internet or local network.",
@@ -3,7 +3,7 @@ title: "BitLocker - Disable"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=624} ```json {filename="config/tweaks.json",linenos=inline,linenostart=613}
"WPFTweaksDisableBitLocker": { "WPFTweaksDisableBitLocker": {
"Content": "BitLocker - Disable", "Content": "BitLocker - Disable",
"Description": "Disables BitLocker.", "Description": "Disables BitLocker.",
@@ -3,7 +3,7 @@ title: "File Explorer Automatic Folder Discovery - Disable"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1244} ```json {filename="config/tweaks.json",linenos=inline,linenostart=1171}
"WPFTweaksDisableExplorerAutoDiscovery": { "WPFTweaksDisableExplorerAutoDiscovery": {
"Content": "File Explorer Automatic Folder Discovery - Disable", "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.", "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: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=117} ```json {filename="config/tweaks.json",linenos=inline,linenostart=96}
"WPFTweaksDisableStoreSearch": { "WPFTweaksDisableStoreSearch": {
"Content": "Microsoft Store Recommended Search Results - Disable", "Content": "Microsoft Store Recommended Search Results - Disable",
"Description": "Will not display recommended Microsoft Store apps when searching for apps in the Start menu.", "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: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1126} ```json {filename="config/tweaks.json",linenos=inline,linenostart=1053}
"WPFTweaksDiskCleanup": { "WPFTweaksDiskCleanup": {
"Content": "Disk Cleanup - Run", "Content": "Disk Cleanup - Run",
"Description": "Runs Disk Cleanup on Drive C: and removes old Windows Updates.", "Description": "Runs Disk Cleanup on Drive C: and removes old Windows Updates.",
@@ -3,7 +3,7 @@ title: "End Task With Right Click - Enable"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=917} ```json {filename="config/tweaks.json",linenos=inline,linenostart=855}
"WPFTweaksEndTaskOnTaskbar": { "WPFTweaksEndTaskOnTaskbar": {
"Content": "End Task With Right Click - Enable", "Content": "End Task With Right Click - Enable",
"Description": "Enables option to end task when right clicking a program in the taskbar.", "Description": "Enables option to end task when right clicking a program in the taskbar.",
@@ -3,7 +3,7 @@ title: "Location Tracking - Disable"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=130} ```json {filename="config/tweaks.json",linenos=inline,linenostart=109}
"WPFTweaksLocation": { "WPFTweaksLocation": {
"Content": "Location Tracking - Disable", "Content": "Location Tracking - Disable",
"Description": "Disables Location Tracking.", "Description": "Disables Location Tracking.",
@@ -3,7 +3,7 @@ title: "Restore Point - Create"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=890} ```json {filename="config/tweaks.json",linenos=inline,linenostart=828}
"WPFTweaksRestorePoint": { "WPFTweaksRestorePoint": {
"Content": "Restore Point - Create", "Content": "Restore Point - Create",
"Description": "Creates a restore point at runtime in case a revert is needed from WinUtil modifications.", "Description": "Creates a restore point at runtime in case a revert is needed from WinUtil modifications.",
@@ -3,3 +3,25 @@ title: "Start Menu Previous Layout - Enable"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=80}
"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. On newer versions of Windows !!THIS TWEAK WILL NOT WORK!!",
"category": "Essential Tweaks",
"panel": "1",
"registry": [
{
"Path": "HKLM:\\SYSTEM\\ControlSet001\\Control\\FeatureManagement\\Overrides\\8\\3036241548",
"Name": "EnabledState",
"Value": "1",
"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: "Services - Set to Manual"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=167} ```json {filename="config/tweaks.json",linenos=inline,linenostart=146}
"WPFTweaksServices": { "WPFTweaksServices": {
"Content": "Services - Set to Manual", "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.", "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.",
@@ -3,7 +3,7 @@ title: "Telemetry - Disable"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=467} ```json {filename="config/tweaks.json",linenos=inline,linenostart=446}
"WPFTweaksTelemetry": { "WPFTweaksTelemetry": {
"Content": "Telemetry - Disable", "Content": "Telemetry - Disable",
"Description": "Disables Microsoft Telemetry.", "Description": "Disables Microsoft Telemetry.",
@@ -3,7 +3,7 @@ title: "Windows Platform Binary Table (WPBT) - Disable"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=989} ```json {filename="config/tweaks.json",linenos=inline,linenostart=931}
"WPFTweaksWPBT": { "WPFTweaksWPBT": {
"Content": "Windows Platform Binary Table (WPBT) - Disable", "Content": "Windows Platform Binary Table (WPBT) - Disable",
"Description": "If enabled, WPBT allows your computer vendor to execute programs at boot time, such as anti-theft software, software drivers, as well as force install software without user consent. Poses potential security risk.", "Description": "If enabled, WPBT allows your computer vendor to execute programs at boot time, such as anti-theft software, software drivers, as well as force install software without user consent. Poses potential security risk.",
@@ -3,7 +3,7 @@ title: "Adobe URL Block List - Enable"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1069} ```json {filename="config/tweaks.json",linenos=inline,linenostart=1011}
"WPFTweaksBlockAdobeNet": { "WPFTweaksBlockAdobeNet": {
"Content": "Adobe URL Block List - Enable", "Content": "Adobe URL Block List - Enable",
"Description": "Reduces user interruptions by selectively blocking connections to Adobe's activation and telemetry servers. Credit: Ruddernation-Designs", "Description": "Reduces user interruptions by selectively blocking connections to Adobe's activation and telemetry servers. Credit: Ruddernation-Designs",
@@ -3,7 +3,7 @@ title: "Brave Browser - Debloat"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=207} ```json {filename="config/tweaks.json",linenos=inline,linenostart=186}
"WPFTweaksBraveDebloat": { "WPFTweaksBraveDebloat": {
"Content": "Brave Browser - Debloat", "Content": "Brave Browser - Debloat",
"Description": "Disables various annoyances like Brave Rewards, Leo AI, Crypto Wallet and VPN.", "Description": "Disables various annoyances like Brave Rewards, Leo AI, Crypto Wallet and VPN.",
@@ -3,7 +3,7 @@ title: "Background Apps - Disable"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1212} ```json {filename="config/tweaks.json",linenos=inline,linenostart=1139}
"WPFTweaksDisableBGapps": { "WPFTweaksDisableBGapps": {
"Content": "Background Apps - Disable", "Content": "Background Apps - Disable",
"Description": "Disables all Microsoft Store apps from running in the background, which has to be done individually since Windows 11.", "Description": "Disables all Microsoft Store apps from running in the background, which has to be done individually since Windows 11.",
@@ -3,7 +3,7 @@ title: "Fullscreen Optimizations - Disable"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1228} ```json {filename="config/tweaks.json",linenos=inline,linenostart=1155}
"WPFTweaksDisableFSO": { "WPFTweaksDisableFSO": {
"Content": "Fullscreen Optimizations - Disable", "Content": "Fullscreen Optimizations - Disable",
"Description": "Disables FSO in all applications. NOTE: This will disable Color Management in Exclusive Fullscreen.", "Description": "Disables FSO in all applications. NOTE: This will disable Color Management in Exclusive Fullscreen.",
@@ -3,7 +3,7 @@ title: "IPv6 - Disable"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1190} ```json {filename="config/tweaks.json",linenos=inline,linenostart=1117}
"WPFTweaksDisableIPv6": { "WPFTweaksDisableIPv6": {
"Content": "IPv6 - Disable", "Content": "IPv6 - Disable",
"Description": "Disables IPv6.", "Description": "Disables IPv6.",
@@ -3,7 +3,7 @@ title: "System Tray Notifications & Calendar - Disable"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1046} ```json {filename="config/tweaks.json",linenos=inline,linenostart=988}
"WPFTweaksDisableNotifications": { "WPFTweaksDisableNotifications": {
"Content": "System Tray Notifications & Calendar - Disable", "Content": "System Tray Notifications & Calendar - Disable",
"Description": "Disables all Notifications INCLUDING Calendar.", "Description": "Disables all Notifications INCLUDING Calendar.",
@@ -3,7 +3,7 @@ title: "RDP Unsigned File Warnings - Disable"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=300} ```json {filename="config/tweaks.json",linenos=inline,linenostart=279}
"WPFTweaksDisableWarningForUnsignedRdp": { "WPFTweaksDisableWarningForUnsignedRdp": {
"Content": "RDP Unsigned File Warnings - Disable", "Content": "RDP Unsigned File Warnings - Disable",
"Description": "Disables warnings shown when launching unsigned RDP files introduced with the latest Windows 10 and 11 updates.", "Description": "Disables warnings shown when launching unsigned RDP files introduced with the latest Windows 10 and 11 updates.",
@@ -3,7 +3,7 @@ title: "Visual Effects - Set to Best Performance"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=727} ```json {filename="config/tweaks.json",linenos=inline,linenostart=716}
"WPFTweaksDisplay": { "WPFTweaksDisplay": {
"Content": "Visual Effects - Set to Best Performance", "Content": "Visual Effects - Set to Best Performance",
"Description": "Sets the system preferences to performance. You can do this manually with sysdm.cpl as well.", "Description": "Sets the system preferences to performance. You can do this manually with sysdm.cpl as well.",
@@ -3,7 +3,7 @@ title: "Microsoft Edge - Debloat"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=323} ```json {filename="config/tweaks.json",linenos=inline,linenostart=302}
"WPFTweaksEdgeDebloat": { "WPFTweaksEdgeDebloat": {
"Content": "Microsoft Edge - Debloat", "Content": "Microsoft Edge - Debloat",
"Description": "Disables various telemetry options, popups, and other annoyances in Edge.", "Description": "Disables various telemetry options, popups, and other annoyances in Edge.",
@@ -3,7 +3,7 @@ title: "IPv6 - Set IPv4 as Preferred"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1152} ```json {filename="config/tweaks.json",linenos=inline,linenostart=1079}
"WPFTweaksIPv46": { "WPFTweaksIPv46": {
"Content": "IPv6 - Set IPv4 as Preferred", "Content": "IPv6 - Set IPv4 as Preferred",
"Description": "Setting the IPv4 preference can have latency and security benefits on private networks where IPv6 is not configured.", "Description": "Setting the IPv4 preference can have latency and security benefits on private networks where IPv6 is not configured.",
@@ -8,12 +8,12 @@ function Invoke-WPFOOSU {
try { try {
$ProgressPreference = 'SilentlyContinue' $ProgressPreference = 'SilentlyContinue'
Invoke-WebRequest -Uri https://dl5.oo-software.com/files/ooshutup10/OOSU10.exe -OutFile "$Env:Temp\ooshutup10.exe" Invoke-WebRequest -Uri https://dl5.oo-software.com/files/ooshutup10/OOSU10.exe -OutFile "$winutildir\ooshutup10.exe"
Start-Process -FilePath "$Env:Temp\ooshutup10.exe" Start-Process -FilePath "$winutildir\ooshutup10.exe"
$ProgressPreference = 'Continue' $ProgressPreference = 'Continue'
} catch { } catch {
Write-Error "Couldn't download O&O ShutUp10. Please make sure you have an active internet connection." Write-Error "Couldn't download O&O ShutUp10. Please make sure you have an active Internet connection."
} }
} }
``` ```
@@ -3,7 +3,7 @@ title: "Razer Software Auto-Install - Disable"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1005} ```json {filename="config/tweaks.json",linenos=inline,linenostart=947}
"WPFTweaksRazerBlock": { "WPFTweaksRazerBlock": {
"Content": "Razer Software Auto-Install - Disable", "Content": "Razer Software Auto-Install - Disable",
"Description": "Blocks ALL Razer Software installations. The hardware works fine without any software.", "Description": "Blocks ALL Razer Software installations. The hardware works fine without any software.",
@@ -27,7 +27,7 @@ description: ""
], ],
"InvokeScript": [ "InvokeScript": [
" "
$RazerPath = \"C:\\Windows\\Installer\\Razer\" $RazerPath = \"$Env:SystemRoot\\Installer\\Razer\"
if (Test-Path $RazerPath) { if (Test-Path $RazerPath) {
Remove-Item $RazerPath\\* -Recurse -Force Remove-Item $RazerPath\\* -Recurse -Force
@@ -40,7 +40,7 @@ description: ""
], ],
"UndoScript": [ "UndoScript": [
" "
icacls \"C:\\Windows\\Installer\\Razer\" /remove:d Everyone icacls \"$Env:SystemRoot\\Installer\\Razer\" /remove:d Everyone
" "
], ],
``` ```
@@ -3,18 +3,28 @@ title: "Microsoft Edge - Remove"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=608} ```json {filename="config/tweaks.json",linenos=inline,linenostart=587}
"WPFTweaksRemoveEdge": { "WPFTweaksRemoveEdge": {
"Content": "Microsoft Edge - Remove", "Content": "Microsoft Edge - Remove",
"Description": "Unblocks Microsoft Edge uninstaller restrictions then uses that uninstaller to remove Microsoft Edge.", "Description": "Uninstalls Microsoft Edge by creating dummy MicrosoftEdge.exe file in the legacy Edge folder. This tricks Windows into unlocking the official Edge uninstaller allowing for a system-level removal.",
"category": "z__Advanced Tweaks - CAUTION", "category": "z__Advanced Tweaks - CAUTION",
"panel": "1", "panel": "1",
"InvokeScript": [ "InvokeScript": [
"Invoke-WinUtilRemoveEdge" "
$Path = Resolve-Path -Path \"$Env:ProgramFiles (x86)\\Microsoft\\Edge\\Application\\*\\Installer\\setup.exe\" | Select-Object -Last 1
if (Test-Path $Path) {
New-Item -Path \"$Env:SystemRoot\\SystemApps\\Microsoft.MicrosoftEdge_8wekyb3d8bbwe\\MicrosoftEdge.exe\" -Force
Start-Process -FilePath $Path -ArgumentList \"--uninstall --system-level --force-uninstall --delete-profile\" -Wait
Write-Host \"Microsoft Edge was removed\"
} else {
Write-Host \"Microsoft Edge is not installed\"
}
"
], ],
"UndoScript": [ "UndoScript": [
" "
Write-Host 'Installing Microsoft Edge...' Write-Host \"Installing Microsoft Edge...\"
winget install Microsoft.Edge --source winget winget install Microsoft.Edge --source winget
" "
], ],
@@ -3,7 +3,7 @@ title: "File Explorer Home and Gallery - Disable"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=697} ```json {filename="config/tweaks.json",linenos=inline,linenostart=686}
"WPFTweaksRemoveHomeAndGallery": { "WPFTweaksRemoveHomeAndGallery": {
"Content": "File Explorer Home and Gallery - Disable", "Content": "File Explorer Home and Gallery - Disable",
"Description": "Removes the Home and Gallery from Explorer and sets This PC as default.", "Description": "Removes the Home and Gallery from Explorer and sets This PC as default.",
@@ -3,7 +3,7 @@ title: "Microsoft OneDrive - Remove"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=653} ```json {filename="config/tweaks.json",linenos=inline,linenostart=642}
"WPFTweaksRemoveOneDrive": { "WPFTweaksRemoveOneDrive": {
"Content": "Microsoft OneDrive - Remove", "Content": "Microsoft OneDrive - Remove",
"Description": "Denies permission to remove OneDrive user files, then uses its own uninstaller to remove it and restores the original permission afterward.", "Description": "Denies permission to remove OneDrive user files, then uses its own uninstaller to remove it and restores the original permission afterward.",
@@ -15,7 +15,7 @@ description: ""
icacls $Env:OneDrive /deny \"Administrators:(D,DC)\" icacls $Env:OneDrive /deny \"Administrators:(D,DC)\"
Write-Host \"Uninstalling OneDrive...\" Write-Host \"Uninstalling OneDrive...\"
Start-Process 'C:\\Windows\\System32\\OneDriveSetup.exe' -ArgumentList '/uninstall' -Wait Start-Process '$Env:SystemRoot\\System32\\OneDriveSetup.exe' -ArgumentList '/uninstall' -Wait
# Some of OneDrive files use explorer, and OneDrive uses FileCoAuth # Some of OneDrive files use explorer, and OneDrive uses FileCoAuth
Write-Host \"Removing leftover OneDrive Files...\" Write-Host \"Removing leftover OneDrive Files...\"
@@ -23,7 +23,7 @@ description: ""
Stop-Process -Name FileCoAuth,Explorer Stop-Process -Name FileCoAuth,Explorer
Remove-Item \"$Env:LocalAppData\\Microsoft\\OneDrive\" -Recurse -Force Remove-Item \"$Env:LocalAppData\\Microsoft\\OneDrive\" -Recurse -Force
Remove-Item \"C:\\ProgramData\\Microsoft OneDrive\" -Recurse -Force Remove-Item \"$Env:ProgramData\\Microsoft OneDrive\" -Recurse -Force
# Grant back permission to access OneDrive folder # Grant back permission to access OneDrive folder
icacls $Env:OneDrive /grant \"Administrators:(D,DC)\" icacls $Env:OneDrive /grant \"Administrators:(D,DC)\"
@@ -0,0 +1,18 @@
---
title: "Disable Reserved Storage"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=815}
"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"
],
```
@@ -3,40 +3,19 @@ title: "Right-Click Menu Previous Layout - Enable"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1095} ```json {filename="config/tweaks.json",linenos=inline,linenostart=1037}
"WPFTweaksRightClickMenu": { "WPFTweaksRightClickMenu": {
"Content": "Right-Click Menu Previous Layout - Enable", "Content": "Right-Click Menu Previous Layout - Enable",
"Description": "Restores the classic context menu when right-clicking in File Explorer, replacing the simplified Windows 11 version.", "Description": "Restores the classic context menu when right-clicking in File Explorer, replacing the simplified Windows 11 version.",
"category": "z__Advanced Tweaks - CAUTION", "category": "z__Advanced Tweaks - CAUTION",
"panel": "1", "panel": "1",
"registry": [
{
"Path": "HKCU:\\Software\\Classes\\CLSID\\{86ca1aa0-34aa-4e8b-a509-50c905bae2a2}\\InprocServer32",
"Name": "(default)",
"Value": "",
"Type": "String",
"OriginalValue": "<RemoveEntry>"
}
],
"InvokeScript": [ "InvokeScript": [
" "
New-Item -Path \"HKCU:\\Software\\Classes\\CLSID\\{86ca1aa0-34aa-4e8b-a509-50c905bae2a2}\" -Name \"InprocServer32\" -force -value \"\" New-Item -Path \"HKCU:\\Software\\Classes\\CLSID\\{86ca1aa0-34aa-4e8b-a509-50c905bae2a2}\" -Name InprocServer32 -Value \"\" -Force
Write-Host Restarting explorer.exe ... Stop-Process -Name explorer
Stop-Process -Name \"explorer\" -Force
" "
], ],
"UndoScript": [ "UndoScript": [
" "Remove-Item -Path \"HKCU:\\Software\\Classes\\CLSID\\{86ca1aa0-34aa-4e8b-a509-50c905bae2a2}\" -Recurse"
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
"
], ],
``` ```
## 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: "Storage Sense - Disable"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=933} ```json {filename="config/tweaks.json",linenos=inline,linenostart=871}
"WPFTweaksStorage": { "WPFTweaksStorage": {
"Content": "Storage Sense - Disable", "Content": "Storage Sense - Disable",
"Description": "Storage Sense deletes temp files automatically.", "Description": "Storage Sense deletes temp files automatically.",
@@ -3,7 +3,7 @@ title: "Teredo - Disable"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1168} ```json {filename="config/tweaks.json",linenos=inline,linenostart=1095}
"WPFTweaksTeredo": { "WPFTweaksTeredo": {
"Content": "Teredo - Disable", "Content": "Teredo - Disable",
"Description": "Teredo network tunneling is an IPv6 feature that can cause additional latency, but may cause problems with some games.", "Description": "Teredo network tunneling is an IPv6 feature that can cause additional latency, but may cause problems with some games.",
@@ -3,7 +3,7 @@ title: "Date & Time - Set Time to UTC"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=637} ```json {filename="config/tweaks.json",linenos=inline,linenostart=626}
"WPFTweaksUTC": { "WPFTweaksUTC": {
"Content": "Date & Time - Set Time to UTC", "Content": "Date & Time - Set Time to UTC",
"Description": "Essential for computers that are dual booting. Fixes the time sync with Linux systems.", "Description": "Essential for computers that are dual booting. Fixes the time sync with Linux systems.",
@@ -1,12 +1,12 @@
--- ---
title: "Windows AI - Disable" title: "Windows AI - Disable And Remove"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=949} ```json {filename="config/tweaks.json",linenos=inline,linenostart=887}
"WPFTweaksWindowsAI": { "WPFTweaksWindowsAI": {
"Content": "Windows AI - Disable", "Content": "Windows AI - Disable And Remove",
"Description": "Removes or disables all ai features and packages", "Description": "Removes and disables all AI features/packages",
"category": "z__Advanced Tweaks - CAUTION", "category": "z__Advanced Tweaks - CAUTION",
"panel": "1", "panel": "1",
"registry": [ "registry": [
@@ -32,9 +32,13 @@ description: ""
New-Item \"HKLM:\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Appx\\AppxAllUserStore\\EndOfLife\\$Sid\\$Appx\" -Force 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
winget uninstall -e --name \"Copilot\" --silent --force --accept-source-agreements 2>$null
Get-AppxPackage -AllUsers Microsoft.MicrosoftOfficeHub | Remove-AppxPackage -AllUsers Get-AppxPackage -AllUsers Microsoft.MicrosoftOfficeHub | Remove-AppxPackage -AllUsers
if ($Appx) {
Remove-AppxPackage $Appx Remove-AppxPackage $Appx
}
Set-Service -Name WSAIFabricSvc -StartupType Disabled Set-Service -Name WSAIFabricSvc -StartupType Disabled
Disable-WindowsOptionalFeature -FeatureName Recall -Online -NoRestart Disable-WindowsOptionalFeature -FeatureName Recall -Online -NoRestart
@@ -1,34 +0,0 @@
---
title: "Xbox & Gaming Components - Remove"
description: ""
---
```json {filename="config/tweaks.json",linenos=inline,linenostart=826}
"WPFTweaksXboxRemoval": {
"Content": "Xbox & Gaming Components - Remove",
"Description": "Removes Xbox services, the Xbox app, Game Bar, and related authentication components.",
"category": "z__Advanced Tweaks - CAUTION",
"panel": "1",
"registry": [
{
"Path": "HKCU:\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\GameDVR",
"Name": "AppCaptureEnabled",
"Value": "0",
"Type": "DWord",
"OriginalValue": "1"
}
],
"appx": [
"Microsoft.XboxIdentityProvider",
"Microsoft.XboxSpeechToTextOverlay",
"Microsoft.GamingApp",
"Microsoft.Xbox.TCUI",
"Microsoft.XboxGamingOverlay"
],
```
## 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: "DNS - Set to:"
description: "" description: ""
--- ---
```json {filename="config/tweaks.json",linenos=inline,linenostart=1873} ```json {filename="config/tweaks.json",linenos=inline,linenostart=1835}
"WPFchangedns": { "WPFchangedns": {
"Content": "DNS - Set to:", "Content": "DNS - Set to:",
"category": "z__Advanced Tweaks - CAUTION", "category": "z__Advanced Tweaks - CAUTION",
+14 -14
View File
@@ -6,46 +6,46 @@ toc: true
## General Questions ## General Questions
### Is Windows 10 still supported? ### Is Windows 10 still supported?
No. Windows 10 is no longer supported by Winutil because it reached the end of support on **October 14, 2025**. No. Windows 10 is no longer supported by WinUtil because it reached the end of support on **October 14, 2025**.
Winutil is focused on Windows 11. WinUtil is focused on Windows 11.
### How do I uninstall Winutil? ### How do I uninstall WinUtil?
You do not need to uninstall Winutil. Because it runs as a PowerShell script, it is loaded into memory only while it is open. Once you close it, it is removed from memory and does not remain installed on your system. You do not need to uninstall WinUtil. Because it runs as a PowerShell script, it is loaded into memory only while it is open. Once you close it, it is removed from memory and does not remain installed on your system.
### Is Winutil safe to use? ### Is WinUtil safe to use?
Yes, Winutil is open source, and the code is publicly available on GitHub. Thousands of users run it daily. However, like any system modification tool, you should: Yes, WinUtil is open source, and the code is publicly available on GitHub. Thousands of users run it daily. However, like any system modification tool, you should:
- Run it as Administrator (required) - Run it as Administrator (required)
- Create a restore point before major changes - Create a restore point before major changes
- Understand what tweaks you're applying - Understand what tweaks you're applying
- Run only from [official source](https://github.com/ChrisTitusTech/winutil/) - Run only from [official source](https://github.com/ChrisTitusTech/winutil/)
### Do I need to keep running Winutil? ### Do I need to keep running WinUtil?
No. Once you've applied tweaks or installed applications, you can close Winutil. Changes persist after closing. You only need to run Winutil again when you want to make additional changes or undo tweaks. No. Once you've applied tweaks or installed applications, you can close WinUtil. Changes persist after closing. You only need to run WinUtil again when you want to make additional changes or undo tweaks.
### Does Winutil require internet access? ### Does Winutil require internet access?
- **For downloading**: Yes, installing applications requires the internet - **For downloading**: Yes, installing applications requires the Internet
- **For tweaks**: No, most tweaks work offline - **For tweaks**: No, most tweaks work offline
- **Initial run**: Yes, to run the latest script - **Initial run**: Yes, to run the latest script
### How often is Winutil updated? ### How often is WinUtil updated?
Winutil is actively maintained with frequent updates. New features, bug fixes, and application additions are released regularly. The script auto-downloads the latest version each time you run it. WinUtil is actively maintained with frequent updates. New features, bug fixes, and application additions are released regularly. The script auto-downloads the latest version each time you run it.
## Installation & Running ## Installation & Running
### How do I run Winutil? ### How do I run WinUtil?
1. Open PowerShell as Administrator 1. Open PowerShell as Administrator
2. Run: `irm "https://christitus.com/win" | iex` 2. Run: `irm "https://christitus.com/win" | iex`
3. Wait for the GUI to appear 3. Wait for the GUI to appear
### Why do I need Administrator rights? ### Why do I need Administrator rights?
Winutil makes system-level changes (registry edits, service modifications, software installation) that require elevated permissions. Without admin rights, most features won't work. WinUtil makes system-level changes (registry edits, service modifications, software installation) that require elevated permissions. Without admin rights, most features won't work.
### The script won't download. What do I do? ### The script won't download. What do I do?
Try these solutions in order: Try these solutions in order:
1. **Use the direct GitHub link**: 1. **Use the direct GitHub link**:
```powershell ```powershell
irm https://github.com/ChrisTitusTech/Winutil/releases/latest/download/Winutil.ps1 | iex irm https://github.com/ChrisTitusTech/winutil/releases/latest/download/Winutil.ps1 | iex
``` ```
2. **Force TLS 1.2**: 2. **Force TLS 1.2**:
+2 -2
View File
@@ -147,7 +147,7 @@ Want to help improve Winutil?
## Video Tutorial ## Video Tutorial
Watch the complete Winutil overview: Watch the complete WinUtil overview:
{{< youtube id=6UQZ5oQg8XA loading=lazy >}} {{< youtube id=6UQZ5oQg8XA loading=lazy >}}
@@ -158,5 +158,5 @@ Ready to get started? Head to the **[Getting Started Guide](getting-started/)**.
Dive right into the following section to get started: Dive right into the following section to get started:
{{< cards >}} {{< cards >}}
{{< card link="getting-started" title="Getting Started" icon="document-text" subtitle="Learn how to use winutil." >}} {{< card link="getting-started" title="Getting Started" icon="document-text" subtitle="Learn how to use WinUtil." >}}
{{< /cards >}} {{< /cards >}}
+1 -1
View File
@@ -5,7 +5,7 @@ prev: /userguide/getting-started/
next: /userguide/tweaks/ next: /userguide/tweaks/
--- ---
Use the Applications tab to install, upgrade, uninstall, and review supported apps from one place. Winutil relies on package manager support for these actions, so the available results depend on what WinGet can detect and manage on your system. Use the Applications tab to install, upgrade, uninstall, and review supported apps from one place. WinUtil relies on package manager support for these actions, so the available results depend on what WinGet can detect and manage on your system.
{{< tabs >}} {{< tabs >}}
+7 -7
View File
@@ -5,9 +5,9 @@ prev: /userguide/updates/
next: /userguide/win11creator/ next: /userguide/win11creator/
--- ---
Use Automation to run Winutil from an exported configuration file. Use Automation to run WinUtil from an exported configuration file.
Winutil supports predefined presets that apply common configurations automatically: WinUtil supports predefined presets that apply common configurations automatically:
- `Standard` - `Standard`
- `Minimal` - `Minimal`
@@ -22,23 +22,23 @@ Example:
To view exactly what each preset does, see: To view exactly what each preset does, see:
https://github.com/ChrisTitusTech/winutil/blob/main/config/preset.json https://github.com/ChrisTitusTech/winutil/blob/main/config/preset.json
To create you're own config file: To create your own config file:
1. Open Winutil. 1. Open WinUtil.
2. Click the gear icon in the top-right corner. 2. Click the gear icon in the top-right corner.
3. Choose **Export**. 3. Choose **Export**.
4. Save the exported JSON file. 4. Save the exported JSON file.
Once you have exported a config, launch Winutil with it using this command: Once you have exported a config, launch WinUtil with it using this command:
```powershell ```powershell
& ([ScriptBlock]::Create((irm "https://christitus.com/win"))) -Config "C:\Path\To\Config.json" & ([ScriptBlock]::Create((irm "https://christitus.com/win"))) -Config "C:\Path\To\Config.json"
``` ```
This is useful for: This is useful for:
- Applying the same Winutil configuration across multiple Windows 11 PCs - Applying the same WinUtil configuration across multiple Windows 11 PCs
- Reusing a known-good baseline after reinstalling Windows - Reusing a known-good baseline after reinstalling Windows
- Standardizing deployments for labs, workstations, or personal setups - Standardizing deployments for labs, workstations, or personal setups
> [!NOTE] > [!NOTE]
> Run the command in an elevated PowerShell session so Winutil can apply system-level changes. > Run the command in an elevated PowerShell session so WinUtil can apply system-level changes.

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