PowerToys/README.md

Microsoft PowerToys

How to use PowerToys | Downloads & Release notes | Contributing to PowerToys | What's Happening | Roadmap

Build status

Architecture	Solution (Main)	Solution (Stable)	Installer (Main) Existing pipeline	Installer (Main) New pipeline
x64
ARM64	Currently investigating	Issue #490

About

Microsoft PowerToys is a set of utilities for power users to tune and streamline their Windows experience for greater productivity. For more info on PowerToys overviews and how to use the utilities, or any other tools and resources for Windows development environments, head over to docs.microsoft.com!

	Current utilities:
PowerToys Awake	Color Picker	FancyZones
File Explorer Add-ons	Image Resizer	Keyboard Manager
Mouse utilities	PowerRename	PowerToys Run
Shortcut Guide	Video Conference Mute

Installing and running Microsoft PowerToys

Requirements

• Windows 11 or Windows 10 v1903 (18362) or newer.
• .NET Core 3.1.20 Desktop Runtime or a newer 3.1.x runtime. The installer will handle this if not present.

Via GitHub with EXE [Recommended]

Microsoft PowerToys GitHub releases page, click on Assets at the bottom to show the files available in the release and then click on PowerToysSetup-0.51.1-x64.exe to download the PowerToys installer.

This is our preferred method.

Via Microsoft Store

Install from the Microsoft Store's PowerToys page. You must be using the new Microsoft Store which will be available for both Windows 11 and Windows 10.

Via WinGet (Preview)

Download PowerToys from WinGet. To install PowerToys, run the following command from the command line / PowerShell:

winget install Microsoft.PowerToys -s winget

Other install methods

There are community driven install methods such as Chocolatey and Scoop. If these are your preferred install solutions, this will have the install instructions.

Contributing

This project welcomes contributions of all types. Help spec'ing, design, documentation, finding bugs are ways everyone can help on top of coding features / bug fixes. We are excited to work with the power user community to build a set of tools for helping you get the most out of Windows.

We ask that before you start work on a feature that you would like to contribute, please read our Contributor's Guide. We will be happy to work with you to figure out the best approach, provide guidance and mentorship throughout feature development, and help avoid any wasted or duplicate effort.

Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution.

For guidance on developing for PowerToys, please read the developer docs for a detailed breakdown. This includes how to setup your computer to compile.

What's Happening

PowerToys Roadmap

Our prioritized roadmap of features and utilities that the core team is focusing on.

0.51 - November 2021 Update

The v0.51 release cycle introduces some new things regarding our mouse utilities. First is we've added in a presentation mode helper to highlight your mouse when you click. We've also added additional settings toward Find my mouse to enable more customization.

Next we've been focusing work on "Always on Top" system to help make any window you want to be the top most. A lot of thought is currently going into interaction models to make sure it 'feels' right for toggling as well as visualizing.

Last, we've been working on our engineering systems this month and into next. This work will improve our localization integration and our 'build farm' match our CI system far more. Behind the scene work but very important work for working faster.

Highlights from v0.51

Things to note

• We shifted our localization internal service and are working on adding automated integrations back in.

PowerToys Awake

• System tray and settings use same language for turning things on.

Color Picker

• New formats added to copy colors as a float or decimal value.
• Adjust color window now accepts lower-case HEX codes.

FancyZones

• New window switching functionality! Now users can assign multiple windows to a zone and cycle between them using the Win + PgDn/PgUp commands by default. Thanks @FLOAT4!
• Added functionality for zones to adopt system accent color and theme. Thanks @davidegiacometti!
• Added visual preview of zone appearance in settings menu. Thanks @niels9001!
• Fixed bug where FancyZones crashes on launch.

Image Resizer

• Fixed bug where resizing images creates empty folders.
• Added option to remove non-essential metadata. Helps significantly reduce the size of files. Thanks @CleanCodeDeveloper!
• Fixed bug caused by Image Resizer receiving an unexpected property type or value. Thanks @CleanCodeDeveloper!

Mouse utilities

