# wbrombil/autoclicker architecture

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

- Interactive diagram: https://gitdiagram.com/wbrombil/autoclicker
- Repository: https://github.com/wbrombil/autoclicker

## Overview

AutoClicker Pro is a Swing desktop app for configuring and running mouse-click sessions or in-memory macros. The user workflow runs from UI input through presenter orchestration to either the click engine or macro engine, which drives the system mouse; events and metrics update the UI. Profiles persist click settings, and a global hotkey can toggle execution. README documents position capture, profiles, macro editing, countdown, and session metrics. The graph reflects sampled calls and README capabilities; unsampled profile and capture details are represented at their enclosing source paths.

Main entry points: [`src/main/java/com/autoclicker/macro/MacroEngine.java`](https://github.com/wbrombil/autoclicker/blob/main/src/main/java/com/autoclicker/macro/MacroEngine.java) (Macro engine), [`src/main/java/com/autoclicker/engine/AutoClickerEngine.java`](https://github.com/wbrombil/autoclicker/blob/main/src/main/java/com/autoclicker/engine/AutoClickerEngine.java) (Click session engine), [`src/main/java/com/autoclicker/presenter/AutoClickerPresenter.java`](https://github.com/wbrombil/autoclicker/blob/main/src/main/java/com/autoclicker/presenter/AutoClickerPresenter.java) (Session presenter), [`src/main/java/com/autoclicker/ui/AutoClickerUI.java`](https://github.com/wbrombil/autoclicker/blob/main/src/main/java/com/autoclicker/ui/AutoClickerUI.java) (Swing interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Desktop interaction"]
  node_ui["Swing interface<br/>[AutoClickerUI.java]"]
  node_hotkey["Global hotkey"]
end

subgraph group_coordination["Session coordination"]
  node_presenter["Session presenter"]
  node_events["Execution events"]
  node_metrics["Session metrics"]
end

subgraph group_execution["Execution engines"]
  node_clickengine["Click session engine"]
  node_macroengine["Macro engine<br/>[MacroEngine.java]"]
  node_sequence["Macro sequence<br/>[MacroSequence.java]"]
  node_action["Macro actions<br/>[ClickAction.java]"]
  node_mouseapi["Mouse controller"]
  node_robot["System mouse"]
  node_clock["Monotonic clock"]
  node_sleeper["Session timing<br/>[Sleeper.java]"]
end

subgraph group_configuration["Settings and profiles"]
  node_config["Click settings"]
  node_profiles[("Profile storage")]
end

node_user(("Desktop user"))

node_user -->|"configures and starts"| node_ui
node_ui -->|"forwards controls"| node_presenter
node_ui -->|"edits settings"| node_config
node_ui -->|"loads and saves"| node_profiles
node_ui -->|"edits macro"| node_sequence
node_hotkey -->|"toggles sessions"| node_presenter
node_presenter -->|"starts or stops"| node_clickengine
node_presenter -->|"starts or stops"| node_macroengine
node_presenter -->|"supplies macro"| node_sequence
node_clickengine -->|"snapshots settings"| node_config
node_macroengine -->|"snapshots settings"| node_config
node_macroengine -->|"snapshots actions"| node_sequence
node_sequence -->|"stores ordered actions"| node_action
node_clickengine -->|"issues mouse actions"| node_mouseapi
node_macroengine -->|"issues macro actions"| node_mouseapi
node_robot -->|"implements controls"| node_mouseapi
node_clickengine -->|"defaults to"| node_robot
node_macroengine -->|"defaults to"| node_robot
node_clickengine -->|"emits lifecycle events"| node_events
node_macroengine -->|"emits steps and events"| node_events
node_presenter -->|"handles events"| node_events
node_clickengine -->|"computes metrics"| node_metrics
node_macroengine -->|"computes metrics"| node_metrics
node_presenter -->|"publishes status"| node_metrics
node_clickengine -->|"measures elapsed time"| node_clock
node_macroengine -->|"measures elapsed time"| node_clock
node_clickengine -->|"waits between clicks"| node_sleeper
node_macroengine -->|"waits during macro"| node_sleeper

click node_ui "https://github.com/wbrombil/autoclicker/blob/main/src/main/java/com/autoclicker/ui/AutoClickerUI.java"
click node_presenter "https://github.com/wbrombil/autoclicker/blob/main/src/main/java/com/autoclicker/presenter/AutoClickerPresenter.java"
click node_hotkey "https://github.com/wbrombil/autoclicker/blob/main/src/main/java/com/autoclicker/listener/HotkeyListener.java"
click node_config "https://github.com/wbrombil/autoclicker/blob/main/src/main/java/com/autoclicker/config/AutoClickerConfig.java"
click node_profiles "https://github.com/wbrombil/autoclicker/blob/main/src/main/java/com/autoclicker/config/ConfigRepository.java"
click node_clickengine "https://github.com/wbrombil/autoclicker/blob/main/src/main/java/com/autoclicker/engine/AutoClickerEngine.java"
click node_macroengine "https://github.com/wbrombil/autoclicker/blob/main/src/main/java/com/autoclicker/macro/MacroEngine.java"
click node_sequence "https://github.com/wbrombil/autoclicker/blob/main/src/main/java/com/autoclicker/macro/MacroSequence.java"
click node_action "https://github.com/wbrombil/autoclicker/blob/main/src/main/java/com/autoclicker/macro/ClickAction.java"
click node_mouseapi "https://github.com/wbrombil/autoclicker/blob/main/src/main/java/com/autoclicker/engine/MouseController.java"
click node_robot "https://github.com/wbrombil/autoclicker/blob/main/src/main/java/com/autoclicker/engine/RobotMouseController.java"
click node_events "https://github.com/wbrombil/autoclicker/blob/main/src/main/java/com/autoclicker/engine/ExecutionEvent.java"
click node_metrics "https://github.com/wbrombil/autoclicker/blob/main/src/main/java/com/autoclicker/engine/SessionMetrics.java"
click node_clock "https://github.com/wbrombil/autoclicker/blob/main/src/main/java/com/autoclicker/engine/MonotonicClock.java"
click node_sleeper "https://github.com/wbrombil/autoclicker/blob/main/src/main/java/com/autoclicker/engine/Sleeper.java"

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_ui,node_hotkey,node_user toneBlue
class node_presenter,node_events,node_metrics toneAmber
class node_clickengine,node_macroengine,node_sequence,node_action,node_mouseapi,node_robot,node_clock,node_sleeper toneMint
class node_config,node_profiles toneRose
```

## Components

### Desktop interaction

- [Swing interface](https://github.com/wbrombil/autoclicker/blob/main/src/main/java/com/autoclicker/ui/AutoClickerUI.java): `src/main/java/com/autoclicker/ui/AutoClickerUI.java`
- [Global hotkey](https://github.com/wbrombil/autoclicker/blob/main/src/main/java/com/autoclicker/listener/HotkeyListener.java): `src/main/java/com/autoclicker/listener/HotkeyListener.java`

### Session coordination

- [Session presenter](https://github.com/wbrombil/autoclicker/blob/main/src/main/java/com/autoclicker/presenter/AutoClickerPresenter.java): `src/main/java/com/autoclicker/presenter/AutoClickerPresenter.java`
- [Execution events](https://github.com/wbrombil/autoclicker/blob/main/src/main/java/com/autoclicker/engine/ExecutionEvent.java): `src/main/java/com/autoclicker/engine/ExecutionEvent.java`
- [Session metrics](https://github.com/wbrombil/autoclicker/blob/main/src/main/java/com/autoclicker/engine/SessionMetrics.java): `src/main/java/com/autoclicker/engine/SessionMetrics.java`

### Execution engines

- [Click session engine](https://github.com/wbrombil/autoclicker/blob/main/src/main/java/com/autoclicker/engine/AutoClickerEngine.java): `src/main/java/com/autoclicker/engine/AutoClickerEngine.java`
- [Macro engine](https://github.com/wbrombil/autoclicker/blob/main/src/main/java/com/autoclicker/macro/MacroEngine.java): `src/main/java/com/autoclicker/macro/MacroEngine.java`
- [Macro sequence](https://github.com/wbrombil/autoclicker/blob/main/src/main/java/com/autoclicker/macro/MacroSequence.java): `src/main/java/com/autoclicker/macro/MacroSequence.java`
- [Macro actions](https://github.com/wbrombil/autoclicker/blob/main/src/main/java/com/autoclicker/macro/ClickAction.java): `src/main/java/com/autoclicker/macro/ClickAction.java`
- [Mouse controller](https://github.com/wbrombil/autoclicker/blob/main/src/main/java/com/autoclicker/engine/MouseController.java): `src/main/java/com/autoclicker/engine/MouseController.java`
- [System mouse](https://github.com/wbrombil/autoclicker/blob/main/src/main/java/com/autoclicker/engine/RobotMouseController.java): `src/main/java/com/autoclicker/engine/RobotMouseController.java`
- [Monotonic clock](https://github.com/wbrombil/autoclicker/blob/main/src/main/java/com/autoclicker/engine/MonotonicClock.java): `src/main/java/com/autoclicker/engine/MonotonicClock.java`
- [Session timing](https://github.com/wbrombil/autoclicker/blob/main/src/main/java/com/autoclicker/engine/Sleeper.java): `src/main/java/com/autoclicker/engine/Sleeper.java`

### Settings and profiles

- [Click settings](https://github.com/wbrombil/autoclicker/blob/main/src/main/java/com/autoclicker/config/AutoClickerConfig.java): `src/main/java/com/autoclicker/config/AutoClickerConfig.java`
- [Profile storage](https://github.com/wbrombil/autoclicker/blob/main/src/main/java/com/autoclicker/config/ConfigRepository.java): `src/main/java/com/autoclicker/config/ConfigRepository.java`

### Other components

- **Desktop user**

## Connections

- Desktop user → Swing interface: configures and starts (evidence: `README.md`)
- Swing interface → Session presenter: forwards controls (evidence: `src/main/java/com/autoclicker/ui/AutoClickerUI.java`)
- Swing interface → Click settings: edits settings (evidence: `src/main/java/com/autoclicker/ui/AutoClickerUI.java`)
- Swing interface → Profile storage: loads and saves (evidence: `src/main/java/com/autoclicker/ui/AutoClickerUI.java`)
- Swing interface → Macro sequence: edits macro (evidence: `src/main/java/com/autoclicker/ui/AutoClickerUI.java`)
- Global hotkey → Session presenter: toggles sessions (evidence: `src/main/java/com/autoclicker/listener/HotkeyListener.java`)
- Session presenter → Click session engine: starts or stops (evidence: `src/main/java/com/autoclicker/presenter/AutoClickerPresenter.java`)
- Session presenter → Macro engine: starts or stops (evidence: `src/main/java/com/autoclicker/presenter/AutoClickerPresenter.java`)
- Session presenter → Macro sequence: supplies macro (evidence: `src/main/java/com/autoclicker/presenter/AutoClickerPresenter.java`)
- Click session engine → Click settings: snapshots settings (evidence: `src/main/java/com/autoclicker/engine/AutoClickerEngine.java`)
- Macro engine → Click settings: snapshots settings (evidence: `src/main/java/com/autoclicker/macro/MacroEngine.java`)
- Macro engine → Macro sequence: snapshots actions (evidence: `src/main/java/com/autoclicker/macro/MacroEngine.java`)
- Macro sequence → Macro actions: stores ordered actions (evidence: `src/main/java/com/autoclicker/macro/MacroSequence.java`)
- Click session engine → Mouse controller: issues mouse actions (evidence: `src/main/java/com/autoclicker/engine/AutoClickerEngine.java`)
- Macro engine → Mouse controller: issues macro actions (evidence: `src/main/java/com/autoclicker/macro/MacroEngine.java`)
- System mouse → Mouse controller: implements controls (evidence: `src/main/java/com/autoclicker/engine/RobotMouseController.java`)
- Click session engine → System mouse: defaults to (evidence: `src/main/java/com/autoclicker/engine/AutoClickerEngine.java`)
- Macro engine → System mouse: defaults to (evidence: `src/main/java/com/autoclicker/macro/MacroEngine.java`)
- Click session engine → Execution events: emits lifecycle events (evidence: `src/main/java/com/autoclicker/engine/AutoClickerEngine.java`)
- Macro engine → Execution events: emits steps and events (evidence: `src/main/java/com/autoclicker/macro/MacroEngine.java`)
- Session presenter → Execution events: handles events (evidence: `src/main/java/com/autoclicker/presenter/AutoClickerPresenter.java`)
- Click session engine → Session metrics: computes metrics (evidence: `src/main/java/com/autoclicker/engine/AutoClickerEngine.java`)
- Macro engine → Session metrics: computes metrics (evidence: `src/main/java/com/autoclicker/macro/MacroEngine.java`)
- Session presenter → Session metrics: publishes status (evidence: `src/main/java/com/autoclicker/presenter/AutoClickerPresenter.java`)
- Click session engine → Monotonic clock: measures elapsed time (evidence: `src/main/java/com/autoclicker/engine/AutoClickerEngine.java`)
- Macro engine → Monotonic clock: measures elapsed time (evidence: `src/main/java/com/autoclicker/macro/MacroEngine.java`)
- Click session engine → Session timing: waits between clicks (evidence: `src/main/java/com/autoclicker/engine/AutoClickerEngine.java`)
- Macro engine → Session timing: waits during macro (evidence: `src/main/java/com/autoclicker/macro/MacroEngine.java`)
