/ DATA_AND_PRIVACY.md
DATA_AND_PRIVACY.md
1 # PowerToys Data & Privacy 2 ## Overview 3 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. 4 5 Additionally, this document aims to list each diagnostic data event individually and describe their purpose clearly. 6 7 For more information, please read the [Microsoft privacy statement](https://privacy.microsoft.com/privacystatement). 8 9 ## What does PowerToys collect? 10 11 1. **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! 12 2. **Stability**: Monitoring bugs and system crashes, as well as analyzing GitHub issue reports, assists us in prioritizing the most urgent issues. 13 3. **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. 14 15 ### Success Story: Fixing FancyZones Bugs with Your Help 16 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. 17 18 ## Transparency and Public Sharing 19 As much as possible, we aim to share the results of diagnostic data publicly. 20 21 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. 22 23 Thank you for using PowerToys! 24 25 ## List of Diagnostic Data Events 26 _**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._ 27 28 _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 langauge._ 29 - [C# events](https://github.com/search?q=repo%3Amicrosoft/PowerToys%20EventBase&type=code) 30 - [C++ events](https://github.com/search?q=repo%3Amicrosoft%2FPowerToys+ProjectTelemetryPrivacyDataTag&type=code) 31 32 ### General 33 <table style="width:100%; table-layout:fixed"> 34 <colgroup> 35 <col style="width:40%"> 36 <col style="width:60%"> 37 </colgroup> 38 <tr> 39 <th>Event Name</th> 40 <th>Description</th> 41 </tr> 42 <tr> 43 <td>Microsoft.PowerToys.DebugEvent</td> 44 <td>Logs debugging information for diagnostics and troubleshooting.</td> 45 </tr> 46 <tr> 47 <td>Microsoft.PowerToys.GeneralSettingsChanged</td> 48 <td>Logs changes made to general settings within PowerToys.</td> 49 </tr> 50 <tr> 51 <td>Microsoft.PowerToys.Install_Fail</td> 52 <td>Triggered when the PowerToys installation process encounters an error and fails to complete.</td> 53 </tr> 54 <tr> 55 <td>Microsoft.PowerToys.Repair_Cancel</td> 56 <td>Triggered when a PowerToys repair operation is cancelled by the user before completion.</td> 57 </tr> 58 <tr> 59 <td>Microsoft.PowerToys.Repair_Fail</td> 60 <td>Triggered when the PowerToys repair operation fails to complete successfully due to an error.</td> 61 </tr> 62 <tr> 63 <td>Microsoft.PowerToys.Runner_Launch</td> 64 <td>Indicates when the PowerToys Runner is launched.</td> 65 </tr> 66 <tr> 67 <td>Microsoft.PowerToys.SettingsBootEvent</td> 68 <td>Triggered when PowerToys settings are initialized at startup.</td> 69 </tr> 70 <tr> 71 <td>Microsoft.PowerToys.SettingsEnabledEvent</td> 72 <td>Indicates that the PowerToys settings have been enabled.</td> 73 </tr> 74 <tr> 75 <td>Microsoft.PowerToys.ScoobeStartedEvent</td> 76 <td>Triggered when SCOOBE (Secondary Out-of-box experience) starts.</td> 77 </tr> 78 <tr> 79 <td>Microsoft.PowerToys.ShortcutConflictControlClickedEvent</td> 80 <td>Triggered when a user clicks on the Shortcut Conflict Control button in the PowerToys Settings UI Dashboard.</td> 81 </tr> 82 <tr> 83 <td>Microsoft.PowerToys.ShortcutConflictDetectedEvent</td> 84 <td>Triggered when keyboard shortcut conflicts are detected in the PowerToys Settings UI Dashboard.</td> 85 </tr> 86 <tr> 87 <td>Microsoft.PowerToys.ShortcutConflictResolvedEvent</td> 88 <td>Triggered when a keyboard shortcut conflict is resolved in the PowerToys Settings UI.</td> 89 </tr> 90 <tr> 91 <td>Microsoft.PowerToys.TrayFlyoutActivatedEvent</td> 92 <td>Indicates when the tray flyout menu is activated.</td> 93 </tr> 94 <tr> 95 <td>Microsoft.PowerToys.TrayFlyoutModuleRunEvent</td> 96 <td>Logs when a utility from the tray flyout menu is run.</td> 97 </tr> 98 <tr> 99 <td>Microsoft.PowerToys.UnInstall_Cancel</td> 100 <td>Triggered when the PowerToys uninstallation process is cancelled by the user before completion.</td> 101 </tr> 102 <tr> 103 <td>Microsoft.PowerToys.UnInstall_Fail</td> 104 <td>Triggered when the PowerToys uninstallation process fails to complete successfully due to an error. </td> 105 </tr> 106 <tr> 107 <td>Microsoft.PowerToys.Uninstall_Success</td> 108 <td>Logs when PowerToys is successfully uninstalled (who would do such a thing!).</td> 109 </tr> 110 <tr> 111 <td>Microsoft.PowerToys.UpdateCheck_Completed</td> 112 <td>Logs when an auto-update check completes, including success status, whether an update is available, and version information.</td> 113 </tr> 114 <tr> 115 <td>Microsoft.PowerToys.UpdateDownload_Completed</td> 116 <td>Logs when an update download completes, including success status and version.</td> 117 </tr> 118 </table> 119 120 ### OOBE (Out-of-box experience) 121 <table style="width:100%; table-layout:fixed"> 122 <colgroup> 123 <col style="width:40%"> 124 <col style="width:60%"> 125 </colgroup> 126 <tr> 127 <th>Event Name</th> 128 <th>Description</th> 129 </tr> 130 <tr> 131 <td>Microsoft.PowerToys.OobeModuleRunEvent</td> 132 <td>Triggered when a user clicks to run or launch a PowerToys module directly from the OOBE (out-of-box experience) interface.</td> 133 </tr> 134 <tr> 135 <td>Microsoft.PowerToys.OobeSectionEvent</td> 136 <td>Occurs when OOBE is shown to the user.</td> 137 </tr> 138 <tr> 139 <td>Microsoft.PowerToys.OobeSettingsEvent</td> 140 <td>Triggers when a Settings page is opened from an OOBE page.</td> 141 </tr> 142 <tr> 143 <td>Microsoft.PowerToys.OobeStartedEvent</td> 144 <td>Indicates when the out-of-box experience has been initiated.</td> 145 </tr> 146 <tr> 147 <td>Microsoft.PowerToys.OobeVariantAssignmentEvent</td> 148 <td>This event logs A/B testing assignments for experimental features, helping track which users are in control or alternate groups for feature experiments. </td> 149 </tr> 150 </table> 151 152 ### Advanced Paste 153 <table style="width:100%; table-layout:fixed"> 154 <colgroup> 155 <col style="width:40%"> 156 <col style="width:60%"> 157 </colgroup> 158 <tr> 159 <th>Event Name</th> 160 <th>Description</th> 161 </tr> 162 <tr> 163 <td>Microsoft.PowerToys.AdvancedPaste_EnableAdvancedPaste</td> 164 <td>Triggered when Advanced Paste is enabled.</td> 165 </tr> 166 <tr> 167 <td>Microsoft.PowerToys.AdvancedPaste_Error</td> 168 <td>Occurs when an error is encountered during the Advanced Paste process.</td> 169 </tr> 170 <tr> 171 <td>Microsoft.PowerToys.AdvancedPaste_InvokeAdvancedPaste</td> 172 <td>Activated when Advanced Paste is called by the user.</td> 173 </tr> 174 <tr> 175 <td>Microsoft.PowerToys.AdvancedPaste_Settings</td> 176 <td>Triggered when settings for Advanced Paste are accessed or modified.</td> 177 </tr> 178 <tr> 179 <td>Microsoft.PowerToys.AdvancedPasteClipboardItemClicked</td> 180 <td>Occurs when a clipboard item is selected from the Advanced Paste menu.</td> 181 </tr> 182 <tr> 183 <td>Microsoft.PowerToys.AdvancedPasteClipboardItemDeletedEvent</td> 184 <td>Triggered when an item is removed from the Advanced Paste clipboard history.</td> 185 </tr> 186 <tr> 187 <td>Microsoft.PowerToys.AdvancedPasteCustomFormatOutputThumbUpDownEvent</td> 188 <td>Triggered when a user gives feedback on a custom format output (thumb up/down).</td> 189 </tr> 190 <tr> 191 <td>Microsoft.PowerToys.AdvancedPasteFormatClickedEvent</td> 192 <td>Occurs when a specific paste format is clicked in the Advanced Paste menu.</td> 193 </tr> 194 <tr> 195 <td>Microsoft.PowerToys.AdvancedPasteGenerateCustomErrorEvent</td> 196 <td>Triggered when an error occurs while generating a custom paste format.</td> 197 </tr> 198 <tr> 199 <td>Microsoft.PowerToys.AdvancedPasteGenerateCustomFormatEvent</td> 200 <td>Occurs when a custom paste format is successfully generated.</td> 201 </tr> 202 <tr> 203 <td>Microsoft.PowerToys.AdvancedPasteInAppKeyboardShortcutEvent</td> 204 <td>Triggered when a keyboard shortcut is used within the Advanced Paste interface.</td> 205 </tr> 206 <tr> 207 <td>Microsoft.PowerToys.AdvancedPasteSemanticKernelFormatEvent</td> 208 <td>Triggered when Advanced Paste leverages the Semantic Kernel.</td> 209 </tr> 210 <tr> 211 <td>Microsoft.PowerToys.AdvancedPasteSemanticKernelErrorEvent</td> 212 <td>Occurs when the Semantic Kernel workflow encounters an error.</td> 213 </tr> 214 <tr> 215 <td>Microsoft.PowerToys.AdvancedPasteEndpointUsageEvent</td> 216 <td>Logs the AI provider, model, and processing duration for each endpoint call.</td> 217 </tr> 218 <tr> 219 <td>Microsoft.PowerToys.AdvancedPasteCustomActionErrorEvent</td> 220 <td>Records provider, model, and status details when a custom action fails.</td> 221 </tr> 222 </table> 223 224 ### Always on Top 225 <table style="width:100%; table-layout:fixed"> 226 <colgroup> 227 <col style="width:40%"> 228 <col style="width:60%"> 229 </colgroup> 230 <tr> 231 <th>Event Name</th> 232 <th>Description</th> 233 </tr> 234 <tr> 235 <td>Microsoft.PowerToys.AlwaysOnTop_EnableAlwaysOnTop</td> 236 <td>Triggered when Always on Top is enabled.</td> 237 </tr> 238 <tr> 239 <td>Microsoft.PowerToys.AlwaysOnTop_PinWindow</td> 240 <td>Occurs when a window is pinned to stay on top of other windows.</td> 241 </tr> 242 <tr> 243 <td>Microsoft.PowerToys.AlwaysOnTop_UnpinWindow</td> 244 <td>Triggered when a pinned window is unpinned, allowing it to be behind other windows.</td> 245 </tr> 246 </table> 247 248 ### Awake 249 <table style="width:100%; table-layout:fixed"> 250 <colgroup> 251 <col style="width:40%"> 252 <col style="width:60%"> 253 </colgroup> 254 <tr> 255 <th>Event Name</th> 256 <th>Description</th> 257 </tr> 258 <tr> 259 <td>Microsoft.PowerToys.Awake_EnableAwake</td> 260 <td>Triggered when Awake is enabled.</td> 261 </tr> 262 <tr> 263 <td>Microsoft.PowerToys.AwakeExpirableKeepAwakeEvent</td> 264 <td>Occurs when the system is kept awake for a temporary, expirable duration.</td> 265 </tr> 266 <tr> 267 <td>Microsoft.PowerToys.AwakeIndefinitelyKeepAwakeEvent</td> 268 <td>Triggered when the system is set to stay awake indefinitely.</td> 269 </tr> 270 <tr> 271 <td>Microsoft.PowerToys.AwakeNoKeepAwakeEvent</td> 272 <td>Occurs when Awake is turned off, allowing the computer to enter sleep mode.</td> 273 </tr> 274 <tr> 275 <td>Microsoft.PowerToys.AwakeTimedKeepAwakeEvent</td> 276 <td>Triggered when the system is kept awake for a specified time duration.</td> 277 </tr> 278 </table> 279 280 ### Color Picker 281 <table style="width:100%; table-layout:fixed"> 282 <colgroup> 283 <col style="width:40%"> 284 <col style="width:60%"> 285 </colgroup> 286 <tr> 287 <th>Event Name</th> 288 <th>Description</th> 289 </tr> 290 <tr> 291 <td>Microsoft.PowerToys.ColorPicker_EnableColorPicker</td> 292 <td>Triggered when Color Picker is enabled.</td> 293 </tr> 294 <tr> 295 <td>Microsoft.PowerToys.ColorPicker_Session</td> 296 <td>Occurs during a Color Picker usage session.</td> 297 </tr> 298 <tr> 299 <td>Microsoft.PowerToys.ColorPicker_Settings</td> 300 <td>Triggered when the settings for the Color Picker are accessed or modified.</td> 301 </tr> 302 </table> 303 304 ### Command Not Found 305 <table style="width:100%; table-layout:fixed"> 306 <colgroup> 307 <col style="width:40%"> 308 <col style="width:60%"> 309 </colgroup> 310 <tr> 311 <th>Event Name</th> 312 <th>Description</th> 313 </tr> 314 <tr> 315 <td>Microsoft.PowerToys.CmdNotFound_EnableCmdNotFound</td> 316 <td>Triggered when Command Not Found is enabled or disabled.</td> 317 </tr> 318 <tr> 319 <td>Microsoft.PowerToys.CmdNotFoundInstallEvent</td> 320 <td>Triggered when a Command Not Found is installed.</td> 321 </tr> 322 <tr> 323 <td>Microsoft.PowerToys.CmdNotFoundUninstallEvent</td> 324 <td>Triggered when Command Not Found is uninstalled after being previously installed.</td> 325 </tr> 326 </table> 327 328 ### Command Palette 329 330 <table style="width:100%; table-layout:fixed"> 331 <colgroup> 332 <col style="width:40%"> 333 <col style="width:60%"> 334 </colgroup> 335 <tr> 336 <th>Event Name</th> 337 <th>Description</th> 338 </tr> 339 <tr> 340 <td>Microsoft.PowerToys.CmdPal_BeginInvoke</td> 341 <td>Triggered when the Command Palette is launched by the user.</td> 342 </tr> 343 <tr> 344 <td>Microsoft.PowerToys.CmdPal_ColdLaunch</td> 345 <td>Occurs when Command Palette starts for the first time (cold start).</td> 346 </tr> 347 <tr> 348 <td>Microsoft.PowerToys.CmdPal_OpenPage</td> 349 <td>Triggered when a page is opened within the Command Palette, tracking navigation depth.</td> 350 </tr> 351 <tr> 352 <td>Microsoft.PowerToys.CmdPal_OpenUri</td> 353 <td>Occurs when a URI is opened through the Command Palette, including whether it's a web URL.</td> 354 </tr> 355 <tr> 356 <td>Microsoft.PowerToys.CmdPal_ReactivateInstance</td> 357 <td>Triggered when an existing Command Palette instance is reactivated.</td> 358 </tr> 359 <tr> 360 <td>Microsoft.PowerToys.CmdPal_RunCommand</td> 361 <td>Logs when a command is executed through the Command Palette, including admin elevation status.</td> 362 </tr> 363 <tr> 364 <td>Microsoft.PowerToys.CmdPal_RunQuery</td> 365 <td>Triggered when a search query is performed, including result count and duration.</td> 366 </tr> 367 <tr> 368 <td>Microsoft.PowerToys.CmdPalDismissedOnEsc</td> 369 <td>Occurs when the Command Palette is dismissed by pressing the Escape key.</td> 370 </tr> 371 <tr> 372 <td>Microsoft.PowerToys.CmdPalDismissedOnLostFocus</td> 373 <td>Triggered when the Command Palette is dismissed due to losing focus.</td> 374 </tr> 375 <tr> 376 <td>Microsoft.PowerToys.CmdPalHotkeySummoned</td> 377 <td>Logs when the Command Palette is summoned via hotkey, distinguishing between global and context-specific hotkeys.</td> 378 </tr> 379 <tr> 380 <td>Microsoft.PowerToys.CmdPalInvokeResult</td> 381 <td>Records the result type of a Command Palette invocation.</td> 382 </tr> 383 <tr> 384 <td>Microsoft.PowerToys.CmdPalProcessStarted</td> 385 <td>Triggered when the Command Palette process is started.</td> 386 </tr> 387 <tr> 388 <td>Microsoft.PowerToys.CmdPal_ExtensionInvoked</td> 389 <td>Tracks extension usage including extension ID, command details, success status, and execution time.</td> 390 </tr> 391 <tr> 392 <td>Microsoft.PowerToys.CmdPal_SessionDuration</td> 393 <td>Logs session metrics from launch to dismissal including duration, commands executed, pages visited, search queries, navigation depth, and errors.</td> 394 </tr> 395 </table> 396 397 ### Crop And Lock 398 <table style="width:100%; table-layout:fixed"> 399 <colgroup> 400 <col style="width:40%"> 401 <col style="width:60%"> 402 </colgroup> 403 <tr> 404 <th>Event Name</th> 405 <th>Description</th> 406 </tr> 407 <tr> 408 <td>Microsoft.PowerToys.CropAndLock_ActivateReparent</td> 409 <td>Triggered when the cropping interface is activated for reparenting the cropped content.</td> 410 </tr> 411 <tr> 412 <td>Microsoft.PowerToys.CropAndLock_ActivateScreenshot</td> 413 <td>Triggered when the screenshot mode is activated in Crop and Lock.</td> 414 </tr> 415 <tr> 416 <td>Microsoft.PowerToys.CropAndLock_ActivateThumbnail</td> 417 <td>Occurs when the thumbnail view for cropped content is activated.</td> 418 </tr> 419 <tr> 420 <td>Microsoft.PowerToys.CropAndLock_CreateReparentWindow</td> 421 <td>Triggered when a reparent window is created in Crop and Lock mode.</td> 422 </tr> 423 <tr> 424 <td>Microsoft.PowerToys.CropAndLock_CreateScreenshotWindow</td> 425 <td>Triggered when a screenshot window is created in Crop and Lock mode.</td> 426 </tr> 427 <tr> 428 <td>Microsoft.PowerToys.CropAndLock_CreateThumbnailWindow</td> 429 <td>Triggered when a thumbnail window is created in Crop and Lock mode.<-/td> 430 </tr> 431 <tr> 432 <td>Microsoft.PowerToys.CropAndLock_EnableCropAndLock</td> 433 <td>Triggered when Crop and Lock is enabled.</td> 434 </tr> 435 <tr> 436 <td>Microsoft.PowerToys.CropAndLock_Settings</td> 437 <td>Occurs when settings related to Crop and Lock are modified.</td> 438 </tr> 439 </table> 440 441 ### Cursor Wrap 442 <table style="width:100%; table-layout:fixed"> 443 <colgroup> 444 <col style="width:40%"> 445 <col style="width:60%"> 446 </colgroup> 447 <tr> 448 <th>Event Name</th> 449 <th>Description</th> 450 </tr> 451 <tr> 452 <td>Microsoft.PowerToys.CursorWrap_EnableCursorWrap</td> 453 <td>Triggered when Cursor Wrap is enabled or disabled.</td> 454 </tr> 455 </table> 456 457 ### Environment Variables 458 <table style="width:100%; table-layout:fixed"> 459 <colgroup> 460 <col style="width:40%"> 461 <col style="width:60%"> 462 </colgroup> 463 <tr> 464 <th>Event Name</th> 465 <th>Description</th> 466 </tr> 467 <tr> 468 <td>Microsoft.PowerToys.EnvironmentVariables_Activate</td> 469 <td>Triggered when Environment Variables is launched.</td> 470 </tr> 471 <tr> 472 <td>Microsoft.PowerToys.EnvironmentVariables_EnableEnvironmentVariables</td> 473 <td>Occurs when Environment Variables is enabled.</td> 474 </tr> 475 <tr> 476 <td>Microsoft.PowerToys.EnvironmentVariablesOpenedEvent</td> 477 <td>Triggered when the Environment Variables interface is opened.</td> 478 </tr> 479 <tr> 480 <td>Microsoft.PowerToys.EnvironmentVariablesProfileEnabledEvent</td> 481 <td>Occurs when an environment variable profile is enabled.</td> 482 </tr> 483 <tr> 484 <td>Microsoft.PowerToys.EnvironmentVariablesVariableChangedEvent</td> 485 <td>Triggered when an environment variable is added, modified, or deleted.</td> 486 </tr> 487 </table> 488 489 ### FancyZones 490 <table style="width:100%; table-layout:fixed"> 491 <colgroup> 492 <col style="width:40%"> 493 <col style="width:60%"> 494 </colgroup> 495 <tr> 496 <th>Event Name</th> 497 <th>Description</th> 498 </tr> 499 <tr> 500 <td>Microsoft.PowerToys.FancyZones_CycleActiveZoneSet</td> 501 <td>Triggered when the active zone set is cycled through.</td> 502 </tr> 503 <tr> 504 <td>Microsoft.PowerToys.FancyZones_EditorLaunch</td> 505 <td>Occurs when the FancyZones editor is launched.</td> 506 </tr> 507 <tr> 508 <td>Microsoft.PowerToys.FancyZones_EnableFancyZones</td> 509 <td>Occurs when FancyZones is enabled.</td> 510 </tr> 511 <tr> 512 <td>Microsoft.PowerToys.FancyZones_Error</td> 513 <td>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.</td> 514 </tr> 515 <tr> 516 <td>Microsoft.PowerToys.FancyZones_KeyboardSnapWindowToZone</td> 517 <td>Triggered when a window is snapped to a zone using the keyboard.</td> 518 </tr> 519 <tr> 520 <td>Microsoft.PowerToys.FancyZones_MoveOrResizeEnded</td> 521 <td>Occurs when a window move or resize action has completed.</td> 522 </tr> 523 <tr> 524 <td>Microsoft.PowerToys.FancyZones_MoveOrResizeStarted</td> 525 <td>Triggered when a window move or resize action is initiated.</td> 526 </tr> 527 <tr> 528 <td>Microsoft.PowerToys.FancyZones_OnKeyDown</td> 529 <td>Triggered when a key is pressed down while interacting with zones.</td> 530 </tr> 531 <tr> 532 <td>Microsoft.PowerToys.FancyZones_QuickLayoutSwitch</td> 533 <td>Occurs when a quick switch between zone layouts is performed.</td> 534 </tr> 535 <tr> 536 <td>Microsoft.PowerToys.FancyZones_Settings</td> 537 <td>Triggered when FancyZones settings are accessed or modified.</td> 538 </tr> 539 <tr> 540 <td>Microsoft.PowerToys.FancyZones_SnapNewWindowIntoZone</td> 541 <td>Triggered when a new window is snapped into a zone.</td> 542 </tr> 543 <tr> 544 <td>Microsoft.PowerToys.FancyZones_VirtualDesktopChanged</td> 545 <td>Occurs when the virtual desktop changes, affecting zone layout.</td> 546 </tr> 547 <tr> 548 <td>Microsoft.PowerToys.FancyZones_ZoneSettingsChanged</td> 549 <td>Triggered when the settings for specific zones are altered.</td> 550 </tr> 551 <tr> 552 <td>Microsoft.PowerToys.FancyZones_ZoneWindowKeyUp</td> 553 <td>Occurs when a key is released while interacting with zones.</td> 554 </tr> 555 <tr> 556 <td>Microsoft.PowerToys.FancyZones_CLICommand</td> 557 <td>Triggered when a FancyZones CLI command is executed, logging the command name and success status.</td> 558 </tr> 559 <tr> 560 <td>Microsoft.PowerToys.FancyZonesEditorStartEvent</td> 561 <td>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.</td> 562 </tr> 563 <tr> 564 <td>Microsoft.PowerToys.FancyZonesEditorStartFinishEvent</td> 565 <td>Triggered when the FancyZones Editor has completed loading and is ready for user interaction.</td> 566 </tr> 567 </table> 568 569 ### File Locksmith 570 <table style="width:100%; table-layout:fixed"> 571 <colgroup> 572 <col style="width:40%"> 573 <col style="width:60%"> 574 </colgroup> 575 <tr> 576 <th>Event Name</th> 577 <th>Description</th> 578 </tr> 579 <tr> 580 <td>Microsoft.PowerToys.FileLocksmith_EnableFileLocksmith</td> 581 <td>Triggered when File Locksmith is enabled.</td> 582 </tr> 583 <tr> 584 <td>Microsoft.PowerToys.FileLocksmith_Invoked</td> 585 <td>Occurs when File Locksmith is invoked.</td> 586 </tr> 587 <tr> 588 <td>Microsoft.PowerToys.FileLocksmith_InvokedRet</td> 589 <td>Triggered when File Locksmith invocation returns a result.</td> 590 </tr> 591 <tr> 592 <td>Microsoft.PowerToys.FileLocksmith_QueryContextMenuError</td> 593 <td>Occurs when there is an error querying the context menu for File Locksmith.</td> 594 </tr> 595 </table> 596 597 ### FileExplorerAddOns 598 <table style="width:100%; table-layout:fixed"> 599 <colgroup> 600 <col style="width:40%"> 601 <col style="width:60%"> 602 </colgroup> 603 <tr> 604 <th>Event Name</th> 605 <th>Description</th> 606 </tr> 607 <tr> 608 <td>Microsoft.PowerToys.GcodeFileHandlerLoaded</td> 609 <td>Triggered when a G-code file handler is loaded.</td> 610 </tr> 611 <tr> 612 <td>Microsoft.PowerToys.GcodeFilePreviewed</td> 613 <td>Occurs when a G-code file is previewed in File Explorer.</td> 614 </tr> 615 <tr> 616 <td>Microsoft.PowerToys.GcodeFilePreviewError</td> 617 <td>Triggered when there is an error previewing a G-code file.</td> 618 </tr> 619 <tr> 620 <td>Microsoft.PowerToys.BgcodeFileHandlerLoaded</td> 621 <td>Triggered when a Binary G-code file handler is loaded.</td> 622 </tr> 623 <tr> 624 <td>Microsoft.PowerToys.BgcodeFilePreviewed</td> 625 <td>Occurs when a Binary G-code file is previewed in File Explorer.</td> 626 </tr> 627 <tr> 628 <td>Microsoft.PowerToys.BgcodeFilePreviewError</td> 629 <td>Triggered when there is an error previewing a Binary G-code file.</td> 630 </tr> 631 <tr> 632 <td>Microsoft.PowerToys.MarkdownFileHandlerLoaded</td> 633 <td>Occurs when a Markdown file handler is loaded.</td> 634 </tr> 635 <tr> 636 <td>Microsoft.PowerToys.MarkdownFilePreviewed</td> 637 <td>Triggered when a Markdown file is previewed in File Explorer.</td> 638 </tr> 639 <tr> 640 <td>Microsoft.PowerToys.MarkdownFilePreviewError</td> 641 <td>Triggered when there is an error previewing a Markdown file in File Explorer.</td> 642 </tr> 643 <tr> 644 <td>Microsoft.PowerToys.PdfFileHandlerLoaded</td> 645 <td>Occurs when a PDF file handler is loaded.</td> 646 </tr> 647 <tr> 648 <td>Microsoft.PowerToys.PdfFilePreviewed</td> 649 <td>Triggered when a PDF file is previewed in File Explorer.</td> 650 </tr> 651 <tr> 652 <td>Microsoft.PowerToys.PdfFilePreviewError</td> 653 <td>Triggered when there is an error previewing a PDF file in File Explorer.</td> 654 </tr> 655 <tr> 656 <td>Microsoft.PowerToys.PowerPreview_Enabled</td> 657 <td>Occurs when preview is enabled.</td> 658 </tr> 659 <tr> 660 <td>Microsoft.PowerToys.PowerPreview_TweakUISettings_Destroyed</td> 661 <td>Triggered when the Tweak UI settings for Power Preview are destroyed.</td> 662 </tr> 663 <tr> 664 <td>Microsoft.PowerToys.PowerPreview_TweakUISettings_FailedUpdatingSettings</td> 665 <td>Occurs when updating Tweak UI settings fails.</td> 666 </tr> 667 <tr> 668 <td>Microsoft.PowerToys.PowerPreview_TweakUISettings_InitSet__ErrorLoadingFile</td> 669 <td>Triggered when there is an error loading a file during Tweak UI settings initialization.</td> 670 </tr> 671 <tr> 672 <td>Microsoft.PowerToys.PowerPreview_TweakUISettings_SetConfig__InvalidJSONGiven</td> 673 <td>Triggered when invalid JSON is provided to the Power Preview settings configuration</td> 674 </tr> 675 <tr> 676 <td>Microsoft.PowerToys.PowerPreview_TweakUISettings_SuccessfullyUpdatedSettings</td> 677 <td>Occurs when the Tweak UI settings for Power Preview are successfully updated.</td> 678 </tr> 679 <tr> 680 <td>Microsoft.PowerToys.QoiFilePreviewed</td> 681 <td>Triggered when a QOI file is previewed in File Explorer.</td> 682 </tr> 683 <tr> 684 <td>Microsoft.PowerToys.QoiFilePreviewError</td> 685 <td>Triggered when there is an error previewing a QOI (Quite OK Image) file in File Explorer.</td> 686 </tr> 687 <tr> 688 <td>Microsoft.PowerToys.SvgFileHandlerLoaded</td> 689 <td>Occurs when an SVG file handler is loaded.</td> 690 </tr> 691 <tr> 692 <td>Microsoft.PowerToys.SvgFilePreviewed</td> 693 <td>Triggered when an SVG file is previewed in File Explorer.</td> 694 </tr> 695 <tr> 696 <td>Microsoft.PowerToys.SvgFilePreviewError</td> 697 <td>Occurs when there is an error previewing an SVG file.</td> 698 </tr> 699 </table> 700 701 ### Find My Mouse 702 <table style="width:100%; table-layout:fixed"> 703 <colgroup> 704 <col style="width:40%"> 705 <col style="width:60%"> 706 </colgroup> 707 <tr> 708 <th>Event Name</th> 709 <th>Description</th> 710 </tr> 711 <tr> 712 <td>Microsoft.PowerToys.FindMyMouse_EnableFindMyMouse</td> 713 <td>Triggered when Find My Mouse is enabled.</td> 714 </tr> 715 <tr> 716 <td>Microsoft.PowerToys.FindMyMouse_MousePointerFocused</td> 717 <td>Occurs when the mouse pointer is focused using Find My Mouse, including the activation method (double-tap left/right Ctrl, shake mouse, or shortcut).</td> 718 </tr> 719 </table> 720 721 ### Hosts File Editor 722 <table style="width:100%; table-layout:fixed"> 723 <colgroup> 724 <col style="width:40%"> 725 <col style="width:60%"> 726 </colgroup> 727 <tr> 728 <th>Event Name</th> 729 <th>Description</th> 730 </tr> 731 <tr> 732 <td>Microsoft.PowerToys.HostsFileEditor_Activate</td> 733 <td>Triggered when Hosts File Editor is activated.</td> 734 </tr> 735 <tr> 736 <td>Microsoft.PowerToys.HostsFileEditor_EnableHostsFileEditor</td> 737 <td>Occurs when Hosts File Editor is enabled.</td> 738 </tr> 739 <tr> 740 <td>Microsoft.PowerToys.HostsFileEditorOpenedEvent</td> 741 <td>Fires when Hosts File Editor is opened.</td> 742 </tr> 743 <tr> 744 <td>Microsoft.PowerToys.HostEditorStartEvent</td> 745 <td>Triggered when the Hosts File Editor application starts. This logs the initialization of the Hosts File Editor UI with a timestamp.</td> 746 </tr> 747 <tr> 748 <td>Microsoft.PowerToys.HostEditorStartFinishEvent</td> 749 <td>Triggered when the Hosts File Editor has completed loading and is ready for user interaction.</td> 750 </tr> 751 </table> 752 753 ### Image Resizer 754 <table style="width:100%; table-layout:fixed"> 755 <colgroup> 756 <col style="width:40%"> 757 <col style="width:60%"> 758 </colgroup> 759 <tr> 760 <th>Event Name</th> 761 <th>Description</th> 762 </tr> 763 <tr> 764 <td>Microsoft.PowerToys.ImageResizer_EnableImageResizer</td> 765 <td>Triggered when Image Resizer is enabled.</td> 766 </tr> 767 <tr> 768 <td>Microsoft.PowerToys.ImageResizer_Invoked</td> 769 <td>Occurs when Image Resizer is invoked by the user.</td> 770 </tr> 771 <tr> 772 <td>Microsoft.PowerToys.ImageResizer_InvokedRet</td> 773 <td>Fires when the Image Resizer operation is completed and returns a result.</td> 774 </tr> 775 <tr> 776 <td>Microsoft.PowerToys.ImageResizer_QueryContextMenuError</td> 777 <td>Triggered when there is an error querying the context menu for Image Resizer.</td> 778 </tr> 779 </table> 780 781 ### Keyboard Manager 782 <table style="width:100%; table-layout:fixed"> 783 <colgroup> 784 <col style="width:40%"> 785 <col style="width:60%"> 786 </colgroup> 787 <tr> 788 <th>Event Name</th> 789 <th>Description</th> 790 </tr> 791 <tr> 792 <td>Microsoft.PowerToys.KeyboardManager_AppSpecificShortcutRemapConfigurationLoaded</td> 793 <td>Indicates that the application-specific shortcut remap configuration has been successfully loaded.</td> 794 </tr> 795 <tr> 796 <td>Microsoft.PowerToys.KeyboardManager_AppSpecificShortcutRemapCount</td> 797 <td>Logs the number of application-specific shortcut remaps configured by the user.</td> 798 </tr> 799 <tr> 800 <td>Microsoft.PowerToys.KeyboardManager_AppSpecificShortcutToKeyRemapInvoked</td> 801 <td>Logs each instance when an application-specific shortcut-to-key remap is used.</td> 802 </tr> 803 <tr> 804 <td>Microsoft.PowerToys.KeyboardManager_AppSpecificShortcutToShortcutRemapInvoked</td> 805 <td>Logs each instance when an application-specific shortcut-to-shortcut remap is used.</td> 806 </tr> 807 <tr> 808 <td>Microsoft.PowerToys.KeyboardManager_Error</td> 809 <td>Triggered when an error occurs in Keyboard Manager. This logs the error code, error message, and the method name where the error occurred.</td> 810 </tr> 811 <tr> 812 <td>Microsoft.PowerToys.KeyboardManager_ErrorSendingKeyAndShortcutRemapLoadedConfiguration</td> 813 <td>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</td> 814 </tr> 815 <tr> 816 <td>Microsoft.PowerToys.KeyboardManager_DailyAppSpecificShortcutToKeyRemapInvoked</td> 817 <td>Logs the daily count of application-specific shortcut-to-key remaps executed by the user.</td> 818 </tr> 819 <tr> 820 <td>Microsoft.PowerToys.KeyboardManager_DailyAppSpecificShortcutToShortcutRemapInvoked</td> 821 <td>Logs the daily count of application-specific shortcut-to-shortcut remaps executed by the user.</td> 822 </tr> 823 <tr> 824 <td>Microsoft.PowerToys.KeyboardManager_DailyKeyToKeyRemapInvoked</td> 825 <td>Logs the daily count of key-to-key remaps used by the user.</td> 826 </tr> 827 <tr> 828 <td>Microsoft.PowerToys.KeyboardManager_DailyKeyToShortcutRemapInvoked</td> 829 <td>Logs the daily count of key-to-shortcut remaps used by the user.</td> 830 </tr> 831 <tr> 832 <td>Microsoft.PowerToys.KeyboardManager_DailyShortcutToKeyRemapInvoked</td> 833 <td>Logs the daily count of shortcut-to-key remaps used by the user.</td> 834 </tr> 835 <tr> 836 <td>Microsoft.PowerToys.KeyboardManager_DailyShortcutToShortcutRemapInvoked</td> 837 <td>Logs the daily count of shortcut-to-shortcut remaps used by the user.</td> 838 </tr> 839 <tr> 840 <td>Microsoft.PowerToys.KeyboardManager_EnableKeyboardManager</td> 841 <td>Indicates that the Keyboard Manager has been enabled in PowerToys settings.</td> 842 </tr> 843 <tr> 844 <td>Microsoft.PowerToys.KeyboardManager_KeyRemapConfigurationLoaded</td> 845 <td>Indicates that the key remap configuration has been successfully loaded.</td> 846 </tr> 847 <tr> 848 <td>Microsoft.PowerToys.KeyboardManager_KeyRemapCount</td> 849 <td>Logs the number of individual key remaps configured by the user.</td> 850 </tr> 851 <tr> 852 <td>Microsoft.PowerToys.KeyboardManager_KeyToKeyRemapInvoked</td> 853 <td>Logs each instance of a key-to-key remap being used.</td> 854 </tr> 855 <tr> 856 <td>Microsoft.PowerToys.KeyboardManager_KeyToShortcutRemapInvoked</td> 857 <td>Logs each instance of a key-to-shortcut remap being used.</td> 858 </tr> 859 <tr> 860 <td>Microsoft.PowerToys.KeyboardManager_OSLevelShortcutRemapCount</td> 861 <td>Logs the total number of OS-level shortcut remaps configured by the user.</td> 862 </tr> 863 <tr> 864 <td>Microsoft.PowerToys.KeyboardManager_OSLevelShortcutToKeyRemapInvoked</td> 865 <td>Logs each instance of an OS-level shortcut-to-key remap being used.</td> 866 </tr> 867 <tr> 868 <td>Microsoft.PowerToys.KeyboardManager_OSLevelShortcutToShortcutRemapInvoked</td> 869 <td>Logs each instance of an OS-level shortcut-to-shortcut remap being used.</td> 870 </tr> 871 <tr> 872 <td>Microsoft.PowerToys.KeyboardManager_ShortcutRemapConfigurationLoaded</td> 873 <td>Indicates that the shortcut remap configuration has been successfully loaded.</td> 874 </tr> 875 </table> 876 877 ### Light Switch 878 <table style="width:100%; table-layout:fixed"> 879 <colgroup> 880 <col style="width:40%"> 881 <col style="width:60%"> 882 </colgroup> 883 <tr> 884 <th>Event Name</th> 885 <th>Description</th> 886 </tr> 887 <tr> 888 <td>Microsoft.PowerToys.LightSwitch_EnableLightSwitch</td> 889 <td>Triggered when Light Switch is enabled or disabled.</td> 890 </tr> 891 <tr> 892 <td>Microsoft.PowerToys.LightSwitch_ShortcutInvoked</td> 893 <td>Occurs when the shortcut for Light Switch is invoked.</td> 894 </tr> 895 <tr> 896 <td>Microsoft.PowerToys.LightSwitch_ScheduleModeToggled</td> 897 <td>Occurs when a new schedule mode is selected for Light Switch.</td> 898 </tr> 899 <tr> 900 <td>Microsoft.PowerToys.LightSwitch_ThemeTargetChanged</td> 901 <td>Occurs when the options for targeting the system or apps is updated.</td> 902 </tr> 903 </table> 904 905 ### Mouse Highlighter 906 <table style="width:100%; table-layout:fixed"> 907 <colgroup> 908 <col style="width:40%"> 909 <col style="width:60%"> 910 </colgroup> 911 <tr> 912 <th>Event Name</th> 913 <th>Description</th> 914 </tr> 915 <tr> 916 <td>Microsoft.PowerToys.MouseHighlighter_EnableMouseHighlighter</td> 917 <td>Triggered when Mouse Highlighter is enabled.</td> 918 </tr> 919 <tr> 920 <td>Microsoft.PowerToys.MouseHighlighter_StartHighlightingSession</td> 921 <td>Occurs when a new highlighting session is started.</td> 922 </tr> 923 <tr> 924 <td>Microsoft.PowerToys.MouseHighlighter_StartSpotlightSession</td> 925 <td>Triggered when a spotlight session is started in Mouse Highlighter. This occurs when the user activates the spotlight mode.</td> 926 </tr> 927 </table> 928 929 ### Mouse Jump 930 <table style="width:100%; table-layout:fixed"> 931 <colgroup> 932 <col style="width:40%"> 933 <col style="width:60%"> 934 </colgroup> 935 <tr> 936 <th>Event Name</th> 937 <th>Description</th> 938 </tr> 939 <tr> 940 <td>Microsoft.PowerToys.MouseJump_EnableJumpTool</td> 941 <td>Triggered when Mouse Jump is enabled.</td> 942 </tr> 943 <tr> 944 <td>Microsoft.PowerToys.MouseJump_InvokeJumpTool</td> 945 <td>Occurs when Mouse Jump is invoked.</td> 946 </tr> 947 <tr> 948 <td>Microsoft.PowerToys.MouseJumpShowEvent</td> 949 <td>Triggered when the Mouse Jump display is shown.</td> 950 </tr> 951 <tr> 952 <td>Microsoft.PowerToys.MouseJumpTeleportCursorEvent</td> 953 <td>Occurs when the cursor is teleported to a new location.</td> 954 </tr> 955 </table> 956 957 ### Mouse Pointer Crosshairs 958 <table style="width:100%; table-layout:fixed"> 959 <colgroup> 960 <col style="width:40%"> 961 <col style="width:60%"> 962 </colgroup> 963 <tr> 964 <th>Event Name</th> 965 <th>Description</th> 966 </tr> 967 <tr> 968 <td>Microsoft.PowerToys.MousePointerCrosshairs_EnableMousePointerCrosshairs</td> 969 <td>Triggered when Mouse Pointer Crosshairs is enabled.</td> 970 </tr> 971 <tr> 972 <td>Microsoft.PowerToys.MousePointerCrosshairs_StartDrawingCrosshairs</td> 973 <td>Occurs when the crosshairs are drawn around the mouse pointer.</td> 974 </tr> 975 </table> 976 977 ### Mouse Without Borders 978 <table style="width:100%; table-layout:fixed"> 979 <colgroup> 980 <col style="width:40%"> 981 <col style="width:60%"> 982 </colgroup> 983 <tr> 984 <th>Event Name</th> 985 <th>Description</th> 986 </tr> 987 <tr> 988 <td>Microsoft.PowerToys.MouseWithoutBorders_Activate</td> 989 <td>Triggered when Mouse Without Borders is activated.</td> 990 </tr> 991 <tr> 992 <td>Microsoft.PowerToys.MouseWithoutBorders_AddFirewallRule</td> 993 <td>Occurs when a firewall rule is added for Mouse Without Borders.</td> 994 </tr> 995 <tr> 996 <td>Microsoft.PowerToys.MouseWithoutBorders_EnableMouseWithoutBorders</td> 997 <td>Triggered when Mouse Without Borders is enabled.</td> 998 </tr> 999 <tr> 1000 <td>Microsoft.PowerToys.MouseWithoutBorders_ToggleServiceRegistration</td> 1001 <td>Occurs when the service registration for Mouse Without Borders is toggled.</td> 1002 </tr> 1003 <tr> 1004 <td>Microsoft.PowerToys.MouseWithoutBordersClipboardFileTransferEvent</td> 1005 <td>Triggered during a clipboard file transfer between computers.</td> 1006 </tr> 1007 <tr> 1008 <td>Microsoft.PowerToys.MouseWithoutBordersDragAndDropEvent</td> 1009 <td>Occurs during a drag-and-drop operation between computers.</td> 1010 </tr> 1011 <tr> 1012 <td>Microsoft.PowerToys.MouseWithoutBordersMultipleModeEvent</td> 1013 <td>Triggered when multiple modes are enabled in Mouse Without Borders.</td> 1014 </tr> 1015 <tr> 1016 <td>Microsoft.PowerToys.MouseWithoutBordersOldUIOpenedEvent</td> 1017 <td>Occurs when the old user interface for Mouse Without Borders is opened.</td> 1018 </tr> 1019 <tr> 1020 <td>Microsoft.PowerToys.MouseWithoutBordersOldUIQuitEvent</td> 1021 <td>Triggered when the old user interface for Mouse Without Borders is closed.</td> 1022 </tr> 1023 <tr> 1024 <td>Microsoft.PowerToys.MouseWithoutBordersOldUIReconfigureEvent</td> 1025 <td>Occurs when the old user interface for Mouse Without Borders is reconfigured.</td> 1026 </tr> 1027 <tr> 1028 <td>Microsoft.PowerToys.MouseWithoutBordersStartedEvent</td> 1029 <td>Triggered when Mouse Without Borders is started.</td> 1030 </tr> 1031 </table> 1032 1033 ### New+ 1034 <table style="width:100%; table-layout:fixed"> 1035 <colgroup> 1036 <col style="width:40%"> 1037 <col style="width:60%"> 1038 </colgroup> 1039 <tr> 1040 <th>Event Name</th> 1041 <th>Description</th> 1042 </tr> 1043 <tr> 1044 <td>Microsoft.PowerToys.NewPlus_ChangedTemplateLocation</td> 1045 <td>Triggered when the template folder location is changed.</td> 1046 </tr> 1047 <tr> 1048 <td>Microsoft.PowerToys.NewPlus_EventCopyTemplate</td> 1049 <td>Triggered when an item from New+ is created (copied to the current directory).</td> 1050 </tr> 1051 <tr> 1052 <td>Microsoft.PowerToys.NewPlus_EventCopyTemplateResult</td> 1053 <td>Logs the success of item creation (copying).</td> 1054 </tr> 1055 <tr> 1056 <td>Microsoft.PowerToys.NewPlus_EventOpenTemplates</td> 1057 <td>Triggered when the templates folder is opened.</td> 1058 </tr> 1059 <tr> 1060 <td>Microsoft.PowerToys.NewPlus_EventShowTemplateItems</td> 1061 <td>Triggered when the New+ context menu flyout is displayed.</td> 1062 </tr> 1063 <tr> 1064 <td>Microsoft.PowerToys.NewPlus_EventToggleOnOff</td> 1065 <td>Triggered when New+ is enabled or disabled.</td> 1066 </tr> 1067 </table> 1068 1069 ### Peek 1070 <table style="width:100%; table-layout:fixed"> 1071 <colgroup> 1072 <col style="width:40%"> 1073 <col style="width:60%"> 1074 </colgroup> 1075 <tr> 1076 <th>Event Name</th> 1077 <th>Description</th> 1078 </tr> 1079 <tr> 1080 <td>Microsoft.PowerToys.Peek_Closed</td> 1081 <td>Triggered when Peek is closed.</td> 1082 </tr> 1083 <tr> 1084 <td>Microsoft.PowerToys.Peek_EnablePeek</td> 1085 <td>Occurs when Peek is enabled.</td> 1086 </tr> 1087 <tr> 1088 <td>Microsoft.PowerToys.Peek_Error</td> 1089 <td>Triggered when an error occurs for Peek.</td> 1090 </tr> 1091 <tr> 1092 <td>Microsoft.PowerToys.Peek_InvokePeek</td> 1093 <td>Occurs when Peek is invoked.</td> 1094 </tr> 1095 <tr> 1096 <td>Microsoft.PowerToys.Peek_Opened</td> 1097 <td>Triggered when a Peek window is opened.</td> 1098 </tr> 1099 <tr> 1100 <td>Microsoft.PowerToys.Peek_OpenWith</td> 1101 <td>Occurs when an item is opened with Peek.</td> 1102 </tr> 1103 <tr> 1104 <td>Microsoft.PowerToys.Peek_Settings</td> 1105 <td>Triggered when the settings for Peek are modified.</td> 1106 </tr> 1107 <tr> 1108 <td>Microsoft.PowerToys.Peek_SpaceModeEnabled</td> 1109 <td>Triggered when the Space key activation mode is enabled or disabled in Peek</td> 1110 </tr> 1111 </table> 1112 1113 ### PowerRename 1114 <table style="width:100%; table-layout:fixed"> 1115 <colgroup> 1116 <col style="width:40%"> 1117 <col style="width:60%"> 1118 </colgroup> 1119 <tr> 1120 <th>Event Name</th> 1121 <th>Description</th> 1122 </tr> 1123 <tr> 1124 <td>Microsoft.PowerToys.PowerRename_EnablePowerRename</td> 1125 <td>Triggered when PowerRename is enabled.</td> 1126 </tr> 1127 <tr> 1128 <td>Microsoft.PowerToys.PowerRename_Invoked</td> 1129 <td>Occurs when PowerRename is invoked.</td> 1130 </tr> 1131 <tr> 1132 <td>Microsoft.PowerToys.PowerRename_InvokedRet</td> 1133 <td>Triggered when the invocation of PowerRename returns a result.</td> 1134 </tr> 1135 <tr> 1136 <td>Microsoft.PowerToys.PowerRename_RenameOperation</td> 1137 <td>Triggered during the rename operation within PowerRename.</td> 1138 </tr> 1139 <tr> 1140 <td>Microsoft.PowerToys.PowerRename_SettingsChanged</td> 1141 <td>Occurs when the settings for PowerRename are changed.</td> 1142 </tr> 1143 <tr> 1144 <td>Microsoft.PowerToys.PowerRename_UIShownRet</td> 1145 <td>Triggered when the PowerRename user interface is shown.</td> 1146 </tr> 1147 </table> 1148 1149 ### PowerToys Run 1150 <table style="width:100%; table-layout:fixed"> 1151 <colgroup> 1152 <col style="width:40%"> 1153 <col style="width:60%"> 1154 </colgroup> 1155 <tr> 1156 <th>Event Name</th> 1157 <th>Description</th> 1158 </tr> 1159 <tr> 1160 <td>Microsoft.PowerToys.LauncherBootEvent</td> 1161 <td>Triggered when PowerToys Run is initialized on boot.</td> 1162 </tr> 1163 <tr> 1164 <td>Microsoft.PowerToys.LauncherColdStateHotkeyEvent</td> 1165 <td>Occurs when the hotkey is pressed in the cold state (not yet initialized).</td> 1166 </tr> 1167 <tr> 1168 <td>Microsoft.PowerToys.LauncherFirstDeleteEvent</td> 1169 <td>Triggered when the first deletion action is performed in PowerToys Run.</td> 1170 </tr> 1171 <tr> 1172 <td>Microsoft.PowerToys.LauncherHideEvent</td> 1173 <td>Occurs when PowerToys Run is hidden.</td> 1174 </tr> 1175 <tr> 1176 <td>Microsoft.PowerToys.LauncherQueryEvent</td> 1177 <td>Triggered when a query is made in PowerToys Run.</td> 1178 </tr> 1179 <tr> 1180 <td>Microsoft.PowerToys.LauncherResultActionEvent</td> 1181 <td>Occurs when an action is taken on a result in PowerToys Run.</td> 1182 </tr> 1183 <tr> 1184 <td>Microsoft.PowerToys.LauncherShowEvent</td> 1185 <td>Triggered when PowerToys Run is shown.</td> 1186 </tr> 1187 <tr> 1188 <td>Microsoft.PowerToys.LauncherWarmStateHotkeyEvent</td> 1189 <td>Occurs when the hotkey is pressed in the warm state (initialized).</td> 1190 </tr> 1191 <tr> 1192 <td>Microsoft.PowerToys.RunPluginsSettingsEvent</td> 1193 <td>Triggered when the settings for PowerToys Run plugins are accessed or modified.</td> 1194 </tr> 1195 </table> 1196 1197 ### Quick Accent 1198 <table style="width:100%; table-layout:fixed"> 1199 <colgroup> 1200 <col style="width:40%"> 1201 <col style="width:60%"> 1202 </colgroup> 1203 <tr> 1204 <th>Event Name</th> 1205 <th>Description</th> 1206 </tr> 1207 <tr> 1208 <td>Microsoft.PowerToys.PowerAccent_EnablePowerAccent</td> 1209 <td>Triggered when Quick Accent is enabled.</td> 1210 </tr> 1211 <tr> 1212 <td>Microsoft.PowerToys.PowerAccentShowAccentMenuEvent</td> 1213 <td>Occurs when the accent menu is displayed.</td> 1214 </tr> 1215 </table> 1216 1217 ### Registry Preview 1218 <table style="width:100%; table-layout:fixed"> 1219 <colgroup> 1220 <col style="width:40%"> 1221 <col style="width:60%"> 1222 </colgroup> 1223 <tr> 1224 <th>Event Name</th> 1225 <th>Description</th> 1226 </tr> 1227 <tr> 1228 <td>Microsoft.PowerToys.RegistryPreview_Activate</td> 1229 <td>Triggered when Registry Preview is activated.</td> 1230 </tr> 1231 <tr> 1232 <td>Microsoft.PowerToys.RegistryPreview_EnableRegistryPreview</td> 1233 <td>Occurs when Registry Preview is enabled.</td> 1234 </tr> 1235 <tr> 1236 <td>Microsoft.PowerToys.RegistryPreviewEditorStartEvent</td> 1237 <td>Triggered when the Registry Preview application starts. This logs the initialization of the Registry Preview UI with a timestamp.</td> 1238 </tr> 1239 <tr> 1240 <td>Microsoft.PowerToys.RegistryPreviewEditorStartFinishEvent</td> 1241 <td>Triggered when the Registry Preview application has completed loading and is ready for user interaction.</td> 1242 </tr> 1243 </table> 1244 1245 ### Screen Ruler 1246 <table style="width:100%; table-layout:fixed"> 1247 <colgroup> 1248 <col style="width:40%"> 1249 <col style="width:60%"> 1250 </colgroup> 1251 <tr> 1252 <th>Event Name</th> 1253 <th>Description</th> 1254 </tr> 1255 <tr> 1256 <td>Microsoft.PowerToys.MeasureTool_BoundsToolActivated</td> 1257 <td>Triggered when Screen Ruler's Bounds tool is activated.</td> 1258 </tr> 1259 <tr> 1260 <td>Microsoft.PowerToys.MeasureTool_EnableMeasureTool</td> 1261 <td>Occurs when Screen Ruler is enabled.</td> 1262 </tr> 1263 <tr> 1264 <td>Microsoft.PowerToys.MeasureTool_MeasureToolActivated</td> 1265 <td>Triggered when Screen Ruler's Measure tool is activated.</td> 1266 </tr> 1267 </table> 1268 1269 ### Shortcut Guide 1270 <table style="width:100%; table-layout:fixed"> 1271 <colgroup> 1272 <col style="width:40%"> 1273 <col style="width:60%"> 1274 </colgroup> 1275 <tr> 1276 <th>Event Name</th> 1277 <th>Description</th> 1278 </tr> 1279 <tr> 1280 <td>Microsoft.PowerToys.ShortcutGuide_GuideSession</td> 1281 <td>Logs a Shortcut Guide session including duration and how it was closed.</td> 1282 </tr> 1283 <tr> 1284 <td>Microsoft.PowerToys.ShortcutGuide_Settings</td> 1285 <td>Indicates a change in the settings related to the Shortcut Guide.</td> 1286 </tr> 1287 </table> 1288 1289 ### Text Extractor 1290 <table style="width:100%; table-layout:fixed"> 1291 <colgroup> 1292 <col style="width:40%"> 1293 <col style="width:60%"> 1294 </colgroup> 1295 <tr> 1296 <th>Event Name</th> 1297 <th>Description</th> 1298 </tr> 1299 <tr> 1300 <td>Microsoft.PowerToys.PowerOCR_EnablePowerOCR</td> 1301 <td>Triggered when the Text Extractor (OCR) feature is enabled.</td> 1302 </tr> 1303 <tr> 1304 <td>Microsoft.PowerToys.PowerOCRCancelledEvent</td> 1305 <td>Occurs when the text extraction process is cancelled.</td> 1306 </tr> 1307 <tr> 1308 <td>Microsoft.PowerToys.PowerOCRCaptureEvent</td> 1309 <td>Occurs when the user has created a capture for text extraction.</td> 1310 </tr> 1311 <tr> 1312 <td>Microsoft.PowerToys.PowerOCRInvokedEvent</td> 1313 <td>Triggered when Text Extractor is invoked.</td> 1314 </tr> 1315 </table> 1316 1317 ### Workspaces 1318 <table style="width:100%; table-layout:fixed"> 1319 <colgroup> 1320 <col style="width:40%"> 1321 <col style="width:60%"> 1322 </colgroup> 1323 <tr> 1324 <th>Event Name</th> 1325 <th>Description</th> 1326 </tr> 1327 <tr> 1328 <td>Microsoft.PowerToys.Workspaces_CreateEvent</td> 1329 <td>Triggered when a new workspace is created.</td> 1330 </tr> 1331 <tr> 1332 <td>Microsoft.PowerToys.Workspaces_DeleteEvent</td> 1333 <td>Triggered when a workspace is deleted.</td> 1334 </tr> 1335 <tr> 1336 <td>Microsoft.PowerToys.Workspaces_EditEvent</td> 1337 <td>Triggered when a workspace is edited or modified.</td> 1338 </tr> 1339 <tr> 1340 <td>Microsoft.PowerToys.Workspaces_Enable</td> 1341 <td>Indicates that Workspaces is enabled.</td> 1342 </tr> 1343 <tr> 1344 <td>Microsoft.PowerToys.Workspaces_LaunchEvent</td> 1345 <td>Triggered when a workspace is launched.</td> 1346 </tr> 1347 <tr> 1348 <td>Microsoft.PowerToys.WorkspacesEditorStartEvent</td> 1349 <td>Triggered when the Workspaces Editor application starts. This logs the initialization of the Workspaces Editor UI with a timestamp.</td> 1350 </tr> 1351 <tr> 1352 <td>Microsoft.PowerToys.WorkspacesEditorStartFinishEvent</td> 1353 <td>Triggered when the Workspaces Editor has completed loading and is ready for user interaction.</td> 1354 </tr> 1355 </table> 1356 1357 ### ZoomIt 1358 <table style="width:100%; table-layout:fixed"> 1359 <colgroup> 1360 <col style="width:40%"> 1361 <col style="width:60%"> 1362 </colgroup> 1363 <tr> 1364 <th>Event Name</th> 1365 <th>Description</th> 1366 </tr> 1367 <tr> 1368 <td>Microsoft.PowerToys.ZoomIt_EnableZoomIt</td> 1369 <td>Triggered when ZoomIt is enabled/disabled.</td> 1370 </tr> 1371 <tr> 1372 <td>Microsoft.PowerToys.ZoomIt_Started</td> 1373 <td>Triggered when the ZoomIt process starts.</td> 1374 </tr> 1375 <tr> 1376 <td>Microsoft.PowerToys.ZoomIt_ActivateBreak</td> 1377 <td>Triggered when the Break mode is entered.</td> 1378 </tr> 1379 <tr> 1380 <td>Microsoft.PowerToys.ZoomIt_ActivateDraw</td> 1381 <td>Triggered when the Draw mode is entered.</td> 1382 </tr> 1383 <tr> 1384 <td>Microsoft.PowerToys.ZoomIt_ActivateZoom</td> 1385 <td>Triggered when the Zoom mode is entered.</td> 1386 </tr> 1387 <tr> 1388 <td>Microsoft.PowerToys.ZoomIt_ActivateLiveZoom</td> 1389 <td>Triggered when the Live Zoom mode is entered.</td> 1390 </tr> 1391 <tr> 1392 <td>Microsoft.PowerToys.ZoomIt_ActivateDemoType</td> 1393 <td>Triggered when the DemoType mode is entered.</td> 1394 </tr> 1395 <tr> 1396 <td>Microsoft.PowerToys.ZoomIt_ActivateRecord</td> 1397 <td>Triggered when the Record mode is entered.</td> 1398 </tr> 1399 <tr> 1400 <td>Microsoft.PowerToys.ZoomIt_ActivateSnip</td> 1401 <td>Triggered when the Snip mode is entered.</td> 1402 </tr> 1403 </table> 1404 1405 <!-- back up of table 1406 1407 <table style="width:100%"> 1408 <tr> 1409 <th>Event Name</th> 1410 <th>Description</th> 1411 </tr> 1412 <tr> 1413 <td>x</td> 1414 <td>x</td> 1415 </tr> 1416 <tr> 1417 <td>x</td> 1418 <td>x</td> 1419 </tr> 1420 <tr> 1421 <td>x</td> 1422 <td>x</td> 1423 </tr> 1424 </table> 1425 -->