# recso/valcpy architecture

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

- Interactive diagram: https://gitdiagram.com/recso/valcpy
- Repository: https://github.com/recso/valcpy

## Overview

Valcore is a Windows desktop screen-color detection and click-automation tool, with GUI-managed host and client modes. The visible workflow is GUI startup and rendering; its controls start the host or initialize the client, which captures frames, detects red pixels, and sends a click request through the client socket. The host exposes a socket server and input injection capability. The GUI uses Dear ImGui with Win32 and Direct3D 11 backends. Source evidence for mode internals is partial, and the README is empty; unshown socket dispatch details are omitted.

Main entry points: [`src/gui.cpp`](https://github.com/recso/valcpy/blob/main/src/gui.cpp) (GUI Controller), [`src/main.cpp`](https://github.com/recso/valcpy/blob/main/src/main.cpp) (Application Entry), [`utils/imgui/imgui.cpp`](https://github.com/recso/valcpy/blob/main/utils/imgui/imgui.cpp) (ImGui Runtime), [`src/cap.cpp`](https://github.com/recso/valcpy/blob/main/src/cap.cpp) (Screen Capture)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_main["Application Entry<br/>[main.cpp]"]
  node_gui["GUI Controller<br/>[gui.cpp]"]
end

subgraph group_automation["Detection Client"]
  node_config["Client Settings<br/>[cfg.cpp]"]
  node_capture["Screen Capture<br/>[cap.cpp]"]
  node_detector["Red Detector<br/>[dtc.cpp]"]
end

subgraph group_network["Socket Modes"]
  node_client["Socket Client<br/>[socketcl.cpp]"]
  node_server["Socket Server<br/>[socketsrv.cpp]"]
  node_input["Mouse Input<br/>[input.cpp]"]
end

subgraph group_ui["GUI Framework"]
  node_imgui["ImGui Runtime<br/>[imgui.cpp]"]
  node_imgui_draw["ImGui Drawing<br/>[imgui_draw.cpp]"]
  node_imgui_tables["ImGui Tables<br/>[imgui_tables.cpp]"]
  node_imgui_win32["Win32 Backend"]
  node_imgui_dx11["Direct3D Backend"]
end

node_user(("Desktop User"))
node_os(("Windows Desktop"))
node_config_file["config.ini"]

node_user -->|"starts"| node_main
node_main -->|"runs"| node_gui
node_gui -->|"configures"| node_config
node_gui -->|"captures"| node_capture
node_gui -->|"detects"| node_detector
node_gui -->|"connects"| node_client
node_gui -->|"starts"| node_server
node_main -->|"loads/saves"| node_config
node_main -->|"captures"| node_capture
node_main -->|"detects"| node_detector
node_main -->|"sends clicks"| node_client
node_gui -->|"saves"| node_config_file
node_main -->|"loads/saves"| node_config_file
node_server -.-> node_input
node_gui -->|"initializes"| node_imgui_win32
node_gui -->|"initializes"| node_imgui_dx11
node_gui -->|"renders with"| node_imgui
node_imgui_draw -->|"uses API"| node_imgui
node_imgui_tables -->|"uses API"| node_imgui
node_imgui_win32 -->|"uses API"| node_imgui
node_imgui_dx11 -->|"uses API"| node_imgui
node_os -.->|"provides screen"| node_capture
node_os -.->|"receives input"| node_input

click node_main "https://github.com/recso/valcpy/blob/main/src/main.cpp"
click node_gui "https://github.com/recso/valcpy/blob/main/src/gui.cpp"
click node_config "https://github.com/recso/valcpy/blob/main/src/cfg.cpp"
click node_capture "https://github.com/recso/valcpy/blob/main/src/cap.cpp"
click node_detector "https://github.com/recso/valcpy/blob/main/src/dtc.cpp"
click node_client "https://github.com/recso/valcpy/blob/main/src/socketcl.cpp"
click node_server "https://github.com/recso/valcpy/blob/main/src/socketsrv.cpp"
click node_input "https://github.com/recso/valcpy/blob/main/utils/input/input.cpp"
click node_imgui "https://github.com/recso/valcpy/blob/main/utils/imgui/imgui.cpp"
click node_imgui_draw "https://github.com/recso/valcpy/blob/main/utils/imgui/imgui_draw.cpp"
click node_imgui_tables "https://github.com/recso/valcpy/blob/main/utils/imgui/imgui_tables.cpp"
click node_imgui_win32 "https://github.com/recso/valcpy/blob/main/utils/imgui/imgui_impl_win32.cpp"
click node_imgui_dx11 "https://github.com/recso/valcpy/blob/main/utils/imgui/imgui_impl_dx11.cpp"

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_gui,node_user toneBlue
class node_config,node_capture,node_detector toneAmber
class node_client,node_server,node_input toneMint
class node_imgui,node_imgui_draw,node_imgui_tables,node_imgui_win32,node_imgui_dx11 toneRose
class node_os,node_config_file toneIndigo
```

## Components

### Application

- [Application Entry](https://github.com/recso/valcpy/blob/main/src/main.cpp): `src/main.cpp`
- [GUI Controller](https://github.com/recso/valcpy/blob/main/src/gui.cpp): `src/gui.cpp`

### Detection Client

- [Client Settings](https://github.com/recso/valcpy/blob/main/src/cfg.cpp): `src/cfg.cpp`
- [Screen Capture](https://github.com/recso/valcpy/blob/main/src/cap.cpp): `src/cap.cpp`
- [Red Detector](https://github.com/recso/valcpy/blob/main/src/dtc.cpp): `src/dtc.cpp`

### Socket Modes

- [Socket Client](https://github.com/recso/valcpy/blob/main/src/socketcl.cpp): `src/socketcl.cpp`
- [Socket Server](https://github.com/recso/valcpy/blob/main/src/socketsrv.cpp): `src/socketsrv.cpp`
- [Mouse Input](https://github.com/recso/valcpy/blob/main/utils/input/input.cpp): `utils/input/input.cpp`

### GUI Framework

- [ImGui Runtime](https://github.com/recso/valcpy/blob/main/utils/imgui/imgui.cpp): `utils/imgui/imgui.cpp`
- [ImGui Drawing](https://github.com/recso/valcpy/blob/main/utils/imgui/imgui_draw.cpp): `utils/imgui/imgui_draw.cpp`
- [ImGui Tables](https://github.com/recso/valcpy/blob/main/utils/imgui/imgui_tables.cpp): `utils/imgui/imgui_tables.cpp`
- [Win32 Backend](https://github.com/recso/valcpy/blob/main/utils/imgui/imgui_impl_win32.cpp): `utils/imgui/imgui_impl_win32.cpp`
- [Direct3D Backend](https://github.com/recso/valcpy/blob/main/utils/imgui/imgui_impl_dx11.cpp): `utils/imgui/imgui_impl_dx11.cpp`

### Other components

- **Desktop User**
- **Windows Desktop**
- **config.ini**

## Connections

- Desktop User → Application Entry: starts (evidence: `src/main.cpp`)
- Application Entry → GUI Controller: runs (evidence: `src/main.cpp`)
- GUI Controller → Client Settings: configures (evidence: `src/gui.cpp`)
- GUI Controller → Screen Capture: captures (evidence: `src/gui.cpp`)
- GUI Controller → Red Detector: detects (evidence: `src/gui.cpp`)
- GUI Controller → Socket Client: connects (evidence: `src/gui.cpp`)
- GUI Controller → Socket Server: starts (evidence: `src/gui.cpp`)
- Application Entry → Client Settings: loads/saves (evidence: `src/main.cpp`)
- Application Entry → Screen Capture: captures (evidence: `src/main.cpp`)
- Application Entry → Red Detector: detects (evidence: `src/main.cpp`)
- Application Entry → Socket Client: sends clicks (evidence: `src/main.cpp`)
- GUI Controller → config.ini: saves (evidence: `src/gui.cpp`)
- Application Entry → config.ini: loads/saves (evidence: `src/main.cpp`)
- Socket Server → Mouse Input
- GUI Controller → Win32 Backend: initializes (evidence: `src/gui.cpp`)
- GUI Controller → Direct3D Backend: initializes (evidence: `src/gui.cpp`)
- GUI Controller → ImGui Runtime: renders with (evidence: `src/gui.cpp`)
- ImGui Drawing → ImGui Runtime: uses API (evidence: `utils/imgui/imgui_draw.cpp`)
- ImGui Tables → ImGui Runtime: uses API (evidence: `utils/imgui/imgui_tables.cpp`)
- Win32 Backend → ImGui Runtime: uses API (evidence: `utils/imgui/imgui_impl_win32.cpp`)
- Direct3D Backend → ImGui Runtime: uses API (evidence: `utils/imgui/imgui_impl_dx11.cpp`)
- Windows Desktop → Screen Capture: provides screen
- Windows Desktop → Mouse Input: receives input
