Skip to content

Latest commit

 

History

History
253 lines (165 loc) · 16.7 KB

README.md

File metadata and controls

253 lines (165 loc) · 16.7 KB

Microsoft PowerToys

Hero image for 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)
x64 Build Status for Main Build Status for Stable Build Status Installer pipeline
ARM64 Build Status for Main Build Status for Main Build Status Installer pipeline

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 learn.microsoft.com!

Current utilities:
Always on Top PowerToys Awake Command Not Found
Color Picker Crop And Lock Environment Variables
FancyZones File Explorer Add-ons File Locksmith
Hosts File Editor Image Resizer Keyboard Manager
Mouse utilities Mouse Without Borders Peek
Paste as Plain Text PowerRename PowerToys Run
Quick Accent Registry Preview Screen Ruler
Shortcut Guide Text Extractor Video Conference Mute

Installing and running Microsoft PowerToys

Requirements

  • Windows 11 or Windows 10 version 2004 (code name 20H1 / build number 19041) or newer.
  • x64 or ARM64 processor
  • Our installer will install the following items:

Via GitHub with EXE [Recommended]

Go to the Microsoft PowerToys GitHub releases page and click on Assets at the bottom to show the files available in the release. Please use the appropriate PowerToys installer that matches your machine's architecture and install scope. For most, it is x64 and per-user.

Description Filename sha256 hash
Per user - x64 PowerToysUserSetup-0.80.0-x64.exe 4D20EB01C4035BB41F57D43AED2A546547E1FAA660FE29DC1CC699F1916DE1CC
Per user - ARM64 PowerToysUserSetup-0.80.0-arm64.exe 1B85E95B0EC7D8CE1EE51B987449DA9A36DAAA4C27DF8EE4796001848EA2CBD1
Machine wide - x64 PowerToysSetup-0.80.0-x64.exe 2D17C1920D970332D93449184D7C2470052686FD4B3EB8ED49EF6475D1D1D62F
Machine wide - ARM64 PowerToysSetup-0.80.0-arm64.exe 0DD40B7A31E35472688A55A8E1ECE58847EA423F3F19FD7B8C557F1271F73F24

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 is available for both Windows 11 and Windows 10.

Via WinGet

Download PowerToys from WinGet. Updating PowerToys via winget will respect current PowerToys installation scope. To install PowerToys, run the following command from the command line / PowerShell:

User scope installer [default]

winget install Microsoft.PowerToys -s winget

Machine-wide scope installer

winget install --scope machine 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, you can find the install instructions there.

Third-Party Run Plugins

There is a collection of third-party plugins created by the community that aren't distributed with PowerToys.

Contributing

This project welcomes contributions of all types. Besides coding features / bug fixes, other ways to assist include spec writing, design, documentation, and finding bugs. 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 would 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 grant us the rights to use your contribution and that you have permission to do so.

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.80 - March 2024 Update

In this release, we focused on stability and improvements. The next release is planned to be released during Microsoft Build 2024 (late May).

Highlights

  • New feature: Desired State Configuration support, allowing the use of winget configure for PowerToys. Check the DSC documentation for more information.
  • The Windows App SDK dependency was updated to 1.5.1, fixing many underlying UI issues.
  • WebP/WebM files support was added to Peek. Thanks @davidegiacometti!
  • Audio files support was added to Peek. Thanks @davidegiacometti!
  • Automated UI testing for FancyZones Editor was added to CI.

General

  • Added a Quick Access entry to access the flyout from PowerToys' tray icon right click menu. Thanks @pekvasnovsky!
  • Added support for Desired State Configuration in PowerToys, allowing the use of winget configure to configure many settings.

Awake

  • Fix an issue causing the "Keep screen on" option to disable after Awake deactivated itself.

Color Picker

  • Fixed a UI issue causing the color picker modal to hide part of the color bar. Thanks @TheChilledBuffalo!

Command Not Found

  • Now tries to find a preview version of PowerShell if no stable version is found.

FancyZones

  • Fixed a crash loading the editor when there's a layout with an empty name in the configuration file.
  • Refactored layout internal data structures and common code to allow for automated testing.
  • The pressing of the shift key is now detected through raw input to fix an issue causing the shift key to be locked for some users.

