# star-pie/starpie architecture

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

- Interactive diagram: https://gitdiagram.com/star-pie/starpie
- Repository: https://github.com/star-pie/starpie

## Overview

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: [`WinPieGestures/ActionExecutor.cs`](https://github.com/star-pie/starpie/blob/main/WinPieGestures/ActionExecutor.cs) (Action executor), [`WinPieGestures/GestureController.cs`](https://github.com/star-pie/starpie/blob/main/WinPieGestures/GestureController.cs) (Gesture controller), [`WinPieGestures/Plugin/PluginHost.cs`](https://github.com/star-pie/starpie/blob/main/WinPieGestures/Plugin/PluginHost.cs) (Plugin host), [`WinPieGestures/RadialWindow.xaml.cs`](https://github.com/star-pie/starpie/blob/main/WinPieGestures/RadialWindow.xaml.cs) (Radial menu)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Gesture interaction"]
  node_input["Global input hooks<br/>[MouseHook.cs]"]
  node_gesture["Gesture controller"]
  node_trail["Trail overlay"]
  node_wheel["Radial menu"]
end

subgraph group_configuration["Configuration and presentation"]
  node_profile["Wheel profiles<br/>[WheelProfile.cs]"]
  node_config[("Configuration manager<br/>[ConfigManager.cs]")]
  node_settings["Settings editor"]
  node_render["Wheel renderers"]
end

subgraph group_actions["Action capabilities"]
  node_actionmodel["Action definitions<br/>[ActionItem.cs]"]
  node_executor["Action executor<br/>[ActionExecutor.cs]"]
  node_process["Process launching"]
  node_ocr["Screen OCR<br/>[OcrManager.cs]"]
  node_window["Window management<br/>[WindowTiler.cs]"]
  node_keyboard["Keyboard remapping"]
end

subgraph group_plugins["Plugin platform"]
  node_sdk["Plugin abstractions<br/>[Actions.cs]"]
  node_host["Plugin host<br/>[PluginHost.cs]"]
  node_instance["Plugin instances<br/>[PluginInstance.cs]"]
  node_official["Official plugin client"]
  node_storage[("Plugin registry")]
end

subgraph group_operations["Application services"]
  node_logger["Diagnostic logging<br/>[AppLogger.cs]"]
  node_updates["Update manager<br/>[UpdateManager.cs]"]
end

node_user(("User"))
node_windows(("Windows desktop"))
node_pluginrepo(("Official plugin source"))

node_user -->|"triggers"| node_input
node_input -.->|"sends events"| node_gesture
node_gesture -.->|"opens menu"| node_wheel
node_gesture -.->|"shows trail"| node_trail
node_gesture -->|"reads settings"| node_config
node_gesture -->|"executes selection"| node_executor
node_wheel -->|"selects action"| node_actionmodel
node_wheel -.->|"renders menu"| node_render
node_config -->|"loads profiles"| node_profile
node_settings -.->|"edits configuration"| node_config
node_executor -->|"dispatches action"| node_actionmodel
node_executor -->|"invokes plugin"| node_host
node_executor -->|"launches process"| node_process
node_executor -->|"runs OCR"| node_ocr
node_executor -.->|"manages windows"| node_window
node_executor -->|"sends system actions"| node_windows
node_keyboard -.->|"remaps keys"| node_windows
node_host -->|"manages instances"| node_instance
node_host -->|"uses registry"| node_storage
node_host -->|"implements contract"| node_sdk
node_official -->|"fetches packages"| node_pluginrepo
node_official -->|"installs plugins"| node_host
node_updates -.->|"checks releases"| node_pluginrepo
node_executor -->|"logs errors"| node_logger

click node_input "https://github.com/star-pie/starpie/blob/main/WinPieGestures/MouseHook.cs"
click node_gesture "https://github.com/star-pie/starpie/blob/main/WinPieGestures/GestureController.cs"
click node_trail "https://github.com/star-pie/starpie/blob/main/WinPieGestures/GestureTrailOverlay.cs"
click node_wheel "https://github.com/star-pie/starpie/blob/main/WinPieGestures/RadialWindow.xaml.cs"
click node_profile "https://github.com/star-pie/starpie/blob/main/WinPieGestures/WheelProfile.cs"
click node_config "https://github.com/star-pie/starpie/blob/main/WinPieGestures/ConfigManager.cs"
click node_settings "https://github.com/star-pie/starpie/blob/main/WinPieGestures/SettingsWindow.xaml.cs"
click node_render "https://github.com/star-pie/starpie/blob/main/WinPieGestures/StyleRendererFactory.cs"
click node_actionmodel "https://github.com/star-pie/starpie/blob/main/WinPieGestures/ActionItem.cs"
click node_executor "https://github.com/star-pie/starpie/blob/main/WinPieGestures/ActionExecutor.cs"
click node_process "https://github.com/star-pie/starpie/blob/main/WinPieGestures/ProcessLaunchExecutor.cs"
click node_ocr "https://github.com/star-pie/starpie/blob/main/WinPieGestures/OcrManager.cs"
click node_window "https://github.com/star-pie/starpie/blob/main/WinPieGestures/WindowTiler.cs"
click node_keyboard "https://github.com/star-pie/starpie/blob/main/WinPieGestures/KeyboardRemapController.cs"
click node_sdk "https://github.com/star-pie/starpie/blob/main/plugin/sdk/StarPie.Plugin.Abstractions/Actions.cs"
click node_host "https://github.com/star-pie/starpie/blob/main/WinPieGestures/Plugin/PluginHost.cs"
click node_instance "https://github.com/star-pie/starpie/blob/main/WinPieGestures/Plugin/PluginInstance.cs"
click node_official "https://github.com/star-pie/starpie/blob/main/WinPieGestures/Plugin/OfficialPluginClient.cs"
click node_storage "https://github.com/star-pie/starpie/blob/main/WinPieGestures/Plugin/PluginRegistryStore.cs"
click node_logger "https://github.com/star-pie/starpie/blob/main/WinPieGestures/AppLogger.cs"
click node_updates "https://github.com/star-pie/starpie/blob/main/WinPieGestures/UpdateManager.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_input,node_gesture,node_trail,node_wheel,node_user toneBlue
class node_profile,node_config,node_settings,node_render toneAmber
class node_actionmodel,node_executor,node_process,node_ocr,node_window,node_keyboard toneMint
class node_sdk,node_host,node_instance,node_official,node_storage toneRose
class node_logger,node_updates,node_windows,node_pluginrepo toneIndigo
```

## Components

### Gesture interaction

- [Global input hooks](https://github.com/star-pie/starpie/blob/main/WinPieGestures/MouseHook.cs): `WinPieGestures/MouseHook.cs`
- [Gesture controller](https://github.com/star-pie/starpie/blob/main/WinPieGestures/GestureController.cs): `WinPieGestures/GestureController.cs`
- [Trail overlay](https://github.com/star-pie/starpie/blob/main/WinPieGestures/GestureTrailOverlay.cs): `WinPieGestures/GestureTrailOverlay.cs`
- [Radial menu](https://github.com/star-pie/starpie/blob/main/WinPieGestures/RadialWindow.xaml.cs): `WinPieGestures/RadialWindow.xaml.cs`

### Configuration and presentation

- [Wheel profiles](https://github.com/star-pie/starpie/blob/main/WinPieGestures/WheelProfile.cs): `WinPieGestures/WheelProfile.cs`
- [Configuration manager](https://github.com/star-pie/starpie/blob/main/WinPieGestures/ConfigManager.cs): `WinPieGestures/ConfigManager.cs`
- [Settings editor](https://github.com/star-pie/starpie/blob/main/WinPieGestures/SettingsWindow.xaml.cs): `WinPieGestures/SettingsWindow.xaml.cs`
- [Wheel renderers](https://github.com/star-pie/starpie/blob/main/WinPieGestures/StyleRendererFactory.cs): `WinPieGestures/StyleRendererFactory.cs`

### Action capabilities

- [Action definitions](https://github.com/star-pie/starpie/blob/main/WinPieGestures/ActionItem.cs): `WinPieGestures/ActionItem.cs`
- [Action executor](https://github.com/star-pie/starpie/blob/main/WinPieGestures/ActionExecutor.cs): `WinPieGestures/ActionExecutor.cs`
- [Process launching](https://github.com/star-pie/starpie/blob/main/WinPieGestures/ProcessLaunchExecutor.cs): `WinPieGestures/ProcessLaunchExecutor.cs`
- [Screen OCR](https://github.com/star-pie/starpie/blob/main/WinPieGestures/OcrManager.cs): `WinPieGestures/OcrManager.cs`
- [Window management](https://github.com/star-pie/starpie/blob/main/WinPieGestures/WindowTiler.cs): `WinPieGestures/WindowTiler.cs`
- [Keyboard remapping](https://github.com/star-pie/starpie/blob/main/WinPieGestures/KeyboardRemapController.cs): `WinPieGestures/KeyboardRemapController.cs`

### Plugin platform

- [Plugin abstractions](https://github.com/star-pie/starpie/blob/main/plugin/sdk/StarPie.Plugin.Abstractions/Actions.cs): `plugin/sdk/StarPie.Plugin.Abstractions/Actions.cs`
- [Plugin host](https://github.com/star-pie/starpie/blob/main/WinPieGestures/Plugin/PluginHost.cs): `WinPieGestures/Plugin/PluginHost.cs`
- [Plugin instances](https://github.com/star-pie/starpie/blob/main/WinPieGestures/Plugin/PluginInstance.cs): `WinPieGestures/Plugin/PluginInstance.cs`
- [Official plugin client](https://github.com/star-pie/starpie/blob/main/WinPieGestures/Plugin/OfficialPluginClient.cs): `WinPieGestures/Plugin/OfficialPluginClient.cs`
- [Plugin registry](https://github.com/star-pie/starpie/blob/main/WinPieGestures/Plugin/PluginRegistryStore.cs): `WinPieGestures/Plugin/PluginRegistryStore.cs`

### Application services

- [Diagnostic logging](https://github.com/star-pie/starpie/blob/main/WinPieGestures/AppLogger.cs): `WinPieGestures/AppLogger.cs`
- [Update manager](https://github.com/star-pie/starpie/blob/main/WinPieGestures/UpdateManager.cs): `WinPieGestures/UpdateManager.cs`

### Other components

- **User**
- **Windows desktop**
- **Official plugin source**

## Connections

- User → Global input hooks: triggers
- Global input hooks → Gesture controller: sends events (evidence: `WinPieGestures/GestureController.cs`)
- Gesture controller → Radial menu: opens menu
- Gesture controller → Trail overlay: shows trail (evidence: `WinPieGestures/GestureController.cs`)
- Gesture controller → Configuration manager: reads settings (evidence: `WinPieGestures/GestureController.cs`)
- Gesture controller → Action executor: executes selection (evidence: `WinPieGestures/GestureController.cs`)
- Radial menu → Action definitions: selects action
- Radial menu → Wheel renderers: renders menu
- Configuration manager → Wheel profiles: loads profiles (evidence: `WinPieGestures/ConfigManager.cs`)
- Settings editor → Configuration manager: edits configuration
- Action executor → Action definitions: dispatches action (evidence: `WinPieGestures/ActionExecutor.cs`)
- Action executor → Plugin host: invokes plugin (evidence: `WinPieGestures/ActionExecutor.cs`)
- Action executor → Process launching: launches process (evidence: `WinPieGestures/ActionExecutor.cs`)
- Action executor → Screen OCR: runs OCR (evidence: `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 (evidence: `WinPieGestures/Plugin/PluginHost.cs`)
- Plugin host → Plugin registry: uses registry (evidence: `WinPieGestures/Plugin/PluginHost.cs`)
- Plugin host → Plugin abstractions: implements contract (evidence: `WinPieGestures/Plugin/PluginHost.cs`)
- Official plugin client → Official plugin source: fetches packages (evidence: `WinPieGestures/Plugin/OfficialPluginClient.cs`)
- Official plugin client → Plugin host: installs plugins (evidence: `WinPieGestures/Plugin/OfficialPluginClient.cs`)
- Update manager → Official plugin source: checks releases
- Action executor → Diagnostic logging: logs errors (evidence: `WinPieGestures/ActionExecutor.cs`)
