PowerToys/README.md
Stefan Markovic 2c5659d746
0.73 release notes ()
Co-authored-by: Ethan Fang <117125208+ethan-fang-MS@users.noreply.github.com>
Co-authored-by: Jaime Bernardo <jaime@janeasystems.com>
Co-authored-by: Clint Rutkas <clint@rutkas.com>
2023-08-31 09:58:24 -07:00

16 KiB
Raw Blame History

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 Color Picker
Crop And Lock 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.
  • Our installer will install the following items:

Go to Microsoft PowerToys GitHub releases page, 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.73.0-x64.exe BA55D245BDD734FD6F19803DD706A3AB8E0ABC491591195534997CF2122D3B7E
Per user - ARM64 PowerToysUserSetup-0.73.0-arm64.exe FBFA40EA5FFA05236A7CCDD05E5142EE0C93D7485B965784196ED9B086BFEBF4
Machine wide - x64 PowerToysSetup-0.73.0-x64.exe 7FDA06292C7C2E6DA5AEF88D8E9D3DE89D331E9E356A232289F9B37CE4503894
Machine wide - ARM64 PowerToysSetup-0.73.0-arm64.exe 4260AA30A1F52F194EE07E9E7ECD9E9F4CF35289267F213BC933F7A5191AC17C

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

Collection of third-party plugins created by the community that aren't distributed with PowerToys.

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.73 - August 2023 Update

In this release, we focused on releasing new features, stability and improvements.

Highlights

  • Keyboard manager now supports Numpad. Note, with previously bound hotkeys stored in settings.json would only react to non-Numpad keys now. If a user wishes to restore the previous behavior, it could be done by manually adding another binding for the Numpad variant.
  • New utility: 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.
  • FancyZones code improvements and refactor.
  • Modernized ImageResizer UX.
  • PowerRename advanced counter functionality.

General

Always On Top

  • Added border transparency.

FancyZones

  • Fixed issue causing canvas zones being drawn only when dragging in zone area.
  • Fixed user-defined default layout highlighting issue.
  • Refactored and improved code quality.
  • Fixed issue causing wrong layout to be applied when duplicating non-selected layout.

File Locksmith

File Explorer add-ons

  • Fixed issue causing thumbnail previewers to lock files.
  • Open URIs from developer files in default browser. Thanks @davidegiacometti!

Installer

  • Fixed PowerToys autorun after installing as SYSTEM user.
  • Removed CreateScheduledTask custom action to handle task creation only from runner code.

Image Resizer

  • Moved from ModernWPF to WpfUI to refresh and modernize UI/UX. Thanks @niels9001!

Keyboard Manager

  • Rephrased labels to enhance clarity. Thanks @Jay-o-Way!
  • Keyboard manager now supports Numpad. Note, with previously bound hotkeys stored in settings.json would only react to non-Numpad keys now. If a user wishes to restore the previous behavior, it could be done by manually adding another binding for the Numpad variant.

Mouse Highlighter

  • Fixed highlighter being invisible issue for Always on Top windows.
  • Added settings for automatic activation on startup. Thanks @davidegiacometti!

Mouse Pointer Crosshairs

Peek

PowerRename

  • Updated OOBE gif. Thanks @ChaseKnowlden!
  • Localized renamed parts combo box.
  • Introduced advanced counter functionality.
  • Added remember last window size logic and optimized items sorting.
  • Enable "Enumerate items" option by default.

PowerToys Run

  • Fixed issue causing original search to be abandoned when cycling through results.
  • Updated device and bluetooth results for Settings plugin. Thanks @htcfreek!
  • Fixed InvalidOperationException exception thrown. Thanks @davidegiacometti!
  • Add Base64 Decoding function to the Value Generator plugin. Thanks @LeagueOfPoro!
  • Added Keep shell open option for Shell plugin.
  • Added Crop And Lock to PowerToys plugin. Thanks @davidegiacometti!

Registry Preview

  • Updated AppBarButtons to use an explicit AppBarButton.Icon. Thanks @randyrants!
  • Fixed crash on clicking Save As button.

Runner

  • Removed unneeded RegisterWindowMessage from tray icon logic. Thanks @sredna!
  • Fixed startup looping issue.
  • Improved old logs and installers cleanup logic. Thanks @davidegiacometti!

Screen Ruler

  • Use proper resources file.

Settings

  • Fixed issue causing problems with modifier keys and ShortcutControl. Thanks @sh0ckj0ckey!
  • Fixed crash when clicking "Windows color settings" link.
  • Added support for launching Settings app directly.
  • Fixed issue causing DisplayDescription not showing for PowerToys Run PluginAdditionalOption.
  • Fixed issue causing FileLocksmith 'Show File Locksmith in' setting not showing correct value.
  • Fixed issue causing Awake on/off toggle in Settings flyout not to work when Settings Awake page is opened.

Documentation

  • Added documentation for PowerToys Run third-party plugins. Thanks @davidegiacometti!
  • Fixed broken links in keyboardmanagerui.md. Thanks @shubhsardana29!
  • Updated core team in COMMUNITY.md.
  • Fixed broken links in ui-architecture.md. Thanks @SamB!
  • Updated community.valuegenerator.md with Base64DecodeRequest description.

Development

What is being planned for version 0.74

For v0.74, we'll work on below:

  • Language selection
  • Modernize and refresh UX of PowerToys based on WPF
  • Stability / bug fixes
  • Peek: UI improvements

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 wouldnt 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 over 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.