How star-pie/starpie works
StarPie is a Windows radial-menu and mouse-gesture utility. The principal workflow is a user trigger, gesture recognition and wheel selection, then dispatch of the selected action. Configuration and per-app profiles shape the wheel; renderers present it, while OCR, window management, and plugins extend the action set. The README documents major capabilities; source excerpts confirm key dispatch, persistence, and plugin boundaries. Several UI and feature implementations are represented from README claims and exact tree paths, not inspected source.
Main entry points: ActionExecutor.cs Action executor · GestureController.cs Gesture controller · PluginHost.cs Plugin host · RadialWindow.xaml.cs Radial menu
Components 24
Gesture interaction
- Global input hooks
WinPieGestures/MouseHook.cs - Gesture controller
WinPieGestures/GestureController.cs - Trail overlay
WinPieGestures/GestureTrailOverlay.cs - Radial menu
WinPieGestures/RadialWindow.xaml.cs
Configuration and presentation
- Wheel profiles
WinPieGestures/WheelProfile.cs - Configuration manager
WinPieGestures/ConfigManager.cs - Settings editor
WinPieGestures/SettingsWindow.xaml.cs - Wheel renderers
WinPieGestures/StyleRendererFactory.cs
Action capabilities
- Action definitions
WinPieGestures/ActionItem.cs - Action executor
WinPieGestures/ActionExecutor.cs - Process launching
WinPieGestures/ProcessLaunchExecutor.cs - Screen OCR
WinPieGestures/OcrManager.cs - Window management
WinPieGestures/WindowTiler.cs - Keyboard remapping
WinPieGestures/KeyboardRemapController.cs
Plugin platform
- Plugin abstractions
plugin/sdk/StarPie.Plugin.Abstractions/Actions.cs - Plugin host
WinPieGestures/Plugin/PluginHost.cs - Plugin instances
WinPieGestures/Plugin/PluginInstance.cs - Official plugin client
WinPieGestures/Plugin/OfficialPluginClient.cs - Plugin registry
WinPieGestures/Plugin/PluginRegistryStore.cs
Application services
- Diagnostic logging
WinPieGestures/AppLogger.cs - Update manager
WinPieGestures/UpdateManager.cs
Other components
- User
- Windows desktop
- Official plugin source
Connections 24
- User → Global input hooks: triggers
- Global input hooks → Gesture controller: sends events
WinPieGestures/GestureController.cs - Gesture controller → Radial menu: opens menu
- Gesture controller → Trail overlay: shows trail
WinPieGestures/GestureController.cs - Gesture controller → Configuration manager: reads settings
WinPieGestures/GestureController.cs - Gesture controller → Action executor: executes selection
WinPieGestures/GestureController.cs - Radial menu → Action definitions: selects action
- Radial menu → Wheel renderers: renders menu
- Configuration manager → Wheel profiles: loads profiles
WinPieGestures/ConfigManager.cs - Settings editor → Configuration manager: edits configuration
- Action executor → Action definitions: dispatches action
WinPieGestures/ActionExecutor.cs - Action executor → Plugin host: invokes plugin
WinPieGestures/ActionExecutor.cs - Action executor → Process launching: launches process
WinPieGestures/ActionExecutor.cs - Action executor → Screen OCR: runs OCR
WinPieGestures/ActionExecutor.cs - Action executor → Window management: manages windows
- Action executor → Windows desktop: sends system actions
- Keyboard remapping → Windows desktop: remaps keys
- Plugin host → Plugin instances: manages instances
WinPieGestures/Plugin/PluginHost.cs - Plugin host → Plugin registry: uses registry
WinPieGestures/Plugin/PluginHost.cs - Plugin host → Plugin abstractions: implements contract
WinPieGestures/Plugin/PluginHost.cs - Official plugin client → Official plugin source: fetches packages
WinPieGestures/Plugin/OfficialPluginClient.cs - Official plugin client → Plugin host: installs plugins
WinPieGestures/Plugin/OfficialPluginClient.cs - Update manager → Official plugin source: checks releases
- Action executor → Diagnostic logging: logs errors
WinPieGestures/ActionExecutor.cs