File Explorer add-ons

  • Fixed a crash occurring in the Monaco previewer when a file being previewed isn't found by the code behind.
  • Fixed an issue in the Markdown previewer adding a leading space to code blocks. Thanks @Aaron-Junker!
  • Fixed wrong location and scaling of preview results on screens with different DPIs.
  • Added better clean up code to thumbnail handlers to prevent locking files.

File Locksmith

  • Allow multiple lines to wrap when viewing the modal with selected file paths. Thanks @sanidhyas3s!

Installer

  • Fixed the final directory name of the PowerToys Run VSCode Workspaces plugin in the installation directory to match the plugin name. Thanks @zetaloop!
  • Used more generic names for the bootstrap steps, so that "Installing PowerToys" is not shown when uninstalling.

Keyboard Manager

  • Fixed an issue that would clear out KBM mappings when certain numpad keys were used as the second key of a chord.
  • Added a comment in localization files so that translators won't translate "Text" as "SMS".

Peek

  • Added support to .WebP/.WebM files in the image/video previewer. Thanks @davidegiacometti!
  • Added support for audio files. Thanks @davidegiacometti!
  • Fixed an issue causing the open file button in the title bar to be un-clickable. Thanks @davidegiacometti!
  • Fixed an issue when previewing a folder with a dot in the name that caused Peek to try to preview it as a file. Thanks @davidegiacometti!

PowerToys Run

  • Added a setting to the Windows Search plugin to exclude files and patterns from the results. Thanks @HydroH!
  • Fixed an issue showing thumbnails caused by a hash collision between similar images.
  • Added the "checkbox and multiline text box" additional property type for plugins and improved multiline text handling. Thanks @htcfreek!

Quick Accent

  • Added the Schwa character to the Italian character set. Thanks @damantioworks!

Registry Preview

  • Allow alternative valid names for the root keys. Thanks @e-t-l!
  • Fixed an issue causing many pick file windows to be opened simultaneously. Thanks @randyrants!

Screen Ruler

Shortcut Guide

  • Updated the Emoji shortcut that is shown to the new Windows key + period (.) hotkey.

Text Extractor

  • Fixed issues creating the extract layout on certain monitor configurations.

Video Conference Mute

  • Added enable/disable telemetry to get usage data.

Settings

  • Added locks to some terms (like the name of some utilities) so that they aren't localized.
  • Fixed some shortcuts not being shown properly in the Flyout and Dashboard. Thanks @davidegiacometti!
  • Updated image for Color Picker and outdated animations for utilities in OOBE. Thanks @niels9001!

Documentation

  • Added FastWeb plugin to PowerToys Run thirdPartyRunPlugins.md docs. Thanks @CCcat8059!
  • Removed the old security link to MSRC from the create new issue page, since security.md is already linked there.
  • Added clarity regarding unofficial plugins to the PowerToys Run thirdPartyRunPlugins.md docs.

Development

  • Updated System.Drawing.Common to 8.0.3 to fix CI builds after the .NET 8.0.3 upgrade was released.
  • Adjusted the GitHub action names for releasing to winget and Microsoft Store so they're clearer in the UI.
  • Upgraded WinAppSDK to 1.5.1, fixing many related issues.
  • Consolidate the WebView2 version used by WinUI 2 in the Keyboard Manager Editor.
  • Unified the use of Precompiled Headers when building on CI. Thanks @dfederm!
  • Added UI tests for FancyZones Editor in CI.
  • Added a GitHub bot to identify possible duplicates when a new issue is created. Thanks @craigloewen-msft!
  • Updated the WiX installer dependency to 3.14.1 to fix possible security issues.
  • Changed the pipelines to use pipeline artifacts instead of build artifacts. Thanks @dfederm!
  • Added the -graph parameter for pipelines. Thanks @dfederm!
  • Tests in the pipelines now run as part of the build step to save on CI time. Thanks @dfederm!

What is being planned for version 0.81

For v0.81, we'll work on the items below:

  • Stability / bug fixes
  • Language selection
  • New module: File Actions Menu

The next release is planned to be released during Microsoft Build 2024.

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. Month by month, you directly help make PowerToys a better piece of software.

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.