# ishuamouren/macroengine architecture

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

- Interactive diagram: https://gitdiagram.com/ishuamouren/macroengine
- Repository: https://github.com/ishuamouren/macroengine

## Overview

MacroEngine is a Windows desktop macro authoring and playback tool. Users create or edit macros in a GUI, save them as INI files, then invoke enabled macros with configured hotkeys; playback interprets command steps and performs desktop actions. The graph separates authoring, stored definitions, hotkey-driven playback, and the shared Windows-operation layer. The sampled code shows editor dialogs and parts of command dispatch; some playback-to-helper calls are only partially visible, so that link is marked unverified. README coverage is limited, with command details also described in the repository wiki.

Main entry points: [`MacroEngine/MacroEditor_Window.cs`](https://github.com/ishuamouren/macroengine/blob/master/MacroEngine/MacroEditor_Window.cs) (Macro editor), [`MacroEngine/Main_Window.cs`](https://github.com/ishuamouren/macroengine/blob/master/MacroEngine/Main_Window.cs) (Macro library UI), [`MacroEngine/Functions.cs`](https://github.com/ishuamouren/macroengine/blob/master/MacroEngine/Functions.cs) (Windows operation helpers), [`MacroEngine/Program.cs`](https://github.com/ishuamouren/macroengine/blob/master/MacroEngine/Program.cs) (Application startup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Macro authoring"]
  node_main["Macro library UI<br/>[Main_Window.cs]"]
  node_editor["Macro editor"]
  node_command_picker["Command picker"]
  node_subcommand_picker["Subcommand picker"]
  node_position_picker["Position picker<br/>[Pos_Window.cs]"]
  node_definitions["INI macro files"]
end

subgraph group_runtime["Playback runtime"]
  node_app["Application startup<br/>[Program.cs]"]
  node_runner["Hotkey playback<br/>[Main_Window.cs]"]
end

subgraph group_operations["Desktop operations"]
  node_helpers["Windows operation helpers<br/>[Functions.cs]"]
end

subgraph group_support["Help and input"]
  node_hotkey["Hotkey control<br/>[HotkeyBox.cs]"]
  node_help["Help window<br/>[Help_Window.cs]"]
end

node_user(("Macro user"))
node_desktop(("Windows desktop"))

node_app -->|"opens"| node_main
node_user -.->|"manages macros"| node_main
node_main -->|"opens editor"| node_editor
node_editor -->|"opens chooser"| node_command_picker
node_editor -->|"opens chooser"| node_subcommand_picker
node_editor -->|"opens picker"| node_position_picker
node_editor -->|"writes INI"| node_definitions
node_main -->|"reads INI"| node_definitions
node_main -->|"dispatches playback"| node_runner
node_runner -->|"reads steps"| node_definitions
node_runner -.->|"invokes actions"| node_helpers
node_helpers -->|"sends input"| node_desktop
node_editor -.->|"uses hotkey input"| node_hotkey
node_user -.->|"requests help"| node_help

click node_app "https://github.com/ishuamouren/macroengine/blob/master/MacroEngine/Program.cs"
click node_main "https://github.com/ishuamouren/macroengine/blob/master/MacroEngine/Main_Window.cs"
click node_editor "https://github.com/ishuamouren/macroengine/blob/master/MacroEngine/MacroEditor_Window.cs"
click node_command_picker "https://github.com/ishuamouren/macroengine/blob/master/MacroEngine/AddCommand_Window.cs"
click node_subcommand_picker "https://github.com/ishuamouren/macroengine/blob/master/MacroEngine/AddSubCommand_Window.cs"
click node_position_picker "https://github.com/ishuamouren/macroengine/blob/master/MacroEngine/Pos_Window.cs"
click node_runner "https://github.com/ishuamouren/macroengine/blob/master/MacroEngine/Main_Window.cs"
click node_hotkey "https://github.com/ishuamouren/macroengine/blob/master/MacroEngine/Controls/HotkeyBox.cs"
click node_helpers "https://github.com/ishuamouren/macroengine/blob/master/MacroEngine/Functions.cs"
click node_help "https://github.com/ishuamouren/macroengine/blob/master/MacroEngine/Help_Window.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_main,node_editor,node_command_picker,node_subcommand_picker,node_position_picker,node_definitions,node_user toneBlue
class node_app,node_runner toneAmber
class node_helpers toneMint
class node_hotkey,node_help toneRose
class node_desktop toneIndigo
```

## Components

### Macro authoring

- [Macro library UI](https://github.com/ishuamouren/macroengine/blob/master/MacroEngine/Main_Window.cs): `MacroEngine/Main_Window.cs`
- [Macro editor](https://github.com/ishuamouren/macroengine/blob/master/MacroEngine/MacroEditor_Window.cs): `MacroEngine/MacroEditor_Window.cs`
- [Command picker](https://github.com/ishuamouren/macroengine/blob/master/MacroEngine/AddCommand_Window.cs): `MacroEngine/AddCommand_Window.cs`
- [Subcommand picker](https://github.com/ishuamouren/macroengine/blob/master/MacroEngine/AddSubCommand_Window.cs): `MacroEngine/AddSubCommand_Window.cs`
- [Position picker](https://github.com/ishuamouren/macroengine/blob/master/MacroEngine/Pos_Window.cs): `MacroEngine/Pos_Window.cs`
- **INI macro files**

### Playback runtime

- [Application startup](https://github.com/ishuamouren/macroengine/blob/master/MacroEngine/Program.cs): `MacroEngine/Program.cs`
- [Hotkey playback](https://github.com/ishuamouren/macroengine/blob/master/MacroEngine/Main_Window.cs): `MacroEngine/Main_Window.cs`

### Desktop operations

- [Windows operation helpers](https://github.com/ishuamouren/macroengine/blob/master/MacroEngine/Functions.cs): `MacroEngine/Functions.cs`

### Help and input

- [Hotkey control](https://github.com/ishuamouren/macroengine/blob/master/MacroEngine/Controls/HotkeyBox.cs): `MacroEngine/Controls/HotkeyBox.cs`
- [Help window](https://github.com/ishuamouren/macroengine/blob/master/MacroEngine/Help_Window.cs): `MacroEngine/Help_Window.cs`

### Other components

- **Macro user**
- **Windows desktop**

## Connections

- Application startup → Macro library UI: opens (evidence: `MacroEngine/Program.cs`)
- Macro user → Macro library UI: manages macros (evidence: `README.md`)
- Macro library UI → Macro editor: opens editor (evidence: `MacroEngine/Main_Window.cs`)
- Macro editor → Command picker: opens chooser (evidence: `MacroEngine/MacroEditor_Window.cs`)
- Macro editor → Subcommand picker: opens chooser (evidence: `MacroEngine/MacroEditor_Window.cs`)
- Macro editor → Position picker: opens picker (evidence: `MacroEngine/MacroEditor_Window.cs`)
- Macro editor → INI macro files: writes INI (evidence: `MacroEngine/MacroEditor_Window.cs`)
- Macro library UI → INI macro files: reads INI (evidence: `MacroEngine/Main_Window.cs`)
- Macro library UI → Hotkey playback: dispatches playback (evidence: `MacroEngine/Main_Window.cs`)
- Hotkey playback → INI macro files: reads steps (evidence: `MacroEngine/Main_Window.cs`)
- Hotkey playback → Windows operation helpers: invokes actions
- Windows operation helpers → Windows desktop: sends input (evidence: `MacroEngine/Functions.cs`)
- Macro editor → Hotkey control: uses hotkey input
- Macro user → Help window: requests help (evidence: `README.md`)
