# dumbeau/autohotpie architecture

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

- Interactive diagram: https://gitdiagram.com/dumbeau/autohotpie
- Repository: https://github.com/dumbeau/autohotpie

## Overview

AutoHotPie is a Windows radial-menu and macro configuration app for artists and macro users. Users configure profiles, activation keys, pie menus, slice actions, scripts, and icons, then save settings and run the menus. The Electron renderer provides the configuration UI; its preload bridge handles file and system access, while AutoHotkey scripts implement menu behavior. The excerpts show some UI and run-path calls, but not all page wiring or the complete launch implementation, so uncertain connections are omitted or marked unverified.

Main entry points: [`src/profileManagement.js`](https://github.com/dumbeau/autohotpie/blob/master/src/profileManagement.js) (Profile management), [`src/editPieMenu.js`](https://github.com/dumbeau/autohotpie/blob/master/src/editPieMenu.js) (Pie menu editor), [`src/lib/renderer.js`](https://github.com/dumbeau/autohotpie/blob/master/src/lib/renderer.js) (Renderer utilities), [`src/runningPieMenu.js`](https://github.com/dumbeau/autohotpie/blob/master/src/runningPieMenu.js) (Run menu UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop app"]
  node_electron["Electron main<br/>[main.js]"]
  node_renderer["Renderer utilities<br/>[renderer.js]"]
  node_bridge["Preload bridge<br/>[preload.js]"]
end

subgraph group_configuration["Menu configuration"]
  node_settings["Settings model<br/>[ahpClasses.js]"]
  node_profiles["Profile management"]
  node_menu_editor["Pie menu editor<br/>[editPieMenu.js]"]
  node_hotkeys["Hotkey management"]
  node_activation["Activation modes"]
  node_new_menu["Create menu"]
  node_new_profile["Create profile"]
  node_function_select["Function selection<br/>[functionSelect.js]"]
end

subgraph group_user_assets["Scripts and assets"]
  node_icon_manager["Icon manager<br/>[iconManager.js]"]
  node_script_editor["Script editor<br/>[editScript.js]"]
  node_script_creator["Create script<br/>[createNewScript.js]"]
  node_color_picker["Color picker<br/>[jscolor.js]"]
end

subgraph group_runtime["Menu runtime"]
  node_run_ui["Run menu UI<br/>[runningPieMenu.js]"]
  node_ahk_engine["Pie menu engine<br/>[PieMenu.ahk]"]
  node_ahk_functions["Menu functions<br/>[PieFunctions.ahk]"]
end

node_user(("User"))
node_ahk_runtime(("AutoHotkey"))

node_user -.->|"opens app"| node_electron
node_electron -.->|"hosts UI"| node_renderer
node_renderer -->|"refreshes icons"| node_icon_manager
node_renderer -->|"opens run UI"| node_run_ui
node_profiles -.->|"edits settings"| node_settings
node_menu_editor -->|"updates menu data"| node_settings
node_profiles -->|"opens before run"| node_run_ui
node_profiles -->|"saves settings"| node_settings
node_run_ui -.->|"starts menu run"| node_bridge
node_bridge -->|"targets script"| node_ahk_engine
node_ahk_runtime -.->|"executes"| node_ahk_engine
node_menu_editor -.->|"chooses icons"| node_icon_manager
node_menu_editor -.->|"selects actions"| node_function_select
node_menu_editor -.->|"sets colors"| node_color_picker
node_profiles -.->|"creates profile"| node_new_profile
node_profiles -.->|"creates menu"| node_new_menu
node_profiles -.->|"configures keys"| node_hotkeys
node_profiles -.->|"configures activation"| node_activation
node_script_editor -.->|"edits scripts"| node_script_creator

click node_electron "https://github.com/dumbeau/autohotpie/blob/master/main.js"
click node_renderer "https://github.com/dumbeau/autohotpie/blob/master/src/lib/renderer.js"
click node_bridge "https://github.com/dumbeau/autohotpie/blob/master/src/preload.js"
click node_settings "https://github.com/dumbeau/autohotpie/blob/master/src/classes/ahpClasses.js"
click node_profiles "https://github.com/dumbeau/autohotpie/blob/master/src/profileManagement.js"
click node_menu_editor "https://github.com/dumbeau/autohotpie/blob/master/src/editPieMenu.js"
click node_hotkeys "https://github.com/dumbeau/autohotpie/blob/master/src/hotkeyManagement.js"
click node_activation "https://github.com/dumbeau/autohotpie/blob/master/src/changeActivationMode.js"
click node_new_menu "https://github.com/dumbeau/autohotpie/blob/master/src/createNewPieMenu.js"
click node_new_profile "https://github.com/dumbeau/autohotpie/blob/master/src/createNewProfile.js"
click node_function_select "https://github.com/dumbeau/autohotpie/blob/master/src/functionSelect.js"
click node_icon_manager "https://github.com/dumbeau/autohotpie/blob/master/src/iconManager.js"
click node_script_editor "https://github.com/dumbeau/autohotpie/blob/master/src/editScript.js"
click node_script_creator "https://github.com/dumbeau/autohotpie/blob/master/src/createNewScript.js"
click node_color_picker "https://github.com/dumbeau/autohotpie/blob/master/src/lib/jscolor.js"
click node_run_ui "https://github.com/dumbeau/autohotpie/blob/master/src/runningPieMenu.js"
click node_ahk_engine "https://github.com/dumbeau/autohotpie/blob/master/src/PieMenu.ahk"
click node_ahk_functions "https://github.com/dumbeau/autohotpie/blob/master/src/lib/PieFunctions.ahk"

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_electron,node_renderer,node_bridge,node_user toneBlue
class node_settings,node_profiles,node_menu_editor,node_hotkeys,node_activation,node_new_menu,node_new_profile,node_function_select toneAmber
class node_icon_manager,node_script_editor,node_script_creator,node_color_picker toneMint
class node_run_ui,node_ahk_engine,node_ahk_functions toneRose
class node_ahk_runtime toneIndigo
```

## Components

### Desktop app

- [Electron main](https://github.com/dumbeau/autohotpie/blob/master/main.js): `main.js`
- [Renderer utilities](https://github.com/dumbeau/autohotpie/blob/master/src/lib/renderer.js): `src/lib/renderer.js`
- [Preload bridge](https://github.com/dumbeau/autohotpie/blob/master/src/preload.js): `src/preload.js`

### Menu configuration

- [Settings model](https://github.com/dumbeau/autohotpie/blob/master/src/classes/ahpClasses.js): `src/classes/ahpClasses.js`
- [Profile management](https://github.com/dumbeau/autohotpie/blob/master/src/profileManagement.js): `src/profileManagement.js`
- [Pie menu editor](https://github.com/dumbeau/autohotpie/blob/master/src/editPieMenu.js): `src/editPieMenu.js`
- [Hotkey management](https://github.com/dumbeau/autohotpie/blob/master/src/hotkeyManagement.js): `src/hotkeyManagement.js`
- [Activation modes](https://github.com/dumbeau/autohotpie/blob/master/src/changeActivationMode.js): `src/changeActivationMode.js`
- [Create menu](https://github.com/dumbeau/autohotpie/blob/master/src/createNewPieMenu.js): `src/createNewPieMenu.js`
- [Create profile](https://github.com/dumbeau/autohotpie/blob/master/src/createNewProfile.js): `src/createNewProfile.js`
- [Function selection](https://github.com/dumbeau/autohotpie/blob/master/src/functionSelect.js): `src/functionSelect.js`

### Scripts and assets

- [Icon manager](https://github.com/dumbeau/autohotpie/blob/master/src/iconManager.js): `src/iconManager.js`
- [Script editor](https://github.com/dumbeau/autohotpie/blob/master/src/editScript.js): `src/editScript.js`
- [Create script](https://github.com/dumbeau/autohotpie/blob/master/src/createNewScript.js): `src/createNewScript.js`
- [Color picker](https://github.com/dumbeau/autohotpie/blob/master/src/lib/jscolor.js): `src/lib/jscolor.js`

### Menu runtime

- [Run menu UI](https://github.com/dumbeau/autohotpie/blob/master/src/runningPieMenu.js): `src/runningPieMenu.js`
- [Pie menu engine](https://github.com/dumbeau/autohotpie/blob/master/src/PieMenu.ahk): `src/PieMenu.ahk`
- [Menu functions](https://github.com/dumbeau/autohotpie/blob/master/src/lib/PieFunctions.ahk): `src/lib/PieFunctions.ahk`

### Other components

- **User**
- **AutoHotkey**

## Connections

- User → Electron main: opens app
- Electron main → Renderer utilities: hosts UI
- Renderer utilities → Icon manager: refreshes icons (evidence: `src/lib/renderer.js`)
- Renderer utilities → Run menu UI: opens run UI (evidence: `src/lib/renderer.js`)
- Profile management → Settings model: edits settings
- Pie menu editor → Settings model: updates menu data (evidence: `src/editPieMenu.js`)
- Profile management → Run menu UI: opens before run (evidence: `src/profileManagement.js`)
- Profile management → Settings model: saves settings (evidence: `src/profileManagement.js`)
- Run menu UI → Preload bridge: starts menu run
- Preload bridge → Pie menu engine: targets script (evidence: `src/preload.js`)
- AutoHotkey → Pie menu engine: executes
- Pie menu editor → Icon manager: chooses icons
- Pie menu editor → Function selection: selects actions
- Pie menu editor → Color picker: sets colors
- Profile management → Create profile: creates profile
- Profile management → Create menu: creates menu
- Profile management → Hotkey management: configures keys
- Profile management → Activation modes: configures activation
- Script editor → Create script: edits scripts
