You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
# Customer intent: As a Windows user, I want to learn about PowerToys, a set of utilities, shell enhancements, and productivity tools for Windows.
9
+
# Customer intent: As a Windows power user, I want to learn about PowerToys, a set of utilities, shell enhancements, and productivity tools for Windows.
10
10
---
11
11
12
12
# Microsoft PowerToys: Utilities to customize Windows
13
13
14
-
:::image type="content" border="false" source="../images/pt-header.png" alt-text="Hero image of PowerToys with app icons of all its utilities":::
15
-
16
-
Microsoft PowerToys is a set of utilities to tune and streamline your Windows experience for greater productivity. These utilities and shell enhancement tools are designed to help you customize Windows to suit your needs.
14
+
Microsoft PowerToys is a set of free Microsoft Windows utilities for power users to tune and streamline their Windows experience for greater productivity. These utilities and shell enhancement tools are designed to help you customize Windows 10 and Windows 11 to suit your needs.
17
15
18
16
> [!div class="nextstepaction"]
19
17
> [Install PowerToys](install.md)
20
18
21
-
PowerToys is an open-source project, to learn more check out the [repository on GitHub](https://aka.ms/powertoys)
19
+
## System requirements
20
+
21
+
PowerToys requires Windows 10 version 2004 (build 19041) or later, or any version of Windows 11. It isn't supported on earlier versions of Windows. For a complete list of system requirements, see [Installing PowerToys \| Requirements](/windows/powertoys/install#system-requirements).
# Customer intent: As a Windows power user, I want to learn how to install PowerToys on Windows using an executable file or package manager.
10
10
---
11
11
12
-
# Install PowerToys
12
+
# Install PowerToys on Windows
13
13
14
14
PowerToys is a set of utilities for customizing Windows that you can install using multiple methods. This article explains how to install PowerToys on Windows 11 and Windows 10 using an executable file, Microsoft Store, or package managers like WinGet, Chocolatey, and Scoop.
15
15
16
16
We recommend installing PowerToys via [GitHub](https://aka.ms/installpowertoys) or [Microsoft Store](https://aka.ms/getPowertoys), but alternative install methods are also listed if you prefer using a package manager.
17
17
18
-
###System requirements
18
+
## System requirements
19
19
20
20
The following are the minimum requirements to install and run PowerToys:
21
21
22
-
- Windows 11 or Windows 10 version 2004 (20H1 / build 19041) or newer
23
-
- 64-bit processor: x64 or ARM64
24
-
- Latest stable version of Microsoft Edge WebView2 Runtime is installed via the bootstrapper during setup
22
+
- Supported Operating Systems:
23
+
- Windows 11 (all versions)
24
+
- Windows 10 v2004 (19041) or newer
25
+
- System architecture
26
+
- x64 and Arm64 architectures are currently supported.
27
+
- The PowerToys installer will install the following runtimes:
28
+
-[Microsoft Edge WebView2 Runtime](https://go.microsoft.com/fwlink/p/?LinkId=2124703) bootstrapper (this will always install the latest version available)
25
29
26
-
### Installation methods
27
-
#### [GitHub](#tab/gh)
30
+
To see if your machine meets these requirements, check your Windows version and build number by opening a Run dialog (Win+R), then type `winver` and select <kbd>OK</kbd> or <kbd>Enter</kbd>. Alternatively, enter the `ver` command in Windows Command Prompt or [Windows Terminal](/windows/terminal/). You may be able to [update to the latest Windows version](ms-settings:windowsupdate) in **Windows Update**.
31
+
32
+
> [!TIP]
33
+
> You can use AI assistance to [create Windows Package Manager install commands for PowerToys with Copilot](#ask-copilot-for-help-with-command-line-arguments).
34
+
35
+
## Install with Windows executable file from GitHub
To install PowerToys using a Windows executable file:
30
41
@@ -33,11 +44,11 @@ To install PowerToys using a Windows executable file:
33
44
1. Select the `PowerToysSetup-0.##.#-x64.exe` or `PowerToysSetup-0.##.#-arm64.exe` file to download the PowerToys executable installer.
34
45
1. Once downloaded, open the executable file and follow the installation prompts.
35
46
36
-
#### [Microsoft Store](#tab/store)
47
+
##Install with Microsoft Store
37
48
38
49
You can install PowerToys from the [Microsoft Store's PowerToys page](https://aka.ms/getPowertoys).
39
50
40
-
#### [WinGet](#tab/winget)
51
+
##Install with Windows Package Manager
41
52
42
53
To install PowerToys using the [Windows Package Manager](../package-manager/winget/index.md), it's as simple as running the following command from the command line / PowerShell:
PowerToys supports configuring through `winget configure` using [Desired State Configuration](dsc-configure.md).
49
60
61
+
## Command-line installer arguments
62
+
50
63
The installer executable accepts the [Microsoft Standard Installer command-line options](/windows/win32/msi/standard-installer-command-line-options).
51
64
52
65
Here are some common commands you may want to use:
@@ -59,7 +72,7 @@ Here are some common commands you may want to use:
59
72
| /layout || create a local image of the bootstrapper |
60
73
| /log | /l | log to a specific file |
61
74
62
-
####Ask Copilot for help with command-line arguments
75
+
### Ask Copilot for help with command-line arguments
63
76
64
77
You can get AI assistance from [Copilot](https://copilot.microsoft.com/) to generate a `winget` command with the arguments you need. You can customize the prompt to generate a string per your requirements.
65
78
@@ -71,11 +84,50 @@ Generate a `winget` command to install Microsoft PowerToys with arguments to ins
71
84
72
85
Copilot is powered by AI, so surprises and mistakes are possible. For more information, see [Copilot FAQs](https://www.microsoft.com/microsoft-copilot/learn/).
73
86
74
-
#### [Other methods](#tab/other)
87
+
### Extracting the MSI from the bundle for 0.94 and later
88
+
89
+
Make sure to have the [.NET SDK](https://dotnet.microsoft.com/download/) installed.
90
+
91
+
In PowerShell, run `dotnet tool install wix --global` to install the latest version of WiX Toolset.
92
+
93
+
This PowerShell example assumes that the PowerToys installer has been downloaded to the Windows desktop.
### Extracting the MSI from the bundle for 0.93 and earlier
100
+
101
+
Make sure to have [WiX Toolset v3](https://docs.firegiant.com/wix/wix3/) installed. The command doesn't work with WiX Toolset v4 and later versions.
102
+
103
+
This PowerShell example assumes the default install location for WiX Toolset and that the PowerToys installer has been downloaded to the Windows desktop.
### Fixes for uninstalling 0.51 and earlier builds issues
113
+
114
+
If you have an issue with the MSI being inaccessible, you can download the installer that corresponds with the installed version via the [PowerToys releases page](https://github.com/microsoft/PowerToys/releases) and run the following command. You'll need to change EXECUTABLE_INSTALLER_NAME to the actual file name.
115
+
116
+
In PowerShell, run `.\EXECUTABLE_INSTALLER_NAME.exe --extract_msi` and this will extract the MSI to your desktop.
117
+
118
+
### Clean-up scripts
119
+
120
+
If there are problems while uninstalling a version, there are cleanup scripts available:
There are community driven install methods such as Chocolatey and Scoop to install PowerToys.
127
+
These community-driven alternative install methods aren't officially supported, and the PowerToys team doesn't update or manage these packages.
128
+
129
+
### Install with Chocolatey
77
130
78
-
##### Chocolatey
79
131
To install [PowerToys](https://community.chocolatey.org/packages/powertoys) using [Chocolatey](https://chocolatey.org/), run the following command from your command line / PowerShell:
80
132
81
133
```powershell
@@ -90,7 +142,7 @@ choco upgrade powertoys
90
142
91
143
If you have issues when installing/upgrading, create an issue at the [maintainers GitHub repository](https://github.com/mkevenaar/chocolatey-packages/issues) or follow the [Chocolatey triage process](https://docs.chocolatey.org/en-us/community-repository/users/package-triage-process).
92
144
93
-
#####Scoop
145
+
###Install with Scoop
94
146
95
147
To install PowerToys using [Scoop](https://scoop.sh/), run the following command from the command line / PowerShell:
96
148
@@ -107,64 +159,21 @@ scoop update powertoys
107
159
108
160
If you have issues when installing/updating, file an issue in the [Scoop repo on GitHub](https://github.com/lukesampson/scoop/issues).
109
161
110
-
---
111
-
112
-
### After installation
162
+
## After installation
113
163
114
164
After successfully installing PowerToys, an overview window will display with introductory guidance for each of the available utilities.
115
165
116
166
If you view the Home view of the PowerToys settings, you can get quick access to some of the utilities, see an overview of the available shortcuts, and enable or disable individual utilities.
117
167
118
168
:::image type="content" source="../images/powertoys-settings-home.png" alt-text="A screenshot of the Home page of the PowerToys settings.":::
119
169
120
-
###Updates
170
+
## Updates
121
171
122
172
PowerToys uses an automatic update checker that checks for new versions when the app is running. If enabled, a toast notification will appear when an update is available. You can also check for updates manually from the PowerToys Settings.
Make sure to have [WiX Toolset v3](https://docs.firegiant.com/wix/wix3/) installed. The command doesn't work with WiX Toolset v4 and later versions.
142
-
143
-
This PowerShell example assumes the default install location for WiX Toolset and that the PowerToys installer has been downloaded to the Windows desktop.
#### Fixes for uninstalling 0.51 and earlier builds issues
155
-
156
-
If you have an issue with the MSI being inaccessible, you can download the installer that corresponds with the installed version via the [PowerToys releases page](https://github.com/microsoft/PowerToys/releases) and run the following command. You'll need to change EXECUTABLE_INSTALLER_NAME to the actual file name.
157
-
158
-
In PowerShell, run `.\EXECUTABLE_INSTALLER_NAME.exe --extract_msi` and this will extract the MSI to your desktop.
159
-
160
-
#### Clean-up scripts
161
-
162
-
If there are problems while uninstalling a version, there are cleanup scripts available:
![learn-build-service-prod[bot]](https://avatars.githubusercontent.com/in/237442?v=4&size=40){kind=avatar}
0 commit comments