# seerge/g-helper architecture

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

- Interactive diagram: https://gitdiagram.com/seerge/g-helper
- Repository: https://github.com/seerge/g-helper

## Overview

G-Helper is a Windows control app for Asus laptops and handhelds. The main workflow runs through the settings UI and application coordinator, which applies user choices to performance, GPU, battery, and display controls; input events and power changes can also trigger those controls. Separate branches cover lighting, handheld controls, supported peripherals, updates, and the live metrics overlay. The README documents these capabilities; some implementation files were not sampled, so their internal links are omitted.

Main entry points: [`app/Settings.cs`](https://github.com/seerge/g-helper/blob/main/app/Settings.cs) (Settings UI), [`app/Program.cs`](https://github.com/seerge/g-helper/blob/main/app/Program.cs) (App coordinator), [`app/Mode/ModeControl.cs`](https://github.com/seerge/g-helper/blob/main/app/Mode/ModeControl.cs) (Performance modes), [`app/AsusACPI.cs`](https://github.com/seerge/g-helper/blob/main/app/AsusACPI.cs) (Asus ACPI control)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and settings"]
  node_settings["Settings UI<br/>[Settings.cs]"]
  node_program["App coordinator<br/>[Program.cs]"]
  node_config["Configuration<br/>[AppConfig.cs]"]
end

subgraph group_hardware["Hardware and modes"]
  node_mode["Performance modes<br/>[ModeControl.cs]"]
  node_mode_data["Mode definitions<br/>[Modes.cs]"]
  node_hardware_control["Hardware monitoring<br/>[HardwareControl.cs]"]
  node_acpi["Asus ACPI control<br/>[AsusACPI.cs]"]
  node_fans["Fan controls"]
  node_battery["Battery control<br/>[BatteryControl.cs]"]
  node_gpu_mode["GPU modes<br/>[GPUModeControl.cs]"]
end

subgraph group_display["Display and lighting"]
  node_display["Screen controls<br/>[ScreenControl.cs]"]
  node_visual["Visual modes<br/>[VisualControl.cs]"]
  node_aura["RGB lighting<br/>[Aura.cs]"]
  node_matrix["Anime Matrix"]
end

subgraph group_input["Input and handheld"]
  node_input["Hotkey handling<br/>[InputDispatcher.cs]"]
  node_ally["ROG Ally controls<br/>[AllyControl.cs]"]
end

subgraph group_extras["Peripherals and extras"]
  node_peripherals["Peripheral discovery"]
  node_keyboard["Asus keyboard<br/>[AsusKeyboard.cs]"]
  node_mouse["Asus mouse<br/>[AsusMouse.cs]"]
  node_updates["BIOS and driver updates"]
  node_auto_update["App updates"]
  node_overlay["Metrics overlay<br/>[HardwareOverlay.cs]"]
  node_fps["FPS monitor<br/>[EtwFpsMonitor.cs]"]
end

node_user(("Laptop user"))

node_user -->|"configures"| node_settings
node_program -->|"creates"| node_settings
node_program -->|"creates"| node_mode
node_program -->|"creates"| node_gpu_mode
node_program -->|"creates"| node_input
node_settings -->|"reads settings"| node_config
node_settings -->|"configures"| node_mode
node_settings -->|"configures"| node_gpu_mode
node_settings -->|"configures"| node_display
node_settings -->|"configures"| node_aura
node_settings -->|"configures"| node_matrix
node_settings -->|"opens"| node_updates
node_settings -->|"configures"| node_auto_update
node_settings -->|"configures"| node_ally
node_mode -->|"uses definitions"| node_mode_data
node_mode -->|"reads metrics"| node_hardware_control
node_mode -->|"sets mode"| node_acpi
node_program -->|"routes power changes"| node_gpu_mode
node_gpu_mode -->|"sets GPU mode"| node_acpi
node_gpu_mode -->|"adjusts display"| node_display
node_fans -->|"sets fan curves"| node_acpi
node_battery -->|"sets charge limit"| node_acpi
node_program -->|"sets startup limit"| node_acpi
node_input -->|"triggers modes"| node_mode
node_input -->|"adjusts brightness"| node_display
node_input -->|"controls lighting"| node_aura
node_program -->|"creates"| node_ally
node_ally -.->|"controls device"| node_acpi
node_display -->|"supports visual modes"| node_visual
node_matrix -->|"uses device metrics"| node_hardware_control
node_peripherals -->|"connects"| node_keyboard
node_peripherals -->|"connects"| node_mouse
node_program -->|"creates"| node_overlay
node_overlay -->|"reads frame events"| node_fps
node_overlay -->|"reads metrics"| node_hardware_control

click node_settings "https://github.com/seerge/g-helper/blob/main/app/Settings.cs"
click node_program "https://github.com/seerge/g-helper/blob/main/app/Program.cs"
click node_config "https://github.com/seerge/g-helper/blob/main/app/AppConfig.cs"
click node_mode "https://github.com/seerge/g-helper/blob/main/app/Mode/ModeControl.cs"
click node_mode_data "https://github.com/seerge/g-helper/blob/main/app/Mode/Modes.cs"
click node_hardware_control "https://github.com/seerge/g-helper/blob/main/app/HardwareControl.cs"
click node_acpi "https://github.com/seerge/g-helper/blob/main/app/AsusACPI.cs"
click node_fans "https://github.com/seerge/g-helper/blob/main/app/Fan/FanSensorControl.cs"
click node_battery "https://github.com/seerge/g-helper/blob/main/app/Battery/BatteryControl.cs"
click node_gpu_mode "https://github.com/seerge/g-helper/blob/main/app/Gpu/GPUModeControl.cs"
click node_display "https://github.com/seerge/g-helper/blob/main/app/Display/ScreenControl.cs"
click node_visual "https://github.com/seerge/g-helper/blob/main/app/Display/VisualControl.cs"
click node_aura "https://github.com/seerge/g-helper/blob/main/app/USB/Aura.cs"
click node_matrix "https://github.com/seerge/g-helper/blob/main/app/AnimeMatrix/AnimeMatrixDevice.cs"
click node_input "https://github.com/seerge/g-helper/blob/main/app/Input/InputDispatcher.cs"
click node_ally "https://github.com/seerge/g-helper/blob/main/app/Ally/AllyControl.cs"
click node_peripherals "https://github.com/seerge/g-helper/blob/main/app/Peripherals/PeripheralsProvider.cs"
click node_keyboard "https://github.com/seerge/g-helper/blob/main/app/Peripherals/Keyboard/AsusKeyboard.cs"
click node_mouse "https://github.com/seerge/g-helper/blob/main/app/Peripherals/Mouse/AsusMouse.cs"
click node_updates "https://github.com/seerge/g-helper/blob/main/app/UpdatesController.cs"
click node_auto_update "https://github.com/seerge/g-helper/blob/main/app/AutoUpdate/AutoUpdateControl.cs"
click node_overlay "https://github.com/seerge/g-helper/blob/main/app/Overlay/HardwareOverlay.cs"
click node_fps "https://github.com/seerge/g-helper/blob/main/app/Overlay/EtwFpsMonitor.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_settings,node_program,node_config,node_user toneBlue
class node_mode,node_mode_data,node_hardware_control,node_acpi,node_fans,node_battery,node_gpu_mode toneAmber
class node_display,node_visual,node_aura,node_matrix toneMint
class node_input,node_ally toneRose
class node_peripherals,node_keyboard,node_mouse,node_updates,node_auto_update,node_overlay,node_fps toneIndigo
```

## Components

### App and settings

- [Settings UI](https://github.com/seerge/g-helper/blob/main/app/Settings.cs): `app/Settings.cs`
- [App coordinator](https://github.com/seerge/g-helper/blob/main/app/Program.cs): `app/Program.cs`
- [Configuration](https://github.com/seerge/g-helper/blob/main/app/AppConfig.cs): `app/AppConfig.cs`

### Hardware and modes

- [Performance modes](https://github.com/seerge/g-helper/blob/main/app/Mode/ModeControl.cs): `app/Mode/ModeControl.cs`
- [Mode definitions](https://github.com/seerge/g-helper/blob/main/app/Mode/Modes.cs): `app/Mode/Modes.cs`
- [Hardware monitoring](https://github.com/seerge/g-helper/blob/main/app/HardwareControl.cs): `app/HardwareControl.cs`
- [Asus ACPI control](https://github.com/seerge/g-helper/blob/main/app/AsusACPI.cs): `app/AsusACPI.cs`
- [Fan controls](https://github.com/seerge/g-helper/blob/main/app/Fan/FanSensorControl.cs): `app/Fan/FanSensorControl.cs`
- [Battery control](https://github.com/seerge/g-helper/blob/main/app/Battery/BatteryControl.cs): `app/Battery/BatteryControl.cs`
- [GPU modes](https://github.com/seerge/g-helper/blob/main/app/Gpu/GPUModeControl.cs): `app/Gpu/GPUModeControl.cs`

### Display and lighting

- [Screen controls](https://github.com/seerge/g-helper/blob/main/app/Display/ScreenControl.cs): `app/Display/ScreenControl.cs`
- [Visual modes](https://github.com/seerge/g-helper/blob/main/app/Display/VisualControl.cs): `app/Display/VisualControl.cs`
- [RGB lighting](https://github.com/seerge/g-helper/blob/main/app/USB/Aura.cs): `app/USB/Aura.cs`
- [Anime Matrix](https://github.com/seerge/g-helper/blob/main/app/AnimeMatrix/AnimeMatrixDevice.cs): `app/AnimeMatrix/AnimeMatrixDevice.cs`

### Input and handheld

- [Hotkey handling](https://github.com/seerge/g-helper/blob/main/app/Input/InputDispatcher.cs): `app/Input/InputDispatcher.cs`
- [ROG Ally controls](https://github.com/seerge/g-helper/blob/main/app/Ally/AllyControl.cs): `app/Ally/AllyControl.cs`

### Peripherals and extras

- [Peripheral discovery](https://github.com/seerge/g-helper/blob/main/app/Peripherals/PeripheralsProvider.cs): `app/Peripherals/PeripheralsProvider.cs`
- [Asus keyboard](https://github.com/seerge/g-helper/blob/main/app/Peripherals/Keyboard/AsusKeyboard.cs): `app/Peripherals/Keyboard/AsusKeyboard.cs`
- [Asus mouse](https://github.com/seerge/g-helper/blob/main/app/Peripherals/Mouse/AsusMouse.cs): `app/Peripherals/Mouse/AsusMouse.cs`
- [BIOS and driver updates](https://github.com/seerge/g-helper/blob/main/app/UpdatesController.cs): `app/UpdatesController.cs`
- [App updates](https://github.com/seerge/g-helper/blob/main/app/AutoUpdate/AutoUpdateControl.cs): `app/AutoUpdate/AutoUpdateControl.cs`
- [Metrics overlay](https://github.com/seerge/g-helper/blob/main/app/Overlay/HardwareOverlay.cs): `app/Overlay/HardwareOverlay.cs`
- [FPS monitor](https://github.com/seerge/g-helper/blob/main/app/Overlay/EtwFpsMonitor.cs): `app/Overlay/EtwFpsMonitor.cs`

### Other components

- **Laptop user**

## Connections

- Laptop user → Settings UI: configures
- App coordinator → Settings UI: creates (evidence: `app/Program.cs`)
- App coordinator → Performance modes: creates (evidence: `app/Program.cs`)
- App coordinator → GPU modes: creates (evidence: `app/Program.cs`)
- App coordinator → Hotkey handling: creates (evidence: `app/Program.cs`)
- Settings UI → Configuration: reads settings (evidence: `app/Settings.cs`)
- Settings UI → Performance modes: configures (evidence: `app/Settings.cs`)
- Settings UI → GPU modes: configures (evidence: `app/Settings.cs`)
- Settings UI → Screen controls: configures (evidence: `app/Settings.cs`)
- Settings UI → RGB lighting: configures (evidence: `app/Settings.cs`)
- Settings UI → Anime Matrix: configures (evidence: `app/Settings.cs`)
- Settings UI → BIOS and driver updates: opens (evidence: `app/Settings.cs`)
- Settings UI → App updates: configures (evidence: `app/Settings.cs`)
- Settings UI → ROG Ally controls: configures (evidence: `app/Settings.cs`)
- Performance modes → Mode definitions: uses definitions (evidence: `app/Mode/ModeControl.cs`)
- Performance modes → Hardware monitoring: reads metrics (evidence: `app/Mode/ModeControl.cs`)
- Performance modes → Asus ACPI control: sets mode (evidence: `app/Mode/ModeControl.cs`)
- App coordinator → GPU modes: routes power changes (evidence: `app/Program.cs`)
- GPU modes → Asus ACPI control: sets GPU mode (evidence: `app/Gpu/GPUModeControl.cs`)
- GPU modes → Screen controls: adjusts display (evidence: `app/Gpu/GPUModeControl.cs`)
- Fan controls → Asus ACPI control: sets fan curves (evidence: `app/Fan/FanSensorControl.cs`)
- Battery control → Asus ACPI control: sets charge limit (evidence: `app/Battery/BatteryControl.cs`)
- App coordinator → Asus ACPI control: sets startup limit (evidence: `app/Program.cs`)
- Hotkey handling → Performance modes: triggers modes (evidence: `app/Input/InputDispatcher.cs`)
- Hotkey handling → Screen controls: adjusts brightness (evidence: `app/Input/InputDispatcher.cs`)
- Hotkey handling → RGB lighting: controls lighting (evidence: `app/Input/InputDispatcher.cs`)
- App coordinator → ROG Ally controls: creates (evidence: `app/Program.cs`)
- ROG Ally controls → Asus ACPI control: controls device (evidence: `app/Ally/AllyControl.cs`)
- Screen controls → Visual modes: supports visual modes (evidence: `app/Display/ScreenControl.cs`)
- Anime Matrix → Hardware monitoring: uses device metrics (evidence: `app/AnimeMatrix/AnimeMatrixDevice.cs`)
- Peripheral discovery → Asus keyboard: connects (evidence: `app/Peripherals/PeripheralsProvider.cs`)
- Peripheral discovery → Asus mouse: connects (evidence: `app/Peripherals/PeripheralsProvider.cs`)
- App coordinator → Metrics overlay: creates (evidence: `app/Program.cs`)
- Metrics overlay → FPS monitor: reads frame events (evidence: `app/Overlay/HardwareOverlay.cs`)
- Metrics overlay → Hardware monitoring: reads metrics (evidence: `app/Overlay/HardwareOverlay.cs`)
