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
Copy file name to clipboardExpand all lines: hub/powertoys/file-locksmith.md
+27Lines changed: 27 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -25,4 +25,31 @@ When File Locksmith is opened, it will scan all of the running processes that it
25
25
26
26
After scanning, a list of processes will be displayed. Select **End task** to terminate the process, or select the expander to show more information. File Locksmith will automatically remove terminated processes from the list, whether or not this action was done via File Locksmith. To manually refresh the list of processes, select **Reload**.
27
27
28
+
## Command-line reference
29
+
30
+
The File Locksmith CLI lets you identify and manage processes that are locking files from the command line.
31
+
32
+
| Command | Description |
33
+
| :--- | :--- |
34
+
|`<path>`|**Required**. One or more file or directory paths to check. You can specify multiple paths separated by spaces. |
35
+
|`--kill`| Terminates (kills) all processes that are currently locking the specified files. |
36
+
|`--json`| Outputs the results in structured **JSON** format instead of human-readable text. Useful for automation and scripts. |
37
+
|`--wait`|**Blocks execution** and waits until the specified files are released. The command will not exit until the files are unlocked. |
38
+
|`--help`| Displays the help message with usage instructions. |
39
+
40
+
**Usage example**
41
+
```powershell
42
+
# Check which processes are locking a specific file:
43
+
FileLocksmithCLI.exe "C:\Users\Docs\report.docx"
44
+
45
+
# Check multiple files and get the output in JSON format for parsing:
Copy file name to clipboardExpand all lines: hub/powertoys/general.md
+2Lines changed: 2 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -55,6 +55,8 @@ If activated, PowerToys will start automatically when you log in to Windows.
55
55
56
56
When activated, PowerToys shows an icon in the system tray area of the taskbar. You can use this icon to open the PowerToys settings app or the PowerToys flyout.
57
57
58
+
In addition, you can control whether the Quick Access flyout is enabled, assign a hotkey, and choose a theme-aware monochrome system tray icon.
59
+
58
60
## Back up & restore
59
61
60
62
Set a location where you want to save your PowerToys settings. You can also restore your settings from an existing backup.
Copy file name to clipboardExpand all lines: hub/powertoys/index.md
+5-10Lines changed: 5 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,21 +11,16 @@ adobe-target: true
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#system-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**.
26
+
### Installation methods
31
27
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
31
@@ -44,21 +34,19 @@ To install PowerToys using a Windows executable file:
44
34
1. Select the `PowerToysSetup-0.##.#-x64.exe` or `PowerToysSetup-0.##.#-arm64.exe` file to download the PowerToys executable installer.
45
35
1. Once downloaded, open the executable file and follow the installation prompts.
46
36
47
-
##Install with Microsoft Store
37
+
#### [Microsoft Store](#tab/store)
48
38
49
39
You can install PowerToys from the [Microsoft Store's PowerToys page](https://aka.ms/getPowertoys).
50
40
51
-
##Install with Windows Package Manager
41
+
#### [WinGet](#tab/winget)
52
42
53
43
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/overview.md).
60
-
61
-
## Command-line installer arguments
49
+
PowerToys supports configuring through `winget configure` using [Desired State Configuration](dsc-configure.md).
62
50
63
51
The installer executable accepts the [Microsoft Standard Installer command-line options](/windows/win32/msi/standard-installer-command-line-options).
64
52
@@ -72,7 +60,7 @@ Here are some common commands you may want to use:
72
60
| /layout || create a local image of the bootstrapper |
73
61
| /log | /l | log to a specific file |
74
62
75
-
### Ask Copilot for help with command-line arguments
63
+
####Ask Copilot for help with command-line arguments
76
64
77
65
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
66
@@ -84,50 +72,11 @@ Generate a `winget` command to install Microsoft PowerToys with arguments to ins
84
72
85
73
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
74
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.
75
+
#### [Other methods](#tab/other)
128
76
129
-
### Install with Chocolatey
77
+
There are community driven install methods such as Chocolatey and Scoop to install PowerToys.
130
78
79
+
##### Chocolatey
131
80
To install [PowerToys](https://community.chocolatey.org/packages/powertoys) using [Chocolatey](https://chocolatey.org/), run the following command from your command line / PowerShell:
132
81
133
82
```powershell
@@ -142,7 +91,7 @@ choco upgrade powertoys
142
91
143
92
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
93
145
-
###Install with Scoop
94
+
#####Scoop
146
95
147
96
To install PowerToys using [Scoop](https://scoop.sh/), run the following command from the command line / PowerShell:
148
97
@@ -159,24 +108,67 @@ scoop update powertoys
159
108
160
109
If you have issues when installing/updating, file an issue in the [Scoop repo on GitHub](https://github.com/lukesampson/scoop/issues).
161
110
162
-
## After installation
111
+
---
112
+
113
+
### After installation
163
114
164
115
After successfully installing PowerToys, an overview window will display with introductory guidance for each of the available utilities.
165
116
166
117
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
118
168
119
:::image type="content" source="../images/powertoys-settings-home.png" alt-text="A screenshot of the Home page of the PowerToys settings.":::
169
120
170
-
## Updates
121
+
###Updates
171
122
172
123
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.
143
+
144
+
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
156
+
157
+
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.
158
+
159
+
In PowerShell, run `.\EXECUTABLE_INSTALLER_NAME.exe --extract_msi` and this will extract the MSI to your desktop.
160
+
161
+
#### Clean-up scripts
162
+
163
+
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