# microsoft/powertoys architecture

> Architecture diagram of the GitHub repository microsoft/powertoys, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/microsoft/powertoys
- Repository: https://github.com/microsoft/powertoys

## Overview

PowerToys is a Windows utility suite: users launch utilities through the resident Runner, configure them in Settings, and use their features in everyday Windows workflows. The README documents a broad set of utilities, but the supplied source excerpts do not show most utilities’ runtime wiring; those capabilities are therefore represented as directory-level components without invented call chains. The graph includes sampled Keyboard Manager, Command Palette search, Preview, settings, and shared-service internals. Dashed links indicate documented product associations whose implementation is not shown.

Main entry points: [`src/settings-ui/Settings.UI/ViewModels/KeyboardManagerViewModel.cs`](https://github.com/microsoft/powertoys/blob/main/src/settings-ui/Settings.UI/ViewModels/KeyboardManagerViewModel.cs) (Keyboard Manager), [`src/settings-ui/Settings.UI/SettingsXAML/App.xaml.cs`](https://github.com/microsoft/powertoys/blob/main/src/settings-ui/Settings.UI/SettingsXAML/App.xaml.cs) (Settings UI), [`src/settings-ui/Settings.UI.Library/SettingsUtils.cs`](https://github.com/microsoft/powertoys/blob/main/src/settings-ui/Settings.UI.Library/SettingsUtils.cs) (Settings storage), [`src/runner/main.cpp`](https://github.com/microsoft/powertoys/blob/main/src/runner/main.cpp) (PowerToys Runner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["App shell"]
  node_runner["PowerToys Runner<br/>[main.cpp]"]
  node_quickaccess["Quick Access<br/>[App.xaml.cs]"]
end

subgraph group_utilities["User utilities"]
  node_keyboard["Keyboard Manager"]
  node_cmdpalette["Command Palette search<br/>[SearchEngine.cs]"]
  node_preview["File Explorer previews"]
  node_advancedpaste[("Advanced Paste cache")]
  node_fancyzones["FancyZones"]
  node_awake["Awake"]
  node_mouseutils["Mouse Utilities"]
  node_workspaces["Workspaces"]
  node_launcher["PowerToys Run"]
  node_otherutilities["Other utilities"]
end

subgraph group_settings["Configuration"]
  node_settingsui["Settings UI<br/>[App.xaml.cs]"]
  node_settingsutils[("Settings storage<br/>[SettingsUtils.cs]")]
  node_keyboardprofile["Keyboard profiles"]
  node_globalsettings["Settings library"]
end

subgraph group_shared["Shared services"]
  node_theme["Theme management<br/>[ThemeManager.cs]"]
  node_language["Language models"]
  node_gpo["Policy projection<br/>[GPOWrapper.cs]"]
  node_telemetry["Telemetry"]
end

node_user(("Windows user"))

node_user -->|"launches"| node_runner
node_runner -.->|"opens settings"| node_settingsui
node_user -.->|"configures"| node_keyboard
node_user -.->|"searches with"| node_cmdpalette
node_user -.->|"previews files"| node_preview
node_user -.->|"uses"| node_advancedpaste
node_user -.->|"arranges windows"| node_fancyzones
node_user -.->|"uses"| node_awake
node_user -.->|"uses"| node_mouseutils
node_user -.->|"uses"| node_workspaces
node_user -.->|"searches with"| node_launcher
node_user -.->|"uses"| node_otherutilities
node_keyboard -.->|"loads settings"| node_settingsutils
node_keyboard -->|"edits profile"| node_keyboardprofile
node_keyboardprofile -.->|"persists through"| node_settingsutils
node_settingsui -.->|"uses settings models"| node_globalsettings
node_advancedpaste -->|"persists cache"| node_settingsutils
node_preview -.->|"uses preview support"| node_language
node_settingsui -.->|"applies themes"| node_theme
node_keyboard -.->|"checks policy"| node_gpo
node_settingsui -.->|"reports events"| node_telemetry

click node_runner "https://github.com/microsoft/powertoys/blob/main/src/runner/main.cpp"
click node_quickaccess "https://github.com/microsoft/powertoys/blob/main/src/settings-ui/QuickAccess.UI/QuickAccessXAML/App.xaml.cs"
click node_settingsui "https://github.com/microsoft/powertoys/blob/main/src/settings-ui/Settings.UI/SettingsXAML/App.xaml.cs"
click node_settingsutils "https://github.com/microsoft/powertoys/blob/main/src/settings-ui/Settings.UI.Library/SettingsUtils.cs"
click node_keyboard "https://github.com/microsoft/powertoys/blob/main/src/settings-ui/Settings.UI/ViewModels/KeyboardManagerViewModel.cs"
click node_keyboardprofile "https://github.com/microsoft/powertoys/blob/main/src/settings-ui/Settings.UI.Library/KeyboardManagerProfile.cs"
click node_cmdpalette "https://github.com/microsoft/powertoys/blob/main/src/modules/cmdpal/ext/Microsoft.CmdPal.Ext.Indexer/SearchEngine.cs"
click node_preview "https://github.com/microsoft/powertoys/blob/main/src/modules/previewpane/MonacoPreviewHandler/MonacoPreviewHandlerControl.cs"
click node_advancedpaste "https://github.com/microsoft/powertoys/blob/main/src/modules/AdvancedPaste/AdvancedPaste/Services/CustomActionKernelQueryCacheService.cs"
click node_fancyzones "https://github.com/microsoft/powertoys/tree/main/src/modules/fancyzones"
click node_awake "https://github.com/microsoft/powertoys/tree/main/src/modules/awake"
click node_mouseutils "https://github.com/microsoft/powertoys/tree/main/src/modules/MouseUtils"
click node_workspaces "https://github.com/microsoft/powertoys/tree/main/src/modules/Workspaces"
click node_launcher "https://github.com/microsoft/powertoys/tree/main/src/modules/launcher"
click node_otherutilities "https://github.com/microsoft/powertoys/tree/main/src/modules"
click node_theme "https://github.com/microsoft/powertoys/blob/main/src/common/Common.UI/ThemeManager.cs"
click node_language "https://github.com/microsoft/powertoys/tree/main/src/common/LanguageModelProvider"
click node_gpo "https://github.com/microsoft/powertoys/blob/main/src/common/GPOWrapperProjection/GPOWrapper.cs"
click node_telemetry "https://github.com/microsoft/powertoys/blob/main/src/common/ManagedTelemetry/Telemetry/PowerToysTelemetry.cs"
click node_globalsettings "https://github.com/microsoft/powertoys/tree/main/src/settings-ui/Settings.UI.Library"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_runner,node_quickaccess,node_user toneBlue
class node_keyboard,node_cmdpalette,node_preview,node_advancedpaste,node_fancyzones,node_awake,node_mouseutils,node_workspaces,node_launcher,node_otherutilities toneAmber
class node_settingsui,node_settingsutils,node_keyboardprofile,node_globalsettings toneMint
class node_theme,node_language,node_gpo,node_telemetry toneRose
```

## Components

### App shell

- [PowerToys Runner](https://github.com/microsoft/powertoys/blob/main/src/runner/main.cpp): `src/runner/main.cpp`
- [Quick Access](https://github.com/microsoft/powertoys/blob/main/src/settings-ui/QuickAccess.UI/QuickAccessXAML/App.xaml.cs): `src/settings-ui/QuickAccess.UI/QuickAccessXAML/App.xaml.cs`

### User utilities

- [Keyboard Manager](https://github.com/microsoft/powertoys/blob/main/src/settings-ui/Settings.UI/ViewModels/KeyboardManagerViewModel.cs): `src/settings-ui/Settings.UI/ViewModels/KeyboardManagerViewModel.cs`
- [Command Palette search](https://github.com/microsoft/powertoys/blob/main/src/modules/cmdpal/ext/Microsoft.CmdPal.Ext.Indexer/SearchEngine.cs): `src/modules/cmdpal/ext/Microsoft.CmdPal.Ext.Indexer/SearchEngine.cs`
- [File Explorer previews](https://github.com/microsoft/powertoys/blob/main/src/modules/previewpane/MonacoPreviewHandler/MonacoPreviewHandlerControl.cs): `src/modules/previewpane/MonacoPreviewHandler/MonacoPreviewHandlerControl.cs`
- [Advanced Paste cache](https://github.com/microsoft/powertoys/blob/main/src/modules/AdvancedPaste/AdvancedPaste/Services/CustomActionKernelQueryCacheService.cs): `src/modules/AdvancedPaste/AdvancedPaste/Services/CustomActionKernelQueryCacheService.cs`
- [FancyZones](https://github.com/microsoft/powertoys/tree/main/src/modules/fancyzones): `src/modules/fancyzones`
- [Awake](https://github.com/microsoft/powertoys/tree/main/src/modules/awake): `src/modules/awake`
- [Mouse Utilities](https://github.com/microsoft/powertoys/tree/main/src/modules/MouseUtils): `src/modules/MouseUtils`
- [Workspaces](https://github.com/microsoft/powertoys/tree/main/src/modules/Workspaces): `src/modules/Workspaces`
- [PowerToys Run](https://github.com/microsoft/powertoys/tree/main/src/modules/launcher): `src/modules/launcher`
- [Other utilities](https://github.com/microsoft/powertoys/tree/main/src/modules): `src/modules`

### Configuration

- [Settings UI](https://github.com/microsoft/powertoys/blob/main/src/settings-ui/Settings.UI/SettingsXAML/App.xaml.cs): `src/settings-ui/Settings.UI/SettingsXAML/App.xaml.cs`
- [Settings storage](https://github.com/microsoft/powertoys/blob/main/src/settings-ui/Settings.UI.Library/SettingsUtils.cs): `src/settings-ui/Settings.UI.Library/SettingsUtils.cs`
- [Keyboard profiles](https://github.com/microsoft/powertoys/blob/main/src/settings-ui/Settings.UI.Library/KeyboardManagerProfile.cs): `src/settings-ui/Settings.UI.Library/KeyboardManagerProfile.cs`
- [Settings library](https://github.com/microsoft/powertoys/tree/main/src/settings-ui/Settings.UI.Library): `src/settings-ui/Settings.UI.Library`

### Shared services

- [Theme management](https://github.com/microsoft/powertoys/blob/main/src/common/Common.UI/ThemeManager.cs): `src/common/Common.UI/ThemeManager.cs`
- [Language models](https://github.com/microsoft/powertoys/tree/main/src/common/LanguageModelProvider): `src/common/LanguageModelProvider`
- [Policy projection](https://github.com/microsoft/powertoys/blob/main/src/common/GPOWrapperProjection/GPOWrapper.cs): `src/common/GPOWrapperProjection/GPOWrapper.cs`
- [Telemetry](https://github.com/microsoft/powertoys/blob/main/src/common/ManagedTelemetry/Telemetry/PowerToysTelemetry.cs): `src/common/ManagedTelemetry/Telemetry/PowerToysTelemetry.cs`

### Other components

- **Windows user**

## Connections

- Windows user → PowerToys Runner: launches (evidence: `README.md`)
- PowerToys Runner → Settings UI: opens settings
- Windows user → Keyboard Manager: configures (evidence: `README.md`)
- Windows user → Command Palette search: searches with (evidence: `README.md`)
- Windows user → File Explorer previews: previews files (evidence: `README.md`)
- Windows user → Advanced Paste cache: uses (evidence: `README.md`)
- Windows user → FancyZones: arranges windows (evidence: `README.md`)
- Windows user → Awake: uses (evidence: `README.md`)
- Windows user → Mouse Utilities: uses (evidence: `README.md`)
- Windows user → Workspaces: uses (evidence: `README.md`)
- Windows user → PowerToys Run: searches with (evidence: `README.md`)
- Windows user → Other utilities: uses (evidence: `README.md`)
- Keyboard Manager → Settings storage: loads settings (evidence: `src/settings-ui/Settings.UI/ViewModels/KeyboardManagerViewModel.cs`)
- Keyboard Manager → Keyboard profiles: edits profile (evidence: `src/settings-ui/Settings.UI/ViewModels/KeyboardManagerViewModel.cs`)
- Keyboard profiles → Settings storage: persists through
- Settings UI → Settings library: uses settings models
- Advanced Paste cache → Settings storage: persists cache (evidence: `src/modules/AdvancedPaste/AdvancedPaste/Services/CustomActionKernelQueryCacheService.cs`)
- File Explorer previews → Language models: uses preview support (evidence: `src/modules/previewpane/MonacoPreviewHandler/MonacoPreviewHandlerControl.cs`)
- Settings UI → Theme management: applies themes
- Keyboard Manager → Policy projection: checks policy (evidence: `src/settings-ui/Settings.UI/ViewModels/KeyboardManagerViewModel.cs`)
- Settings UI → Telemetry: reports events
