PowerToys/README.md

Microsoft PowerToys

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

Build status

Architecture	Master	Stable	Installer
x64

About

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

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

Installing and running Microsoft PowerToys

Requirements

• Windows 10 v1903 (build 18362) or better preferred, Windows 10 v1803 (build 17134) minimum.
• Have .NET Core 3.1 Desktop Runtime. The installer should handle this but we want to directly make people aware.

Via GitHub with EXE [Recommended]

Stable version

Install from the Microsoft PowerToys GitHub releases page. Click on Assets to show the files available in the release and then click on PowerToysSetup-0.31.1-x64.exe to download the PowerToys installer.

This is our preferred method.

Experimental version

To install the Video Conference mute, please use the v0.28 pre-release experimental version of PowerToys to try out this version. It includes all improvements from v0.27 in addition to the Video conference utility. Click on Assets to show the files available in the release and then download the .exe installer.

We hope to have an updated version in February 2021 with the new DirectShow driver.

Via WinGet (Preview)

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

WinGet install powertoys

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.

Processor support

We currently support the matrix below.

x64	x86	ARM64
Supported	Issue #602	Issue #490

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.31 - January 2021 Update

Our goals for v0.31 release cycle were to focus on improving the FancyZones editor, adding in some new features into PowerToys Run, some ARM64 work, and stability.

Our prioritized roadmap of features and utilities that the core team is focusing on for the near future. We fixed a lot of localization issues from our initial release but we may not still be perfect. If you find an issue, please file a localization bug.

Highlights from v0.31

General

• Bug report tool and improved logging now added to our system tray.
• Added in CodeQL and other CI improvements.
• OOBE Spec should be finalized

ARM64 Progress

• .NET Core upgrade for code bases the PowerToys team controls is complete. We still have two external dependencies that are .NET Framework that need to be updated.

Color Picker

• Bug fixes in editor

FancyZones

• Streamlined, simplified user interface (Massive thanks to @niels9001)
• Dark mode for the editor
• Certain settings (e.g. number of zones, spacing settings) can now be set on individual layouts.
• Bug fixes

File explorer

• Fixed a bug with SVG preview on OneDrive folders
• SVG are scaled appropriately when viewbox is provided
• SVG thumbnail quality improved

PowerToys Run

• Service management plugin (restart, stop, ...)
• Registry key plugin
• System action plugin (reboot, lock, ...)
• Hyperbolic functions added to calculator
• Icon fixes when running in certain themes
• Unneeded dependencies removed
• Bug fixes

Installer

• Default to .NET Core 3.1.11

Community contributions

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

@Aaron-Junker, @BenConstable9, @chrdavis, @davidegiacometti, @ExecThTs, @htcfreek, @itsme-alan, @jay-o-way, @martinchrzan, @niels9001, @pavelzw, and @TobiasSekan

What is being planned for v0.33 - February 2021

For v0.33, we are proactively working on:

• Stability
• Video conference mute's new DirectShow filter should be ready shortly for testing and we hope to have the utility inside the official 0.33 build
• OOBE dialog
• Plugin Manager

For 0.35, we aim to focus mainly on getting all the parts needed to support ARM64 support. This includes our installer, CI system, build server, and upgrading all projects to .NET Core projects to .NET 5.

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.