PowerToys/README.md
Stefan Markovic 9f1c71ddf4
0.71 changelogs (#27094)
Co-authored-by: Aaron Junker <aaron.junker@outlook.com>
Co-authored-by: Jay <65828559+Jay-o-Way@users.noreply.github.com>
Co-authored-by: Niels Laute <niels.laute@live.nl>
2023-07-05 10:56:31 -07:00

19 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
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.71.0-x64.exe 4C6CCB3055E3838DA50FF529A670BAAD129570F4BFABF497B5D92259D3052794
Per user - ARM64 PowerToysUserSetup-0.71.0-arm64.exe 48633758DFBB99DE34BA2D3E3F294A60EF7E01015296D29A884251068B6FE3F6
Machine wide - x64 PowerToysSetup-0.71.0-x64.exe 44F092DFAC002536A27ABC701750D8C78FF30F8879768990BC4A0AFD0D5119F1
Machine wide - ARM64 PowerToysSetup-0.71.0-arm64.exe 283A67539EDA5D3AD88735C7B0150852ECB57D569BAC80396F942C60D6ACB33F

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.

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.71 - June 2023 Update

In this release, we focused on stability and improvements.

Highlights

  • Support previewing archive files with Peek. Thanks @davidegiacometti!
  • Fixed PT Run crash caused by missing App.Dark.png file.
  • Added setting to set Registry Preview as default app for opening .reg files. Thanks @randyrants!
  • Modernized Settings app title bar and styling (Mica background material) to be inline with Windows 11 guidelines. Thanks @niels9001!

General

  • Fixed infinite loop issue caused by global event not being reset. (This was a hotfix for 0.70)
  • Bump CommunityToolkit.Mvvm package version to 8.2.0. Thanks @davidegiacometti!
  • Fixed issue causing runner lag by moving check for updates and running bug report logic to the background thread.
  • Bump WinUIEx package version to 2.2. Thanks @niels9001!
  • Fixed issue causing Settings app crash when launching a second app process. Thanks @BLM16!
  • Fixed network errors when checking for updates on virtual machines.
  • Bump Microsoft.CodeAnalysis.NetAnalyzers package version to 7.0.3. Thanks @davidegiacometti!
  • Bump Microsoft.Windows.Compatibility package version to 7.0.3.
  • Bump System.Management package version to 7.0.2.
  • Fixed issue causing PowerToys to start with Below Normal priority on startup.

ColorPicker

  • Store color history in a separated file.

FancyZones

  • Added feature to use middle click to toggle multiple zones spanning. Thanks @BasitAli!
  • Fixed issue causing zoning not to happen until the cursor is moved.
  • Improved monitor identification logic to mitigate issues causing layout reset.
  • Fixed issue where default layout was applied instead of blank layout.

File Locksmith

  • Added setting to show only in extended context menu.

File Explorer add-ons

  • Developer files preview support for .vsconfig, .sln, .vcproj, .vbproj, .fsproj and .vcxproj files. (This was a hotfix for 0.70)
  • Developer files preview support .vbs, .inf, .gitconfig, .gitattributes and .editorconfig files. (This was a hotfix for 0.70) Thanks @Aaron-Junker!
  • Changed order of developer files preview` context menu items. Thanks @Aaron-Junker!
  • Developer files preview support for .gitignore files. (This was a hotfix for 0.70) Thanks @Aaron-Junker!
  • Fixed issue causing preview pane flickering on file selection and resizing. Thanks @tanchekwei!

Hosts

  • Improved UX by adding keyboard shortcuts. Thanks @davidegiacometti!
  • Added setting to select the file encoding. Thanks @davidegiacometti!
  • Fixed parsing of commented lines with an address and host in the middle of the comment. Thanks @davidegiacometti!
  • Fixed issue on adding first entry and improve empty hosts list UI. Thanks @davidegiacometti!
  • Added logic to handle more than 9 hosts per entry (Windows limitation) by splitting them into separate entries. Thanks @davidegiacometti!

ImageResizer

  • Added Enter key event handler when setting width/height of the new custom size.

Installer

  • Fixed PowerToys Plugin installation. (This was a hotfix for 0.70) Thanks @davidegiacometti!
  • Fixed issue causing missing Mouse Without Borders service after upgrade. (This was a hotfix for 0.70)
  • Removed unneeded PT Run registry entries.

Mouse Without Borders

  • Added Name2IP setting. (This was a hotfix for 0.70)
  • Fixed device layout issues. (This was a hotfix for 0.70)
  • Fixed hiding cursor at the top of the screen when "Hide mouse at the screen edge" is enabled. (This was a hotfix for 0.70)
  • Fixed issue that was preventing OS going to sleep mode. (This was a hotfix for 0.70)
  • Remove shortcut for deprecated VKMap functionality. (This was a hotfix for 0.70) Thanks @dtaylor84!
  • Make MWB work without service if service doesn't start properly. (This was a hotfix for 0.70)
  • Fixed focus issue causing "Hide mouse at the screen edge" not to work properly. (This was a hotfix for 0.70)
  • Fixed issue causing app to hijack shortcut keys if they are only partially matched.

Peek

  • Consume Ctrl+Space shortcut only if Desktop or Shell are in the foreground. (This was a hotfix for 0.70)
  • Added feature to hide window with Esc key. (This was a hotfix for 0.70) Thanks @davidegiacometti!
  • Added a setting to always run not-elevated (enabled by default). (This was a hotfix for 0.70)
  • Support .vsconfig, .sln, .vcproj, .vbproj, .fsproj and .vcxproj files. (This was a hotfix for 0.70)
  • Fixed blinking issue while loading developer files. (This was a hotfix for 0.70)
  • Reset preview Source on Peek window close. (This was a hotfix for 0.70)
  • Center Peek window on File Explorer activated monitor. (This was a hotfix for 0.70) Thanks @SamChaps!
  • Fix previewing unsupported file types by using effective pixels. (This was a hotfix for 0.70) Thanks @SamChaps!
  • Support .vbs, .inf, .gitconfig, .gitattributes and .editorconfig files. (This was a hotfix for 0.70) Thanks @Aaron-Junker!
  • Fixed memory leak by clearing generated thumbnails. (This was a hotfix for 0.70)
  • Added setting to close on focus lost. (This was a hotfix for 0.70)
  • Fixed crash when triggering Peek with no files being selected. (This was a hotfix for 0.70)
  • Fixed setting Peek window as a foreground window. (This was a hotfix for 0.70)
  • Fixed race condition causing low quality preview to be displayed even if high quality preview is present. (This was a hotfix for 0.70)
  • Added support for .htm files.
  • Fixed issue where title bar button colors were not update on Windows theme change.
  • Added up/down arrow key item navigation. Thanks @DanWiseProgramming!
  • Improved UX by defining minimum window size and adding tooltips for shown text. Thanks @htcfreek!
  • Fixed crash on previewing internet shortcuts files.
  • Support previewing archive files. Thanks @davidegiacometti!

PowerToys Run

  • Fixed crash caused by non thread-safe Results update.
  • Fixed crash caused by missing App.Dark.png
  • Code cleanup and fixed possible crash caused by missing VS Code instance in VS Code plugin. Thanks @davidegiacometti!
  • Fix environment helper for nested environment variables. Thanks @htcfreek!

Quick Accent

  • Added multiplication and division signs. Thanks @ailintom!
  • Added opening exclamation mark to Catalan and Spanish language. Thanks @Aaron-Junker!
  • Added the section sign ("§", U+00A7). Thanks @EikeJoo!
  • Added accent units and more additional signs. Thanks @WilkoLu!

Registry Preview

  • Added setting to set the app as default app for opening .reg files. Thanks @randyrants!
  • Merge settings to single folder.
  • Fixed issue of saving files without truncation. Thanks @qwerty472123!

Text Extractor

  • Various improvements and fixes. Thanks @TheJoeFin!

Settings

  • Styling fixes for Peek and Mouse Without Borders pages. (This was a hotfix for 0.70) Thanks @niels9001!
  • Fixed Mouse Without Borders machine connection status styling. (This was a hotfix for 0.70)
  • Improved Mouse Without Border page Uninstall service UX when it is inaccessible. (This was a hotfix for 0.70)
  • Updated File Explorer module screenshots and instructions to reflect the Windows 11 File Explorer. Thanks @infinitepower18!
  • Modernized the app title bar and styling (Mica background material) to be inline with Windows11 guidelines. Thanks @niels9001!
  • Improved error handling on settings backup failure.
  • Added Reset button to shortcut control to reset activation shortcut to default value. Thanks @Svenlaa!
  • Improved Exclude apps setting for all modules to also detect apps by title.

Development

  • Added Peek and Mouse Without Borders to GitHub templates. (This was a hotfix for 0.70)
  • Fixed the CI release pipelines winget package submission. (This was a hotfix for 0.70)
  • Fixed process report and termination lists for Peek and Mouse Without Borders. (This was a hotfix for 0.70)
  • Added Winget configuration file. (This was a hotfix for 0.70) Thanks @ryfu-msft!
  • Fixed tests localization issues.
  • Added Microsoft.VisualStudio.Component.VC.ATL library to .vsconfig.
  • Onboarding to GitOps.ResourceManagement.

What is being planned for version 0.72

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

  • Adjustments on feedback / stability / bug fixes
  • Modernize and refresh UX of PowerToys based on WPF

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.