Since version 0.80, the PowerToys installer has been released on GitHub with Microsoft.PowerToys.ConfigureDSC resource that allows you to configure PowerToys using a Winget configuration file.
Installation
Prerequisites
PSDesiredStateConfiguration 2.0.7 or later: Refer to the PowerShell DSC documentation for installation instructions.
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 in the PowerToys repo.
Available Configuration Settings by Module
AlwaysOnTop
Name
Type
Description
Available
Enabled
Boolean
The enabled state for this utility.
✅
Hotkey
KeyboardKeys
Customize the shortcut to pin or unpin an app 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
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
Boolean
Enable round corners.
✅
Awake
Name
Type
Description
Available
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.
✅
ColorPicker
Name
Type
Description
Available
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.
✅
VisibleColorFormats
—
—
❌
ShowColorName
Boolean
This will show the name of the color when picking a color.
✅
Note
Configuring custom color formats through DSC is not yet supported.
CropAndLock
Name
Type
Description
Available
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.
✅
EnvironmentVariables
Name
Type
Description
Available
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
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
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 current 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
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
Boolean
Use system theme for zone appearance.
✅
FancyzonesShowZoneNumber
Boolean
Show zone number.
✅
Note
Configuring layouts through DSC is not yet supported.
FileLocksmith
Name
Type
Description
Available
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
Boolean
The enabled state for this utility.
✅
ActivationMethod
Int
Activation method index.
✅
ActivationShortcut
HotkeySettings
Custom activation shortcut when using Custom for ActivationMethod.
✅
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.
✅
SpotlightRadius
Int
Spotlight radius in px.
✅
AnimationDurationMs
Int
Animation duration in milliseconds.
✅
SpotlightInitialZoom
Int
Spotlight zoom factor at animation start.
✅
ExcludedApps
String
'\r'-separated list of executable names to prevent module activation.
✅
ShakingMinimumDistance
Int
When using shake mouse ActivationMethod, the minimum distance for mouse shaking activation, for adjusting sensitivity.
✅
ShakingIntervalMs
Int
When using shake mouse ActivationMethod, the span of time during which we track mouse movement to detect shaking, for adjusting sensitivity.
✅
ShakingFactor
Int
When using shake mouse ActivationMethod, Shake factor in percentage.
✅
Hosts
Name
Type
Description
Available
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.
✅
Encoding
HostsEncoding
Possible values: Utf8, Utf8Bom.
✅
ImageResizer
Name
Type
Description
Available
Enabled
Boolean
The enabled state for this utility.
✅
ImageresizerSelectedSizeIndex
Int
Default size preset index.
✅
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
Boolean
Remove metadata that doesn't affect rendering.
✅
ImageresizerFallbackEncoder
String
Fallback encoder to use.
✅
ImageresizerCustomSize
—
—
❌
Note
Configuring custom sizes through DSC is not yet supported.
KeyboardManager
Name
Type
Description
Available
Enabled
Boolean
The enabled state for this utility.
✅
ActiveConfiguration
—
—
❌
KeyboardConfigurations
—
—
❌
Note
Configuring remappings through DSC is not yet supported.
MeasureTool
Measure Tool is the internal name for Screen Ruler.
Name
Type
Description
Available
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.
✅
PerColorChannelEdgeDetection
Boolean
Enable a different edge detection algorithm.
✅
PixelTolerance
Int
Pixel Tolerance for edge detection.
✅
MeasureCrossColor
String
Line color in #FFFFFFFF format.
✅
DefaultMeasureStyle
Int
Default measure style index.
✅
MouseHighlighter
Name
Type
Description
Available
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.
✅
AlwaysColor
String
Always highlight color in #FFFFFFFF format.
✅
HighlightRadius
Int
Highlight radius in pixels.
✅
HighlightFadeDelayMs
Int
Fade delay in milliseconds.
✅
HighlightFadeDurationMs
Int
Fade duration in milliseconds.
✅
AutoActivate
Boolean
Automatically activate on utility startup.
✅
MouseJump
Name
Type
Description
Available
Enabled
Boolean
The enabled state for this utility.
✅
ActivationShortcut
HotkeySettings
Customize the shortcut to turn on or off this mode.
✅
ThumbnailSize
MouseJumpThumbnailSize
Thumbnail size.
✅
MousePointerCrosshairs
Name
Type
Description
Available
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.
✅
CrosshairsRadius
Int
Crosshairs center radius in pixels.
✅
CrosshairsThickness
Int
Crosshairs thickness in pixels.
✅
CrosshairsBorderColor
String
Crosshairs border color in #FFFFFFFF format.
✅
CrosshairsBorderSize
Int
Crosshairs border size in pixels.
✅
CrosshairsAutoHide
Boolean
Automatically hide crosshairs when the mouse pointer is hidden.
✅
CrosshairsIsFixedLengthEnabled
Boolean
Fix crosshairs length.
✅
CrosshairsFixedLength
Int
Crosshairs fixed length in pixels.
✅
AutoActivate
Boolean
Automatically activate on utility startup.
✅
MouseWithoutBorders
Name
Type
Description
Available
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.
✅
TransferFile
Boolean
If a file (<100MB) is copied, it will be transferred to the remote machine clipboard.
✅
HideMouseAtScreenEdge
Boolean
Hide mouse at the screen edge.
✅
DrawMouseCursor
Boolean
Mouse cursor may not be visible in Windows 10 and later versions of Windows when there is no physical mouse attached.
✅
ValidateRemoteMachineIP
Boolean
Reverse DNS lookup to validate machine IP Address.
✅
SameSubnetOnly
Boolean
Only connect to machines in the same intranet NNN.NNN.. (only works when both machines have IPv4 enabled).
✅
BlockScreenSaverOnOtherMachines
Boolean
Block screen saver on other machines.
✅
MoveMouseRelatively
Boolean
Use this option when remote machine's monitor settings are different, or remote machine has multiple monitors.
✅
BlockMouseAtScreenCorners
Boolean
Block mouse at screen corners to avoid accident machine-switch at screen corners.
✅
ShowClipboardAndNetworkStatusMessages
Boolean
Show clipboard and network status messages.
✅
EasyMouse
Int
Easy Mouse mode index.
✅
HotKeySwitchMachine
Int
Shortcut to switch between machines index.
✅
ToggleEasyMouseShortcut
HotkeySettings
Shortcut to toggle Easy Mouse.
✅
LockMachineShortcut
HotkeySettings
Shortcut to lock all machines.
✅
ReconnectShortcut
HotkeySettings
Shortcut to try reconnecting.
✅
Switch2AllPCShortcut
HotkeySettings
Shortcut to switch to multiple machine mode.
✅
Name2IP
String
IP address mapping.
✅
PastePlain
Name
Type
Description
Available
Enabled
Boolean
The enabled state for this utility.
✅
ActivationShortcut
HotkeySettings
Customize the shortcut to activate this module.
✅
Peek
Name
Type
Description
Available
Enabled
Boolean
The enabled state for this utility.
✅
ActivationShortcut
HotkeySettings
Customize the shortcut to activate this module.
✅
AlwaysRunNotElevated
Boolean
Always run not elevated, even when PowerToys is elevated.
✅
CloseAfterLosingFocus
Boolean
Automatically close the Peek window after it loses focus.
✅
PowerAccent
PowerAccent is the internal name for Quick Accent.
Name
Type
Description
Available
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.
✅
InputTime
Int
Input time delay in milliseconds.
✅
SelectedLang
String
A character set to use.
✅
ExcludedApps
String
'\r'-separated list of executable names to prevent module activation if they're in a foreground.
✅
ShowUnicodeDescription
Boolean
Show the Unicode code and name of the currently selected character.
✅
SortByUsageFrequency
Boolean
Sort characters by usage frequency.
✅
StartSelectionFromTheLeft
Boolean
Start selection from the left.
✅
PowerLauncher
PowerLaucher is the internal name for PowerToys Run.
Name
Type
Description
Available
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 open.
✅
TabSelectsContextButtons
Boolean
Tab through context buttons.
✅
Theme
Theme
Possible values: System, Light, Dark, HighContrastOne, HighContrastTwo, HighContrastBlack, HighContrastWhite.
✅
TitleFontSize
Int32
Text size in points.
✅
Position
StartupPosition
Possible values: Cursor, PrimaryMonitor, Focus.
✅
UseCentralizedKeyboardHook
Boolean
Use centralized keyboard hook.
✅
SearchQueryResultsWithDelay
Boolean
Input Smoothing.
✅
SearchInputDelay
Int32
Immediate plugins delay in milliseconds.
✅
SearchInputDelayFast
Int32
Background execution plugins delay in milliseconds.
✅
SearchClickedItemWeight
Int32
Selected item weight.
✅
SearchQueryTuningEnabled
Boolean
Results order tuning.
✅
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
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.
These are the available properties to configure each plugin:
Name
Type
Description
Name
String
Name of the plugin we want to configure
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 through DSC is not yet supported.
PowerOcr
PowerOcr is the internal name for Text Extractor.
Name
Type
Description
Available
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)".
Enable auto-complete for the search & replace fields.
✅
MaxMRUSize
Int
Maximum number of recently used items to remember.
✅
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
Boolean
The enabled state for this utility.
✅
DefaultRegApp
Boolean
Make Registry Preview default app for opening .reg files.
✅
ShortcutGuide
Name
Type
Description
Available
Enabled
Boolean
The enabled state for this utility.
✅
OpenShortcutGuide
HotkeySettings
Customize the shortcut to activate this module.
✅
OverlayOpacity
Int
Background opacity in percentage.
✅
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.
✅
DisabledApps
String
Turns off Shortcut Guide when these applications have focus.
✅
VideoConference
Name
Type
Description
Available
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
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].
✅
ToolbarPosition
String
Toolbar position option: "Top center", "Bottom center", "Top right corner", "Top left corner", "Bottom right corner", "Bottom left corner".
✅
ToolbarMonitor
String
Toolbar monitor option: "Main monitor", "All monitors".
✅
CameraOverlayImagePath
String
Path to the image used for the camera overlay.
✅
ToolbarHide
String
When to hide the toolbar: "Never", "When both camera and microphone are unmuted", "When both camera and microphone are muted", "After timeout".
✅
StartupAction
String
Startup action: "Nothing", "Unmute", "Mute".
✅
GeneralSettings
Name
Type
Description
Available
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
Opt-in into experimental features.
✅
Contributing
Refer to the relevant devdocs section in the developer documentation to start working on the DSC module.
Collaborate with us on GitHub
The source for this content can be found on GitHub, where you can also create and review issues and pull requests. For more information, see our contributor guide.
Windows developer feedback
Windows developer is an open source project. Select a link to provide feedback: