# vhanla/winxcorners architecture

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

- Interactive diagram: https://gitdiagram.com/vhanla/winxcorners
- Repository: https://github.com/vhanla/winxcorners

## Overview

WinXcorners is a Windows utility that assigns actions to monitor corners. The documented workflow is to open its tray popup, configure corner actions, then hover a corner to trigger the selected action. Advanced settings add delay and countdown controls; supported actions include Windows commands, custom executables, and custom hotkey sequences. The README also documents startup preferences, temporary disabling, drag/full-screen suppression, and theme awareness. No source excerpts were provided, so relationships below reflect README statements only; implementation ownership and internal calls remain unverified.

Main entry points: [`Main.pas`](https://github.com/vhanla/winxcorners/blob/master/Main.pas) (Action selection), [`frmSettings.pas`](https://github.com/vhanla/winxcorners/blob/master/frmSettings.pas) (Corner settings), [`frmAdvanced.pas`](https://github.com/vhanla/winxcorners/blob/master/frmAdvanced.pas) (Advanced options), [`hotkeyhelper.pas`](https://github.com/vhanla/winxcorners/blob/master/hotkeyhelper.pas) (Custom hotkeys)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Corner monitoring"]
  node_tray["Tray popup<br/>[Main.pas]"]
  node_monitor["Corner hover<br/>[Main.pas]"]
  node_suppression["Trigger safeguards<br/>[Main.pas]"]
end

subgraph group_configuration["Settings and controls"]
  node_settings["Corner settings<br/>[frmSettings.pas]"]
  node_advanced["Advanced options<br/>[frmAdvanced.pas]"]
  node_countdown["Countdown display<br/>[osdgui.pas]"]
  node_startup["Startup preference<br/>[Main.pas]"]
end

subgraph group_actions["Corner actions"]
  node_dispatch["Action selection<br/>[Main.pas]"]
  node_windows_actions["Windows actions<br/>[Main.pas]"]
  node_custom_program["Custom executable<br/>[Main.pas]"]
  node_custom_hotkey["Custom hotkeys<br/>[hotkeyhelper.pas]"]
end

node_user(("User"))
node_windows{{"Windows desktop"}}

node_user -->|"opens"| node_tray
node_user -->|"configures"| node_settings
node_user -->|"hovers over"| node_monitor
node_tray -->|"opens"| node_advanced
node_advanced -->|"enables"| node_countdown
node_settings -->|"assigns actions"| node_dispatch
node_monitor -->|"respects"| node_suppression
node_monitor -->|"triggers assigned action"| node_dispatch
node_dispatch -->|"selects"| node_windows_actions
node_dispatch -->|"selects"| node_custom_program
node_dispatch -->|"selects"| node_custom_hotkey
node_windows_actions -->|"invokes"| node_windows
node_custom_program -->|"runs on"| node_windows
node_custom_hotkey -->|"sends keys to"| node_windows
node_settings -->|"sets preference"| node_startup

click node_tray "https://github.com/vhanla/winxcorners/blob/master/Main.pas"
click node_monitor "https://github.com/vhanla/winxcorners/blob/master/Main.pas"
click node_suppression "https://github.com/vhanla/winxcorners/blob/master/Main.pas"
click node_settings "https://github.com/vhanla/winxcorners/blob/master/frmSettings.pas"
click node_advanced "https://github.com/vhanla/winxcorners/blob/master/frmAdvanced.pas"
click node_countdown "https://github.com/vhanla/winxcorners/blob/master/osdgui.pas"
click node_startup "https://github.com/vhanla/winxcorners/blob/master/Main.pas"
click node_dispatch "https://github.com/vhanla/winxcorners/blob/master/Main.pas"
click node_windows_actions "https://github.com/vhanla/winxcorners/blob/master/Main.pas"
click node_custom_program "https://github.com/vhanla/winxcorners/blob/master/Main.pas"
click node_custom_hotkey "https://github.com/vhanla/winxcorners/blob/master/hotkeyhelper.pas"

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_tray,node_monitor,node_suppression,node_user toneBlue
class node_settings,node_advanced,node_countdown,node_startup toneAmber
class node_dispatch,node_windows_actions,node_custom_program,node_custom_hotkey toneMint
class node_windows toneIndigo
```

## Components

### Corner monitoring

- [Tray popup](https://github.com/vhanla/winxcorners/blob/master/Main.pas): `Main.pas`
- [Corner hover](https://github.com/vhanla/winxcorners/blob/master/Main.pas): `Main.pas`
- [Trigger safeguards](https://github.com/vhanla/winxcorners/blob/master/Main.pas): `Main.pas`

### Settings and controls

- [Corner settings](https://github.com/vhanla/winxcorners/blob/master/frmSettings.pas): `frmSettings.pas`
- [Advanced options](https://github.com/vhanla/winxcorners/blob/master/frmAdvanced.pas): `frmAdvanced.pas`
- [Countdown display](https://github.com/vhanla/winxcorners/blob/master/osdgui.pas): `osdgui.pas`
- [Startup preference](https://github.com/vhanla/winxcorners/blob/master/Main.pas): `Main.pas`

### Corner actions

- [Action selection](https://github.com/vhanla/winxcorners/blob/master/Main.pas): `Main.pas`
- [Windows actions](https://github.com/vhanla/winxcorners/blob/master/Main.pas): `Main.pas`
- [Custom executable](https://github.com/vhanla/winxcorners/blob/master/Main.pas): `Main.pas`
- [Custom hotkeys](https://github.com/vhanla/winxcorners/blob/master/hotkeyhelper.pas): `hotkeyhelper.pas`

### Other components

- **User**
- **Windows desktop**

## Connections

- User → Tray popup: opens (evidence: `README.md`)
- User → Corner settings: configures (evidence: `README.md`)
- User → Corner hover: hovers over (evidence: `README.md`)
- Tray popup → Advanced options: opens (evidence: `README.md`)
- Advanced options → Countdown display: enables (evidence: `README.md`)
- Corner settings → Action selection: assigns actions (evidence: `README.md`)
- Corner hover → Trigger safeguards: respects (evidence: `README.md`)
- Corner hover → Action selection: triggers assigned action (evidence: `README.md`)
- Action selection → Windows actions: selects (evidence: `README.md`)
- Action selection → Custom executable: selects (evidence: `README.md`)
- Action selection → Custom hotkeys: selects (evidence: `README.md`)
- Windows actions → Windows desktop: invokes (evidence: `README.md`)
- Custom executable → Windows desktop: runs on (evidence: `README.md`)
- Custom hotkeys → Windows desktop: sends keys to (evidence: `README.md`)
- Corner settings → Startup preference: sets preference (evidence: `README.md`)
