0 Fork 0

mirror of https://github.com/microsoft/PowerToys.git synced 2026-10-28 08:36:04 +08:00

Files

T

Boliang ZhangandCopilot 06e6ae43e2 feat(workspaces): add list and launch CLI (#51114 )

<!-- Enter a brief description/summary of your PR here. What does it
fix/what does it change/how was it tested (even manually, if necessary)?
-->
## Summary of the Pull Request

Add Workspaces **list** and synchronous **launch** through a thin native
CLI and shared GUI/CLI execution core. Related to #49900;
capture/create/CRUD are excluded. Usage and contracts:
`doc\devdocs\modules\workspaces-cli.md`.

<!-- Please review the items on the PR checklist before submitting-->
## PR Checklist

- [ ] Closes: N/A - partial scope of #49900.
<!-- - [ ] Closes: #yyy (add separate lines for additional resolved
issues) -->
- [x] **Communication:** I've discussed this with core contributors
already. If the work hasn't been agreed, this work might be rejected
- [x] **Tests:** Added/updated and all pass (scoped local runs below;
CI/release gates remain)
- [x] **Localization:** All end-user-facing strings can be localized
- [x] **Dev docs:** Added/updated
- [x] **New binaries:** Added on the required places
- [x] [JSON for
signing](https://github.com/microsoft/PowerToys/blob/main/.pipelines/ESRPSigning_core.json)
for new binaries
- [x] [WXS for
installer](https://github.com/microsoft/PowerToys/blob/main/installer/PowerToysSetup/Product.wxs)
for new binaries and localization folder - current integration:
`installer\PowerToysSetupVNext\CliShims.wxs`
- [x] [YML for CI
pipeline](https://github.com/microsoft/PowerToys/blob/main/.pipelines/ci/templates/build-powertoys-steps.yml)
for new test projects - existing discovery; session-peer companion
signing updated
- [x] [YML for signed
pipeline](https://github.com/microsoft/PowerToys/blob/main/.pipelines/release.yml)
- N/A: existing signing pipeline
- [ ] **Documentation updated:** If checked, please file a pull request
on [our docs
repo](https://github.com/MicrosoftDocs/windows-uwp/tree/docs/hub/powertoys)
and link it here: N/A - follow-up not filed.

<!-- Provide a more detailed description of the PR, other things fixed,
or any additional comments/features here -->
## Detailed Description of the Pull Request / Additional comments

### Shared execution, conditional process boundary

```mermaid
flowchart TB
    EDITOR["Editor process<br/>C# / WPF"] -->|"start GUI Launcher"| ADAPTER
    SHELL["Terminal / script"] -->|"CLI shim starts CLI"| ADAPTER

    subgraph CALLER["Caller process: CLI.exe OR Launcher.exe in GUI mode"]
        ADAPTER["Thin entry adapter"]
        START["WorkspacesSession::Start<br/>snapshot + context check"]
        LOCAL["WorkspacesSession::Execute()<br/>function inside the caller process"]
        ADAPTER -->|"in-process"| START
        START -->|"verified Medium: in-process"| LOCAL
        LOCAL -.->|"typed return via Start"| ADAPTER
    end

    subgraph HOST["Elevated callers only: Medium host process<br/>PowerToys.WorkspacesLauncher.exe"]
        HANDOFF["Host entry<br/>receive and validate SessionHandoff"]
        REMOTE["WorkspacesSession::Execute()<br/>function inside this host process"]
        HANDOFF -->|"function call within the same process"| REMOTE
    end

    START -->|"elevated: create host<br/>read-only snapshot + restricted handles"| HANDOFF
    REMOTE -.->|"private anonymous result pipe"| START
    START -.->|"host outcome returned"| ADAPTER
    LOCAL <-->|"named pipes"| ARRANGER["WindowArranger process"]
    REMOTE <-->|"named pipes"| ARRANGER
    LOCAL <-->|"named pipes"| UI["Existing WPF Launcher UI process"]
    REMOTE <-->|"named pipes"| UI

    classDef shared fill:#dbeafe,stroke:#2563eb,color:#172554
    class START,LOCAL,REMOTE shared
```

The caller box represents **one of the two entry executables**, not both
in one process. Blue nodes are code statically linked from
`WorkspacesLib.lib`, not a DLL or shared service. **Medium GUI/CLI
callers execute in their own process without another Launcher host.**
Only elevated callers create a verified Medium host through the existing
`run_non_elevated` helper; it calls the same
`WorkspacesLib\LaunchExecution.cpp` core. No elevated fallback.

**`Execute()` is a function, not another EXE.** The host entry and its
`Execute()` share the same process ID. Execution uses a worker thread
inside that process, not another Launcher process. The two `Execute()`
nodes represent the same library implementation running in alternative
caller/host contexts.

- **Shared behavior:** one preparation, launch, arrangement,
confirmation and history flow. GUI retains progress; CLI shows only
required existing confirmation UI. GUI Cancel and console cancellation
use the shared stop/result path; already-started apps survive. Arranger
callbacks are stopped and joined before their helper owner is released.
An unresponsive inline Shell call yields `outcomeUnknown` before the
one-shot adapter exits, rather than killing a thread or claiming
cancellation succeeded.
- **Contracts:** `list` is read-only; summary JSON reuses existing
names. All arranged = `completed`/0; partial progress = `partial`/10; no
progress = `failed`/10. Incomplete, fractional or invalid final states
yield `outcomeUnknown`/9. Persistence verification failure retains exit
11 and displays application results in both text and JSON modes. The
existing `LaunchedAndMoved` enum and numeric IPC values are unchanged.
- **Persistence/integration:** preserve IDs, initialize missing legacy
IDs, update history best-effort; unsaved GUI drafts do not write saved
configuration/history. Only shim `bin` goes on PATH. Editor sibling-tool
resolution is executable-relative.
- **Telemetry:** one frontend `Workspaces_CLICommand` event when
optional diagnostics are enabled, following #50507's fixed command
category + success model. No workspace names/IDs, paths, arguments or
error text; the Medium host does not double-count. Uses the existing
native telemetry channel; documented in `DATA_AND_PRIVACY.md`.
- **Release IPC:** exact session-owner PID and official CLI/Launcher
identities remain checked. CI companion signing now includes CLI,
Launcher, arranger and Launcher UI; production signature checks are not
disabled.
- **Console isolation:** console workspace targets get their own
console; inline execution does not detach, redirect or share the CLI's
console.
- **Launch and Edit:** a missing temporary draft now falls back to the
saved workspace before GUID validation; malformed existing drafts still
fail. The existing UI regression explicitly checks that no draft is
present.
- **GUI file errors:** unreadable saved files and drafts show the
existing localized file-reading dialog with the correct source filename;
malformed-file dialogs also retain that context. Public CLI error JSON
is unchanged.
- **UI-test transport:** shared value setters place target options
before `--` and pass selectors/values literally. This fixes the
leading-dash command-line inputs rejected by CI's winapp 0.7.1 without
changing Workspaces test payloads or assertions.

### Changed-file breakdown

Full PR versus main, not just the latest commit. Each file is counted
once; test projects and fixtures are grouped under tests. These are file
categories, not process or library boundaries.

| Category | Files |
|---|---:|
| CLI adapter, output, resources and project | 7 |
| Shared session/execution entry, contracts, IPC, storage and telemetry
| 19 |
| Launcher engine/host adapter, arranger and UI | 18 |
| Managed storage and Editor path compatibility | 4 |
| Common helpers | 9 |
| Tests and fixtures | 24 |
| Build, installer and signing | 6 |
| Documentation and privacy catalog | 4 |
| **Total** | **91** |

The Launcher engine sources are compiled into `WorkspacesLib` even
though their source files remain under `WorkspacesLauncher`; the table
does not imply a separate engine process.

**Scope/known follow-ups:** general Editor save/conflict redesign and
the pre-existing localized-name/package-version matching bug are
deferred. Final GUI progress presentation still needs follow-up; this
update does not claim to fix its spinner-before-close behavior. The
native C++ parser is retained by the PR author's decision; a managed
System.CommandLine migration is not included. This does not amend the
repository-wide CLI convention.

<details>
<summary>List output and shared confirmation UI</summary>

![Workspaces CLI
list](https://github.com/user-attachments/assets/3755c810-0b85-4afe-b80f-f17f12e7f07d)
![Shared confirmation UI; controlled probe, no target
executed](https://github.com/user-attachments/assets/fbd09160-725d-47b7-907e-307bb2d749dc)

</details>

<!-- Describe how you validated the behavior. Add automated tests
wherever possible, but list manual validation steps taken as well -->
## Validation Steps Performed

x64 Debug builds of the affected product and UI-test/fixture projects
passed; Release core, ModuleInterface, arranger, Launcher and CLI builds
also passed. The pre-GUI-error scoped native run passed **160 tests**.
Two deterministic paused-dispatch regressions reproduced `0xC0000005`
before the teardown fix (snapshot and final-result callbacks); both now
return acknowledged cancellation. Test hooks are compiled only into the
fixture, not production builds. **48 signing-selection** tests passed
earlier against unchanged selection logic. The preceding missing-draft
fix passed **39 focused tests** plus the complete local-host `winapp`
Launch and Edit flow, with settings/pointer/Editor state restored. This
is targeted host validation, not full local OS-matrix sign-off.

The GUI error follow-up `8ea5619586` passed **33 focused native tests in
each of Debug and Release**, including a regression that failed before
the fix. Both real saved-file/draft error dialogs were driven locally
with UIA; original configuration bytes and draft absence were restored.

The CI transport follow-up `e0945376e6` passed **19 focused
shared-harness tests in each of Debug and Release**. Using the
hash-verified winapp **0.7.1** archive from the failing CI revision, the
original invocation reproduced `invalid_arguments`; the fixed wrappers
passed **nine owned-UI setter checks** for leading options, quoted text,
empty text, and negative numeric values. The TextBox, editable ComboBox,
NumberBox, and Slider setters share the corrected argument boundary.
This is focused wrapper validation, not a claim that the full Workspaces
suite ran locally.

<details>
<summary>Commands and results</summary>

Used the verified side-by-side SDK 10.0.303; no global/repository SDK or
package-source change. With `$root='D:\PowerToys-workspace-cli'`, from
each affected project directory:

```powershell
& "$root\tools\build\build.ps1" -Platform x64 -Configuration Debug -ExtraArgs @("/p:SolutionDir=$root\", '/p:BuildProjectReferences=false', '/p:WorkspacesCliLiveTests=true')
# Passed, exit 0.
& "$root\tools\build\build.ps1" -Platform x64 -Configuration Release -ExtraArgs @("/p:SolutionDir=$root\", '/p:BuildProjectReferences=false')
# Passed, exit 0, for core/arranger/Launcher/CLI.
```

Missing Release UI dependencies were first built with project references
enabled:

```powershell
# From src\modules\Workspaces\WorkspacesLauncherUI:
& "$root\tools\build\build.ps1" -Platform x64 -Configuration Release -ExtraArgs @("/p:SolutionDir=$root\")
# Passed, exit 0.
```

Pre-GUI-error scoped native run (`$evidence` is the local report
directory):

```powershell
$env:WORKSPACES_CLI_LIVE_TESTS='1'
& 'C:\Program Files\Microsoft Visual Studio\18\Enterprise\Common7\IDE\CommonExtensions\Microsoft\TestWindow\vstest.console.exe' "$root\x64\Debug\tests\Workspaces\Workspaces.Lib.UnitTests.dll" '/TestCaseFilter:FullyQualifiedName~CliContractTests|FullyQualifiedName~CliJsonOutputTests|FullyQualifiedName~CliRuntimeTests|FullyQualifiedName~CliHandoffTests|FullyQualifiedName~CliWorkerTests|FullyQualifiedName~WorkspaceStoreTests|FullyQualifiedName~SignatureVerificationTests|FullyQualifiedName~SignatureTrustTests|FullyQualifiedName~ExecutableTargetTests|FullyQualifiedName~ElevatedLaunchGateTests|FullyQualifiedName~PendingLaunchApprovalTests' "/ResultsDirectory:$evidence" '/Logger:trx;LogFileName=teardown-race-green.trx' '/Logger:console;verbosity=minimal'
# Passed: 160; failed/skipped: 0; exit 0.
& 'C:\Program Files\Microsoft Visual Studio\18\Enterprise\Common7\IDE\CommonExtensions\Microsoft\TestWindow\vstest.console.exe' "$root\x64\Debug\tests\Workspaces\Workspaces.Lib.UnitTests.dll" '/TestCaseFilter:FullyQualifiedName~CliContractTests|FullyQualifiedName~JsonUtilsTests' "/ResultsDirectory:$evidence" '/Logger:trx;LogFileName=missing-draft-headless.trx' '/Logger:console;verbosity=minimal'
# Passed after the draft fix: 39; failed/skipped: 0; exit 0.
Invoke-Pester -Script 'D:\PowerToys-workspace-cli\.pipelines\tests\uiTestSigningSelection.Tests.ps1' -PassThru
# Passed: 48; failed: 0.
git diff --check
# Passed, exit 0.
```

Telemetry lifecycle tests use a recording sink and synthetic commands;
they neither transmit telemetry nor change diagnostic consent.

Recorded host UI actions (3892 was this run's owned Editor PID, not a
reusable PID):

```powershell
winapp ui 'invoke' 'EditButton' '-a' '3892' '--json'
winapp ui 'invoke' 'LaunchEditButton' '-a' '3892' '--json'
winapp ui 'invoke' 'SnapshotButton' '-a' '3892' '--json'
winapp ui 'invoke' 'SaveButton' '-a' '3892' '--json'
# All passed, exit 0; fixture startup, exact placement, recapture and persisted IDs were asserted.
```

</details>

Latest shared-harness build/test commands, from
`src\common\UITestAutomation.Next.UnitTests`:

```powershell
& "$root\tools\build\build.ps1" -Platform x64 -Configuration Debug -ExtraArgs @("/p:SolutionDir=$root\")
& "$root\tools\build\build.ps1" -Platform x64 -Configuration Release -ExtraArgs @("/p:SolutionDir=$root\")
# Both passed, exit 0, including analyzers.
& "$root\x64\Debug\tests\UITestAutomation.Next.UnitTests\net10.0-windows10.0.26100.0\UITestAutomation.Next.UnitTests.exe" --filter 'FullyQualifiedName~WinappCliTests|FullyQualifiedName~SessionTests' --report-trx --report-trx-filename ci-set-value-unit.trx --results-directory $evidence
& "$root\x64\Release\tests\UITestAutomation.Next.UnitTests\net10.0-windows10.0.26100.0\UITestAutomation.Next.UnitTests.exe" --filter 'FullyQualifiedName~WinappCliTests|FullyQualifiedName~SessionTests' --report-trx --report-trx-filename ci-set-value-unit-release.trx --results-directory $evidence
# Each passed: 19; failed/skipped: 0; exit 0.
```

**CI status:**
[391837](https://dev.azure.com/shine-oss/62769a65-d989-45e3-803c-9ad21fcf2ea2/_build/results?buildId=391837)
**succeeded** on current head `e0945376e6`, tested as merge `e27f537028`
with main `79ceeee01c`. SDK/x64/ARM64 builds passed, and **34/34
Workspaces UI tests passed on each of Windows 10 x64, Windows 11 x64,
and Windows 11 ARM64**, with zero failures or skips. Finished 2026-10-26
16:18:46 UTC.

The preceding
[391820](https://dev.azure.com/shine-oss/62769a65-d989-45e3-803c-9ad21fcf2ea2/_build/results?buildId=391820)
on `8ea5619586` passed product builds but had 29/34 UI tests pass on
each platform. All five failures were leading-dash textbox values
rejected by winapp 0.7.1; the shared helper was identical to main and
predates this PR. The setter fix resolves those failures without
changing Workspaces product code or weakening assertions. Fresh
High-parent/UAC, installer servicing and broader mixed-DPI validation
remain release gates.

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 664ee900-ce2d-4112-ac57-395314d818dc

2026-10-27 11:29:49 +08:00

38 KiB

Raw Permalink Blame History

PowerToys data & privacy

Overview

PowerToys diagnostic data is completely optional for users and is off by default in v0.86 and beyond. Our team believes in transparency and trust. As PowerToys is open source, all of our diagnostic data events are in the codebase.

Additionally, this document aims to list each diagnostic data event individually and describe their purpose clearly.

For more information, please read the Microsoft privacy statement.

What does PowerToys collect?

Usage: Understanding usage and frequency rates for utilities and settings helps us make decisions on where to focus our time and energy. This data also helps us better understand what and how to move well-loved features directly into Windows!
Stability: Monitoring bugs and system crashes, as well as analyzing GitHub issue reports, assists us in prioritizing the most urgent issues.
Performance: Assessing the performance of PowerToys features to load and execute gives us an understanding of what surfaces are causing slowdowns. This supports our commitment to providing you with tools that are both speedy and effective.

Success story: Fixing FancyZones bugs with your help

FancyZones had numerous bug reports related to virtual desktop interactions. Initially, these were considered lower priority, since the assumption was that virtual desktops were not widely used, so we chose to focus on more urgent issues. However, the volume of bug reports suggested otherwise, prompting us to add additional diagnostics to see virtual desktop usage with FancyZones. We discovered that virtual desktop usage was much higher among FancyZones users. This new understanding led us to prioritize this class of bugs and get them fixed.

As much as possible, we aim to share the results of diagnostic data publicly.

We hope this document provides clarity on why and how we collect diagnostic data to improve PowerToys for our users. If you have any questions or concerns, please feel free to reach out to us.

Thank you for using PowerToys!

List of diagnostic data events

Note

We're in the process of updating this section with more events and their descriptions. We aim to keep this list current by adding any new diagnostic data events as they become available.

If you want to find diagnostic data events in the source code, these two links will be good starting points based on the source code's language:

General

Event Name	Description
Microsoft.PowerToys.DebugEvent	Logs debugging information for diagnostics and troubleshooting.
Microsoft.PowerToys.GeneralSettingsChanged	Logs changes made to general settings within PowerToys.
Microsoft.PowerToys.Install_Fail	Triggered when the PowerToys installation process encounters an error and fails to complete.
Microsoft.PowerToys.PowerToys_ModuleLaunchedFromSettings	Logs when a module editor is launched from the Settings UI or Quick Access panel, including which module was launched.
Microsoft.PowerToys.Repair_Cancel	Triggered when a PowerToys repair operation is cancelled by the user before completion.
Microsoft.PowerToys.Repair_Fail	Triggered when the PowerToys repair operation fails to complete successfully due to an error.
Microsoft.PowerToys.Runner_Launch	Indicates when the PowerToys Runner is launched.
Microsoft.PowerToys.ScoobeStartedEvent	Triggered when SCOOBE (Secondary Out-of-box experience) starts.
Microsoft.PowerToys.Settings_CLICommand	Triggered when the Settings CLI is invoked, logging only a fixed command category and success status. Module names, settings values, and other arguments are not collected.
Microsoft.PowerToys.SettingsBootEvent	Triggered when PowerToys settings are initialized at startup.
Microsoft.PowerToys.SettingsEnabledEvent	Indicates that the PowerToys settings have been enabled.
Microsoft.PowerToys.ShortcutConflictControlClickedEvent	Triggered when a user clicks on the Shortcut Conflict Control button in the PowerToys Settings UI Dashboard.
Microsoft.PowerToys.ShortcutConflictDetectedEvent	Triggered when keyboard shortcut conflicts are detected in the PowerToys Settings UI Dashboard.
Microsoft.PowerToys.ShortcutConflictResolvedEvent	Triggered when a keyboard shortcut conflict is resolved in the PowerToys Settings UI.
Microsoft.PowerToys.TrayFlyoutActivatedEvent	Indicates when the tray flyout menu is activated.
Microsoft.PowerToys.TrayFlyoutModuleRunEvent	Logs when a utility from the tray flyout menu is run.
Microsoft.PowerToys.UnInstall_Cancel	Triggered when the PowerToys uninstallation process is cancelled by the user before completion.
Microsoft.PowerToys.UnInstall_Fail	Triggered when the PowerToys uninstallation process fails to complete successfully due to an error.
Microsoft.PowerToys.Uninstall_Success	Logs when PowerToys is successfully uninstalled (who would do such a thing!).
Microsoft.PowerToys.UpdateCheck_Completed	Logs when an auto-update check completes, including success status, whether an update is available, and version information.
Microsoft.PowerToys.UpdateDownload_Completed	Logs when an update download completes, including success status and version.

OOBE (Out-of-box experience)

Event Name	Description
Microsoft.PowerToys.OobeModuleRunEvent	Triggered when a user clicks to run or launch a PowerToys module directly from the OOBE (out-of-box experience) interface.
Microsoft.PowerToys.OobeSectionEvent	Occurs when OOBE is shown to the user.
Microsoft.PowerToys.OobeSettingsEvent	Triggers when a Settings page is opened from an OOBE page.
Microsoft.PowerToys.OobeStartedEvent	Indicates when the out-of-box experience has been initiated.
Microsoft.PowerToys.OobeVariantAssignmentEvent	This event logs A/B testing assignments for experimental features, helping track which users are in control or alternate groups for feature experiments.

Advanced Paste

Event Name	Description
Microsoft.PowerToys.AdvancedPaste_EnableAdvancedPaste	Triggered when Advanced Paste is enabled.
Microsoft.PowerToys.AdvancedPaste_Error	Occurs when an error is encountered during the Advanced Paste process.
Microsoft.PowerToys.AdvancedPaste_InvokeAdvancedPaste	Activated when Advanced Paste is called by the user.
Microsoft.PowerToys.AdvancedPaste_Settings	Triggered when settings for Advanced Paste are accessed or modified.
Microsoft.PowerToys.AdvancedPasteClipboardItemClicked	Occurs when a clipboard item is selected from the Advanced Paste menu.
Microsoft.PowerToys.AdvancedPasteClipboardItemDeletedEvent	Triggered when an item is removed from the Advanced Paste clipboard history.
Microsoft.PowerToys.AdvancedPaste_CLICommand	Triggered when an Advanced Paste CLI command is executed, logging only the bounded command name and success status.
Microsoft.PowerToys.AdvancedPasteCustomActionErrorEvent	Records provider, model, and status details when a custom action fails.
Microsoft.PowerToys.AdvancedPasteCustomFormatOutputThumbUpDownEvent	Triggered when a user gives feedback on a custom format output (thumb up/down).
Microsoft.PowerToys.AdvancedPasteEndpointUsageEvent	Logs the AI provider, model, and processing duration for each endpoint call.
Microsoft.PowerToys.AdvancedPasteFormatClickedEvent	Occurs when a specific paste format is clicked in the Advanced Paste menu.
Microsoft.PowerToys.AdvancedPasteGenerateCustomErrorEvent	Triggered when an error occurs while generating a custom paste format.
Microsoft.PowerToys.AdvancedPasteGenerateCustomFormatEvent	Occurs when a custom paste format is successfully generated.
Microsoft.PowerToys.AdvancedPasteInAppKeyboardShortcutEvent	Triggered when a keyboard shortcut is used within the Advanced Paste interface.
Microsoft.PowerToys.AdvancedPasteSemanticKernelErrorEvent	Occurs when the Semantic Kernel workflow encounters an error.
Microsoft.PowerToys.AdvancedPasteSemanticKernelFormatEvent	Triggered when Advanced Paste leverages the Semantic Kernel.

Always on Top

Event Name	Description
Microsoft.PowerToys.AlwaysOnTop_EnableAlwaysOnTop	Triggered when Always on Top is enabled.
Microsoft.PowerToys.AlwaysOnTop_PinWindow	Occurs when a window is pinned to stay on top of other windows.
Microsoft.PowerToys.AlwaysOnTop_UnpinWindow	Triggered when a pinned window is unpinned, allowing it to be behind other windows.

CursorHide

Event Name	Description
Microsoft.PowerToys.AutoHideCursor_EnableAutoHideCursor	Records whether CursorHide is enabled or disabled (`Enabled` boolean) to understand utility usage. Does not include keystrokes, typed text, or cursor positions.

Awake

Event Name	Description
Microsoft.PowerToys.Awake_EnableAwake	Triggered when Awake is enabled.
Microsoft.PowerToys.AwakeExpirableKeepAwakeEvent	Occurs when the system is kept awake for a temporary, expirable duration.
Microsoft.PowerToys.AwakeIndefinitelyKeepAwakeEvent	Triggered when the system is set to stay awake indefinitely.
Microsoft.PowerToys.AwakeNoKeepAwakeEvent	Occurs when Awake is turned off, allowing the computer to enter sleep mode.
Microsoft.PowerToys.AwakeTimedKeepAwakeEvent	Triggered when the system is kept awake for a specified time duration.
Microsoft.PowerToys.Awake_CLICommand	Triggered when an Awake CLI command is executed, logging the command name and success status.

Color Picker

Event Name	Description
Microsoft.PowerToys.ColorPicker_EnableColorPicker	Triggered when Color Picker is enabled.
Microsoft.PowerToys.ColorPicker_Session	Occurs during a Color Picker usage session.
Microsoft.PowerToys.ColorPicker_Settings	Triggered when the settings for the Color Picker are accessed or modified.

Command Not Found

Event Name	Description
Microsoft.PowerToys.CmdNotFound_EnableCmdNotFound	Triggered when Command Not Found is enabled or disabled.
Microsoft.PowerToys.CmdNotFoundInstallEvent	Triggered when a Command Not Found is installed.
Microsoft.PowerToys.CmdNotFoundUninstallEvent	Triggered when Command Not Found is uninstalled after being previously installed.

Command Palette

Event Name	Description
Microsoft.PowerToys.CmdPal_BeginInvoke	Triggered when the Command Palette is launched by the user.
Microsoft.PowerToys.CmdPal_ColdLaunch	Occurs when Command Palette starts for the first time (cold start).
Microsoft.PowerToys.CmdPal_DockConfiguration	Tracks dock configuration at startup including whether the dock is enabled, dock side (top, bottom, left, or right), and the list of extension commands pinned to the start, center, and end sections of the dock.
Microsoft.PowerToys.CmdPal_ExtensionInvoked	Tracks extension usage including extension ID, command details, success status, and execution time.
Microsoft.PowerToys.CmdPal_OpenPage	Triggered when a page is opened within the Command Palette, tracking navigation depth.
Microsoft.PowerToys.CmdPal_OpenUri	Occurs when a URI is opened through the Command Palette, including whether it's a web URL.
Microsoft.PowerToys.CmdPal_ReactivateInstance	Triggered when an existing Command Palette instance is reactivated.
Microsoft.PowerToys.CmdPal_RunCommand	Logs when a command is executed through the Command Palette, including admin elevation status.
Microsoft.PowerToys.CmdPal_RunQuery	Triggered when a search query is performed, including result count and duration.
Microsoft.PowerToys.CmdPal_SessionDuration	Logs session metrics from launch to dismissal including duration, commands executed, pages visited, search queries, navigation depth, and errors.
Microsoft.PowerToys.CmdPalDismissedOnEsc	Occurs when the Command Palette is dismissed by pressing the Escape key.
Microsoft.PowerToys.CmdPalDismissedOnLostFocus	Triggered when the Command Palette is dismissed due to losing focus.
Microsoft.PowerToys.CmdPalHotkeySummoned	Logs when the Command Palette is summoned via hotkey, distinguishing between global and context-specific hotkeys.
Microsoft.PowerToys.CmdPalInvokeResult	Records the result type of a Command Palette invocation.
Microsoft.PowerToys.CmdPalProcessStarted	Triggered when the Command Palette process is started.
Microsoft.PowerToys.CmdPal_SearchResults	Triggered when a search is triggered on the main list, including query length, result count, and duration.
Microsoft.PowerToys.CmdPal_SearchResultSelected	Triggered when a search result is selected, including query length, selection index, and result tier.

Crop and lock

Event Name	Description
Microsoft.PowerToys.CropAndLock_ActivateReparent	Triggered when the cropping interface is activated for reparenting the cropped content.
Microsoft.PowerToys.CropAndLock_ActivateScreenshot	Triggered when the screenshot mode is activated in Crop and Lock.
Microsoft.PowerToys.CropAndLock_ActivateThumbnail	Occurs when the thumbnail view for cropped content is activated.
Microsoft.PowerToys.CropAndLock_CreateReparentWindow	Triggered when a reparent window is created in Crop and Lock mode.
Microsoft.PowerToys.CropAndLock_CreateScreenshotWindow	Triggered when a screenshot window is created in Crop and Lock mode.
Microsoft.PowerToys.CropAndLock_CreateThumbnailWindow	Triggered when a thumbnail window is created in Crop and Lock mode.
Microsoft.PowerToys.CropAndLock_EnableCropAndLock	Triggered when Crop and Lock is enabled.
Microsoft.PowerToys.CropAndLock_Settings	Occurs when settings related to Crop and Lock are modified.

Cursor Wrap

Event Name	Description
Microsoft.PowerToys.CursorWrap_EnableCursorWrap	Triggered when Cursor Wrap is enabled or disabled.

Environment Variables

Event Name	Description
Microsoft.PowerToys.EnvironmentVariables_Activate	Triggered when Environment Variables is launched.
Microsoft.PowerToys.EnvironmentVariables_EnableEnvironmentVariables	Occurs when Environment Variables is enabled.
Microsoft.PowerToys.EnvironmentVariablesOpenedEvent	Triggered when the Environment Variables interface is opened.
Microsoft.PowerToys.EnvironmentVariablesProfileEnabledEvent	Occurs when an environment variable profile is enabled.
Microsoft.PowerToys.EnvironmentVariablesVariableChangedEvent	Triggered when an environment variable is added, modified, or deleted.

FancyZones

Event Name	Description
Microsoft.PowerToys.FancyZones_CLICommand	Triggered when a FancyZones CLI command is executed, logging the command name and success status.
Microsoft.PowerToys.FancyZones_CycleActiveZoneSet	Triggered when the active zone set is cycled through.
Microsoft.PowerToys.FancyZones_EditorLaunch	Occurs when the FancyZones editor is launched.
Microsoft.PowerToys.FancyZones_EnableFancyZones	Occurs when FancyZones is enabled.
Microsoft.PowerToys.FancyZones_Error	Triggered when an error occurs within the FancyZones module. This event logs critical errors to help diagnose and troubleshoot issues with FancyZones functionality, such as failures to set up Windows hooks or other system-level operations required for window management.
Microsoft.PowerToys.FancyZones_KeyboardSnapWindowToZone	Triggered when a window is snapped to a zone using the keyboard.
Microsoft.PowerToys.FancyZones_MoveOrResizeEnded	Occurs when a window move or resize action has completed.
Microsoft.PowerToys.FancyZones_MoveOrResizeStarted	Triggered when a window move or resize action is initiated.
Microsoft.PowerToys.FancyZones_OnKeyDown	Triggered when a key is pressed down while interacting with zones.
Microsoft.PowerToys.FancyZones_QuickLayoutSwitch	Occurs when a quick switch between zone layouts is performed.
Microsoft.PowerToys.FancyZones_Settings	Triggered when FancyZones settings are accessed or modified.
Microsoft.PowerToys.FancyZones_SnapNewWindowIntoZone	Triggered when a new window is snapped into a zone.
Microsoft.PowerToys.FancyZones_VirtualDesktopChanged	Occurs when the virtual desktop changes, affecting zone layout.
Microsoft.PowerToys.FancyZones_ZoneSettingsChanged	Triggered when the settings for specific zones are altered.
Microsoft.PowerToys.FancyZones_ZoneWindowKeyUp	Occurs when a key is released while interacting with zones.
Microsoft.PowerToys.FancyZonesEditorStartEvent	Triggered when the FancyZones Editor application starts. This logs the initialization of the editor UI, which is used to create and configure custom zone layouts.
Microsoft.PowerToys.FancyZonesEditorStartFinishEvent	Triggered when the FancyZones Editor has completed loading and is ready for user interaction.

File Locksmith

Event Name	Description
Microsoft.PowerToys.FileLocksmith_EnableFileLocksmith	Triggered when File Locksmith is enabled.
Microsoft.PowerToys.FileLocksmith_Invoked	Occurs when File Locksmith is invoked.
Microsoft.PowerToys.FileLocksmith_InvokedRet	Triggered when File Locksmith invocation returns a result.
Microsoft.PowerToys.FileLocksmith_QueryContextMenuError	Occurs when there is an error querying the context menu for File Locksmith.
Microsoft.PowerToys.FileLocksmith_ServicingWindowInitialization	Records the HRESULT result of initializing the servicing window for the packaged File Locksmith context-menu surrogate.
Microsoft.PowerToys.FileLocksmith_CLICommand	Triggered when a File Locksmith CLI command is executed, logging the operation mode (query, kill, query-wait, query-json, or help) and success status.

FileExplorerAddOns

Event Name	Description
Microsoft.PowerToys.BgcodeFileHandlerLoaded	Triggered when a Binary G-code file handler is loaded.
Microsoft.PowerToys.BgcodeFilePreviewed	Occurs when a Binary G-code file is previewed in File Explorer.
Microsoft.PowerToys.BgcodeFilePreviewError	Triggered when there is an error previewing a Binary G-code file.
Microsoft.PowerToys.GcodeFileHandlerLoaded	Triggered when a G-code file handler is loaded.
Microsoft.PowerToys.GcodeFilePreviewed	Occurs when a G-code file is previewed in File Explorer.
Microsoft.PowerToys.GcodeFilePreviewError	Triggered when there is an error previewing a G-code file.
Microsoft.PowerToys.MarkdownFileHandlerLoaded	Occurs when a Markdown file handler is loaded.
Microsoft.PowerToys.MarkdownFilePreviewed	Triggered when a Markdown file is previewed in File Explorer.
Microsoft.PowerToys.MarkdownFilePreviewError	Triggered when there is an error previewing a Markdown file in File Explorer.
Microsoft.PowerToys.PdfFileHandlerLoaded	Occurs when a PDF file handler is loaded.
Microsoft.PowerToys.PdfFilePreviewed	Triggered when a PDF file is previewed in File Explorer.
Microsoft.PowerToys.PdfFilePreviewError	Triggered when there is an error previewing a PDF file in File Explorer.
Microsoft.PowerToys.PowerPreview_Enabled	Occurs when preview is enabled.
Microsoft.PowerToys.PowerPreview_TweakUISettings_Destroyed	Triggered when the Tweak UI settings for Power Preview are destroyed.
Microsoft.PowerToys.PowerPreview_TweakUISettings_FailedUpdatingSettings	Occurs when updating Tweak UI settings fails.
Microsoft.PowerToys.PowerPreview_TweakUISettings_InitSet__ErrorLoadingFile	Triggered when there is an error loading a file during Tweak UI settings initialization.
Microsoft.PowerToys.PowerPreview_TweakUISettings_SetConfig__InvalidJSONGiven	Triggered when invalid JSON is provided to the Power Preview settings configuration.
Microsoft.PowerToys.PowerPreview_TweakUISettings_SuccessfullyUpdatedSettings	Occurs when the Tweak UI settings for Power Preview are successfully updated.
Microsoft.PowerToys.QoiFilePreviewed	Triggered when a QOI file is previewed in File Explorer.
Microsoft.PowerToys.QoiFilePreviewError	Triggered when there is an error previewing a QOI (Quite OK Image) file in File Explorer.
Microsoft.PowerToys.SvgFileHandlerLoaded	Occurs when an SVG file handler is loaded.
Microsoft.PowerToys.SvgFilePreviewed	Triggered when an SVG file is previewed in File Explorer.
Microsoft.PowerToys.SvgFilePreviewError	Occurs when there is an error previewing an SVG file.

Find My Mouse

Event Name	Description
Microsoft.PowerToys.FindMyMouse_EnableFindMyMouse	Triggered when Find My Mouse is enabled.
Microsoft.PowerToys.FindMyMouse_MousePointerFocused	Occurs when the mouse pointer is focused using Find My Mouse, including the activation method (double-tap left/right Ctrl, shake mouse, or shortcut).

Grab And Move

Event Name	Description
Microsoft.PowerToys.GrabAndMove_EnableGrabAndMove	Triggered when Grab And Move is enabled or disabled.
Microsoft.PowerToys.GrabAndMove_ShortcutUse	Logs an attempt to move or resize a window via the Alt+Drag shortcut, including whether it succeeded, the action type (move or resize), and the reason (e.g., started, blocked by game mode).

Hosts File Editor

Event Name	Description
Microsoft.PowerToys.HostEditorStartEvent	Triggered when the Hosts File Editor application starts. This logs the initialization of the Hosts File Editor UI with a timestamp.
Microsoft.PowerToys.HostEditorStartFinishEvent	Triggered when the Hosts File Editor has completed loading and is ready for user interaction.
Microsoft.PowerToys.HostsFileEditor_Activate	Triggered when Hosts File Editor is activated.
Microsoft.PowerToys.HostsFileEditor_EnableHostsFileEditor	Occurs when Hosts File Editor is enabled.
Microsoft.PowerToys.HostsFileEditorOpenedEvent	Fires when Hosts File Editor is opened.

Image Resizer

Event Name	Description
Microsoft.PowerToys.ImageResizer_EnableImageResizer	Triggered when Image Resizer is enabled.
Microsoft.PowerToys.ImageResizer_Invoked	Occurs when Image Resizer is invoked by the user.
Microsoft.PowerToys.ImageResizer_InvokedRet	Fires when the Image Resizer operation is completed and returns a result.
Microsoft.PowerToys.ImageResizer_QueryContextMenuError	Triggered when there is an error querying the context menu for Image Resizer.
Microsoft.PowerToys.ImageResizer_ServicingWindowInitialization	Records the HRESULT result of initializing the servicing window for the packaged Image Resizer context-menu surrogate.
Microsoft.PowerToys.ImageResizer_CLICommand	Triggered when an Image Resizer CLI command is executed, logging the command name and success status.

Keyboard Manager

Event Name	Description
Microsoft.PowerToys.KeyboardManager_AppSpecificShortcutRemapConfigurationLoaded	Indicates that the application-specific shortcut remap configuration has been successfully loaded.
Microsoft.PowerToys.KeyboardManager_AppSpecificShortcutRemapCount	Logs the number of application-specific shortcut remaps configured by the user.
Microsoft.PowerToys.KeyboardManager_AppSpecificShortcutToKeyRemapInvoked	Logs each instance when an application-specific shortcut-to-key remap is used.
Microsoft.PowerToys.KeyboardManager_AppSpecificShortcutToShortcutRemapInvoked	Logs each instance when an application-specific shortcut-to-shortcut remap is used.
Microsoft.PowerToys.KeyboardManager_DailyAppSpecificShortcutToKeyRemapInvoked	Logs the daily count of application-specific shortcut-to-key remaps executed by the user.
Microsoft.PowerToys.KeyboardManager_DailyAppSpecificShortcutToShortcutRemapInvoked	Logs the daily count of application-specific shortcut-to-shortcut remaps executed by the user.
Microsoft.PowerToys.KeyboardManager_DailyKeyToKeyRemapInvoked	Logs the daily count of key-to-key remaps used by the user.
Microsoft.PowerToys.KeyboardManager_DailyKeyToShortcutRemapInvoked	Logs the daily count of key-to-shortcut remaps used by the user.
Microsoft.PowerToys.KeyboardManager_DailyShortcutToKeyRemapInvoked	Logs the daily count of shortcut-to-key remaps used by the user.
Microsoft.PowerToys.KeyboardManager_DailyShortcutToShortcutRemapInvoked	Logs the daily count of shortcut-to-shortcut remaps used by the user.
Microsoft.PowerToys.KeyboardManager_EnableKeyboardManager	Indicates that the Keyboard Manager has been enabled in PowerToys settings.
Microsoft.PowerToys.KeyboardManager_Error	Triggered when an error occurs in Keyboard Manager. This logs the error code, error message, and the method name where the error occurred.
Microsoft.PowerToys.KeyboardManager_ErrorSendingKeyAndShortcutRemapLoadedConfiguration	Triggered when there is an error sending remapping configuration telemetry. This occurs when Keyboard Manager fails to report the loaded key and shortcut remap configurations.
Microsoft.PowerToys.KeyboardManager_KeyRemapConfigurationLoaded	Indicates that the key remap configuration has been successfully loaded.
Microsoft.PowerToys.KeyboardManager_KeyRemapCount	Logs the number of individual key remaps configured by the user.
Microsoft.PowerToys.KeyboardManager_KeyToKeyRemapInvoked	Logs each instance of a key-to-key remap being used.
Microsoft.PowerToys.KeyboardManager_KeyToShortcutRemapInvoked	Logs each instance of a key-to-shortcut remap being used.
Microsoft.PowerToys.KeyboardManager_LaunchEditor	Logs when the Keyboard Manager editor is launched, including whether it was opened via hotkey or through settings.
Microsoft.PowerToys.KeyboardManager_OSLevelShortcutRemapCount	Logs the total number of OS-level shortcut remaps configured by the user.
Microsoft.PowerToys.KeyboardManager_OSLevelShortcutToKeyRemapInvoked	Logs each instance of an OS-level shortcut-to-key remap being used.
Microsoft.PowerToys.KeyboardManager_OSLevelShortcutToShortcutRemapInvoked	Logs each instance of an OS-level shortcut-to-shortcut remap being used.
Microsoft.PowerToys.KeyboardManager_ShortcutRemapConfigurationLoaded	Indicates that the shortcut remap configuration has been successfully loaded.

Light Switch

Event Name	Description
Microsoft.PowerToys.LightSwitch_CLICommand	Triggered when the Light Switch CLI is invoked, logging only a fixed command category and success status based on the final exit code. Raw arguments, schedule values, and file paths are not collected.
Microsoft.PowerToys.LightSwitch_EnableLightSwitch	Triggered when Light Switch is enabled or disabled.
Microsoft.PowerToys.LightSwitch_ScheduleModeToggled	Occurs when a new schedule mode is selected for Light Switch.
Microsoft.PowerToys.LightSwitch_ShortcutInvoked	Occurs when the shortcut for Light Switch is invoked.
Microsoft.PowerToys.LightSwitch_ThemeTargetChanged	Occurs when the options for targeting the system or apps is updated.

Mouse Button Lock

Event Name	Description
Microsoft.PowerToys.MouseButtonLock_EnableMouseButtonLock	Triggered when Mouse Button Lock is enabled or disabled.

Mouse Highlighter

Event Name	Description
Microsoft.PowerToys.MouseHighlighter_EnableMouseHighlighter	Triggered when Mouse Highlighter is enabled.
Microsoft.PowerToys.MouseHighlighter_StartHighlightingSession	Occurs when a new highlighting session is started.
Microsoft.PowerToys.MouseHighlighter_StartSpotlightSession	Triggered when a spotlight session is started in Mouse Highlighter. This occurs when the user activates the spotlight mode.

Mouse Jump

Event Name	Description
Microsoft.PowerToys.MouseJump_EnableJumpTool	Triggered when Mouse Jump is enabled.
Microsoft.PowerToys.MouseJump_InvokeJumpTool	Occurs when Mouse Jump is invoked.
Microsoft.PowerToys.MouseJumpShowEvent	Triggered when the Mouse Jump display is shown.
Microsoft.PowerToys.MouseJumpTeleportCursorEvent	Occurs when the cursor is teleported to a new location.

Mouse Pointer Crosshairs

Event Name	Description
Microsoft.PowerToys.MousePointerCrosshairs_EnableMousePointerCrosshairs	Triggered when Mouse Pointer Crosshairs is enabled.
Microsoft.PowerToys.MousePointerCrosshairs_StartDrawingCrosshairs	Occurs when the crosshairs are drawn around the mouse pointer.

Mouse Without Borders

Event Name	Description
Microsoft.PowerToys.MouseWithoutBorders_Activate	Triggered when Mouse Without Borders is activated.
Microsoft.PowerToys.MouseWithoutBorders_AddFirewallRule	Occurs when a firewall rule is added for Mouse Without Borders.
Microsoft.PowerToys.MouseWithoutBorders_EnableMouseWithoutBorders	Triggered when Mouse Without Borders is enabled.
Microsoft.PowerToys.MouseWithoutBorders_ToggleServiceRegistration	Occurs when the service registration for Mouse Without Borders is toggled.
Microsoft.PowerToys.MouseWithoutBordersClipboardFileTransferEvent	Triggered during a clipboard file transfer between computers.
Microsoft.PowerToys.MouseWithoutBordersDragAndDropEvent	Occurs during a drag-and-drop operation between computers.
Microsoft.PowerToys.MouseWithoutBordersMultipleModeEvent	Triggered when multiple modes are enabled in Mouse Without Borders.
Microsoft.PowerToys.MouseWithoutBordersOldUIOpenedEvent	Occurs when the old user interface for Mouse Without Borders is opened.
Microsoft.PowerToys.MouseWithoutBordersOldUIQuitEvent	Triggered when the old user interface for Mouse Without Borders is closed.
Microsoft.PowerToys.MouseWithoutBordersOldUIReconfigureEvent	Occurs when the old user interface for Mouse Without Borders is reconfigured.
Microsoft.PowerToys.MouseWithoutBordersStartedEvent	Triggered when Mouse Without Borders is started.

New+

Event Name	Description
Microsoft.PowerToys.NewPlus_ChangedTemplateLocation	Triggered when the template folder location is changed.
Microsoft.PowerToys.NewPlus_EventCopyTemplate	Triggered when an item from New+ is created (copied to the current directory).
Microsoft.PowerToys.NewPlus_EventCopyTemplateResult	Logs the success of item creation (copying).
Microsoft.PowerToys.NewPlus_EventOpenTemplates	Triggered when the templates folder is opened.
Microsoft.PowerToys.NewPlus_EventShowTemplateItems	Triggered when the New+ context menu flyout is displayed.
Microsoft.PowerToys.NewPlus_EventToggleOnOff	Triggered when New+ is enabled or disabled.
Microsoft.PowerToys.NewPlus_ServicingWindowInitialization	Records the HRESULT result of initializing the servicing window for the packaged New+ context-menu surrogate.

Peek

Event Name	Description
Microsoft.PowerToys.Peek_Closed	Triggered when Peek is closed.
Microsoft.PowerToys.Peek_EnablePeek	Occurs when Peek is enabled.
Microsoft.PowerToys.Peek_Error	Triggered when an error occurs for Peek.
Microsoft.PowerToys.Peek_InvokePeek	Occurs when Peek is invoked.
Microsoft.PowerToys.Peek_Opened	Triggered when a Peek window is opened.
Microsoft.PowerToys.Peek_OpenWith	Occurs when an item is opened with Peek.
Microsoft.PowerToys.Peek_Settings	Triggered when the settings for Peek are modified.
Microsoft.PowerToys.Peek_SpaceModeEnabled	Triggered when the Space key activation mode is enabled or disabled in Peek.

Power Display

Event Name	Description
Microsoft.PowerToys.PowerDisplay_CLICommand	Triggered when the PowerDisplay CLI is invoked, logging only a fixed command category and success status based on the final exit code. Raw arguments, monitor IDs, profile values, and file paths are not collected.
Microsoft.PowerToys.PowerDisplay_EnablePowerDisplay	Triggered when Power Display is enabled or disabled.
Microsoft.PowerToys.PowerDisplay_Activate	Triggered when Power Display is activated via hotkey or tray toggle.
Microsoft.PowerToys.PowerDisplay_Start	Triggered when the Power Display application process starts.
Microsoft.PowerToys.PowerDisplay_Settings	Periodic snapshot of Power Display settings, including whether the hotkey and tray icon are enabled, the number of detected monitors, and the number of saved profiles.

PowerRename

Event Name	Description
Microsoft.PowerToys.PowerRename_EnablePowerRename	Triggered when PowerRename is enabled.
Microsoft.PowerToys.PowerRename_Invoked	Occurs when PowerRename is invoked.
Microsoft.PowerToys.PowerRename_InvokedRet	Triggered when the invocation of PowerRename returns a result.
Microsoft.PowerToys.PowerRename_RenameOperation	Triggered during the rename operation within PowerRename.
Microsoft.PowerToys.PowerRename_ServicingWindowInitialization	Records the HRESULT result of initializing the servicing window for the packaged PowerRename context-menu surrogate.
Microsoft.PowerToys.PowerRename_SettingsChanged	Occurs when the settings for PowerRename are changed.
Microsoft.PowerToys.PowerRename_UIShownRet	Triggered when the PowerRename user interface is shown.

PowerToys Run

Event Name	Description
Microsoft.PowerToys.LauncherBootEvent	Triggered when PowerToys Run is initialized on boot.
Microsoft.PowerToys.LauncherColdStateHotkeyEvent	Occurs when the hotkey is pressed in the cold state (not yet initialized).
Microsoft.PowerToys.LauncherFirstDeleteEvent	Triggered when the first deletion action is performed in PowerToys Run.
Microsoft.PowerToys.LauncherHideEvent	Occurs when PowerToys Run is hidden.
Microsoft.PowerToys.LauncherQueryEvent	Triggered when a query is made in PowerToys Run.
Microsoft.PowerToys.LauncherResultActionEvent	Occurs when an action is taken on a result in PowerToys Run.
Microsoft.PowerToys.LauncherShowEvent	Triggered when PowerToys Run is shown.
Microsoft.PowerToys.LauncherWarmStateHotkeyEvent	Occurs when the hotkey is pressed in the warm state (initialized).
Microsoft.PowerToys.RunPluginsSettingsEvent	Triggered when the settings for PowerToys Run plugins are accessed or modified.

Quick Accent

Event Name	Description
Microsoft.PowerToys.PowerAccent_EnablePowerAccent	Triggered when Quick Accent is enabled.
Microsoft.PowerToys.PowerAccentShowAccentMenuEvent	Occurs when the accent menu is displayed.

Registry Preview

Event Name	Description
Microsoft.PowerToys.RegistryPreview_Activate	Triggered when Registry Preview is activated.
Microsoft.PowerToys.RegistryPreview_EnableRegistryPreview	Occurs when Registry Preview is enabled.
Microsoft.PowerToys.RegistryPreviewEditorStartEvent	Triggered when the Registry Preview application starts. This logs the initialization of the Registry Preview UI with a timestamp.
Microsoft.PowerToys.RegistryPreviewEditorStartFinishEvent	Triggered when the Registry Preview application has completed loading and is ready for user interaction.

Screen Ruler

Event Name	Description
Microsoft.PowerToys.MeasureTool_BoundsToolActivated	Triggered when Screen Ruler's Bounds tool is activated.
Microsoft.PowerToys.MeasureTool_EnableMeasureTool	Occurs when Screen Ruler is enabled.
Microsoft.PowerToys.MeasureTool_MeasureToolActivated	Triggered when Screen Ruler's Measure tool is activated.

Shortcut Guide

Event Name	Description
Microsoft.PowerToys.ShortcutGuide_GuideSession	Logs a Shortcut Guide session including duration and how it was closed.
Microsoft.PowerToys.ShortcutGuide_Settings	Indicates a change in the settings related to the Shortcut Guide.

Text Extractor

Event Name	Description
Microsoft.PowerToys.PowerOCR_EnablePowerOCR	Triggered when the Text Extractor (OCR) feature is enabled.
Microsoft.PowerToys.PowerOCRCancelledEvent	Occurs when the text extraction process is cancelled.
Microsoft.PowerToys.PowerOCRCaptureEvent	Occurs when the user has created a capture for text extraction.
Microsoft.PowerToys.PowerOCRInvokedEvent	Triggered when Text Extractor is invoked.

Workspaces

Event Name	Description
Microsoft.PowerToys.Workspaces_CLICommand	Triggered once per Workspaces CLI invocation when optional diagnostics are enabled. Records only a fixed command category (list, launch, help, version, none, or unknown) and success status. Workspace names and IDs, application paths, arguments, and error text are not collected.
Microsoft.PowerToys.Workspaces_CreateEvent	Triggered when a new workspace is created.
Microsoft.PowerToys.Workspaces_DeleteEvent	Triggered when a workspace is deleted.
Microsoft.PowerToys.Workspaces_EditEvent	Triggered when a workspace is edited or modified.
Microsoft.PowerToys.Workspaces_Enable	Indicates that Workspaces is enabled.
Microsoft.PowerToys.Workspaces_LaunchEvent	Triggered when a workspace is launched.
Microsoft.PowerToys.WorkspacesEditorStartEvent	Triggered when the Workspaces Editor application starts. This logs the initialization of the Workspaces Editor UI with a timestamp.
Microsoft.PowerToys.WorkspacesEditorStartFinishEvent	Triggered when the Workspaces Editor has completed loading and is ready for user interaction.

ZoomIt

Event Name	Description
Microsoft.PowerToys.ZoomIt_ActivateBreak	Triggered when the Break mode is entered.
Microsoft.PowerToys.ZoomIt_ActivateDemoType	Triggered when the DemoType mode is entered.
Microsoft.PowerToys.ZoomIt_ActivateDraw	Triggered when the Draw mode is entered.
Microsoft.PowerToys.ZoomIt_ActivateLiveZoom	Triggered when the Live Zoom mode is entered.
Microsoft.PowerToys.ZoomIt_ActivateRecord	Triggered when the Record mode is entered.
Microsoft.PowerToys.ZoomIt_ActivateSnip	Triggered when the Snip mode is entered.
Microsoft.PowerToys.ZoomIt_ActivateZoom	Triggered when the Zoom mode is entered.
Microsoft.PowerToys.ZoomIt_EnableZoomIt	Triggered when ZoomIt is enabled/disabled.
Microsoft.PowerToys.ZoomIt_Started	Triggered when the ZoomIt process starts.

38 KiB Raw Permalink Blame History