mirror of
https://github.com/microsoft/PowerToys.git
synced 2026-07-09 20:09:28 +02:00
e8a00f5fdc
- Fix app-not-running being misreported as TIMEOUT (exit 8) after a ~5s hang: bound the pipe-connect phase (ConnectTimeout=2s) separately from and strictly shorter than the overall deadline (OperationTimeout=5s), so a down app surfaces as PROVIDER_UNAVAILABLE (exit 10) quickly instead of losing the connect race. Rename IpcDispatcher _timeout -> _connectTimeout to match its sole use. - Fix global --quiet / --confirm-power-off (ArgumentArity.ZeroOrOne) greedily swallowing a following true/false bareword: `apply-profile --quiet true` bound "true" as the flag value and left apply-profile with no name. Use ArgumentArity.Zero (mirrors the up/down setting flags). - Unify AdjustCommand.CountSelectedSettings with SetCommand (array + LINQ Count). - Document the CLI: clarify the exit-code baseline in cli-conventions.md (modules may extend; code 2 differs) and add doc/devdocs/modules/powerdisplay/cli.md (commands, exit codes, error codes, examples). - Add tests: --quiet non-swallow, --confirm-power-off presence, and the ConnectTimeout < OperationTimeout invariant. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
PowerToys Modules
This section contains documentation for individual PowerToys modules, including their architecture, implementation details, and debugging tools.
Available Modules
| Module | Description |
|---|---|
| Advanced Paste | Tool for enhanced clipboard pasting with formatting options |
| Always on Top | Tool for pinning windows to stay on top of other windows |
| Awake | Tool to keep your computer awake without modifying power settings |
| Color Picker | Tool for selecting and managing colors from the screen |
| Command Not Found | Tool suggesting package installations for missing commands |
| Crop and Lock | Tool for cropping application windows into smaller windows or thumbnails |
| Environment Variables | Tool for managing user and system environment variables |
| FancyZones (debugging tools) | Window manager utility for custom window layouts |
| File Explorer add-ons | Extensions for enhancing Windows File Explorer functionality |
| File Locksmith | Tool for finding processes that lock files |
| Hosts File Editor | Tool for managing the system hosts file |
| Image Resizer | Tool for quickly resizing images within File Explorer |
| Keyboard Manager | Tool for remapping keys and keyboard shortcuts |
| Mouse Utilities | Collection of tools to enhance mouse and cursor functionality |
| Mouse Without Borders | Tool for controlling multiple computers with a single mouse and keyboard |
| NewPlus | Context menu extension for creating new files in File Explorer |
| Peek | File preview utility for quick file content viewing |
| Power Rename | Bulk file renaming tool with search and replace functionality |
| PowerToys Run (deprecation soon) | Quick application launcher and search utility |
| Quick Accent | Tool for quickly inserting accented characters and special symbols |
| Registry Preview | Tool for visualizing and editing Registry files |
| Screen Ruler | Tool for measuring pixel distances and color boundaries on screen |
| Shortcut Guide | Tool for displaying Windows keyboard shortcuts when holding the Windows key |
| Text Extractor | Tool for extracting text from images and screenshots |
| Workspaces | Tool for saving and restoring window layouts for different projects |
| ZoomIt | Screen zoom and annotation tool |
Adding New Module Documentation
When adding documentation for a new module:
- Create a dedicated markdown file for the module (e.g.,
modulename.md) - If the module has specialized debugging tools, consider creating a separate tools document (e.g.,
modulename-tools.md) - Update this index with links to the new documentation
- Follow the existing documentation structure for consistency