• Find My Mouse: Improved functionality to activate when user double click time configuration is set above 100ms.
• Find My Mouse: Fixed display on all virtual desktops as opposed to only the virtual desktop where it was created.
• Find My Mouse: New settings to enable a lot more customization based on your feedback.
• Minor UI tweaks for fluent icons, appearance, Ctrl usage, and utility descriptions. Thanks @niels9001!
• New Mouse Highlighter PowerToy! When enabled, activate mouse highlighting with Win + Shift + H by default to begin displaying visual cues on your display when either the left or right mouse buttons are clicked. There is a much more powerful tool called SysInternal ZoomIt that is very helpful as well.

PowerRename

• Improved rename performance! This is now at parity (or better) with the prior version based on multiple tests.
• Added keyboard accelerators with Enter and Ctrl + Enter to execute rename. Thanks @niels9001!
• UI tweaks to now add number of items selected, grid-lines for improved readability, reduced font sizes & margins, and improved window resizing.
• Fixed UI focus issues. Thanks @niels9001!
• Added default window width and height. Thanks @niels9001!
• Added PowerRename event logging for BugReportTool

PowerToys Run

• New entries added for settings plugin. Thanks @htcfreek!
• Added support for application URI handling like mailto: and ms-settings:. Thanks @franky920920!
• Added DevContainer workspaces to search results of the VSCode Workspaces Plugin. Thanks @JacobDeuchert!
• Fixes for crashing issues.

Shortcut Guide

• Added rounded corners to keys and tooltips, and system accent colors for desktop backdrop. Thanks @niels9001!

Settings

• Fixed default settings window size to prevent it from opening offscreen. Thanks @davidegiacometti!

Video Conference Mute

• Minor UI tweaks for icon, clear button, and overlay image selection #14248. Thanks @niels9001!

Prototype work

• Always on top prototype of being actively worked on. Right now you hit a key-combo and it enables it. We are investigating ways to highlight the window in some form as well.

Installer

• Investigated how to fully shift to WIX bootstrapper and remove custom boot strapper
• Investigated how to fully shift to HKCU vs HKLM.

Random helping out

• Spell check fix - Thanks @franky920920!
• Fix a URL - Thanks @JeffersonQin!

Development relevant

• Focusing on cleaning up backlog of issues and developing a method to aid in prioritizing. @Dend and @crutkas are partnering to see if we can develop one signal to see what we are calling 'centers of gravity'.
• Our primary dev branch is now named Main.
• Adjusting plugin folder structure for PT Run #10796
• Working on shifting our release pipeline onto same system that Windows Terminal uses.
• Improvements to environment variable usage/update process in PT Run. Thanks @htcfreek!
• Update .NET to 3.1.20.
• Centralized process list in the BugReportTool.
• Registry handling improvement for MSI and File Explorer add-ons.

Community contributions

We'd like to directly mention certain contributors (in alphabetical order) for their continued community support this month and helping directly make PowerToys a better piece of software.

@AnonymousWP, @Aaron-Junker, @CleanCodeDeveloper, @davidegiacometti, @FLOAT4, @franky920920, @htcfreek, @JacobDeuchert, @Jay-o-Way @JeffersonQin, @niels9001, and @rdeveen.

What is being planned for v0.53

For v0.53, due to holidays, we'll be in a maintenance sprint but here are some of the larger items:

• Hope to add Always on Top into PowerToys. We currently have a proof of concept ready.
• We are working to heavily reduce / remove the UAC prompt over the next few releases on install. This is a big shift so it is spanning multiple releases so we can isolate issues if they do occur. Work is tracked in #10126
• Update the PowerToys Build Pipeline to allow .NET 6 integration
• Engineering Systems/Stability/Bug fixes

PowerToys Community

The PowerToys team is extremely grateful to have the support of an amazing active community. The work you do is incredibly important. PowerToys wouldn’t be nearly what it is today without your help filing bugs, updating documentation, guiding the design, or writing features. We want to say thank you and take time to recognize your work.

Code of Conduct

This project has adopted the Microsoft Open Source Code of Conduct.

Privacy Statement

The application logs basic telemetry. Our Telemetry Data page (Coming Soon) has the trends from the telemetry. Please read the Microsoft privacy statement for more information.