diff --git a/hub/powertoys/administrator.md b/hub/powertoys/administrator.md
index b58c156297..741daa08c3 100644
--- a/hub/powertoys/administrator.md
+++ b/hub/powertoys/administrator.md
@@ -59,8 +59,8 @@ The simplest way to run an app or program in administrative mode is to right-cli
If you see this User Account Control prompt, the application is requesting administrator level elevated permission:
-
+
In the case of an elevated command line, typically the text "Administrator" will be included in the title bar.
-
+
diff --git a/hub/powertoys/always-on-top.md b/hub/powertoys/always-on-top.md
index 46af3278de..e0b6324973 100644
--- a/hub/powertoys/always-on-top.md
+++ b/hub/powertoys/always-on-top.md
@@ -10,7 +10,7 @@ no-loc: [PowerToys, Windows, Always On Top, Win]
A system-wide Windows utility to pin windows above other windows.
-
+
## Pin a window
diff --git a/hub/powertoys/awake.md b/hub/powertoys/awake.md
index 3f48b05dc3..5cc90fb413 100644
--- a/hub/powertoys/awake.md
+++ b/hub/powertoys/awake.md
@@ -21,7 +21,7 @@ You can use PowerToys Awake directly from PowerToys Settings or as a standalone
In the PowerToys Settings, start PowerToys Awake by toggling **Enable Awake** on. Once enabled, the application will manage the awakeness state of the computer.
-
+
You can choose the following Awake states:
@@ -45,7 +45,7 @@ This feature only works if Awake is running in one of the three **Keep awake** s
To manage the execution of the tool from the system tray, right-click on the PowerToys Awake icon.
-
+
## Command Line Interface (CLI)
diff --git a/hub/powertoys/cmd-not-found.md b/hub/powertoys/cmd-not-found.md
index 968f7ca2f9..24f6dfc1ee 100644
--- a/hub/powertoys/cmd-not-found.md
+++ b/hub/powertoys/cmd-not-found.md
@@ -11,9 +11,9 @@ no-loc: [PowerToys, Windows, Command Not Found, Win]
A PowerShell 7 module that detects command-line errors and suggests a relevant WinGet package to install, if available.
> [!IMPORTANT]
-> There are some incompatibilities between Command Not Found and some PowerShell configurations. You can read more about them in [issue 30818](https://github.com/microsoft/PowerToys/issues/30818) on GitHub.
+> There are some incompatibilities between Command Not Found and some PowerShell configurations. Read more about them in [issue 30818](https://github.com/microsoft/PowerToys/issues/30818) on GitHub.
-
+
## Requirements
@@ -27,7 +27,7 @@ To install the Command Not Found module, navigate to the Command Not Found page
- PSFeedbackProvider
- PSCommandNotFoundSuggestion
-After that, PowerShell profile file will be appended with following block of PowerShell commands:
+After that, the PowerShell profile file will be appended with following block of PowerShell commands:
```psh
#34de4b3d-13a8-4540-b76d-b9e8d3851756 PowerToys CommandNotFound module
diff --git a/hub/powertoys/color-picker.md b/hub/powertoys/color-picker.md
index 05a5e978a4..93f580186c 100644
--- a/hub/powertoys/color-picker.md
+++ b/hub/powertoys/color-picker.md
@@ -11,7 +11,7 @@ no-loc: [PowerToys, Windows, Color Picker, Color, Picker]
A system-wide color picking utility for Windows to pick colors from any screen and copy it in a configurable format to the clipboard.
-
+
## Getting started
@@ -21,7 +21,7 @@ Enable Color Picker in the **Color Picker** tab in PowerToys Settings.
### Activating Color Picker
-You can choose what happens when you activate Color Picker (default: Win+Shift+C) by changing **Activation Behavior**:
+Choose what happens when you activate Color Picker (default: Win+Shift+C) by changing **Activation Behavior**:
:::image type="content" source="../images/pt-colorpicker-activation.gif" alt-text="Color Picker behaviors.":::
@@ -35,7 +35,7 @@ After activating Color Picker, select a color on your screen to pick that color.
Color Picker copies the selected color to the clipboard in the **Default color format** you've chosen in Color Picker's settings (default: HEX).
-
+
> [!TIP]
> To select the color of the non-hover state of a element:
@@ -46,7 +46,7 @@ Color Picker copies the selected color to the clipboard in the **Default color f
## Using the Color Picker editor
-The Color Picker editor stores a history of up to 20 picked colors and lets you copy them to the clipboard. You can choose which color formats are visible in the editor in **Color formats** in PowerToys Settings.
+The Color Picker editor stores a history of up to 20 picked colors and lets you copy them to the clipboard. Choose which color formats are visible in the editor in **Color formats** in PowerToys Settings.
The colored bar at the top of the Color Picker editor lets you:
@@ -57,7 +57,7 @@ To fine tune your chosen color, select the central color in the color bar. The f
To choose a similar color, select one of the segments on the left and right edges of the color bar. The Color Picker editor suggests two lighter shades on the left of the bar, and two darker shades on the right of the bar. Selecting one of these similar colors adds that color to the colors history.
-
+
To remove a color from the colors history, right-click a color and select **Remove**.
@@ -75,7 +75,7 @@ Color Picker has the following settings:
| **Show color name** | When turned on, this setting shows a high-level representation of the color. For example, 'Light Green', 'Green', or 'Dark Green'. |
| **Color formats** | This section lets you enable and add different color formats, and change the order of color formats in the Color Picker editor. Read more about **Color formats** in [Managing color formats](#managing-color-formats).
-
+
### Managing color formats
@@ -87,9 +87,9 @@ To disable a color format, turn off the toggle next to that color format. Color
To delete a color format, select **•••** next to a color format and select **Delete**.
-To add a new color format, select **Add custom color format**. You can choose the color format's **Name** and **Format**. Select **Save** to add the color format. The syntax for color formats is described in the **Add custom color format** dialog.
+To add a new color format, select **Add custom color format**. Choose the color format's **Name** and **Format**. Select **Save** to add the color format. The syntax for color formats is described in the **Add custom color format** dialog.
-To edit a color format, select it from the list. You can edit the color format's **Name** and **Format** in the **Edit custom color format** dialog. Select **Update** to save your changes. The syntax for color formats is described in the **Edit custom color format** dialog.
+To edit a color format, select it from the list. Edit the color format's **Name** and **Format** in the **Edit custom color format** dialog. Select **Update** to save your changes. The syntax for color formats is described in the **Edit custom color format** dialog.
Define color formats with these parameters:
diff --git a/hub/powertoys/crop-and-lock.md b/hub/powertoys/crop-and-lock.md
index 5d7859242b..1381938cec 100644
--- a/hub/powertoys/crop-and-lock.md
+++ b/hub/powertoys/crop-and-lock.md
@@ -11,7 +11,7 @@ no-loc: [PowerToys, Windows, Crop And Lock, Win]
PowerToys **Crop And Lock** allows you to crop a current application into a smaller window or just create a thumbnail. Focus the target window and press the shortcut to start cropping.
-
+
## Getting started
@@ -19,14 +19,14 @@ PowerToys **Crop And Lock** allows you to crop a current application into a smal
To start using Crop And Lock, enable it in the PowerToys Settings (**Crop And Lock** tab).
-Once enabled, you can focus a Window and press the "Thumbnail" shortcut (default: ⊞ Win+Ctrl+Shift+T) or the "Reparent" shortcut (default: ⊞ Win+Ctrl+Shift+R) to select an area of the window to crop.
+Once enabled, focus a Window and press the "Thumbnail" shortcut (default: ⊞ Win+Ctrl+Shift+T) or the "Reparent" shortcut (default: ⊞ Win+Ctrl+Shift+R) to select an area of the window to crop.
> [!TIP]
-> You can use the Esc key to cancel the crop selection.
+> Use Esc to cancel the crop selection.
After you've selected the area of the window, a new window will appear and behave according to the selected crop mode.
-Use the **X** button on the top right corner of the cropped window to close it and restore the original window.
+Select the **Close** button of the cropped window to close it and restore the original window.
## Crop modes
@@ -42,4 +42,4 @@ Creates a window that replaces the original window, showing only the selected ar
- Cropping maximized or full-screen windows in "Reparent" mode might not work. It's recommended to resize the window to fill the screen corners instead.
- Some UWP apps won't react well to being cropped in "Reparent" mode. The Windows Calculator is a notable example of this.
-- Applications that use sub-windows or tabs can also react poorly to being cropped in "Reparent" mode. Notepad and OneNote are notable examples of applications that react poorly.
+- Applications that use sub-windows or tabs can react poorly to being cropped in "Reparent" mode. Notepad and OneNote are notable examples of applications that react poorly.
diff --git a/hub/powertoys/dsc-configure.md b/hub/powertoys/dsc-configure.md
index 1a0f373538..b80278804b 100644
--- a/hub/powertoys/dsc-configure.md
+++ b/hub/powertoys/dsc-configure.md
@@ -1,12 +1,12 @@
---
title: PowerToys DSC Configure module
-description: DSC configure module documentation for PowerToys
+description: Desired State Configuration module documentation for PowerToys
ms.date: 04/03/2024
ms.topic: article
no-loc: [PowerToys, Windows, DSC, Win]
---
-# DSC configuration
+# Desired State Configuration
Since version 0.80, the PowerToys installer has been released on GitHub with `Microsoft.PowerToys.Configure` [DSC resource](/powershell/dsc/overview) that allows you to configure PowerToys using a [Winget configuration file](/windows/package-manager/configuration/create).
@@ -14,26 +14,26 @@ Since version 0.80, the PowerToys installer has been released on GitHub with `Mi
### Prerequisites
-- `PSDesiredStateConfiguration` 2.0.7 or higher: Refer to the [PowerShell DSC documentation](/powershell/dsc/overview) for installation instructions.
+- PSDesiredStateConfiguration 2.0.7 or later: Refer to the [PowerShell DSC documentation](/powershell/dsc/overview) for installation instructions.
- PowerShell 7.2 or higher.
- WinGet [version v1.6.2631 or later](https://github.com/microsoft/winget-cli/releases).
### Download
-`Microsoft.PowerToys.Configure` is [installed alongside PowerToys](install.md). Depending on the installer type, it's installed as follows:
+Microsoft.PowerToys.Configure is [installed with PowerToys](install.md). Depending on the installer type, it's installed as follows:
- For the per-user install scope, the module is located in `%USERPROFILE%\Documents\PowerShell\Modules\Microsoft.PowerToys.Configure`.
- For the machine-wide install scope, it's found in `%ProgramFiles%\WindowsPowerShell\Modules\Microsoft.PowerToys.Configure`.
## Usage
-You can invoke the resource directly using the following syntax:
+You can invoke the resource directly using the following Powershell syntax:
```ps
Invoke-DscResource -Name PowerToysConfigure -Method Set -ModuleName Microsoft.PowerToys.Configure -Property @{ Awake = @{ Enabled = $false; Mode = "TIMED"; IntervalMinutes = "10" } }
```
-However, creating a configuration.dsc.yaml file that contains the required settings in a simpler format is more convenient. Here's an example:
+However, creating a _configuration.dsc.yaml_ file that contains the required settings in a simpler format is more convenient. Here's an example:
```yaml
properties:
@@ -67,7 +67,7 @@ Use the following command to apply the configuration from the file:
winget configure .\configuration.dsc.yaml
```
-This command installs the latest version of PowerToys and uses the PowerToysConfigure resource to apply settings for multiple PowerToys modules. More examples can be found [here](https://github.com/microsoft/PowerToys/tree/main/src/dsc/Microsoft.PowerToys.Configure/examples).
+This command installs the latest version of PowerToys and uses the PowerToysConfigure resource to apply settings for multiple PowerToys modules. More examples can be found [in the PowerToys repo](https://github.com/microsoft/PowerToys/tree/main/src/dsc/Microsoft.PowerToys.Configure/examples).
## Available Configuration Settings by Module
@@ -75,34 +75,34 @@ This command installs the latest version of PowerToys and uses the PowerToysConf
| Name | Type | Description | Available |
| :--- | :--- | :--- | :--- |
-| Enabled | Bool | The enabled state for this utility. | ✅ |
+| Enabled | Boolean | The enabled state for this utility. | ✅ |
| Hotkey | KeyboardKeys | Customize the shortcut to pin or unpin an app window. | ✅ |
-| FrameEnabled | Bool | Show a border around the pinned window. | ✅ |
+| FrameEnabled | Boolean | Show a border around the pinned window. | ✅ |
| FrameThickness | Int | Border thickness in pixels. | ✅ |
| FrameColor | String | Specify a color in a `#FFFFFFFF` format. | ✅ |
| FrameOpacity | Int | Border opacity in percentage. | ✅ |
-| FrameAccentColor | Bool | Whether to use a custom FrameColor value. | ✅ |
-| SoundEnabled | Bool | Play a sound when pinning a window. | ✅ |
-| DoNotActivateOnGameMode | Bool | Disable activation shortcut when Game Mode is on. | ✅ |
+| FrameAccentColor | Boolean | Use a custom FrameColor value. | ✅ |
+| SoundEnabled | Boolean | Play a sound when pinning a window. | ✅ |
+| DoNotActivateOnGameMode | Boolean | Disable activation shortcut when Game Mode is on. | ✅ |
| ExcludedApps | String | '\r'-separated list of executable names to exclude from pinning on top. | ✅ |
-| RoundCornersEnabled | Bool | Enable round corners. | ✅ |
+| RoundCornersEnabled | Boolean | Enable round corners. | ✅ |
### Awake
| Name | Type | Description | Available |
| :--- | :--- | :--- | :--- |
-| Enabled | Bool | The enabled state for this utility. | ✅ |
+| Enabled | Boolean | The enabled state for this utility. | ✅ |
| KeepDisplayOn | Boolean | This setting is only available when keeping the PC awake. | ✅ |
| Mode | AwakeMode | Possible values: PASSIVE, INDEFINITE, TIMED, EXPIRABLE. | ✅ |
-| IntervalHours | UInt32 | When using TIMED Mode, specifies the number of hours. | ✅ |
-| IntervalMinutes | UInt32 | When using TIMED Mode, specifies the number of minutes. | ✅ |
-| ExpirationDateTime | DateTimeOffset | When using EXPIRABLE Mode, specifies the date and time in a format parsable with `DateTimeOffset.TryParse`. | ✅ |
+| IntervalHours | UInt32 | When using TIMED mode, specifies the number of hours. | ✅ |
+| IntervalMinutes | UInt32 | When using TIMED mode, specifies the number of minutes. | ✅ |
+| ExpirationDateTime | DateTimeOffset | When using EXPIRABLE mode, specifies the date and time in a format parsable with `DateTimeOffset.TryParse`. | ✅ |
### ColorPicker
| Name | Type | Description | Available |
| :--- | :--- | :--- | :--- |
-| Enabled | Bool | The enabled state for this utility. | ✅ |
+| Enabled | Boolean | The enabled state for this utility. | ✅ |
| ActivationShortcut | HotkeySettings | Customize the shortcut to activate this module. | ✅ |
| CopiedColorRepresentation | String | The default color representation to be used. Example :"HEX". | ✅ |
| ActivationAction | ColorPickerActivationAction | Possible values: OpenEditor, OpenColorPickerAndThenEditor, OpenOnlyColorPicker. | ✅ |
@@ -116,7 +116,7 @@ This command installs the latest version of PowerToys and uses the PowerToysConf
| Name | Type | Description | Available |
| :--- | :--- | :--- | :--- |
-| Enabled | Bool | The enabled state for this utility. | ✅ |
+| Enabled | Boolean | The enabled state for this utility. | ✅ |
| ReparentHotkey | KeyboardKeys | Shortcut to crop an application's window into a cropped window. | ✅ |
| ThumbnailHotkey | KeyboardKeys | Shortcut to crop and create a thumbnail of another window. | ✅ |
@@ -124,46 +124,46 @@ This command installs the latest version of PowerToys and uses the PowerToysConf
| Name | Type | Description | Available |
| :--- | :--- | :--- | :--- |
-| Enabled | Bool | The enabled state for this utility. | ✅ |
+| Enabled | Boolean | The enabled state for this utility. | ✅ |
| LaunchAdministrator | Boolean | Needs to be launched as administrator in order to make changes to the system environment variables. | ✅ |
### FancyZones
| Name | Type | Description | Available |
| :--- | :--- | :--- | :--- |
-| Enabled | Bool | The enabled state for this utility. | ✅ |
-| FancyzonesShiftDrag | Bool | Hold Shift key to activate zones while dragging a window. | ✅ |
-| FancyzonesMouseSwitch | Bool | Use a non-primary mouse button to toggle zone activation. | ✅ |
-| FancyzonesMouseMiddleClickSpanningMultipleZones | Bool | Use middle-click mouse button to toggle multiple zones spanning. | ✅ |
-| FancyzonesOverrideSnapHotkeys | Bool | This overrides the Windows Snap shortcut (Win + arrow) to move windows between zones. | ✅ |
-| FancyzonesMoveWindowsAcrossMonitors | Bool | Move windows between zones across all monitors. | ✅ |
-| FancyzonesMoveWindowsBasedOnPosition | Bool | Move windows based on relative position or zone index. | ✅ |
+| Enabled | Boolean | The enabled state for this utility. | ✅ |
+| FancyzonesShiftDrag | Boolean | Hold Shift key to activate zones while dragging a window. | ✅ |
+| FancyzonesMouseSwitch | Boolean | Use a non-primary mouse button to toggle zone activation. | ✅ |
+| FancyzonesMouseMiddleClickSpanningMultipleZones | Boolean | Use middle-click mouse button to toggle multiple zones spanning. | ✅ |
+| FancyzonesOverrideSnapHotkeys | Boolean | This overrides the Windows Snap shortcut (Win + arrow) to move windows between zones. | ✅ |
+| FancyzonesMoveWindowsAcrossMonitors | Boolean | Move windows between zones across all monitors. | ✅ |
+| FancyzonesMoveWindowsBasedOnPosition | Boolean | Move windows based on relative position or zone index. | ✅ |
| FancyzonesOverlappingZonesAlgorithm | Int | When multiple zones overlap algorithm index. | ✅ |
-| FancyzonesDisplayOrWorkAreaChangeMoveWindows | Bool | Keep windows in their zones when the screen resolution or work area changes. | ✅ |
-| FancyzonesZoneSetChangeMoveWindows | Bool | During zone layout changes, windows assigned to a zone will match new size/positions. | ✅ |
-| FancyzonesAppLastZoneMoveWindows | Bool | Move newly created windows to their last known zone. | ✅ |
-| FancyzonesOpenWindowOnActiveMonitor | Bool | Move newly created windows to the curreynt active monitor (Experimental). | ✅ |
-| FancyzonesRestoreSize | Bool | Restore the original size of windows when unsnapping. | ✅ |
-| FancyzonesQuickLayoutSwitch | Bool | Enable quick layout switch. | ✅ |
-| FancyzonesFlashZonesOnQuickSwitch | Bool | Flash zones when switching layout. | ✅ |
-| UseCursorposEditorStartupscreen | Bool | Whether to launch editor on the display where the mouse point is. | ✅ |
-| FancyzonesShowOnAllMonitors | Bool | Show zones on all monitors while dragging a window. | ✅ |
-| FancyzonesSpanZonesAcrossMonitors | Bool | Allow zones to span across monitors. | ✅ |
-| FancyzonesMakeDraggedWindowTransparent | Bool | Make dragged window transparent. | ✅ |
-| FancyzonesAllowChildWindowSnap | Bool | Allow child windows snapping. | ✅ |
-| FancyzonesDisableRoundCornersOnSnap | Bool | Disable round corners when window is snapped. | ✅ |
+| FancyzonesDisplayOrWorkAreaChangeMoveWindows | Boolean | Keep windows in their zones when the screen resolution or work area changes. | ✅ |
+| FancyzonesZoneSetChangeMoveWindows | Boolean | During zone layout changes, windows assigned to a zone will match new size/positions. | ✅ |
+| FancyzonesAppLastZoneMoveWindows | Boolean | Move newly created windows to their last known zone. | ✅ |
+| FancyzonesOpenWindowOnActiveMonitor | Boolean | Move newly created windows to the curreynt active monitor (Experimental). | ✅ |
+| FancyzonesRestoreSize | Boolean | Restore the original size of windows when unsnapping. | ✅ |
+| FancyzonesQuickLayoutSwitch | Boolean | Enable quick layout switch. | ✅ |
+| FancyzonesFlashZonesOnQuickSwitch | Boolean | Flash zones when switching layout. | ✅ |
+| UseCursorposEditorStartupscreen | Boolean | Open editor on the display where the mouse point is. | ✅ |
+| FancyzonesShowOnAllMonitors | Boolean | Show zones on all monitors while dragging a window. | ✅ |
+| FancyzonesSpanZonesAcrossMonitors | Boolean | Allow zones to span across monitors. | ✅ |
+| FancyzonesMakeDraggedWindowTransparent | Boolean | Make dragged window transparent. | ✅ |
+| FancyzonesAllowChildWindowSnap | Boolean | Allow child windows snapping. | ✅ |
+| FancyzonesDisableRoundCornersOnSnap | Boolean | Disable round corners when window is snapped. | ✅ |
| FancyzonesZoneHighlightColor | String | If not using FancyzonesSystemTheme, highlight color to use in `#FFFFFFFF` format. | ✅ |
| FancyzonesHighlightOpacity | Int | Zone opacity in percentage. | ✅ |
| FancyzonesEditorHotkey | KeyboardKeys | Customize the shortcut to activate this module. | ✅ |
-| FancyzonesWindowSwitching | Bool | Switch between windows in the current zone. | ✅ |
+| FancyzonesWindowSwitching | Boolean | Switch between windows in the current zone. | ✅ |
| FancyzonesNextTabHotkey | KeyboardKeys | Next window shortcut. | ✅ |
| FancyzonesPrevTabHotkey | KeyboardKeys | Previous window shortcut. | ✅ |
| FancyzonesExcludedApps | String | '\r'-separated list of executable names to exclude from snapping. | ✅ |
| FancyzonesBorderColor | String | If not using FancyzonesSystemTheme, border color to use in `#FFFFFFFF` format. | ✅ |
| FancyzonesInActiveColor | String | If not using FancyzonesSystemTheme, inactive color to use in `#FFFFFFFF` format. | ✅ |
| FancyzonesNumberColor | String | If not using FancyzonesSystemTheme, number color to use in `#FFFFFFFF` format. | ✅ |
-| FancyzonesSystemTheme | Bool | Whether to use system theme for zone appearance. | ✅ |
-| FancyzonesShowZoneNumber | Bool | Whether to show zone number. | ✅ |
+| FancyzonesSystemTheme | Boolean | Use system theme for zone appearance. | ✅ |
+| FancyzonesShowZoneNumber | Boolean | Show zone number. | ✅ |
> [!NOTE]
> Configuring layouts through DSC is not yet supported.
@@ -172,17 +172,17 @@ This command installs the latest version of PowerToys and uses the PowerToysConf
| Name | Type | Description | Available |
| :--- | :--- | :--- | :--- |
-| Enabled | Bool | The enabled state for this utility. | ✅ |
-| ExtendedContextMenuOnly | Bool | Show File Locksmith in extended context menu only or in default context menu as well. | ✅ |
+| Enabled | Boolean | The enabled state for this utility. | ✅ |
+| ExtendedContextMenuOnly | Boolean | Show File Locksmith in extended context menu only or in default context menu as well. | ✅ |
### FindMyMouse
| Name | Type | Description | Available |
| :--- | :--- | :--- | :--- |
-| Enabled | Bool | The enabled state for this utility. | ✅ |
+| Enabled | Boolean | The enabled state for this utility. | ✅ |
| ActivationMethod | Int | Activation method index. | ✅ |
| ActivationShortcut | HotkeySettings | Custom activation shortcut when using Custom for ActivationMethod. | ✅ |
-| DoNotActivateOnGameMode | Bool | Disable activation shortcut when Game Mode is on. | ✅ |
+| DoNotActivateOnGameMode | Boolean | Disable activation shortcut when Game Mode is on. | ✅ |
| BackgroundColor | String | Background color in `#FFFFFFFF` format. | ✅ |
| SpotlightColor | String | Spotlight color in `#FFFFFFFF` format. | ✅ |
| OverlayOpacity | Int | Overlay opacity in percentage. | ✅ |
@@ -198,8 +198,8 @@ This command installs the latest version of PowerToys and uses the PowerToysConf
| Name | Type | Description | Available |
| :--- | :--- | :--- | :--- |
-| Enabled | Bool | The enabled state for this utility. | ✅ |
-| LaunchAdministrator | Boolean | Needs to be launched as administrator in order to make changes to the system environment variables. | ✅ |
+| Enabled | Boolean | The enabled state for this utility. | ✅ |
+| LaunchAdministrator | Boolean | Needs to be opened as administrator in order to make changes to the system environment variables. | ✅ |
| ShowStartupWarning | Boolean | Show a warning at startup. | ✅ |
| LoopbackDuplicates | Boolean | Consider loopback addresses as duplicates. | ✅ |
| AdditionalLinesPosition | HostsAdditionalLinesPosition | Possible values: Top, Bottom. | ✅ |
@@ -209,33 +209,33 @@ This command installs the latest version of PowerToys and uses the PowerToysConf
| Name | Type | Description | Available |
| :--- | :--- | :--- | :--- |
-| Enabled | Bool | The enabled state for this utility. | ✅ |
+| Enabled | Boolean | The enabled state for this utility. | ✅ |
| ImageresizerSelectedSizeIndex | Int | Default size preset index. | ✅ |
-| ImageresizerShrinkOnly | Bool | Make pictures smaller but not larger. | ✅ |
-| ImageresizerReplace | Bool | Overwrite files. | ✅ |
-| ImageresizerIgnoreOrientation | Bool | Ignore the orientation of pictures. | ✅ |
+| ImageresizerShrinkOnly | Boolean | Make pictures smaller but not larger. | ✅ |
+| ImageresizerReplace | Boolean | Overwrite files. | ✅ |
+| ImageresizerIgnoreOrientation | Boolean | Ignore the orientation of pictures. | ✅ |
| ImageresizerJpegQualityLevel | Int | JPEG quality level in percentage. | ✅ |
| ImageresizerPngInterlaceOption | Int | PNG interlacing option index. | ✅ |
| ImageresizerTiffCompressOption | Int | Tiff compression index. | ✅ |
| ImageresizerFileName | String | This format is used as the filename for resized images. | ✅ |
| ImageresizerSizes | — | — | ❌ |
-| ImageresizerKeepDateModified | Bool | Remove metadata that doesn't affect rendering. | ✅ |
+| ImageresizerKeepDateModified | Boolean | Remove metadata that doesn't affect rendering. | ✅ |
| ImageresizerFallbackEncoder | String | Fallback encoder to use. | ✅ |
| ImageresizerCustomSize | — | — | ❌ |
> [!NOTE]
-> Configuring custom sizes through DSC is not supported yet.
+> Configuring custom sizes through DSC is not yet supported.
### KeyboardManager
| Name | Type | Description | Available |
| :--- | :--- | :--- | :--- |
-| Enabled | Bool | The enabled state for this utility. | ✅ |
+| Enabled | Boolean | The enabled state for this utility. | ✅ |
| ActiveConfiguration | — | — | ❌ |
| KeyboardConfigurations | — | — | ❌ |
> [!NOTE]
-> Configuring remappings through DSC is not supported yet.
+> Configuring remappings through DSC is not yet supported.
### MeasureTool
@@ -243,7 +243,7 @@ Measure Tool is the internal name for Screen Ruler.
| Name | Type | Description | Available |
| :--- | :--- | :--- | :--- |
-| Enabled | Bool | The enabled state for this utility. | ✅ |
+| Enabled | Boolean | The enabled state for this utility. | ✅ |
| ActivationShortcut | HotkeySettings | Customize the shortcut to bring up the command bar. | ✅ |
| ContinuousCapture | Boolean | Capture screen continuously during measuring. | ✅ |
| DrawFeetOnCross | Boolean | Adds feet to the end of cross lines. | ✅ |
@@ -256,7 +256,7 @@ Measure Tool is the internal name for Screen Ruler.
| Name | Type | Description | Available |
| :--- | :--- | :--- | :--- |
-| Enabled | Bool | The enabled state for this utility. | ✅ |
+| Enabled | Boolean | The enabled state for this utility. | ✅ |
| ActivationShortcut | HotkeySettings | Customize the shortcut to turn on or off this mode. | ✅ |
| LeftButtonClickColor | String | Primary button highlight color in `#FFFFFFFF` format. | ✅ |
| RightButtonClickColor | String | Secondary button highlight color in `#FFFFFFFF` format. | ✅ |
@@ -264,13 +264,13 @@ Measure Tool is the internal name for Screen Ruler.
| HighlightRadius | Int | Highlight radius in pixels. | ✅ |
| HighlightFadeDelayMs | Int | Fade delay in milliseconds. | ✅ |
| HighlightFadeDurationMs | Int | Fade duration in milliseconds. | ✅ |
-| AutoActivate | Bool | Automatically activate on utility startup. | ✅ |
+| AutoActivate | Boolean | Automatically activate on utility startup. | ✅ |
### MouseJump
| Name | Type | Description | Available |
| :--- | :--- | :--- | :--- |
-| Enabled | Bool | The enabled state for this utility. | ✅ |
+| Enabled | Boolean | The enabled state for this utility. | ✅ |
| ActivationShortcut | HotkeySettings | Customize the shortcut to turn on or off this mode. | ✅ |
| ThumbnailSize | MouseJumpThumbnailSize | Thumbnail size. | ✅ |
@@ -278,7 +278,7 @@ Measure Tool is the internal name for Screen Ruler.
| Name | Type | Description | Available |
| :--- | :--- | :--- | :--- |
-| Enabled | Bool | The enabled state for this utility. | ✅ |
+| Enabled | Boolean | The enabled state for this utility. | ✅ |
| ActivationShortcut | HotkeySettings | Customize the shortcut to show/hide the crosshairs. | ✅ |
| CrosshairsColor | String | Crosshairs color in `#FFFFFFFF`. | ✅ |
| CrosshairsOpacity | Int | Crosshairs opacity in percentage. | ✅ |
@@ -286,16 +286,16 @@ Measure Tool is the internal name for Screen Ruler.
| CrosshairsThickness | Int | Crosshairs thickness in pixels. | ✅ |
| CrosshairsBorderColor | String | Crosshairs border color in `#FFFFFFFF` format. | ✅ |
| CrosshairsBorderSize | Int | Crosshairs border size in pixels. | ✅ |
-| CrosshairsAutoHide | Bool | Automatically hide crosshairs when the mouse pointer is hidden. | ✅ |
-| CrosshairsIsFixedLengthEnabled | Bool | Fix crosshairs length. | ✅ |
+| CrosshairsAutoHide | Boolean | Automatically hide crosshairs when the mouse pointer is hidden. | ✅ |
+| CrosshairsIsFixedLengthEnabled | Boolean | Fix crosshairs length. | ✅ |
| CrosshairsFixedLength | Int | Crosshairs fixed length in pixels. | ✅ |
-| AutoActivate | Bool | Automatically activate on utility startup. | ✅ |
+| AutoActivate | Boolean | Automatically activate on utility startup. | ✅ |
### MouseWithoutBorders
| Name | Type | Description | Available |
| :--- | :--- | :--- | :--- |
-| Enabled | Bool | The enabled state for this utility. | ✅ |
+| Enabled | Boolean | The enabled state for this utility. | ✅ |
| ShowOriginalUI | Boolean | Show the original Mouse Without Borders UI. | ✅ |
| WrapMouse | Boolean | Move control back to the first machine when mouse moves past the last one. | ✅ |
| ShareClipboard | Boolean | If share clipboard stops working, Ctrl+Alt+Del then Esc may solve the problem. | ✅ |
@@ -320,17 +320,17 @@ Measure Tool is the internal name for Screen Ruler.
| Name | Type | Description | Available |
| :--- | :--- | :--- | :--- |
-| Enabled | Bool | The enabled state for this utility. | ✅ |
+| Enabled | Boolean | The enabled state for this utility. | ✅ |
| ActivationShortcut | HotkeySettings | Customize the shortcut to activate this module. | ✅ |
### Peek
| Name | Type | Description | Available |
| :--- | :--- | :--- | :--- |
-| Enabled | Bool | The enabled state for this utility. | ✅ |
+| Enabled | Boolean | The enabled state for this utility. | ✅ |
| ActivationShortcut | HotkeySettings | Customize the shortcut to activate this module. | ✅ |
-| AlwaysRunNotElevated | Bool | Always run not elevated, even when PowerToys is elevated. | ✅ |
-| CloseAfterLosingFocus | Bool | Automatically close the Peek window after it loses focus. | ✅ |
+| AlwaysRunNotElevated | Boolean | Always run not elevated, even when PowerToys is elevated. | ✅ |
+| CloseAfterLosingFocus | Boolean | Automatically close the Peek window after it loses focus. | ✅ |
### PowerAccent
@@ -338,7 +338,7 @@ PowerAccent is the internal name for Quick Accent.
| Name | Type | Description | Available |
| :--- | :--- | :--- | :--- |
-| Enabled | Bool | The enabled state for this utility. | ✅ |
+| Enabled | Boolean | The enabled state for this utility. | ✅ |
| ActivationKey | PowerAccentActivationKey | Possible values: LeftRightArrow, Space, Both. | ✅ |
| DoNotActivateOnGameMode | Boolean | Disable activation shortcut when Game Mode is on. | ✅ |
| ToolbarPosition | String | Toolbar position index. | ✅ |
@@ -355,10 +355,10 @@ PowerLaucher is the internal name for PowerToys Run.
| Name | Type | Description | Available |
| :--- | :--- | :--- | :--- |
-| Enabled | Bool | The enabled state for this utility. | ✅ |
+| Enabled | Boolean | The enabled state for this utility. | ✅ |
| OpenPowerLauncher | HotkeySettings | Customize the shortcut to activate the module. | ✅ |
| IgnoreHotkeysInFullscreen | Boolean | Ignore shortcuts in fullscreen mode. | ✅ |
-| ClearInputOnLaunch | Boolean | Clear the previous query on launch. | ✅ |
+| ClearInputOnLaunch | Boolean | Clear the previous query on open. | ✅ |
| TabSelectsContextButtons | Boolean | Tab through context buttons. | ✅ |
| Theme | Theme | Possible values: System, Light, Dark, HighContrastOne, HighContrastTwo, HighContrastBlack, HighContrastWhite. | ✅ |
| TitleFontSize | Int32 | Text size in points. | ✅ |
@@ -372,25 +372,25 @@ PowerLaucher is the internal name for PowerToys Run.
| SearchWaitForSlowResults | Boolean | Wait for slower plugin results before selecting top item in results. | ✅ |
| MaximumNumberOfResults | Int | Number of results shown before having to scroll. | ✅ |
| UsePinyin | Boolean | Use Pinyin. | ✅ |
-| GenerateThumbnailsFromFiles | Boolean | Whether thumbnail generation for files is turned on. | ✅ |
-| Plugins | explained in the next subsection | Whether thumbnail generation for files is turned on. | ✅ |
+| GenerateThumbnailsFromFiles | Boolean | Thumbnail generation for files is turned on. | ✅ |
+| Plugins | explained in the next subsection | Thumbnail generation for files is turned on. | ✅ |
#### PowerToys Run plugins
-PowerToys Run plugins can be configured in the Plugins property. [A sample can be found in the PowerToys repository.](https://github.com/microsoft/PowerToys/blob/main/src/dsc/Microsoft.PowerToys.Configure/examples/configureLauncherPlugins.dsc.yaml)
+PowerToys Run plugins can be configured in the Plugins property. [A sample](https://github.com/microsoft/PowerToys/blob/main/src/dsc/Microsoft.PowerToys.Configure/examples/configureLauncherPlugins.dsc.yaml) can be found in the PowerToys repository.
These are the available properties to configure each plugin:
| Name | Type | Description |
| :--- | :--- | :--- |
| Name | String | Name of the plugin we want to configure |
-| Disabled | Boolean | Whether the plugin should be disabled |
-| IsGlobal | Boolean | Whether the results for this plugin are shown in the global results |
+| Disabled | Boolean | The plugin should be disabled |
+| IsGlobal | Boolean | The results for this plugin are shown in the global results |
| ActionKeyword | String | Configure the action keyword of the plugin |
| WeightBoost | Int | The weight modifier to help in ordering the results for this plugin |
> [!NOTE]
-> Configuring additional properties of plugins is not yet supported through DSC.
+> Configuring additional properties of plugins through DSC is not yet supported.
### PowerOcr
@@ -398,7 +398,7 @@ PowerOcr is the internal name for Text Extractor.
| Name | Type | Description | Available |
| :--- | :--- | :--- | :--- |
-| Enabled | Bool | The enabled state for this utility. | ✅ |
+| Enabled | Boolean | The enabled state for this utility. | ✅ |
| ActivationShortcut | HotkeySettings | Customize the shortcut to activate this module. | ✅ |
| PreferredLanguage | String | Should match the full name of one of the languages installed in the system. Example: "English (United States)". | ✅ |
@@ -429,27 +429,27 @@ PowerOcr is the internal name for Text Extractor.
| Name | Type | Description | Available |
| :--- | :--- | :--- | :--- |
-| Enabled | Bool | The enabled state for this utility. | ✅ |
-| MRUEnabled | Bool | Enable auto-complete for the search & replace fields. | ✅ |
+| Enabled | Boolean | The enabled state for this utility. | ✅ |
+| MRUEnabled | Boolean | Enable auto-complete for the search & replace fields. | ✅ |
| MaxMRUSize | Int | Maximum number of recently used items to remember. | ✅ |
-| ExtendedContextMenuOnly | Bool | Show PowerRename in extended context menu only or in default context menu as well. | ✅ |
-| UseBoostLib | Bool | Use Boost Library. | ✅ |
+| ExtendedContextMenuOnly | Boolean | Show PowerRename in extended context menu only or in default context menu as well. | ✅ |
+| UseBoostLib | Boolean | Use Boost Library. | ✅ |
### RegistryPreview
| Name | Type | Description | Available |
| :--- | :--- | :--- | :--- |
-| Enabled | Bool | The enabled state for this utility. | ✅ |
+| Enabled | Boolean | The enabled state for this utility. | ✅ |
| DefaultRegApp | Boolean | Make Registry Preview default app for opening .reg files. | ✅ |
### ShortcutGuide
| Name | Type | Description | Available |
| :--- | :--- | :--- | :--- |
-| Enabled | Bool | The enabled state for this utility. | ✅ |
+| Enabled | Boolean | The enabled state for this utility. | ✅ |
| OpenShortcutGuide | HotkeySettings | Customize the shortcut to activate this module. | ✅ |
| OverlayOpacity | Int | Background opacity in percentage. | ✅ |
-| UseLegacyPressWinKeyBehavior | Bool | If ShortcutGuide should be activated by pressing the Windows key. | ✅ |
+| UseLegacyPressWinKeyBehavior | Boolean | If ShortcutGuide should be activated by pressing the Windows key. | ✅ |
| PressTimeForGlobalWindowsShortcuts | Int | Press duration before showing global Windows shortcuts in milliseconds. | ✅ |
| PressTimeForTaskbarIconShortcuts | Int | Press duration before showing taskbar icon shortcuts in milliseconds. | ✅ |
| Theme | String | Theme index. | ✅ |
@@ -459,11 +459,11 @@ PowerOcr is the internal name for Text Extractor.
| Name | Type | Description | Available |
| :--- | :--- | :--- | :--- |
-| Enabled | Bool | The enabled state for this utility. | ✅ |
+| Enabled | Boolean | The enabled state for this utility. | ✅ |
| MuteCameraAndMicrophoneHotkey | KeyboardKeys | Shortcut for muting the camera and microphone. | ✅ |
| MuteMicrophoneHotkey | KeyboardKeys | Shortcut for muting the microphone. | ✅ |
| PushToTalkMicrophoneHotkey | KeyboardKeys | Shortcut for push to talk. | ✅ |
-| PushToReverseEnabled | Bool | If enabled, allows both push to talk and push to mute, depending on microphone state. | ✅ |
+| PushToReverseEnabled | Boolean | If enabled, allows both push to talk and push to mute, depending on microphone state. | ✅ |
| MuteCameraHotkey | KeyboardKeys | Shortcut for muting the camera. | ✅ |
| SelectedCamera | String | Device name. | ✅ |
| SelectedMicrophone | String | Device name or [All]. | ✅ |
@@ -477,13 +477,13 @@ PowerOcr is the internal name for Text Extractor.
| Name | Type | Description | Available |
| :--- | :--- | :--- | :--- |
-| Startup | Boolean | Whether PowerToys is automatically enabled at startup. | ✅ |
+| Startup | Boolean | PowerToys is automatically enabled at startup. | ✅ |
| EnableWarningsElevatedApps | Boolean | Show a warning for functionality issues when running alongside elevated applications. | ✅ |
| Theme | String | What theme to use for the Settings application: "system", "dark", "light". | ✅ |
| ShowNewUpdatesToastNotification | Boolean | Show a toast notification when a new PowerToys update is available. | ✅ |
| AutoDownloadUpdates | Boolean | If new updates of PowerToys should be automatically downloaded in the background. | ✅ |
| ShowWhatsNewAfterUpdates | Boolean | After updating PowerToys, open the "What's new" screen. | ✅ |
-| EnableExperimentation | Boolean | Whether to opt-in into experimental features. | ✅ |
+| EnableExperimentation | Boolean | Opt-in into experimental features. | ✅ |
## Contributing
diff --git a/hub/powertoys/environment-variables.md b/hub/powertoys/environment-variables.md
index 89e14111ca..19b4d49dc0 100644
--- a/hub/powertoys/environment-variables.md
+++ b/hub/powertoys/environment-variables.md
@@ -10,13 +10,13 @@ no-loc: [PowerToys, Windows, Environment Variables, Win]
Environment Variables offers an easy and convenient way to manage environment variables. It also allows you to create profiles for managing a set of variables together. Profile variables have precedence over User and System variables. Applying the profile adds variables to User environment variables in the background. When a profile is applied, if there is an existing User variable with the same name, a backup variable is created in User variables which will be reverted to the original value on profile un-apply.
-Applied variables list shows the current state of the environment, respecting the order of evaluation of environment variables (Profile -> User -> System). Evaluated Path variable value is shown at the top of the list.
+Applied variables list shows the current state of the environment, respecting the order of evaluation of environment variables (Profile > User > System). Evaluated Path variable value is shown at the top of the list.
-
+
## Edit/Remove variable
-To edit or remove a variable (profile, User or System), select the more options button (**•••**) on the desired variable:
+To edit or remove a variable (profile, User or System), select the **more** button (•••) on the desired variable:
@@ -26,17 +26,17 @@ To add a new profile:
- Select **New profile**
- Enter profile name
- - Set Enabled toggle to On to apply the profile right after creation
- - Select **Add variable** to add variables to profile (either new variable or existing User/System variables).
+ - Set **Enabled** toggle to On to apply the profile right after creation
+ - Select **Add variable** to add variables to profile (either new variable or existing User/System variables)
- Select **Save**
-To edit or remove a profile, select the more options button (**•••**) on the desired profile.
+To edit or remove a profile, select the **more** button (•••) on the desired profile.
## Apply profile
-To apply a profile, set the profile toggle to On. Only one profile can be applied at a time. The Applied variables list will show applied profile variables at the top (below Path variable):
+To apply a profile, set the **profile** toggle to On. Only one profile can be applied at a time. The Applied variables list will show applied profile variables at the top (below Path variable):
@@ -46,4 +46,4 @@ From the Settings menu, the following options can be configured:
| Setting | Description |
| :--- | :--- |
-| Launch as administrator | Launch as administrator allow management of System variables. If disabled, only profile and User variables can be modified. Environment Variables is started as administrator by default. |
+| Open as administrator | Allow management of System variables. If disabled, only profile and User variables can be modified. Environment Variables is opened as administrator by default. |
diff --git a/hub/powertoys/fancyzones.md b/hub/powertoys/fancyzones.md
index 497fb9cb26..cf94d59047 100644
--- a/hub/powertoys/fancyzones.md
+++ b/hub/powertoys/fancyzones.md
@@ -9,7 +9,8 @@ no-loc: [PowerToys, Windows, FancyZones, Fancy, Zone, Zones, Win]
# FancyZones utility
-FancyZones is a window manager utility for arranging and snapping windows into efficient layouts to improve your workflow and restore layouts quickly. You can define a set of zone locations to use as targets for windows on your desktop. When you drag a window into a zone, or enter the associated keyboard shortcut, the window is resized and repositioned to fill that zone.
+FancyZones is a window manager utility for arranging and snapping windows into efficient layouts to improve your workflow and restore layouts quickly.
+You can define a set of zone locations to use as targets for windows on your desktop. When you drag a window into a zone, or enter the associated keyboard shortcut, the window is resized and repositioned to fill that zone.
## Snapping to a single zone with mouse
@@ -19,13 +20,13 @@ You can also trigger zone selection mode by using a non-primary mouse button if
If both **Hold Shift key to activate zones while dragging** and **Use non-primary mouse button to toggle zone activation** are cleared, zones will appear immediately after you start dragging the window.
-
+
## Snapping to a single zone with keyboard
Select **Override Windows Snap** in the FancyZones settings. Use Win+[arrow keys] to snap a window to a zone. Use **Move windows based on** to choose whether to move windows based the zone index or a window's relative position.
-
+
## Snapping to multiple zones
@@ -39,23 +40,23 @@ If two zones are adjacent, you can snap a window to the sum of their area (round
Drag the window until one zone is activated, then press and hold the Ctrl key while dragging the window to select multiple zones.
-
+
### Snapping to multiple zones with only the keyboard
Turn on the **Override Windows Snap** toggle and select **Move windows based on: Relative position**. Use Win+Ctrl+Alt+[arrow keys] to expand the window to multiple zones.
-
+
### Window switching
-When two or more windows are snapped in the same zone, you can cycle between the snapped windows in that zone by using the shortcut Win+PgUp/PgDn.
+When two or more windows are snapped in the same zone, cycle between the snapped windows in that zone by using the shortcut Win+PgUp/PgDn.
### Shortcut keys
| Shortcut | Action |
| --- | --- |
-| ⊞ Win+Shift+\` | Launches the editor (this shortcut can be changed in the Settings window) |
+| ⊞ Win+Shift+\` | Opens the editor (this shortcut can be changed in the Settings window) |
| ⊞ Win+Left/Right | Move focused window between zones (only if **Override Windows Snap hotkeys** is selected and **Zone index** is chosen; in that case only the ⊞ Win+Left and ⊞ Win+Right are overridden, while the ⊞ Win+Up and ⊞ Win+Down keep working as usual) |
| ⊞ Win+Left/Right/Up/Down | Move focused window between zones (only if **Override Windows Snap hotkeys** is selected and **Relative position** is chosen; in that case all the ⊞ Win+Left, ⊞ Win+Right, ⊞ Win+Up and ⊞ Win+Down are overridden) |
| ⊞ Win+PgUp/PgDn | Cycle between windows snapped to the same zone |
@@ -73,15 +74,15 @@ FancyZones includes an editor to give you more control over your window layouts
### Open the layout editor
-Open the layout editor by selecting **Launch layout editor** or by pressing Win+Shift+` ("back-tick" or "accent grave"). You can change the FancyZones layout editor shortcut in PowerToys Settings.
+Open the layout editor by selecting **Launch layout editor** or with Win+Shift+` ("back-tick" or "accent grave"). You can change the FancyZones layout editor shortcut in PowerToys Settings.
-
+
### Layout Editor: Choose your layout
-When you first launch the layout editor, you'll see a list of layouts that can be adjusted by how many windows are on the monitor. Selecting a layout shows a preview of that layout on the screen. The selected layout is applied automatically. Double-clicking a layout will apply it and close the editor. The editor will detect and display the available monitors. Select a monitor, and it becomes the target of the selected layout.
+When you first open the layout editor, you'll see a list of layouts that can be adjusted by how many windows are on the monitor. Selecting a layout shows a preview of that layout on the screen. The selected layout is applied automatically. Double-clicking a layout will apply it and close the editor. The editor will detect and display the available monitors. Select a monitor, and it becomes the target of the selected layout.
-
+
#### Space around zones
@@ -91,15 +92,15 @@ When you first launch the layout editor, you'll see a list of layouts that can b
**Default layout for horizontal monitor orientation** and **Default layout for vertical monitor orientation** set which layout to use as the default when the display configuration is changed in the system (for example, if you add a new display).
-
+
### Creating a custom layout
-Select **+ Create new layout** at the bottom.
+Select **Create new layout** at the bottom.
There are two styles of custom zone layouts: **Grid** and **Canvas**.
-The **Grid** model starts with a three column grid and allows zones to be created by splitting and merging zones, moving the gutter between zones as desired. This is a relative layout and will resize with different screen sizes. You can edit the layout using mouse or using keyboard.
+The **Grid** model starts with a three column grid and allows zones to be created by splitting and merging zones, moving the gutter between zones as desired. This is a relative layout and will resize with different screen sizes. You can edit the layout using mouse or keyboard.
#### Mouse
@@ -114,24 +115,24 @@ The **Grid** model starts with a three column grid and allows zones to be create
- To move a divider: focus the divider and press arrow keys to move it.
- To merge/delete zones: focus the divider between zones and press Delete. All zones adjacent to deleted divider will be merged into one zone.
-
+
The **Canvas** model starts with one zone and supports adding zones that can be moved and resized, similar to windows. Zones in the canvas model may be overlapping.
Canvas layout also has keyboard support for zone editing. Use the arrow keys (Left, Right, Up, Down) to move a zone by 10 pixels, or Ctrl+arrow to move a zone by 1 pixel. Use the Shift+arrow keys to resize a zone by 10 pixels (5 per edge), or Ctrl+Shift+arrow to resize a zone by 2 pixels (1 per edge). To switch between the editor and dialog, press the Ctrl+Tab keys.
-
+
### Quickly changing between custom layouts
> [!NOTE]
-> Turn on the **Enable quick layout switch** toggle to use this feature.
+> Select **Enable quick layout switch** to use this feature.
A custom layout can be configured to have a user-defined hotkey to quickly apply it to the active screen. The hotkey can be set by opening the custom layout's edit dialog. Once set, the custom layout can be applied by pressing the Win+Ctrl+Alt+[number] binding. The layout can also be applied by pressing the hotkey when dragging a window.
In the demo below, we start with a default template applied to the screen and two custom layouts that we assign hotkeys for. We then use the Win+Ctrl+Alt+[number] binding to apply the first custom layout and snap a window to it. Finally, we apply the second custom layout while dragging a window and snap the window to it.
-
+
> [!TIP]
> The settings for custom zone layouts are saved in the file `%LocalAppData%\Microsoft\PowerToys\FancyZones\custom-layouts.json`. This file can be manually changed to tweak zones, and exported to share layouts across devices. Other json files in the same directory can be modified to alter settings for monitors, layout hotkeys, etc. Be warned that editing these files is not recommended as it may cause other issues with FancyZones functionality.
@@ -174,4 +175,4 @@ In the demo below, we start with a default template applied to the screen and tw
| Flash zones when switching layout | The zones will flash when a layout is selected via the shortcut. |
| Exclude applications from snapping to zones | Add an application's name, or part of the name, one per line (e.g. adding `Notepad` will match both `Notepad.exe` and `Notepad++.exe`; to match only `Notepad.exe` add the `.exe` extension) |
-
+
diff --git a/hub/powertoys/file-explorer.md b/hub/powertoys/file-explorer.md
index 29313e9b31..bd25a8e193 100644
--- a/hub/powertoys/file-explorer.md
+++ b/hub/powertoys/file-explorer.md
@@ -39,7 +39,7 @@ Expand the **Source code files (Monaco)** section to change the following settin
To enable preview support, set the extension to **On**.
-
+
If the preview pane does not appear to work after setting the extension to **On**, there is an advanced setting in Windows that may be blocking the preview handler. Open the **Options** menu in Windows File Explorer and select the **View** tab. Under the **View** tab, you will see a list of **Advanced settings**. Ensure that **Show preview handlers in preview pane** has a check next to it in order for the preview pane to display.
@@ -47,13 +47,13 @@ If the preview pane does not appear to work after setting the extension to **On*
Open Windows File Explorer, select the **View** menu in the Explorer ribbon. Hover over **Show**, and then select **Preview pane**.
-
+
### Enabling the Explorer pane in Windows 10
Open Windows File Explorer, select the **View** tab in the Explorer ribbon, and then select **Preview Pane**.
-
+
> [!NOTE]
> It is not possible to change the background color of the preview pane, so if you are working with transparent images with white shapes, you may not be able to see them in the preview.
diff --git a/hub/powertoys/file-locksmith.md b/hub/powertoys/file-locksmith.md
index 2b9e544b48..1608ea7a2d 100644
--- a/hub/powertoys/file-locksmith.md
+++ b/hub/powertoys/file-locksmith.md
@@ -10,15 +10,16 @@ no-loc: [PowerToys, Windows, File Locksmith, Win]
File Locksmith is a Windows shell extension for checking which files are in use and by which processes.
-
+
## How to activate and use File Locksmith
-To activate File Locksmith, open PowerToys and turn on the **Enable File Locksmith** toggle. Select one or more files or directories in Windows File Explorer. If a directory is selected, all of its files and subdirectories will be scanned as well. Right-click on the selected file(s), select **Show more options** from the menu to expand your list of menu options, then select **Unlock with File Locksmith** to open File Locksmith and see which processes are using the file(s).
+To activate File Locksmith, open PowerToys and turn on the **Enable File Locksmith** toggle. Select one or more files or directories in Windows File Explorer. If a directory is selected, all of its files and subdirectories will be scanned as well.
+Right-click on the selected file(s), select **Show more options** from the menu to expand the list of menu options, then select **Unlock with File Locksmith** to open File Locksmith and see which processes are using the file(s).
When File Locksmith is activated, it will scan all of the running processes that it can access, checking which files the processes are using. Processes that are being run by a different user cannot be accessed and may be missing from the list of results. To scan all processes, select **Restart as administrator**.
-
+
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**.
diff --git a/hub/powertoys/general.md b/hub/powertoys/general.md
index c174792926..a6d2c2ba2b 100644
--- a/hub/powertoys/general.md
+++ b/hub/powertoys/general.md
@@ -14,7 +14,7 @@ The general section of Microsoft PowerToys contains the following settings:
## Version
-Here you can check for new updates and if a new update is available, you can download and install it.
+Here you can check for new updates and if one is available, you can download and install it.
You can set if updates should be downloaded automatically.
@@ -26,7 +26,7 @@ Read more about the administrator mode in the [PowerToys running with administra
### App theme
-Here you can set the theme of the PowerToys settings app and the PowerToys flyout. You can set it to Windows default, light or dark.
+Here you can set the theme of the PowerToys settings app and the PowerToys flyout: **Dark**, **Light**, or **Windows default**.
### Run at startup
diff --git a/hub/powertoys/grouppolicy.md b/hub/powertoys/grouppolicy.md
index 803a7c272f..8886c82944 100644
--- a/hub/powertoys/grouppolicy.md
+++ b/hub/powertoys/grouppolicy.md
@@ -14,23 +14,23 @@ Since version 0.64, PowerToys is released on GitHub with Administrative Template
### Download
-You can find the latest administrative templates (ADMX files) in the assets section of our newest PowerToys release on . The file is named `GroupPolicyObjectsFiles-.zip`.
+You can find the latest administrative templates (ADMX files) in the assets section of our newest PowerToys release on [GitHub](https://github.com/microsoft/PowerToys/releases). The file is named `GroupPolicyObjectsFiles-.zip`.
### Add the administrative template to an individual computer
-1. Copy the "PowerToys.admx" file to your Policy Definition template folder. (Example: C:\Windows\PolicyDefinitions)
-2. Copy the "PowerToys.adml" file to the matching language folder in your Policy Definition folder. (Example: C:\Windows\PolicyDefinitions\en-US)
+1. Copy the _PowerToys.admx_ file to your Policy Definition template folder. (Example: _C:\Windows\PolicyDefinitions_)
+2. Copy the _PowerToys.adml_ file to the matching language folder in your Policy Definition folder. (Example: _C:\Windows\PolicyDefinitions\en-US_)
### Add the administrative template to Active Directory
-1. On a domain controller or workstation with RSAT, go to the **PolicyDefinition** folder (also known as the *Central Store*) on any domain controller for your domain. For older versions of Windows Server, you might need to create the **PolicyDefinition** folder. For more information, see [How to create and manage the Central Store for Group Policy Administrative Templates in Windows](https://support.microsoft.com/help/3087759/how-to-create-and-manage-the-central-store-for-group-policy-administra).
-2. Copy the "PowerToys.admx" file to the PolicyDefinition folder. (Example: %systemroot%\sysvol\domain\policies\PolicyDefinitions)
-3. Copy the "PowerToys.adml" file to the matching language folder in the PolicyDefinition folder. Create the folder if it doesn't already exist. (Example: %systemroot%\sysvol\domain\policies\PolicyDefinitions\EN-US)
+1. On a domain controller or workstation with RSAT, go to the **PolicyDefinition** folder (also known as the _Central Store_) on any domain controller for your domain. For older versions of Windows Server, you might need to create the **PolicyDefinition** folder. For more information, see [How to create and manage the Central Store for Group Policy Administrative Templates in Windows](https://support.microsoft.com/help/3087759/how-to-create-and-manage-the-central-store-for-group-policy-administra).
+2. Copy the _PowerToys.admx_ file to the PolicyDefinition folder. (Example: _%systemroot%\sysvol\domain\policies\PolicyDefinitions_)
+3. Copy the _PowerToys.adml_ file to the matching language folder in the PolicyDefinition folder. Create the folder if it doesn't already exist. (Example: _%systemroot%\sysvol\domain\policies\PolicyDefinitions\EN-US_)
4. If your domain has more than one domain controller, the new ADMX files will be replicated to them at the next domain replication interval.
### Import the administrative template in Intune
-You can find all instructions on how to import the administrative templates in Intune [here](/mem/intune/configuration/administrative-templates-import-custom#add-the-admx-and-adml-files).
+You can find all instructions on how to import the administrative templates in Intune on [this page](/mem/intune/configuration/administrative-templates-import-custom#add-the-admx-and-adml-files).
### Scope
@@ -44,7 +44,7 @@ The syntax of OMA-URI is the following: ./Device/Vendor/MSFT/Policy/Config/Power
### Configure global utility enabled state
-> Supported on PowerToys 0.75.0 or later.
+Supported on PowerToys 0.75.0 or later.
This policy configures the enabled state for all PowerToys utilities.
@@ -60,7 +60,7 @@ The individual enabled state policies for the utilities will override this polic
- GP name: Configure global utility enabled state
- GP path: Administrative Templates/Microsoft PowerToys
- GP scope: Computer and user
-- ADMX file name: PowerToys.admx
+- ADMX file name: _PowerToys.admx_
#### Registry information
@@ -76,15 +76,15 @@ The individual enabled state policies for the utilities will override this polic
### Configure enabled state for individual utilities
-> Supported on PowerToys 0.64.0 or later depending on the utility.
+Supported on PowerToys 0.64.0 or later, depending on the utility.
For each utility shipped with PowerToys, there's a "Configure enabled state" policy, which forces an enabled state for the utility.
-- If you enable this setting, the utility will be always enabled and the user won't be able to disable it.
-- If you disable this setting, the utility will be always disabled and the user won't be able to enable it.
+- If you enable this setting, the utility will be always enabled and the user won't be able to disable them.
+- If you disable this setting, the utility will be always disabled and the user won't be able to enable them.
- If you don't configure this setting, users are able to enable or disable the utility.
-These policies have a higher priority than the policy "Configure global utility enabled state" and override it.
+These policies have a higher priority than, and will override, the policy "Configure global utility enabled state".
> [!NOTE]
> PDF file preview: There have been reports of incompatibility between the PDF Preview Handler and Outlook.
@@ -137,7 +137,7 @@ These policies have a higher priority than the policy "Configure global utility
- GP name: See the table above.
- GP path: Administrative Templates/Microsoft PowerToys
- GP scope: Computer and user
-- ADMX file name: PowerToys.admx
+- ADMX file name: _PowerToys.admx_
#### Registry information
@@ -150,14 +150,14 @@ These policies have a higher priority than the policy "Configure global utility
- OMA-URI: `./Device/Vendor/MSFT/Policy/Config/PowerToys~Policy~PowerToys/`
- > [!Note]
- > Please see the table above for the *PolicyID* value.
+> [!Note]
+> Please see the table above for the _PolicyID_ value.
- Example value: ``
### Allow experimentation
-> Supported on PowerToys 0.68.0 or later.
+Supported on PowerToys 0.68.0 or later.
This policy configures whether PowerToys experimentation is allowed. With experimentation allowed the user sees the new features being experimented if it gets selected as part of the test group. (Experimentation will only happen on Windows Insider builds.)
@@ -170,7 +170,7 @@ This policy configures whether PowerToys experimentation is allowed. With experi
- GP name: Allow experimentation
- GP path: Administrative Templates/Microsoft PowerToys
- GP scope: Computer and user
-- ADMX file name: PowerToys.admx
+- ADMX file name: _PowerToys.admx_
#### Registry information
@@ -188,7 +188,7 @@ This policy configures whether PowerToys experimentation is allowed. With experi
#### Disable per-user installation
-> Supported on PowerToys 0.68.0 or later.
+Supported on PowerToys 0.68.0 or later.
This policy configures whether PowerToys per-user installation is allowed or not.
@@ -204,7 +204,7 @@ This policy configures whether PowerToys per-user installation is allowed or not
- GP name: Disable per-user installation
- GP path: Administrative Templates/Microsoft PowerToys/Installer and Updates
- GP scope: Computer only
-- ADMX file name: PowerToys.admx
+- ADMX file name: _PowerToys.admx_
##### Registry information
@@ -220,7 +220,7 @@ This policy configures whether PowerToys per-user installation is allowed or not
#### Disable automatic downloads
-> Supported on PowerToys 0.68.0 or later.
+Supported on PowerToys 0.68.0 or later.
This policy configures whether the automatic download and installation of available updates is disabled or not. (On metered connections updates are never downloaded.)
@@ -233,7 +233,7 @@ This policy configures whether the automatic download and installation of availa
- GP name: Disable automatic downloads
- GP path: Administrative Templates/Microsoft PowerToys/Installer and Updates
- GP scope: Computer and user
-- ADMX file name: PowerToys.admx
+- ADMX file name: _PowerToys.admx_
##### Registry information
@@ -249,7 +249,7 @@ This policy configures whether the automatic download and installation of availa
#### Suspend Action Center notification for new updates
-> Supported on PowerToys 0.68.0 or later.
+Supported on PowerToys 0.68.0 or later.
This policy configures whether the action center notification for new updates is suspended for 2 minor releases. (Example: if the installed version is v0.60.0, then the next notification is shown for the v0.63.* release.)
@@ -265,7 +265,7 @@ This policy configures whether the action center notification for new updates is
- GP name: Suspend Action Center notification for new updates
- GP path: Administrative Templates/Microsoft PowerToys/Installer and Updates
- GP scope: Computer and user
-- ADMX file name: PowerToys.admx
+- ADMX file name: _PowerToys.admx_
##### Registry information
@@ -281,7 +281,7 @@ This policy configures whether the action center notification for new updates is
#### Disable Action Center notification for new updates
-> Supported on PowerToys 0.78.0 or later.
+Supported on PowerToys 0.78.0 or later.
This policy configures whether the action center notification for new updates is shown or not.
@@ -294,7 +294,7 @@ This policy configures whether the action center notification for new updates is
- GP name: Disable Action Center notification for new updates
- GP path: Administrative Templates/Microsoft PowerToys/Installer and Updates
- GP scope: Computer and user
-- ADMX file name: PowerToys.admx
+- ADMX file name: _PowerToys.admx_
##### Registry information
@@ -310,7 +310,7 @@ This policy configures whether the action center notification for new updates is
#### Do not show the release notes after updates
-> Supported on PowerToys 0.78.0 or later.
+Supported on PowerToys 0.78.0 or later.
This policy allows you to configure if the window with the release notes is shown after updates.
@@ -323,7 +323,7 @@ This policy allows you to configure if the window with the release notes is show
- GP name: Disable Action Center notification for new updates
- GP path: Administrative Templates/Microsoft PowerToys/Installer and Updates
- GP scope: Computer and user
-- ADMX file name: PowerToys.admx
+- ADMX file name: _PowerToys.admx_
##### Registry information
@@ -341,7 +341,7 @@ This policy allows you to configure if the window with the release notes is show
#### Configure enabled state for all plugins
-> Supported on PowerToys 0.75.0 or later.
+Supported on PowerToys 0.75.0 or later.
This policy configures the enabled state for all PowerToys Run plugins. All plugins will have the same state.
@@ -360,7 +360,7 @@ You can override this policy for individual plugins using the policy "Configure
- GP name: Configure enabled state for all plugins
- GP path: Administrative Templates/Microsoft PowerToys/PowerToys Run
- GP scope: Computer and user
-- ADMX file name: PowerToys.admx
+- ADMX file name: _PowerToys.admx_
##### Registry information
@@ -376,7 +376,7 @@ You can override this policy for individual plugins using the policy "Configure
#### Configure enabled state for individual plugins
-> Supported on PowerToys 0.75.0 or later.
+Supported on PowerToys 0.75.0 or later.
With this policy you can configure an individual enabled state for each PowerToys Run plugin that you add to the list.
@@ -399,14 +399,14 @@ You can set the enabled state for all plugins not controlled by this policy usin
- GP name: Configure enabled state for individual plugins
- GP path: Administrative Templates/Microsoft PowerToys/PowerToys Run
- GP scope: Computer and user
-- ADMX file name: PowerToys.admx
+- ADMX file name: _PowerToys.admx_
##### Registry information
- Path: Software\Policies\PowerToys\PowerLauncherIndividualPluginEnabledList
- Name: The plugin ID from the `plugin.json` file.
- Type: STRING
-- Example value:
+- Example values:
```
Software\Policies\PowerToys\0778F0C264114FEC8A3DF59447CF0A74 = 2 (=> User can enable/disable the OneNote plugin.)
@@ -419,11 +419,10 @@ You can set the enabled state for all plugins not controlled by this policy usin
- OMA-URI: `./Device/Vendor/MSFT/Policy/Config/PowerToys~Policy~PowerToys~PowerToysRun/PowerToysRunIndividualPluginEnabledState`
- Example value:
- > [!NOTE]
- > Syntax for the :::no-loc text="value"::: property from the :::no-loc text="data"::: element:
- > ``
-
```
```
+ > [!NOTE]
+ > Syntax for the :::no-loc text="value"::: property from the :::no-loc text="data"::: element:
+ > ``
diff --git a/hub/powertoys/hosts-file-editor.md b/hub/powertoys/hosts-file-editor.md
index 66f66b3495..50ade99531 100644
--- a/hub/powertoys/hosts-file-editor.md
+++ b/hub/powertoys/hosts-file-editor.md
@@ -42,7 +42,7 @@ From the Settings menu, the following options can be configured:
| Setting | Description |
| :--- | :--- |
-| Launch as administrator | Launch as administrator to be able edit the hosts file. If disabled, the editor is run in read-only mode. Hosts File Editor is started as administrator by default. |
+| Launch as administrator | Open as administrator to be able edit the hosts file. If disabled, the editor is run in read-only mode. Hosts File Editor is started as administrator by default. |
| Show a warning at startup | Warns that editing hosts can change DNS names resolution. Enabled by default. |
| Additional lines position | Default value is **Top**. If **Bottom** is selected, the file header is moved below hosts settings to the bottom. |
| Consider loopback addresses as duplicates | Loopback addresses (like 127.0.0.1 and ::1) are considered as duplicates. |
diff --git a/hub/powertoys/image-resizer.md b/hub/powertoys/image-resizer.md
index 9a5e2107a5..813420f076 100644
--- a/hub/powertoys/image-resizer.md
+++ b/hub/powertoys/image-resizer.md
@@ -11,11 +11,11 @@ no-loc: [PowerToys, Windows, File Explorer, Image Resizer]
Image Resizer is a Windows shell extension for bulk image-resizing. After installing PowerToys, right-click on one or more selected image files in File Explorer, and select **Resize with ImageResizer** from the menu.
-
+
Image Resizer allows you to resize images by dragging and dropping your selected files with the right mouse button. This way, resized pictures can quickly be saved in a different folder.
-
+
> [!NOTE]
> If **Ignore the orientation of pictures** is selected, the width and height of the specified size _may_ be swapped to match the orientation (portrait/landscape) of the current image. In other words: If selected, the **smallest** number (in width/height) in the settings will be applied to the **smallest** dimension of the picture. Regardless if this is declared as width or height. The idea is that different photos with different orientations will still be the same size.
@@ -24,7 +24,7 @@ Image Resizer allows you to resize images by dragging and dropping your selected
On the **Image Resizer** tab, configure the following settings.
-
+
### Sizes
diff --git a/hub/powertoys/index.md b/hub/powertoys/index.md
index f0ae827c83..b3ef543607 100644
--- a/hub/powertoys/index.md
+++ b/hub/powertoys/index.md
@@ -28,7 +28,7 @@ The currently available utilities include:
:::row:::
:::column:::
- [](always-on-top.md)
+ [](always-on-top.md)
:::column-end:::
:::column span="2":::
[Always On Top](always-on-top.md) enables you to pin windows above other windows with a quick key shortcut (⊞ Win+Ctrl+T).
@@ -39,7 +39,7 @@ The currently available utilities include:
:::row:::
:::column:::
- [](awake.md)
+ [](awake.md)
:::column-end:::
:::column span="2":::
[PowerToys Awake](awake.md) is designed to keep a computer awake without having to manage its power & sleep settings. This behavior can be helpful when running time-consuming tasks, ensuring that the computer does not go to sleep or turns off its displays.
@@ -50,7 +50,7 @@ The currently available utilities include:
:::row:::
:::column:::
- [](color-picker.md)
+ [](color-picker.md)
:::column-end:::
:::column span="2":::
[Color Picker](color-picker.md) is a system-wide color picking utility activated with ⊞ Win+Shift+C. Pick colors from anywhere on the screen, the picker automatically copies the color into your clipboard in a set format.
@@ -62,7 +62,7 @@ The currently available utilities include:
:::row:::
:::column:::
- [](cmd-not-found.md)
+ [](cmd-not-found.md)
:::column-end:::
:::column span="2":::
[Command Not Found](cmd-not-found.md) is a PowerShell 7 module that detects an error thrown by a command and suggests a relevant WinGet package to install, if available.
@@ -74,7 +74,7 @@ The currently available utilities include:
:::row:::
:::column:::
- [](crop-and-lock.md)
+ [](crop-and-lock.md)
:::column-end:::
:::column span="2":::
[Crop And Lock](crop-and-lock.md) is a utility that creates a new window that's a crop or a thumbnail of another window.
@@ -85,7 +85,7 @@ The currently available utilities include:
:::row:::
:::column:::
- [](environment-variables.md)
+ [](environment-variables.md)
:::column-end:::
:::column span="2":::
[Environment Variables](environment-variables.md) offers an easy and convenient way to manage environment variables. It also allows you to create profiles for managing a set of variables together.
@@ -96,7 +96,7 @@ The currently available utilities include:
:::row:::
:::column:::
- [](fancyzones.md)
+ [](fancyzones.md)
:::column-end:::
:::column span="2":::
[FancyZones](fancyzones.md) is a window manager that makes it easy to create complex window layouts and quickly position windows into those layouts.
@@ -107,7 +107,7 @@ The currently available utilities include:
:::row:::
:::column:::
- [](file-explorer.md)
+ [](file-explorer.md)
:::column-end:::
:::column span="2":::
[File Explorer add-ons](file-explorer.md) enable Preview pane and thumbnail rendering in File Explorer to display a variety of file types. To enable the Preview pane, select the "View" tab in File Explorer, then select "Preview Pane".
@@ -118,7 +118,7 @@ The currently available utilities include:
:::row:::
:::column:::
- [](file-locksmith.md)
+ [](file-locksmith.md)
:::column-end:::
:::column span="2":::
[File Locksmith](file-locksmith.md) is a Windows shell extension to check which files are in use and by which processes. Right-click on one or more selected files in File Explorer, and then select **Unlock with File Locksmith**.
@@ -129,7 +129,7 @@ The currently available utilities include:
:::row:::
:::column:::
- [](hosts-file-editor.md)
+ [](hosts-file-editor.md)
:::column-end:::
:::column span="2":::
[Hosts File Editor](hosts-file-editor.md) is a convenient way to edit the 'Hosts' file that contains domain names and matching IP addresses, acting as a map to identify and locate hosts on IP networks.
@@ -140,7 +140,7 @@ The currently available utilities include:
:::row:::
:::column:::
- [](image-resizer.md)
+ [](image-resizer.md)
:::column-end:::
:::column span="2":::
[Image Resizer](image-resizer.md) is a Windows Shell extension for quickly resizing images. With a simple right click from File Explorer, resize one or many images instantly. This code is based on [Brice Lambson's Image Resizer](https://github.com/bricelam/ImageResizer).
@@ -151,7 +151,7 @@ The currently available utilities include:
:::row:::
:::column:::
- [](keyboard-manager.md)
+ [](keyboard-manager.md)
:::column-end:::
:::column span="2":::
[Keyboard Manager](keyboard-manager.md) allows you to customize the keyboard to be more productive by remapping keys and creating your own keyboard shortcuts.
@@ -162,7 +162,7 @@ The currently available utilities include:
:::row:::
:::column:::
- [](mouse-utilities.md)
+ [](mouse-utilities.md)
:::column-end:::
:::column span="2":::
[Mouse utilities](mouse-utilities.md) add functionality to enhance your mouse and cursor. With Find My Mouse, quickly locate your mouse's position with a spotlight that focuses on your cursor. This feature is based on source code developed by [Raymond Chen](https://github.com/oldnewthing). Mouse Highlighter displays visual indicators when the left or right mouse buttons are clicked. Mouse Jump allows a quick jump on large displays. Mouse Pointer Crosshairs draws crosshairs centered on the mouse pointer.
@@ -173,7 +173,7 @@ The currently available utilities include:
:::row:::
:::column:::
- [](mouse-without-borders.md)
+ [](mouse-without-borders.md)
:::column-end:::
:::column span="2":::
[Mouse Without Borders](mouse-without-borders.md) enables you to interact with multiple computers from the same keyboard and mouse, sharing clipboard contents and files between the machines seamlessly.
@@ -184,7 +184,7 @@ The currently available utilities include:
:::row:::
:::column:::
- [](paste-as-plain-text.md)
+ [](paste-as-plain-text.md)
:::column-end:::
:::column span="2":::
[Paste As Plain Text](paste-as-plain-text.md) allows you to paste text from your clipboard, excluding text-formatting, with a quick key shortcut (⊞ Win+Ctrl+Alt+V).
@@ -195,7 +195,7 @@ The currently available utilities include:
:::row:::
:::column:::
- [](peek.md)
+ [](peek.md)
:::column-end:::
:::column span="2":::
[Peek](peek.md) allows you to preview file content without the need to open multiple applications or interrupt your workflow. Simply select the file and use the shortcut (Ctrl+Space)
@@ -206,7 +206,7 @@ The currently available utilities include:
:::row:::
:::column:::
- [](powerrename.md)
+ [](powerrename.md)
:::column-end:::
:::column span="2":::
[PowerRename](powerrename.md) enables you to perform bulk renaming, searching and replacing file names. It includes advanced features, such as using regular expressions, targeting specific file types, previewing expected results, and the ability to undo changes. This code is based on [Chris Davis's SmartRename](https://github.com/chrdavis/SmartRename).
@@ -217,10 +217,10 @@ The currently available utilities include:
:::row:::
:::column:::
- [](run.md)
+ [](run.md)
:::column-end:::
:::column span="2":::
- [PowerToys Run](run.md) can help you search and launch your app instantly. To open, use the shortcut Alt+Space and start typing. It is open source and modular for additional plugins.
+ [PowerToys Run](run.md) can help you search and open your app instantly. To open, use the shortcut Alt+Space and start typing. It is open source and modular for additional plugins.
:::column-end:::
:::row-end:::
@@ -228,7 +228,7 @@ The currently available utilities include:
:::row:::
:::column:::
- [](Quick-accent.md)
+ [](Quick-accent.md)
:::column-end:::
:::column span="2":::
[Quick Accent](Quick-accent.md) is an alternative way to type accented characters, useful for when a keyboard doesn't support that specific accent with a quick key combo.
@@ -239,7 +239,7 @@ The currently available utilities include:
:::row:::
:::column:::
- [](registry-preview.md)
+ [](registry-preview.md)
:::column-end:::
:::column span="2":::
[Registry Preview](registry-preview.md) is a utility to visualize and edit Windows Registry files.
@@ -250,7 +250,7 @@ The currently available utilities include:
:::row:::
:::column:::
- [](screen-ruler.md)
+ [](screen-ruler.md)
:::column-end:::
:::column span="2":::
[Screen Ruler](screen-ruler.md) allows you to quickly measure pixels on your screen based with image edge detection. To activate, use the shortcut ⊞ Win+Shift+M. This was inspired by [Pete Blois's Rooler](https://github.com/peteblois/rooler).
@@ -261,10 +261,10 @@ The currently available utilities include:
:::row:::
:::column:::
- [](shortcut-guide.md)
+ [](shortcut-guide.md)
:::column-end:::
:::column span="2":::
- [Windows key shortcut guide](shortcut-guide.md) appears when you press ⊞ Win+Shift+/ (or as we like to think, ⊞ Win+?) and shows the available shortcuts for the current state of the desktop. You can also change this setting and press and hold ⊞ Win.
+ [Windows key shortcut guide](shortcut-guide.md) appears when you press ⊞ Win+Shift+/ (or as we like to think, ⊞ Win+?) and shows the available shortcuts for the current state of the desktop. You can also use press and hold ⊞ Win.
:::column-end:::
:::row-end:::
@@ -272,7 +272,7 @@ The currently available utilities include:
:::row:::
:::column:::
- [](text-extractor.md)
+ [](text-extractor.md)
:::column-end:::
:::column span="2":::
[Text Extractor](text-extractor.md) is a convenient way to copy text from anywhere on your screen. To activate, use the shortcut ⊞ Win+Shift+T. This code is based on [Joe Finney's Text Grab](https://github.com/TheJoeFin/Text-Grab).
@@ -283,7 +283,7 @@ The currently available utilities include:
:::row:::
:::column:::
- [](video-conference-mute.md)
+ [](video-conference-mute.md)
:::column-end:::
:::column span="2":::
[Video Conference Mute](video-conference-mute.md) is a quick way to globally "mute" both your microphone and camera using ⊞ Win+Shift+Q while on a conference call, regardless of the application that currently has focus.
@@ -300,7 +300,7 @@ _Note that new elements of the app might sometimes not yet be translated in the
In this video, Clint Rutkas (PM for PowerToys) walks through how to install and use the various utilities available, in addition to sharing some tips, info on how to contribute, and more.
-> [!VIDEO https://learn.microsoft.com/shows/Tabs-vs-Spaces/PowerToys-Utilities-to-customize-Windows-10/player?format=ny]
+[!VIDEO https://learn.microsoft.com/shows/Tabs-vs-Spaces/PowerToys-Utilities-to-customize-Windows-10/player?format=ny]
## Known issues
@@ -324,7 +324,7 @@ PowerToys [release notes](https://github.com/microsoft/PowerToys/releases/) are
## PowerToys history
-Inspired by the [Windows 95 era PowerToys project](https://en.wikipedia.org/wiki/Microsoft_PowerToys), this reboot provides power users with ways to squeeze more efficiency out of the Windows shell and customize it for individual workflows. An overview of the original PowerToys can be found here: [Using Windows 95 PowerToys](https://socket3.wordpress.com/2016/10/22/using-windows-95-powertoys/).
+Inspired by the [Windows 95 era PowerToys project](https://wikipedia.org/wiki/Microsoft_PowerToys), this reboot provides power users with ways to squeeze more efficiency out of the Windows shell and customize it for individual workflows. An overview of the original PowerToys can be found here: [Using Windows 95 PowerToys](https://socket3.wordpress.com/2016/10/22/using-windows-95-powertoys/).
## PowerToys roadmap
diff --git a/hub/powertoys/install.md b/hub/powertoys/install.md
index b7912de03d..f7ae3ac1cd 100644
--- a/hub/powertoys/install.md
+++ b/hub/powertoys/install.md
@@ -21,7 +21,7 @@ We recommend installing PowerToys via GitHub or Microsoft Store, but alternative
- Our installer will install the following runtimes:
- [Microsoft Edge WebView2 Runtime](https://go.microsoft.com/fwlink/p/?LinkId=2124703) bootstrapper (this will always install the latest version available)
-To ensure that your machine meets these requirements, check your Windows version and build number by pressing ⊞ Win+R, then type `winver` and press OK. Or enter the `ver` command in Windows Command Prompt. You can [update to the latest Windows version](ms-settings:windowsupdate) in the **Windows Settings**.
+To ensure that your machine meets these requirements, check your Windows version and build number by pressing ⊞ Win+R, then type `winver` and press OK. Or enter the `ver` command in Windows Command Prompt. You can [update to the latest Windows version](ms-settings:windowsupdate) in **Windows Update**.
## Installing with Windows executable file via GitHub
@@ -57,11 +57,11 @@ Here are the common commands you may want:
| Command | Abbreviation | Function |
|----------|--------------| ------------ |
-| **/quiet** | **/q** | Silent install |
-| **/silent** | **/s** | Silent install |
-| **/passive** | | progress bar only install |
-| **/layout** | | create a local image of the bootstrapper |
-| **/log** | **/l** | log to a specific file |
+| /quiet | /q | Silent install |
+| /silent | /s | Silent install |
+| /passive | | progress bar only install |
+| /layout | | create a local image of the bootstrapper |
+| /log | /l | log to a specific file |
### Extracting the MSI from the bundle
@@ -134,4 +134,4 @@ After successfully installing PowerToys, an overview window will display with in
PowerToys uses an auto-updater that checks for new versions when the app is running. If enabled, a toast notification will appear when an update is available. Updates can also be checked for manually from the PowerToys Settings, under the General page.
-
+
diff --git a/hub/powertoys/keyboard-manager.md b/hub/powertoys/keyboard-manager.md
index 488882eb9f..392aac643e 100644
--- a/hub/powertoys/keyboard-manager.md
+++ b/hub/powertoys/keyboard-manager.md
@@ -13,7 +13,7 @@ The PowerToys Keyboard Manager enables you to redefine keys on your keyboard.
For example, you can exchange the letter A for the letter B on your keyboard. When you press the A key, a `B` will be inserted.
-
+
You can exchange shortcut key combinations. For example: The shortcut key Ctrl+C will copy text in many applications. With PowerToys Keyboard Manager utility, you can swap that shortcut for ⊞ Win+C. Now, ⊞ Win+C will copy text. If you do not specify a targeted application in PowerToys Keyboard Manager, the shortcut exchange will be applied globally across Windows.
@@ -22,7 +22,7 @@ Also, you can exchange key or shortcut to arbitrary unicode text sequence. For e
PowerToys Keyboard Manager must be enabled (with PowerToys running in the background) for remapped keys and shortcuts to be applied. If PowerToys is not running, key remapping will no longer be applied.
> [!IMPORTANT]
-> There are some shortcut keys that are reserved for the operating system or cannot be replaced. Keys that cannot be remapped include:
+> There are some shortcut keys that are reserved by the operating system or cannot be replaced. Keys that cannot be remapped include:
>
> - ⊞ Win+L and Ctrl+Alt+Del cannot be remapped as they are reserved by the Windows OS.
> - The Fn (function) key cannot be remapped (in most cases). The F1 ~ F12 (and F13 ~ F24) keys can be mapped.
@@ -31,14 +31,14 @@ PowerToys Keyboard Manager must be enabled (with PowerToys running in the backgr
## Settings
-To create mappings with Keyboard Manager, open the PowerToys Settings. Inside PowerToys Settings, on the Keyboard Manager tab, you will see options to:
+To create mappings with Keyboard Manager, open the PowerToys Settings. In PowerToys Settings, on the Keyboard Manager tab, you will see options to:
-- Launch the Remap Keys settings window by selecting **Remap a key**
-- Launch the Remap Shortcuts settings window by selecting **Remap a shortcut**
+- Open the Remap Keys settings window by selecting **Remap a key**
+- Open the Remap Shortcuts settings window by selecting **Remap a shortcut**
### Remapping keys
-To remap a key, changing it to a new value, launch the Remap Keyboard settings window with **Remap a Key**. When first launched, no predefined mappings will be displayed. Select **╋ Add key remapping** to add a new remap.
+To remap a key, changing it to a new value, open the Remap Keyboard settings window with **Remap a Key**. When first opened, no predefined mappings will be displayed. Select **Add key remapping** to add a new remap.
Once a new remap row appears, select the input key whose output you want to _change_ in the “Select” column. Select the new key, shortcut or text value to assign in the “To send” column.
@@ -54,7 +54,7 @@ To swap key positions between the A and B keys, add anothe
| :--- | :--- |
| `B` | `A` |
-
+
### Remapping a key to a shortcut
@@ -81,9 +81,9 @@ For example, to press the H key and have it result in `Hello!`:
### Remapping shortcuts
-To remap a shortcut key combination, like Ctrl+C, select **Remap a shortcut** to launch the Remap Shortcuts settings window.
+To remap a shortcut key combination, like Ctrl+C, select **Remap a shortcut** to open the Remap Shortcuts settings window.
-When first launched, no predefined mappings will be displayed. Select **+ Add shortcut remapping** to add a new remap.
+When first opened, no predefined mappings will be displayed. Select **Add shortcut remapping** to add a new remap.
Once a new remap row appears, select the input keys whose output you want to _change_ in the “Select” column. Select the new shortcut value to assign in the “To send” column.
@@ -93,7 +93,7 @@ For example, the shortcut Ctrl+C copies selected text. To
| :--- | :--- |
| `Alt` + `C` | `Ctrl` + `C` |
-
+
There are a few rules to follow when remapping shortcuts. These rules only apply to the "Shortcut" column.
@@ -103,12 +103,13 @@ There are a few rules to follow when remapping shortcuts. These rules only apply
#### Shortcuts with chords
-Shortcuts can be created with one or more modifiers and two non-modifier keys. These are called 'chords.' In order to create a chord, you need to use the edit button to open the modal to record the shortcut using the keyboard. Once this is open, you need to toggle on the 'Allow chords' switch. Doing this allows you to enter two non-modifier keys. For example, you can create shortcuts using a chord based on 'V' for **V**olume **U**p and **V**olume **D**own like this:
+Shortcuts can be created with one or more modifiers and two non-modifier keys. These are called "chords". In order to create a chord, select **Edit** to open the dialog to record the shortcut using the keyboard. Once opened, toggle on the **Allow chords** switch. This allows you to enter two non-modifier keys.
+For example, you can create shortcuts using a chord based on 'V' for **V**olume **U**p and **V**olume **D**own like this:
| Select: | To send: |
| :--- | :--- |
-| `Shift`+`Ctrl` + `V` \, `U` | `Volume Up` |
-| `Shift`+`Ctrl` + `V` \, `D` | `Volume Down` |
+| `Shift` + `Ctrl` + `V` , `U` | `Volume Up` |
+| `Shift` + `Ctrl` + `V` , `D` | `Volume Down` |
Chords are handy if you have a number of shortcuts that are similar, and so it makes sense to have them all start with the same non-modifier key.
@@ -187,7 +188,7 @@ Using the drop-down menu, you can search with the key name and additional drop-d
Orphaning a key means that you mapped it to another key and no longer have anything mapped to it. For example, if the key is remapped from `A` to `B`, then a key no longer exists on your keyboard that results in `A`. To ensure this does not happen by accident, a warning will display for any orphaned keys. To fix this, select **╋** to create another remapped key that is mapped to result in `A`.
-
+
## Frequently asked questions
@@ -223,7 +224,7 @@ Currently no. We are not aware of an API where we can see the input and which de
Keyboard Manager lists mappings for all known physical keyboard keys. Some of these mappings may not be available on your keyboard as there may not be a physical key that it corresponds to. For instance: the Start App 1 option shown below is only available on keyboards that physically have a Start App 1 key. Trying to map to and from this key on a keyboard that does not support the Start App 1 key will result in undefined behavior.
-
+
## Troubleshooting
diff --git a/hub/powertoys/mouse-utilities.md b/hub/powertoys/mouse-utilities.md
index a8ecf16105..c8c311689c 100644
--- a/hub/powertoys/mouse-utilities.md
+++ b/hub/powertoys/mouse-utilities.md
@@ -13,9 +13,10 @@ Mouse utilities is a collection of features that enhance mouse and cursor functi
## Find my mouse
-Activate a spotlight that focuses on the cursor's position pressing the Ctrl key twice, using a custom shortcut or shaking the mouse. Click the mouse or press any keyboard key to dismiss it. If you move the mouse while the spotlight is active, the spotlight will dismiss on its own shortly after the mouse stops moving.
+Activate a spotlight that focuses on the cursor's position pressing the Ctrl key twice, using a custom shortcut or shaking the mouse. Click the mouse or press any keyboard key to dismiss it.
+If you move the mouse while the spotlight is active, the spotlight will dismiss on its own shortly after the mouse stops moving.
-
+
### Settings
@@ -41,7 +42,7 @@ Display visual indicators when the left or right mouse buttons are clicked. By d
### Settings
-
+
From the settings page, the following options can be configured:
@@ -58,7 +59,7 @@ From the settings page, the following options can be configured:
## Mouse jump
-
+
Mouse jump allows moving the mouse pointer long distances on a single screen or across multiple screens.
@@ -68,7 +69,7 @@ Mouse jump allows moving the mouse pointer long distances on a single screen or
## Mouse pointer Crosshairs
-
+
Mouse Pointer Crosshairs draws crosshairs centered on the mouse pointer.
diff --git a/hub/powertoys/mouse-without-borders.md b/hub/powertoys/mouse-without-borders.md
index 4422fc8993..31a4f33368 100644
--- a/hub/powertoys/mouse-without-borders.md
+++ b/hub/powertoys/mouse-without-borders.md
@@ -26,19 +26,19 @@ With the latest version of PowerToys installed, you will see Mouse Without Borde
2. On the first computer, select **New Key** to generate a security key for connecting.
- 
+ 
3. On the second computer, enter the security key that was generated on the first computer and the name of the first computer. Then select **Connect**.
- 
+ 
4. Once the computers are connected, you will be able to switch between them by moving your mouse cursor beyond the edge of the screen, transitioning between computers.
- 
+ 
It's possible to switch the order of the devices by dragging the device icon to a new position in the layout.
- 
+ 
### Install Mouse Without Borders as a service
@@ -83,11 +83,12 @@ To enable the service mode, run PowerToys in administrator mode and turn on the
| Show the original Mouse Without Borders UI | Show the original UI from Mouse Without Borders through the original tray icon. Mouse Without Borders needs to be restarted for it to take effect. |
## Status Colors
+
The following colors are used to indicate the connection status to the user when trying to connect to another computer:
| Connection Status | Color | Hex Code |
-| :-----: | :---: | :---: |
-| NA | Dark Grey | `#00717171` |
+| :--- | :--- | :--- |
+| N/A | Dark Grey | `#00717171` |
| Resolving | Yellow | `#FFFFFF00` |
| Connecting | Orange | `#FFFFA500` |
| Handshaking | Blue | `#FF0000FF` |
@@ -98,7 +99,6 @@ The following colors are used to indicate the connection status to the user when
| SendError | Maroon | `#FF800000` |
| Connected | Green | `#FF008000` |
-
## Troubleshooting
If you can't setup the initial connection:
diff --git a/hub/powertoys/paste-as-plain-text.md b/hub/powertoys/paste-as-plain-text.md
index 1d2413589d..4355673a4d 100644
--- a/hub/powertoys/paste-as-plain-text.md
+++ b/hub/powertoys/paste-as-plain-text.md
@@ -11,7 +11,7 @@ no-loc: [PowerToys, Windows, Paste as Plain Text, Win]
PowerToys **Paste as Plain Text** enables you to paste text stored in your clipboard, excluding any text-formatting, using a quick key shortcut. Any formatting included with the clipboard text will be replaced with an unformatted version of the text.
-
+
## Getting started
diff --git a/hub/powertoys/peek.md b/hub/powertoys/peek.md
index 5c7ce3a249..13cabd534f 100644
--- a/hub/powertoys/peek.md
+++ b/hub/powertoys/peek.md
@@ -10,7 +10,7 @@ no-loc: [PowerToys, Windows, Peek, Win]
A system-wide utility for Windows that allows you to preview file content without the need to open multiple applications or interrupt your workflow. It offers a seamless and quick file preview experience for various file types, including images, Office documents, web pages, Markdown files, text files, and developer files.
-
+
## Preview a file
@@ -21,9 +21,7 @@ Using Left and Right or Up and Down,
## Pin preview window position and size
The Peek window adjusts its size based on the dimensions of the images being previewed. However, if you prefer to keep the window's size and position, you can utilize the pinning feature.
-
By selecting the pinning button located in the top right corner of the Peek window, the window will preserve the current size and position.
-
Selecting the pinning button again will unpin the window. When unpinned, the Peek window will return to the default position and size when previewing the next file.
## Open file with the default program
diff --git a/hub/powertoys/powerrename.md b/hub/powertoys/powerrename.md
index 7f6f71512b..9a3b4ac075 100644
--- a/hub/powertoys/powerrename.md
+++ b/hub/powertoys/powerrename.md
@@ -21,13 +21,13 @@ PowerRename is a bulk renaming tool that enables you to:
In this demo, all instances of the file name "foo" are replaced with "foobar". Since all of the files are uniquely named, this would have taken a long time to complete manually one-by-one. PowerRename enables a single bulk rename. Notice that the Explorer's "Undo Rename" (Ctrl+Z) command makes it possible to undo the last change.
-
+
## PowerRename window
After selecting files in Windows File Explorer, right-click and select **Resize with PowerRename** (which will appear only if enabled in PowerToys). The selected items will be displayed, along with search and replace values, a list of options, and a preview pane displaying results of the search and replace values entered.
-
+
### Search for
@@ -35,7 +35,7 @@ Enter text or a [regular expression](https://wikipedia.org/wiki/Regular_expressi
### Replace with
-Enter text to replace the _Search for_ value entered previously. You can view the original file name and renamed file name in the _Preview_ pane.
+Enter text to replace the _Search for_ value entered previously. You can see the original file name and renamed file name in the _Preview_ pane.
### Use regular expressions
@@ -213,7 +213,7 @@ Filters can be used in PowerRename to narrow the results of the rename. Use the
- The default preview will show all selected files, with only files matching the _Search for_ criteria displaying the updated rename value.
- Selecting the _Renamed_ header will toggle the preview to only display files that will be renamed. Other selected files from your original selection will not be visible.
-
+
## Settings
diff --git a/hub/powertoys/registry-preview.md b/hub/powertoys/registry-preview.md
index 2c32c2f449..852d8e5aa2 100644
--- a/hub/powertoys/registry-preview.md
+++ b/hub/powertoys/registry-preview.md
@@ -11,7 +11,7 @@ no-loc: [PowerToys, Windows, Registry Preview, Win]
PowerToys **Registry Preview** simplifies the process of visualizing and editing complex Windows Registry files. It can also write changes to the Windows Registry.
-
+
## Getting started
diff --git a/hub/powertoys/run.md b/hub/powertoys/run.md
index 01cf89f36d..d47b5481ad 100644
--- a/hub/powertoys/run.md
+++ b/hub/powertoys/run.md
@@ -16,7 +16,7 @@ To use PowerToys Run, select Alt+Space and start typing! _
> [!IMPORTANT]
> PowerToys must be running in the background and Run must be enabled for this utility to work.
-
+
## Features
@@ -47,20 +47,21 @@ The following general options are available on the PowerToys Run settings page.
| Immediate plugins | How many milliseconds a plugin that makes the UI wait should wait before showing results |
| Background execution plugins | How many milliseconds a plugin that executes in the background should wait before showing results |
| Maximum number of results before scrolling | Maximum number of results shown without scrolling |
-| Clear the previous query on launch | When launched, previous searches will not be highlighted |
+| Clear the previous query on launch | When opened, previous searches will not be highlighted |
| Results order tuning | Fine tunes the ordering of the displayed results |
| Selected item weight | Use a higher number to get selected results to rise faster (Default: 5, 0 to disable) |
| Wait for slower plugin results before selecting top item in results | Selecting this can help preselect the top, more relevant result, but at the risk of jumpiness |
| Tab through context buttons | When enabled, you can tab through the context buttons before tabbing to the next result |
| Generate thumbnails for files | When enabled, thumbnails will be generated for files in the results list (Disabling this can increase speed and stability) |
-| Preferred monitor position | If multiple displays are in use, PowerToys Run can be launched on:
• Primary display
• Display with mouse cursor
• Display with focused window |
+| Preferred monitor position | If multiple displays are in use, PowerToys Run can be opened on:
• Primary display
• Display with mouse cursor
• Display with focused window |
| App theme | Change the color theme used by PowerToys Run |
### Plugin manager
-PowerToys Run uses a plugin system to provide different types of results. The settings page includes a plugin manager that allows you to enable/disable the various available plugins. By selecting and expanding the sections, you can customize the direct activation commands used by each plugin. In addition, you can select whether a plugin appears in global results and set additional plugin options where available.
+PowerToys Run uses a plugin system to provide different types of results. The settings page includes a plugin manager that allows you to enable/disable the various available plugins.
+By selecting and expanding the sections, you can customize the direct activation commands used by each plugin. In addition, you can select whether a plugin appears in global results and set additional plugin options where available.
-
+
#### Direct activation commands
@@ -91,10 +92,10 @@ The plugins can be activated with a direct activation command so that PowerToys
| [Time and date](#time-and-date-plugin) | `)` | `) time and date` shows the current time and date in different formats.
`) calendar week::04/01/2022` shows the calendar week for the date '04/01/2022'. |
| [Unit converter](#unit-converter-plugin) | `%%` | `%% 10 ft in m` to calculate the number of meters in 10 feet. |
| [Value Generator](#value-generator-plugin) | `#` | `# guid3 ns:URL www.microsoft.com` to generate the GUIDv3 for the URL namespace using the URL namespace.
`# sha1 abc` to calculate the SHA1 hash for the string 'abc'.
`# base64 abc` to encode the string 'abc' to base64. |
-| URI-handler | `//` | `//` to launch your default browser.
`// learn.microsoft.com` to have your default browser go to Microsoft Learn.
`mailto:` and `ms-settings:` links are supported. |
+| URI-handler | `//` | `//` to open your default browser.
`// learn.microsoft.com` to have your default browser go to Microsoft Learn.
`mailto:` and `ms-settings:` links are supported. |
| Visual Studio Code | `{` | `{ powertoys` to search for previously opened workspaces, remote machines and containers that contain 'powertoys' in their paths. |
-| Web search | `??` | `??` to launch your default browser's search page.
`?? What is the answer to life` to search with your default browser's search engine. |
-| [Windows settings](#windows-settings-plugin) | `$` | `$ Add/Remove Programs` to launch the Windows settings page for managing installed programs.
`$ Device:` to list all settings with 'device' in their area/category name.
`$ control>system>admin` shows all settings of the path 'Control Panel > System and Security > Administrative Tools'. |
+| Web search | `??` | `??` to open your default browser's search page.
`?? What is the answer to life` to search with your default browser's search engine. |
+| [Windows settings](#windows-settings-plugin) | `$` | `$ Add/Remove Programs` to open the Windows settings page for managing installed programs.
`$ Device:` to list all settings with 'device' in their area/category name.
`$ control>system>admin` shows all settings of the path 'Control Panel > System and Security > Administrative Tools'. |
| Windows Terminal profiles | `_` | `_ powershell` to list all profiles that contains 'powershell' in their name. |
| [Window Walker](#window-walker-plugin) | `<` | `< outlook` to find all open windows that contain 'outlook' in their name or the name of their process. |
@@ -136,11 +137,12 @@ _*) This command may take some time to provide the results._
### Program plugin
-The **Program** plugin can launch software applications (such as Win32 or packaged programs). The plugin works by scanning common install locations, like the start menu and desktops that you have access to, looking for executable files (.exe) or shortcut files (such as `.lnk` or `.url`). On occasion, a program may not be found by the program plugin scan and you may want to manually create a shortcut in the directory containing the program you want to access.
+The **Program** plugin can open software applications (such as Win32 or packaged programs). The plugin works by scanning common install locations, like the start menu and desktops that you have access to, looking for executable files (.exe) or shortcut files (such as .lnk or .url).
+On occasion, a program may not be found by the program plugin scan and you may want to manually create a shortcut in the directory containing the program you want to access.
#### Program parameters
-The Program plugin allows for program arguments to be added when launching an application. The program arguments must follow the expected format as defined by the program's command line interface.
+The Program plugin allows for program arguments to be added when opening an application. The program arguments must follow the expected format as defined by the program's command line interface.
> [!NOTE]
> To input valid search queries, the first element after the program name has to be one of the following possibilities:
@@ -150,7 +152,7 @@ The Program plugin allows for program arguments to be added when launching an ap
> - A parameter that starts with `--`.
> - A parameter that starts with `/`.
-For example, when launching Visual Studio Code, you can specify the folder to be opened with:
+For example, when opening Visual Studio Code, specify the folder to be opened with:
`Visual Studio Code -- C:\myFolder`
@@ -166,7 +168,7 @@ If the program plugin's option "Include in global result" is not selected, inclu
> [!IMPORTANT]
> Please be aware of the different decimal and thousand delimiters in different locals.
-> The Calculator plugin respects the number format settings of your system. If you prefer the English (United States) number format, you can change the behavior for the query input and the result output in the [plugin manager](#plugin-manager).
+> The Calculator plugin respects the number format settings of your system. If you prefer the English (United States) number format, change the behavior for the query input and the result output in the [plugin manager](#plugin-manager).
> If your system's number format uses the comma (`,`) as the decimal delimiter, you have to write a space between the number(s) and comma(s) on operations with multiple parameters. The input has to look like this: `min( 1,2 , 3 , 5,7)` or `min( 1.2 , 3 , 5.7)`.
> [!TIP]
@@ -360,9 +362,9 @@ In the Folder plugin you can filter the results by using some special characters
| Character sequence | Result | Example |
| :--- | :--- | :--- |
-| `>` | Search inside the folder. | `C:\Users\tom\Documents\>` |
-| `*` | Search files by mask. | `C:\Users\tom\Documents\*.doc` |
-| `>*` | Search files inside the folder by mask. | `C:\Users\tom\Documents\>*.doc` |
+| `>` | Search inside the folder | `C:\Users\tom\Documents\>` |
+| `*` | Search files by mask | `C:\Users\tom\Documents\*.doc` |
+| `>*` | Search files inside the folder by mask | `C:\Users\tom\Documents\>*.doc` |
### Windows Settings plugin
@@ -371,7 +373,7 @@ The Windows Settings plugin allows you to search for Windows settings. You can s
To search by location you can use the following syntax:
- `$ device:` to list all settings with 'device' in the area name.
-- `$ control>system>admin` shows all settings of the path Control Panel > System and Security > Administrative Tools.
+- `$ control>system>admin` to show all settings of the path Control Panel > System and Security > Administrative Tools.
### Service plugin
@@ -405,33 +407,33 @@ With the Window Walker plugin you can kill the process of a window if it stops r
If the File Explorer settings in Windows are not set to open each window in a separate process, you will see the following message when searching for open Explorer windows:
-
+
You can turn off the message in the PowerToys Run plugin manager options for Window Walker, or select the message to change the File Explorer settings. On the **Folder options** window, select **Launch folder windows in a separate process**.
-
+
### Windows Search plugin
-With the Windows Search plugin you can search for files and folders that are index by the `Windows Search Index` service.
+With the Windows Search plugin you can search for files and folders that are index by the **Windows Search Index** service.
#### Windows Search settings
If the indexing settings for Windows Search are not set to cover all drives, you will see the following warning when using the Windows Search plugin:
-
+
-You can turn off the warning in the PowerToys Run plugin manager options for Windows Search, or select the warning to expand which drives are being indexed. After selecting the warning, the Windows settings page with the "Searching Windows" options will open.
+You can turn off the warning in the PowerToys Run plugin manager options for Windows Search, or select the warning to expand which drives are being indexed. After selecting the warning, the Windows settings page **Searching Windows** will open.
-
+
-On the "Searching Windows" page, you can:
+On the **Searching Windows** page, you can:
- Select **Enhanced** mode to enable indexing across all of the drives on your Windows machine.
- Specify folder paths to exclude.
-- Select the **Advanced Search Indexer Settings** (near the bottom of the menu options) to set advanced index settings, add or remove search locations, index encrypted files, etc.
+- Select **Advanced Search Indexer Settings** to set advanced index settings, add or remove search locations, index encrypted files, etc.
-
+
## Known issues
diff --git a/hub/powertoys/screen-ruler.md b/hub/powertoys/screen-ruler.md
index 16bb0ce3a4..cd1b29eb01 100644
--- a/hub/powertoys/screen-ruler.md
+++ b/hub/powertoys/screen-ruler.md
@@ -14,14 +14,14 @@ Screen ruler allows you to quickly measure pixels on your screen based on image
## How to activate
-Press ⊞ Win+Shift+M to activate and then select which tool you want to measure with. To exit, press Esc or click ╳ in the toolbar.
+Press ⊞ Win+Shift+M to activate and then select which tool you want to measure with. To exit, press Esc or select ╳ in the toolbar.
## How to use
-- Bounds (Dashed square symbol): This is a bounding box. Click and drag with your mouse. If you hold Shift, the box(es) will stay in place until you cancel the interaction.
-- Spacing (╋): This will measure horizontal and vertical spacing at the same time. Click the symbol and move your mouse to your target location.
-- Horizontal (━): This will measure only horizontal spacing. Click the symbol and move your mouse pointer to your target location.
-- Vertical (┃): This will measure only vertical spacing. Click the symbol and move your mouse pointer to your target location.
+- Bounds (dashed square symbol): This is a bounding box. Click and drag with your mouse. If you hold Shift, the box(es) will stay in place until you cancel the interaction.
+- Spacing (╋): This will measure horizontal and vertical spacing at the same time. Select the symbol and move your mouse to your target location.
+- Horizontal (━): This will measure only horizontal spacing. Select the symbol and move your mouse pointer to your target location.
+- Vertical (┃): This will measure only vertical spacing. Select the symbol and move your mouse pointer to your target location.
- Cancel interaction: Esc, ╳ or mouse click. Upon clicking the primary mouse button, the measurement is copied to the clipboard.
The controls on the toolbar can also be selected via Ctrl+1/2/3/4.
diff --git a/hub/powertoys/shortcut-guide.md b/hub/powertoys/shortcut-guide.md
index f46aa44609..83475dc47d 100644
--- a/hub/powertoys/shortcut-guide.md
+++ b/hub/powertoys/shortcut-guide.md
@@ -19,7 +19,7 @@ Open the shortcut guide with the shortcut key combination: ⊞ Win+⊞ Win can be used while the guide is displayed. The result of those shortcuts (active window moved, arrow shortcut behavior changes etc.) will be displayed in the guide.
@@ -37,10 +37,10 @@ These configurations can be edited from the PowerToys Settings:
| Setting | Description |
| :--- | :--- |
| Activation method | Choose your own shortcut or use the ⊞ Win key |
-| Activation shortcut | The custom shortcut used to launch the shortcut guide |
+| Activation shortcut | The custom shortcut used to open the shortcut guide |
| Press duration | Time (in milliseconds) to hold down the ⊞ Win key in order to open global Windows shortcuts or taskbar icon shortcuts |
| App theme | Light, dark or Windows theme |
| Opacity of background | Opacity of the Shortcut Guide overlay |
| Excluded apps | Ignores Shortcut Guide when these apps are in focus. Add an application's name, or part of the name, one per line (e.g. adding `Notepad` will match both `Notepad.exe` and `Notepad++.exe`; to match only `Notepad.exe` add the `.exe` extension). |
-
+
diff --git a/hub/powertoys/text-extractor.md b/hub/powertoys/text-extractor.md
index a931e21a8a..8ee175366b 100644
--- a/hub/powertoys/text-extractor.md
+++ b/hub/powertoys/text-extractor.md
@@ -16,7 +16,7 @@ With the activation shortcut (default: ⊞ Win+Shift+
## How to deactivate
-Capture mode is deactivated immediately after text in the selected region is recognized and copied to the clipboard. You can exit capture mode by pressing Esc at any moment.
+Capture mode is deactivated immediately after text in the selected region is recognized and copied to the clipboard. Exit capture mode with Esc at any moment.
## Adjust while trying to capture
@@ -26,7 +26,7 @@ By holding Shift, you will change from adjusting the capture region's
>
> 1. The produced text may not be perfect, so you have to do a quick proof read of the output.
> 2. This tool uses OCR (Optical Character Recognition) to read text on the screen.
-> 3. The default language used will be based on your [Windows system language > keyboard settings](https://support.microsoft.com/windows/manage-the-input-and-display-language-settings-in-windows-12a10cb4-8626-9b77-0ccb-5013e0c7c7a2) (OCR language packs are available for install).
+> 3. The default language used will be based on your [Windows system language > Keyboard settings](https://support.microsoft.com/windows/manage-the-input-and-display-language-settings-in-windows-12a10cb4-8626-9b77-0ccb-5013e0c7c7a2). OCR language packs are available for installation.
## Settings
@@ -107,7 +107,7 @@ $Capability | Remove-WindowsCapability -Online
This section will list possible errors and solutions.
-### "No Possible OCR languages are installed."
+### "No Possible OCR languages are installed"
This message is shown when there are no available languages for recognition.
diff --git a/hub/powertoys/video-conference-mute.md b/hub/powertoys/video-conference-mute.md
index 55b7f680f4..b28f2ddca7 100644
--- a/hub/powertoys/video-conference-mute.md
+++ b/hub/powertoys/video-conference-mute.md
@@ -10,7 +10,7 @@ no-loc: [PowerToys, Windows, File Explorer, Video Conference Mute, Shift]
# Video Conference Mute
> [!NOTE]
-> VCM is moving into legacy mode. Please find more about what this means [in our dedicated discussion issue](https://github.com/microsoft/PowerToys/issues/21473).
+> VCM is moving into legacy mode. Please find more about what this means [in our dedicated issue](https://github.com/microsoft/PowerToys/issues/21473).
Quickly mute your microphone (audio) and turn off your camera (video) with a single keystroke while on a conference call, regardless of what application has focus on your computer.
@@ -23,13 +23,13 @@ The default shortcuts to use Video Conference Mute are:
- ⊞ Win+Shift+I to toggle microphone until key release
- ⊞ Win+Shift+O to toggle camera
-When using the microphone and/or camera toggle shortcut keys, you will see a small toolbar letting you know whether your microphone and camera are set to on, off, or not in use. You can set the position of this toolbar in the Video Conference Mute tab of PowerToys settings.
+When using the microphone and/or camera toggle shortcut keys, you'll see a small toolbar letting you know whether your microphone and camera are set to on, off, or not in use. Set the position of this toolbar in the Video Conference Mute tab of PowerToys settings.
-
+
To use this module, it must be selected as the _source_ in the apps that are using camera and/or microphone. Go to the settings and select PowerToys VCM.
-
+
## Settings
@@ -46,7 +46,7 @@ The Video Conference Mute page in Settings provides the following options:
| Show toolbar on | Select whether you prefer the toolbar to be displayed on the main monitor only (default) or on all monitors. |
| Hide toolbar when both camera and microphone are unmuted | |
-
+
## How this works under the hood