Repo Cleanup (#2367)

* remove trailing whitespaces, remove unused img folder

* Rename TweaksScreen.PNG to TweaksScreen.png

* restructure "Install-WinUtilProgramWinget"

* undo programwinget function rework

* fix typo

.github/PULL_REQUEST_TEMPLATE.md

@@ -33,4 +33,4 @@
 - [ ] I have performed a self-review of my own code.
 - [ ] I have commented my code, particularly in hard-to-understand areas.
 - [ ] I have made corresponding changes to the documentation.
-- [ ] My changes generate no errors/warnings/merge conflicts. 
+- [ ] My changes generate no errors/warnings/merge conflicts.

.github/workflows/github-pages.yml

@@ -2,7 +2,7 @@ name: GitHub Pages Deploy
 on:
   push:
     branches:
-      - master 
+      - master
       - main
 permissions:
   contents: write

Battery.txt

@@ -1,83 +0,0 @@
-# Battery drains too fast.
-When your battery on the laptop drains too fast, please perform these steps and report the results back to the Winutil community.
-
-1. **Check Battery Health:**
-   - Open a Command Prompt as an administrator.
-   - Run the following command to generate a battery report:
-     ```powershell
-     powercfg /batteryreport /output "C:\battery_report.html"
-     ```
-   - Open the generated HTML report to review information about battery health and usage.
-
-2. **Review Power Settings:**
-   - Go to "Settings" > "System" > "Power & sleep."
-   - Adjust power plan settings based on your preferences and usage patterns.
-   - Click on "Additional power settings" to access advanced power settings.
-
-3. **Identify Power-Hungry Apps:**
-   - Right-click on the taskbar and select "Task Manager."
-   - Navigate to the "Processes" tab to identify applications with high CPU or memory usage.
-   - Consider closing unnecessary background applications.
-
-4. **Update Drivers:**
-   - Visit your laptop manufacturer's website or use Windows Update to check for driver updates.
-   - Ensure graphics, chipset, and other essential drivers are up to date.
-
-5. **Check for Windows Updates:**
-   - Go to "Settings" > "Update & Security" > "Windows Update."
-   - Check for and install any available updates for your operating system.
-
-6. **Reduce Screen Brightness:**
-   - Adjust screen brightness based on your preferences and lighting conditions.
-   - Go to "Settings" > "System" > "Display" to adjust brightness.
-
-7. **Battery Saver Mode:**
-   - Go to "Settings" > "System" > "Battery."
-   - Turn on "Battery saver" to limit background activity and conserve power.
-
-8. **Check Power Usage in Settings:**
-   - Go to "Settings" > "System" > "Battery" > "Battery usage by app."
-   - Review the list of apps and their power usage.
-
-9. **Check Background Apps:**
-   - Go to "Settings" > "Privacy" > "Background apps."
-   - Disable unnecessary apps running in the background.
-
-10. **Use Powercfg for Analysis:**
-    - Open a Command Prompt as an administrator.
-    - Run the following command to analyze energy usage and generate a report:
-      ```powershell
-      powercfg /energy /output "C:\energy_report.html"
-      ```
-    - Open the generated HTML report to identify energy consumption patterns.
-
-11. **Review Event Viewer:**
-    - Open Event Viewer by searching for it in the Start menu.
-    - Navigate to "Windows Logs" > "System."
-    - Look for events with the source "Power-Troubleshooter" to identify power-related events.
-
-12. **Check Wake-up Sources:**
-    - Open a Command Prompt as an administrator.
-    - Use the command `powercfg /requests` to identify processes preventing sleep.
-    - Check Task Scheduler for tasks waking up the computer.
-    - Use the command `powercfg /waketimers` to view active wake timers.
-
-13. **Resource Monitor:**
-    - Open Resource Monitor from the Start menu.
-    - Navigate to the "CPU" tab and identify processes with high CPU usage.
-
-14. **Windows Settings - Activity History:**
-    - In "Settings," go to "Privacy" > "Activity history."
-    - Turn off "Let Windows collect my activities from this PC."
-
-15. **Network Adapters:**
-    - Open Device Manager by searching for it in the Start menu.
-    - Locate your network adapter, right-click, and go to "Properties."
-    - Under the "Power Management" tab, uncheck the option that allows the device to wake the computer.
-
-16. **Review Installed Applications:**
-    - Manually review installed applications by searching for "Add or remove programs" in the Start menu.
-    - Check settings/preferences of individual applications for power-related options.
-    - Uninstall unnecessary or problematic software.
-
-By following these detailed instructions, you should be able to thoroughly diagnose and address battery drain issues on your Windows laptop. Adjust settings as needed to optimize power management and improve battery life.

Error-in-Winutil-MicroWin-during-ISO-mounting.txt

@@ -1,39 +0,0 @@
-# Troubleshoot errors during Microwin usage
-
-## Error `0x80041031`
-
-This error code typically indicates an issue related to Windows Management Instrumentation (WMI). Here are a few steps you can try to resolve the issue:
-
-1. **Reboot Your Computer:**
-   Sometimes, a simple reboot can resolve temporary issues. Restart your computer and try mounting the ISO again.
-
-2. **Check for System Corruption:**
-   Run the System File Checker (SFC) utility to scan and repair system files that may be corrupted.
-   ```powershell
-   sfc /scannow
-   ```
-
-3. **Update Your System:**
-   Make sure your operating system is up-to-date. Check for Windows updates and install any pending updates.
-
-4. **Check WMI Service:**
-   Ensure that the Windows Management Instrumentation (WMI) service is running. You can do this through the Services application:
-   - Press `Win + R` to open the Run dialog.
-   - Type `services.msc` and press Enter.
-   - Locate "Windows Management Instrumentation" in the list.
-   - Make sure to set its status to "Running" and the startup type to "Automatic."
-
-5. **Check for Security Software Interference:**
-   Security software can sometimes interfere with WMI operations. Temporarily disable your antivirus or security software and check if the issue persists.
-
-6. **Event Viewer:**
-   Check the Event Viewer for more detailed error information. Look for entries related to the `80041031` error and check if there are any additional details that can help identify the cause.
-
-   - Press `Win + X` and select "Event Viewer."
-   - Navigate to "Windows Logs" -> "Application" or "System."
-   - Look for entries with the source related to WMI or the application use to mount the ISO.
-
-7. **ISO File Integrity:**
-   Ensure that the ISO file you are trying to mount is uncorrupted. Try mounting a different ISO file to see if the issue persists.
-
-If the problem persists after trying these steps, additional troubleshooting is required. Consider seeking assistance from Microsoft support or community forums for more specific guidance based on your system configuration and the software you use to mount the ISO.

README.md

@@ -37,7 +37,7 @@ irm "https://christitus.com/windev" | iex
 
 If you have Issues, refer to [Known Issues](https://christitustech.github.io/winutil/KnownIssues/)
 
-## 🎓 Documenation
+## 🎓 Documentation
 
 ### [WinUtil Official Documentation](https://christitustech.github.io/winutil/)
 

docs/KnownIssues.md

@@ -51,3 +51,127 @@ Get-Service -Name "XboxGipSvc" | Set-Service -StartupType Automatic
 - (Windows 11) Quick Settings no longer works: Launch the Script and click 'Enable Action Center'
 
 - Explorer no longer launches: Go to Control Panel, File Explorer Options, Change the 'Open File Explorer to' option to 'This PC'.
+
+### Battery drains too fast.
+When your battery on the laptop drains too fast, please perform these steps and report the results back to the Winutil community.
+
+1. **Check Battery Health:**
+   - Open a Command Prompt as an administrator.
+   - Run the following command to generate a battery report:
+     ```powershell
+     powercfg /batteryreport /output "C:\battery_report.html"
+     ```
+   - Open the generated HTML report to review information about battery health and usage.
+
+2. **Review Power Settings:**
+   - Go to "Settings" > "System" > "Power & sleep."
+   - Adjust power plan settings based on your preferences and usage patterns.
+   - Click on "Additional power settings" to access advanced power settings.
+
+3. **Identify Power-Hungry Apps:**
+   - Right-click on the taskbar and select "Task Manager."
+   - Navigate to the "Processes" tab to identify applications with high CPU or memory usage.
+   - Consider closing unnecessary background applications.
+
+4. **Update Drivers:**
+   - Visit your laptop manufacturer's website or use Windows Update to check for driver updates.
+   - Ensure graphics, chipset, and other essential drivers are up to date.
+
+5. **Check for Windows Updates:**
+   - Go to "Settings" > "Update & Security" > "Windows Update."
+   - Check for and install any available updates for your operating system.
+
+6. **Reduce Screen Brightness:**
+   - Adjust screen brightness based on your preferences and lighting conditions.
+   - Go to "Settings" > "System" > "Display" to adjust brightness.
+
+7. **Battery Saver Mode:**
+   - Go to "Settings" > "System" > "Battery."
+   - Turn on "Battery saver" to limit background activity and conserve power.
+
+8. **Check Power Usage in Settings:**
+   - Go to "Settings" > "System" > "Battery" > "Battery usage by app."
+   - Review the list of apps and their power usage.
+
+9. **Check Background Apps:**
+   - Go to "Settings" > "Privacy" > "Background apps."
+   - Disable unnecessary apps running in the background.
+
+10. **Use Powercfg for Analysis:**
+    - Open a Command Prompt as an administrator.
+    - Run the following command to analyze energy usage and generate a report:
+      ```powershell
+      powercfg /energy /output "C:\energy_report.html"
+      ```
+    - Open the generated HTML report to identify energy consumption patterns.
+
+11. **Review Event Viewer:**
+    - Open Event Viewer by searching for it in the Start menu.
+    - Navigate to "Windows Logs" > "System."
+    - Look for events with the source "Power-Troubleshooter" to identify power-related events.
+
+12. **Check Wake-up Sources:**
+    - Open a Command Prompt as an administrator.
+    - Use the command `powercfg /requests` to identify processes preventing sleep.
+    - Check Task Scheduler for tasks waking up the computer.
+    - Use the command `powercfg /waketimers` to view active wake timers.
+
+13. **Resource Monitor:**
+    - Open Resource Monitor from the Start menu.
+    - Navigate to the "CPU" tab and identify processes with high CPU usage.
+
+14. **Windows Settings - Activity History:**
+    - In "Settings," go to "Privacy" > "Activity history."
+    - Turn off "Let Windows collect my activities from this PC."
+
+15. **Network Adapters:**
+    - Open Device Manager by searching for it in the Start menu.
+    - Locate your network adapter, right-click, and go to "Properties."
+    - Under the "Power Management" tab, uncheck the option that allows the device to wake the computer.
+
+16. **Review Installed Applications:**
+    - Manually review installed applications by searching for "Add or remove programs" in the Start menu.
+    - Check settings/preferences of individual applications for power-related options.
+    - Uninstall unnecessary or problematic software.
+
+By following these detailed instructions, you should be able to thoroughly diagnose and address battery drain issues on your Windows laptop. Adjust settings as needed to optimize power management and improve battery life.
+
+### Troubleshoot errors during Microwin usage
+
+#### Error `0x80041031`
+
+This error code typically indicates an issue related to Windows Management Instrumentation (WMI). Here are a few steps you can try to resolve the issue:
+
+1. **Reboot Your Computer:**
+   Sometimes, a simple reboot can resolve temporary issues. Restart your computer and try mounting the ISO again.
+
+2. **Check for System Corruption:**
+   Run the System File Checker (SFC) utility to scan and repair system files that may be corrupted.
+   ```powershell
+   sfc /scannow
+   ```
+
+3. **Update Your System:**
+   Make sure your operating system is up-to-date. Check for Windows updates and install any pending updates.
+
+4. **Check WMI Service:**
+   Ensure that the Windows Management Instrumentation (WMI) service is running. You can do this through the Services application:
+   - Press `Win + R` to open the Run dialog.
+   - Type `services.msc` and press Enter.
+   - Locate "Windows Management Instrumentation" in the list.
+   - Make sure to set its status to "Running" and the startup type to "Automatic."
+
+5. **Check for Security Software Interference:**
+   Security software can sometimes interfere with WMI operations. Temporarily disable your antivirus or security software and check if the issue persists.
+
+6. **Event Viewer:**
+   Check the Event Viewer for more detailed error information. Look for entries related to the `80041031` error and check if there are any additional details that can help identify the cause.
+
+   - Press `Win + X` and select "Event Viewer."
+   - Navigate to "Windows Logs" -> "Application" or "System."
+   - Look for entries with the source related to WMI or the application use to mount the ISO.
+
+7. **ISO File Integrity:**
+   Ensure that the ISO file you are trying to mount is uncorrupted. Try mounting a different ISO file to see if the issue persists.
+
+If the problem persists after trying these steps, additional troubleshooting is required. Consider seeking assistance from Microsoft support or community forums for more specific guidance based on your system configuration and the software you use to mount the ISO.

docs/contribute.md

@@ -27,8 +27,8 @@
 * Fork the WinUtil Repository [here](https://github.com/ChrisTitusTech/winutil) to create a copy that will be available in your Repository-list.
 ![Fork](assets/ForkButton.png)
 
-### Clone the Fork 
+### Clone the Fork
-* While you can make your changes directly through the Web, we recommend cloning the repo to your device to test your fork easily. 
+* While you can make your changes directly through the Web, we recommend cloning the repo to your device to test your fork easily.
 * Using the application GitHub Desktop (available in WinUtil) you can easily manage your repos locally. You can do it using other tools like git-cli (available in WinUtil), we recommend GitHub Desktop for ease of use.
 * Install GitHub Desktop if not already installed
 * Log in using the same GitHub account u used to fork WinUtil

docs/userguide.md

@@ -33,7 +33,7 @@
 
 #### Tweaks Addition
 * To enable tweaks on your system select Tweaks at the top next to Install.
-* Then you can select what tweaks you want adding to your system. We do have some presets you can select from at the top you can see this in the picture below. 
+* Then you can select what tweaks you want adding to your system. We do have some presets you can select from at the top you can see this in the picture below.
 ![Tweaks Screen](assets/TweaksScreen.PNG)
 * After you have chosen your tweaks click the Run Tweaks button at the bottom of the screen.
 
@@ -114,7 +114,7 @@
 * **Keep Provisioned Packages**: leaving this option unticked (default) will try to remove every operating system package
 
 	Some packages may remain after processing. This can happen if the packages in question were permanent ones or had been superseded by newer versions
-	
+
 * **Keep Appx Packages**: leaving this option unticked (default) will try to remove every Microsoft Store app from the Windows image
 
 	This option will exclude some applications that are essential in the case that you want or need to add a Store app later on
@@ -122,7 +122,7 @@
 * **Keep Defender**: leaving this option unticked will try to remove every part of Windows Defender, including the Windows Security app
 
 	Leaving this option unticked is **NOT recommended** unless you plan to use a third-party antivirus solution on your MicroWin installation. On that regard, don't install AVs with bad reputation or rogueware
-	
+
 * **Keep Edge**: leaving this option unticked will try to remove every part of the Microsoft Edge browser using the best methods available
 
 	Leaving this option unticked is not recommended because it might break some applications that might depend on the `Edge WebView2` runtime. However, if that happens, you can easily [reinstall it](https://developer.microsoft.com/en-us/microsoft-edge/webview2)
@@ -141,7 +141,7 @@
 * **Copy to Ventoy** will copy the target ISO file to any USB drive with [Ventoy](https://ventoy.net/en/index.html) installed
 
 	Ventoy is a solution that lets you boot to any ISO file stored in a drive. Think of it as having multiple bootable USBs in one. Do note though that your drive needs to have enough free space for the target ISO file
-	
+
 
 ## Automation
 

functions/public/Invoke-WPFShortcut.ps1

@@ -28,9 +28,9 @@ function Invoke-WPFShortcut {
             else{
                 $shell = "powershell.exe"
             }
-            
+
             $shellArgs = "-ExecutionPolicy Bypass -Command `"Start-Process $shell -verb runas -ArgumentList `'-Command `"irm https://christitus.com/win | iex`"`'"
-            
+
             $DestinationName = "WinUtil.lnk"
 
             Invoke-WebRequest -Uri "https://christitus.com/images/logo-full.png" -OutFile "$env:TEMP\cttlogo.png"

functions/public/Invoke-WPFTweakPS7.ps1

@@ -30,11 +30,11 @@ function Invoke-WPFTweakPS7{
         Write-Host "Windows Terminal not installed. Skipping Terminal preference"
         return
     }
-    # Check if the Windows Terminal settings.json file exists and return if not (Prereqisite for the following code) 
+    # Check if the Windows Terminal settings.json file exists and return if not (Prereqisite for the following code)
     $settingsPath = "$env:LOCALAPPDATA\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json"
     if (-not (Test-Path -Path $settingsPath)){
         Write-Host "Windows Terminal Settings file not found at $settingsPath"
-        return 
+        return
     }
 
     Write-Host "Settings file found."
@@ -49,5 +49,5 @@ function Invoke-WPFTweakPS7{
         Write-Host "using the name attribute."
     } else {
         Write-Host "No PowerShell 7 profile found in Windows Terminal settings using the name attribute."
-    }   
+    }
 }

functions/public/Invoke-WPFUltimatePerformance.ps1

@@ -33,7 +33,7 @@ Function Invoke-WPFUltimatePerformance {
             if ($ultimatePlan) {
                 # Extract the GUID of the Ultimate Performance plan
                 $ultimatePlanGUID = $ultimatePlan.Line.Split()[3]
-                
+
                 # Set a different power plan as active before deleting the Ultimate Performance plan
                 $balancedPlanGUID = (powercfg -list | Select-String -Pattern "Balanced").Line.Split()[3]
                 powercfg -setactive $balancedPlanGUID

mkdocs.yml

@@ -29,15 +29,15 @@ theme:
     - media: "(prefers-color-scheme: light)"
       scheme: default
       toggle:
-        icon: material/toggle-switch-off-outline 
+        icon: material/toggle-switch-off-outline
         name: Switch to dark mode
       primary: black
-      accent: purple 
+      accent: purple
     - media: "(prefers-color-scheme: dark)"
-      scheme: slate 
+      scheme: slate
       toggle:
         icon: material/toggle-switch
-        name: Switch to light mode    
+        name: Switch to light mode
       primary: teal
       accent: lime
   markdown_extensions: