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 power user, I want to learn about PowerToys, a set of utilities, shell enhancements, and productivity tools for Windows.
9
+
# Customer intent: As a Windows 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
-
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.
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.
15
17
16
18
> [!div class="nextstepaction"]
17
19
> [Install PowerToys](install.md)
18
20
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#requirements).
22
-
23
-
### Processor architecture support
24
-
25
-
-**x64**: Supported
26
-
-**ARM64**: Supported
21
+
PowerToys is an open-source project, to learn more check out the [repository on GitHub](https://aka.ms/powertoys)
# 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 on Windows
12
+
# Install PowerToys
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
-
- 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)
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
29
25
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:
41
30
@@ -44,11 +33,11 @@ To install PowerToys using a Windows executable file:
44
33
1. Select the `PowerToysSetup-0.##.#-x64.exe` or `PowerToysSetup-0.##.#-arm64.exe` file to download the PowerToys executable installer.
45
34
1. Once downloaded, open the executable file and follow the installation prompts.
46
35
47
-
##Install with Microsoft Store
36
+
#### [Microsoft Store](#tab/store)
48
37
49
38
You can install PowerToys from the [Microsoft Store's PowerToys page](https://aka.ms/getPowertoys).
50
39
51
-
##Install with Windows Package Manager
40
+
#### [WinGet](#tab/winget)
52
41
53
42
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).
60
49
61
-
## Command-line installer arguments
62
-
63
50
The installer executable accepts the [Microsoft Standard Installer command-line options](/windows/win32/msi/standard-installer-command-line-options).
64
51
65
52
Here are some common commands you may want to use:
@@ -72,7 +59,7 @@ Here are some common commands you may want to use:
72
59
| /layout || create a local image of the bootstrapper |
73
60
| /log | /l | log to a specific file |
74
61
75
-
### Ask Copilot for help with command-line arguments
62
+
####Ask Copilot for help with command-line arguments
76
63
77
64
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.
78
65
@@ -84,50 +71,11 @@ Generate a `winget` command to install Microsoft PowerToys with arguments to ins
84
71
85
72
Copilot is powered by AI, so surprises and mistakes are possible. For more information, see [Copilot FAQs](https://www.microsoft.com/microsoft-copilot/learn/).
86
73
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:
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
76
+
There are community driven install methods such as Chocolatey and Scoop to install PowerToys.
130
77
78
+
##### Chocolatey
131
79
To install [PowerToys](https://community.chocolatey.org/packages/powertoys) using [Chocolatey](https://chocolatey.org/), run the following command from your command line / PowerShell:
132
80
133
81
```powershell
@@ -142,7 +90,7 @@ choco upgrade powertoys
142
90
143
91
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).
144
92
145
-
###Install with Scoop
93
+
#####Scoop
146
94
147
95
To install PowerToys using [Scoop](https://scoop.sh/), run the following command from the command line / PowerShell:
148
96
@@ -159,21 +107,64 @@ scoop update powertoys
159
107
160
108
If you have issues when installing/updating, file an issue in the [Scoop repo on GitHub](https://github.com/lukesampson/scoop/issues).
161
109
162
-
## After installation
110
+
---
111
+
112
+
### After installation
163
113
164
114
After successfully installing PowerToys, an overview window will display with introductory guidance for each of the available utilities.
165
115
166
116
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.
167
117
168
118
:::image type="content" source="../images/powertoys-settings-home.png" alt-text="A screenshot of the Home page of the PowerToys settings.":::
169
119
170
-
## Updates
120
+
###Updates
171
121
172
122
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