# zevolpato/powertoys architecture

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

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

## Overview

PowerToys is a Windows productivity suite: users configure and invoke individual utilities, which perform focused desktop tasks. The graph shows the shared runner/settings foundation and representative documented utility branches, including file previews, search, and workspace management. README descriptions establish the suite’s capabilities; sampled runner code confirms update dispatch, while source excerpts show selected settings, cache, and search behavior. Many utility implementations and their wiring were not sampled, so their connections are intentionally left unasserted.

Main entry points: [`src/settings-ui/Settings.UI/ViewModels/KeyboardManagerViewModel.cs`](https://github.com/zevolpato/powertoys/blob/main/src/settings-ui/Settings.UI/ViewModels/KeyboardManagerViewModel.cs) (Keyboard Manager settings), [`src/settings-ui/Settings.UI/SettingsXAML/App.xaml.cs`](https://github.com/zevolpato/powertoys/blob/main/src/settings-ui/Settings.UI/SettingsXAML/App.xaml.cs) (Settings UI), [`src/modules/cmdpal`](https://github.com/zevolpato/powertoys/tree/main/src/modules/cmdpal) (Command Palette), [`src/modules/previewpane`](https://github.com/zevolpato/powertoys/tree/main/src/modules/previewpane) (File Explorer previews)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["Application shell"]
  node_runner["PowerToys Runner<br/>[main.cpp]"]
  node_update["Update handling"]
end

subgraph group_settings["Settings and policy"]
  node_settingsui["Settings UI<br/>[App.xaml.cs]"]
  node_keyboardvm["Keyboard Manager settings"]
  node_settingslib["Settings persistence<br/>[SettingsUtils.cs]"]
  node_settingsmodels["Keyboard profiles"]
  node_dsc["Configuration resources<br/>[PowerToys.DSC]"]
  node_searchsettings["Settings search index"]
end

subgraph group_productivity["Productivity utilities"]
  node_advancedpaste["Advanced Paste"]
  node_awake["Awake<br/>[Manager.cs]"]
  node_keyboard["Keyboard Manager"]
  node_mouse["Mouse utilities"]
  node_workspaces["Workspaces"]
  node_mwbsettings["Mouse Without Borders settings<br/>[Setting.cs]"]
  node_launcherlog["Launcher logging<br/>[Log.cs]"]
  node_workspacesmodel["Workspace applications<br/>[Application.cs]"]
end

subgraph group_filework["File and search tools"]
  node_cmdpal["Command Palette"]
  node_indexer["File index search<br/>[SearchEngine.cs]"]
  node_preview["File Explorer previews"]
  node_monaco["Monaco preview handler"]
  node_monacoengine["Monaco editor assets<br/>[editor.main.js]"]
  node_previewforms["Preview form controls"]
end

subgraph group_platform["Shared platform"]
  node_theme["Theme management<br/>[ThemeManager.cs]"]
  node_gpo["Group policy wrapper<br/>[GPOWrapper.cs]"]
  node_telemetry["Telemetry"]
  node_language["Local language models<br/>[Runtime.cs]"]
end

node_user(("Windows user"))

node_user -.->|"uses suite"| node_runner
node_runner -->|"launches update"| node_update
node_user -.->|"configures utilities"| node_settingsui
node_settingsui -.->|"hosts settings"| node_keyboardvm
node_keyboardvm -->|"loads settings"| node_settingslib
node_keyboardvm -->|"edits profiles"| node_settingsmodels
node_dsc -.->|"uses settings"| node_settingslib
node_user -.->|"invokes utility"| node_advancedpaste
node_user -.->|"invokes utility"| node_awake
node_user -.->|"invokes utility"| node_keyboard
node_user -.->|"invokes utility"| node_mouse
node_user -.->|"invokes utility"| node_workspaces
node_user -.->|"invokes utility"| node_cmdpal
node_cmdpal -.->|"offers search"| node_indexer
node_user -.->|"previews files"| node_preview
node_preview -.->|"hosts handler"| node_monaco
node_monaco -.->|"uses editor assets"| node_monacoengine
node_settingsui -.->|"applies themes"| node_theme
node_keyboardvm -->|"checks policy"| node_gpo
node_keyboardvm -->|"reports events"| node_telemetry
node_advancedpaste -.->|"uses model provider"| node_language
node_mwbsettings -.->|"configures utility"| node_mouse
node_launcherlog -.->|"supports logging"| node_cmdpal
node_workspacesmodel -.->|"models applications"| node_workspaces
node_previewforms -.->|"supports handlers"| node_preview
node_settingsui -.->|"provides search"| node_searchsettings

click node_runner "https://github.com/zevolpato/powertoys/blob/main/src/runner/main.cpp"
click node_update "https://github.com/zevolpato/powertoys/blob/main/src/Update/PowerToys.Update.cpp"
click node_settingsui "https://github.com/zevolpato/powertoys/blob/main/src/settings-ui/Settings.UI/SettingsXAML/App.xaml.cs"
click node_keyboardvm "https://github.com/zevolpato/powertoys/blob/main/src/settings-ui/Settings.UI/ViewModels/KeyboardManagerViewModel.cs"
click node_settingslib "https://github.com/zevolpato/powertoys/blob/main/src/settings-ui/Settings.UI.Library/SettingsUtils.cs"
click node_settingsmodels "https://github.com/zevolpato/powertoys/blob/main/src/settings-ui/Settings.UI.Library/KeyboardManagerProfile.cs"
click node_dsc "https://github.com/zevolpato/powertoys/tree/main/src/dsc/v3/PowerToys.DSC"
click node_advancedpaste "https://github.com/zevolpato/powertoys/tree/main/src/modules/AdvancedPaste/AdvancedPaste"
click node_awake "https://github.com/zevolpato/powertoys/blob/main/src/modules/awake/Awake/Core/Manager.cs"
click node_keyboard "https://github.com/zevolpato/powertoys/tree/main/src/modules/keyboardmanager"
click node_mouse "https://github.com/zevolpato/powertoys/tree/main/src/modules/MouseUtils"
click node_workspaces "https://github.com/zevolpato/powertoys/tree/main/src/modules/Workspaces"
click node_cmdpal "https://github.com/zevolpato/powertoys/tree/main/src/modules/cmdpal"
click node_indexer "https://github.com/zevolpato/powertoys/blob/main/src/modules/cmdpal/ext/Microsoft.CmdPal.Ext.Indexer/SearchEngine.cs"
click node_preview "https://github.com/zevolpato/powertoys/tree/main/src/modules/previewpane"
click node_monaco "https://github.com/zevolpato/powertoys/blob/main/src/modules/previewpane/MonacoPreviewHandler/MonacoPreviewHandlerControl.cs"
click node_monacoengine "https://github.com/zevolpato/powertoys/blob/main/src/Monaco/monacoSRC/min/vs/editor/editor.main.js"
click node_theme "https://github.com/zevolpato/powertoys/blob/main/src/common/Common.UI/ThemeManager.cs"
click node_gpo "https://github.com/zevolpato/powertoys/blob/main/src/common/GPOWrapperProjection/GPOWrapper.cs"
click node_telemetry "https://github.com/zevolpato/powertoys/blob/main/src/common/ManagedTelemetry/Telemetry/PowerToysTelemetry.cs"
click node_language "https://github.com/zevolpato/powertoys/blob/main/src/common/LanguageModelProvider/FoundryLocal/Runtime.cs"
click node_mwbsettings "https://github.com/zevolpato/powertoys/blob/main/src/modules/MouseWithoutBorders/App/Class/Setting.cs"
click node_launcherlog "https://github.com/zevolpato/powertoys/blob/main/src/modules/launcher/Wox.Plugin/Logger/Log.cs"
click node_workspacesmodel "https://github.com/zevolpato/powertoys/blob/main/src/modules/Workspaces/WorkspacesEditor/Models/Application.cs"
click node_previewforms "https://github.com/zevolpato/powertoys/blob/main/src/modules/previewpane/common/controls/FormHandlerControl.cs"
click node_searchsettings "https://github.com/zevolpato/powertoys/blob/main/src/settings-ui/Settings.UI/Services/SearchIndexService.cs"

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_update,node_user toneBlue
class node_settingsui,node_keyboardvm,node_settingslib,node_settingsmodels,node_dsc,node_searchsettings toneAmber
class node_advancedpaste,node_awake,node_keyboard,node_mouse,node_workspaces,node_mwbsettings,node_launcherlog,node_workspacesmodel toneMint
class node_cmdpal,node_indexer,node_preview,node_monaco,node_monacoengine,node_previewforms toneRose
class node_theme,node_gpo,node_telemetry,node_language toneIndigo
```

## Components

### Application shell

- [PowerToys Runner](https://github.com/zevolpato/powertoys/blob/main/src/runner/main.cpp): `src/runner/main.cpp`
- [Update handling](https://github.com/zevolpato/powertoys/blob/main/src/Update/PowerToys.Update.cpp): `src/Update/PowerToys.Update.cpp`

### Settings and policy

- [Settings UI](https://github.com/zevolpato/powertoys/blob/main/src/settings-ui/Settings.UI/SettingsXAML/App.xaml.cs): `src/settings-ui/Settings.UI/SettingsXAML/App.xaml.cs`
- [Keyboard Manager settings](https://github.com/zevolpato/powertoys/blob/main/src/settings-ui/Settings.UI/ViewModels/KeyboardManagerViewModel.cs): `src/settings-ui/Settings.UI/ViewModels/KeyboardManagerViewModel.cs`
- [Settings persistence](https://github.com/zevolpato/powertoys/blob/main/src/settings-ui/Settings.UI.Library/SettingsUtils.cs): `src/settings-ui/Settings.UI.Library/SettingsUtils.cs`
- [Keyboard profiles](https://github.com/zevolpato/powertoys/blob/main/src/settings-ui/Settings.UI.Library/KeyboardManagerProfile.cs): `src/settings-ui/Settings.UI.Library/KeyboardManagerProfile.cs`
- [Configuration resources](https://github.com/zevolpato/powertoys/tree/main/src/dsc/v3/PowerToys.DSC): `src/dsc/v3/PowerToys.DSC`
- [Settings search index](https://github.com/zevolpato/powertoys/blob/main/src/settings-ui/Settings.UI/Services/SearchIndexService.cs): `src/settings-ui/Settings.UI/Services/SearchIndexService.cs`

### Productivity utilities

- [Advanced Paste](https://github.com/zevolpato/powertoys/tree/main/src/modules/AdvancedPaste/AdvancedPaste): `src/modules/AdvancedPaste/AdvancedPaste`
- [Awake](https://github.com/zevolpato/powertoys/blob/main/src/modules/awake/Awake/Core/Manager.cs): `src/modules/awake/Awake/Core/Manager.cs`
- [Keyboard Manager](https://github.com/zevolpato/powertoys/tree/main/src/modules/keyboardmanager): `src/modules/keyboardmanager`
- [Mouse utilities](https://github.com/zevolpato/powertoys/tree/main/src/modules/MouseUtils): `src/modules/MouseUtils`
- [Workspaces](https://github.com/zevolpato/powertoys/tree/main/src/modules/Workspaces): `src/modules/Workspaces`
- [Mouse Without Borders settings](https://github.com/zevolpato/powertoys/blob/main/src/modules/MouseWithoutBorders/App/Class/Setting.cs): `src/modules/MouseWithoutBorders/App/Class/Setting.cs`
- [Launcher logging](https://github.com/zevolpato/powertoys/blob/main/src/modules/launcher/Wox.Plugin/Logger/Log.cs): `src/modules/launcher/Wox.Plugin/Logger/Log.cs`
- [Workspace applications](https://github.com/zevolpato/powertoys/blob/main/src/modules/Workspaces/WorkspacesEditor/Models/Application.cs): `src/modules/Workspaces/WorkspacesEditor/Models/Application.cs`

### File and search tools

- [Command Palette](https://github.com/zevolpato/powertoys/tree/main/src/modules/cmdpal): `src/modules/cmdpal`
- [File index search](https://github.com/zevolpato/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/zevolpato/powertoys/tree/main/src/modules/previewpane): `src/modules/previewpane`
- [Monaco preview handler](https://github.com/zevolpato/powertoys/blob/main/src/modules/previewpane/MonacoPreviewHandler/MonacoPreviewHandlerControl.cs): `src/modules/previewpane/MonacoPreviewHandler/MonacoPreviewHandlerControl.cs`
- [Monaco editor assets](https://github.com/zevolpato/powertoys/blob/main/src/Monaco/monacoSRC/min/vs/editor/editor.main.js): `src/Monaco/monacoSRC/min/vs/editor/editor.main.js`
- [Preview form controls](https://github.com/zevolpato/powertoys/blob/main/src/modules/previewpane/common/controls/FormHandlerControl.cs): `src/modules/previewpane/common/controls/FormHandlerControl.cs`

### Shared platform

- [Theme management](https://github.com/zevolpato/powertoys/blob/main/src/common/Common.UI/ThemeManager.cs): `src/common/Common.UI/ThemeManager.cs`
- [Group policy wrapper](https://github.com/zevolpato/powertoys/blob/main/src/common/GPOWrapperProjection/GPOWrapper.cs): `src/common/GPOWrapperProjection/GPOWrapper.cs`
- [Telemetry](https://github.com/zevolpato/powertoys/blob/main/src/common/ManagedTelemetry/Telemetry/PowerToysTelemetry.cs): `src/common/ManagedTelemetry/Telemetry/PowerToysTelemetry.cs`
- [Local language models](https://github.com/zevolpato/powertoys/blob/main/src/common/LanguageModelProvider/FoundryLocal/Runtime.cs): `src/common/LanguageModelProvider/FoundryLocal/Runtime.cs`

### Other components

- **Windows user**

## Connections

- Windows user → PowerToys Runner: uses suite (evidence: `README.md`)
- PowerToys Runner → Update handling: launches update (evidence: `src/runner/main.cpp`)
- Windows user → Settings UI: configures utilities (evidence: `README.md`)
- Settings UI → Keyboard Manager settings: hosts settings
- Keyboard Manager settings → Settings persistence: loads settings (evidence: `src/settings-ui/Settings.UI/ViewModels/KeyboardManagerViewModel.cs`)
- Keyboard Manager settings → Keyboard profiles: edits profiles (evidence: `src/settings-ui/Settings.UI/ViewModels/KeyboardManagerViewModel.cs`)
- Configuration resources → Settings persistence: uses settings
- Windows user → Advanced Paste: invokes utility (evidence: `README.md`)
- Windows user → Awake: invokes utility (evidence: `README.md`)
- Windows user → Keyboard Manager: invokes utility (evidence: `README.md`)
- Windows user → Mouse utilities: invokes utility (evidence: `README.md`)
- Windows user → Workspaces: invokes utility (evidence: `README.md`)
- Windows user → Command Palette: invokes utility (evidence: `README.md`)
- Command Palette → File index search: offers search (evidence: `src/modules/cmdpal/ext/Microsoft.CmdPal.Ext.Indexer/SearchEngine.cs`)
- Windows user → File Explorer previews: previews files (evidence: `README.md`)
- File Explorer previews → Monaco preview handler: hosts handler (evidence: `src/modules/previewpane/MonacoPreviewHandler/MonacoPreviewHandlerControl.cs`)
- Monaco preview handler → Monaco editor assets: uses editor assets
- Settings UI → Theme management: applies themes
- Keyboard Manager settings → Group policy wrapper: checks policy (evidence: `src/settings-ui/Settings.UI/ViewModels/KeyboardManagerViewModel.cs`)
- Keyboard Manager settings → Telemetry: reports events (evidence: `src/settings-ui/Settings.UI/ViewModels/KeyboardManagerViewModel.cs`)
- Advanced Paste → Local language models: uses model provider
- Mouse Without Borders settings → Mouse utilities: configures utility
- Launcher logging → Command Palette: supports logging
- Workspace applications → Workspaces: models applications (evidence: `src/modules/Workspaces/WorkspacesEditor/Models/Application.cs`)
- Preview form controls → File Explorer previews: supports handlers (evidence: `src/modules/previewpane/common/controls/FormHandlerControl.cs`)
- Settings UI → Settings search index: provides search
