How microsoft/powertoys works
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: KeyboardManagerViewModel.cs Keyboard Manager · App.xaml.cs Settings UI · SettingsUtils.cs Settings storage · main.cpp PowerToys Runner
Components 21
App shell
- PowerToys Runner
src/runner/main.cpp - Quick Access
src/settings-ui/QuickAccess.UI/QuickAccessXAML/App.xaml.cs
User utilities
- Keyboard Manager
src/settings-ui/Settings.UI/ViewModels/KeyboardManagerViewModel.cs - Command Palette search
src/modules/cmdpal/ext/Microsoft.CmdPal.Ext.Indexer/SearchEngine.cs - File Explorer previews
src/modules/previewpane/MonacoPreviewHandler/MonacoPreviewHandlerControl.cs - Advanced Paste cache
src/modules/AdvancedPaste/AdvancedPaste/Services/CustomActionKernelQueryCacheService.cs - FancyZones
src/modules/fancyzones - Awake
src/modules/awake - Mouse Utilities
src/modules/MouseUtils - Workspaces
src/modules/Workspaces - PowerToys Run
src/modules/launcher - Other utilities
src/modules
Configuration
- Settings UI
src/settings-ui/Settings.UI/SettingsXAML/App.xaml.cs - Settings storage
src/settings-ui/Settings.UI.Library/SettingsUtils.cs - Keyboard profiles
src/settings-ui/Settings.UI.Library/KeyboardManagerProfile.cs - Settings library
src/settings-ui/Settings.UI.Library
Shared services
- Theme management
src/common/Common.UI/ThemeManager.cs - Language models
src/common/LanguageModelProvider - Policy projection
src/common/GPOWrapperProjection/GPOWrapper.cs - Telemetry
src/common/ManagedTelemetry/Telemetry/PowerToysTelemetry.cs
Other components
- Windows user
Connections 21
- Windows user → PowerToys Runner: launches
README.md - PowerToys Runner → Settings UI: opens settings
- Windows user → Keyboard Manager: configures
README.md - Windows user → Command Palette search: searches with
README.md - Windows user → File Explorer previews: previews files
README.md - Windows user → Advanced Paste cache: uses
README.md - Windows user → FancyZones: arranges windows
README.md - Windows user → Awake: uses
README.md - Windows user → Mouse Utilities: uses
README.md - Windows user → Workspaces: uses
README.md - Windows user → PowerToys Run: searches with
README.md - Windows user → Other utilities: uses
README.md - Keyboard Manager → Settings storage: loads settings
src/settings-ui/Settings.UI/ViewModels/KeyboardManagerViewModel.cs - Keyboard Manager → Keyboard profiles: edits profile
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
src/modules/AdvancedPaste/AdvancedPaste/Services/CustomActionKernelQueryCacheService.cs - File Explorer previews → Language models: uses preview support
src/modules/previewpane/MonacoPreviewHandler/MonacoPreviewHandlerControl.cs - Settings UI → Theme management: applies themes
- Keyboard Manager → Policy projection: checks policy
src/settings-ui/Settings.UI/ViewModels/KeyboardManagerViewModel.cs - Settings UI → Telemetry: reports events