# boopathivellaichamy0-png/blue-plus-tech architecture

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

- Interactive diagram: https://gitdiagram.com/boopathivellaichamy0-png/blue-plus-tech
- Repository: https://github.com/boopathivellaichamy0-png/blue-plus-tech

## Overview

Blue Pluse Tech is a desktop vision auto-clicker. The main workflow starts in the app UI, selects a screen region, scans it for eligible blue buttons, and clicks detections; the UI also exposes pause/stop controls and live status. A separate command-line entry point provides an autonomous clicking mode. The excerpts show the selector, capture/detection logic, OCR checks, and UI callbacks, but omit some implementation details, so several documented connections cite the README.

Main entry points: [`app.py`](https://github.com/boopathivellaichamy0-png/blue-plus-tech/blob/main/app.py) (Click Loop), [`auto_submit.py`](https://github.com/boopathivellaichamy0-png/blue-plus-tech/blob/main/auto_submit.py) (Autonomous CLI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Desktop Interface"]
  node_app_ui["App UI<br/>[app.py]"]
  node_region_selector["Region Selector<br/>[app.py]"]
  node_controls["Session Controls<br/>[app.py]"]
  node_telemetry["Status and Metrics<br/>[app.py]"]
  node_hotkeys["Global Hotkeys<br/>[app.py]"]
end

subgraph group_vision["Detection and Clicking"]
  node_capture["Screen Capture<br/>[app.py]"]
  node_button_detection["Button Detection<br/>[app.py]"]
  node_text_verification["Text Verification<br/>[app.py]"]
  node_click_loop["Click Loop<br/>[app.py]"]
  node_click_feedback["Click Feedback<br/>[app.py]"]
end

subgraph group_alternate["Autonomous Mode"]
  node_autonomous_cli["Autonomous CLI<br/>[auto_submit.py]"]
  node_cli_capture["CLI Capture<br/>[auto_submit.py]"]
  node_cli_detection["CLI Detection<br/>[auto_submit.py]"]
  node_cli_clicking["CLI Click Loop<br/>[auto_submit.py]"]
end

node_user(("User"))
node_display["Screen"]

node_user -->|"operates"| node_app_ui
node_app_ui -->|"requests selection"| node_region_selector
node_region_selector -->|"sets target region"| node_click_loop
node_user -->|"starts or pauses"| node_controls
node_controls -->|"controls session"| node_click_loop
node_hotkeys -->|"triggers actions"| node_controls
node_click_loop -->|"grabs screen"| node_capture
node_capture -->|"supplies frames"| node_button_detection
node_button_detection -->|"checks candidate text"| node_text_verification
node_click_loop -->|"searches frames"| node_button_detection
node_click_loop -->|"reports clicks"| node_click_feedback
node_click_feedback -->|"updates metrics"| node_telemetry
node_app_ui -->|"shows status"| node_telemetry
node_display -->|"provides pixels"| node_capture
node_click_loop -->|"clicks targets"| node_display
node_user -->|"launches"| node_autonomous_cli
node_autonomous_cli -->|"scans display"| node_cli_capture
node_cli_capture -->|"supplies frames"| node_cli_detection
node_autonomous_cli -->|"finds button"| node_cli_detection
node_autonomous_cli -->|"runs click loop"| node_cli_clicking
node_cli_clicking -->|"dispatches click"| node_display

click node_app_ui "https://github.com/boopathivellaichamy0-png/blue-plus-tech/blob/main/app.py"
click node_region_selector "https://github.com/boopathivellaichamy0-png/blue-plus-tech/blob/main/app.py"
click node_controls "https://github.com/boopathivellaichamy0-png/blue-plus-tech/blob/main/app.py"
click node_telemetry "https://github.com/boopathivellaichamy0-png/blue-plus-tech/blob/main/app.py"
click node_hotkeys "https://github.com/boopathivellaichamy0-png/blue-plus-tech/blob/main/app.py"
click node_capture "https://github.com/boopathivellaichamy0-png/blue-plus-tech/blob/main/app.py"
click node_button_detection "https://github.com/boopathivellaichamy0-png/blue-plus-tech/blob/main/app.py"
click node_text_verification "https://github.com/boopathivellaichamy0-png/blue-plus-tech/blob/main/app.py"
click node_click_loop "https://github.com/boopathivellaichamy0-png/blue-plus-tech/blob/main/app.py"
click node_click_feedback "https://github.com/boopathivellaichamy0-png/blue-plus-tech/blob/main/app.py"
click node_autonomous_cli "https://github.com/boopathivellaichamy0-png/blue-plus-tech/blob/main/auto_submit.py"
click node_cli_capture "https://github.com/boopathivellaichamy0-png/blue-plus-tech/blob/main/auto_submit.py"
click node_cli_detection "https://github.com/boopathivellaichamy0-png/blue-plus-tech/blob/main/auto_submit.py"
click node_cli_clicking "https://github.com/boopathivellaichamy0-png/blue-plus-tech/blob/main/auto_submit.py"

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_app_ui,node_region_selector,node_controls,node_telemetry,node_hotkeys,node_user,node_display toneBlue
class node_capture,node_button_detection,node_text_verification,node_click_loop,node_click_feedback toneAmber
class node_autonomous_cli,node_cli_capture,node_cli_detection,node_cli_clicking toneMint
```

## Components

### Desktop Interface

- [App UI](https://github.com/boopathivellaichamy0-png/blue-plus-tech/blob/main/app.py): `app.py`
- [Region Selector](https://github.com/boopathivellaichamy0-png/blue-plus-tech/blob/main/app.py): `app.py`
- [Session Controls](https://github.com/boopathivellaichamy0-png/blue-plus-tech/blob/main/app.py): `app.py`
- [Status and Metrics](https://github.com/boopathivellaichamy0-png/blue-plus-tech/blob/main/app.py): `app.py`
- [Global Hotkeys](https://github.com/boopathivellaichamy0-png/blue-plus-tech/blob/main/app.py): `app.py`

### Detection and Clicking

- [Screen Capture](https://github.com/boopathivellaichamy0-png/blue-plus-tech/blob/main/app.py): `app.py`
- [Button Detection](https://github.com/boopathivellaichamy0-png/blue-plus-tech/blob/main/app.py): `app.py`
- [Text Verification](https://github.com/boopathivellaichamy0-png/blue-plus-tech/blob/main/app.py): `app.py`
- [Click Loop](https://github.com/boopathivellaichamy0-png/blue-plus-tech/blob/main/app.py): `app.py`
- [Click Feedback](https://github.com/boopathivellaichamy0-png/blue-plus-tech/blob/main/app.py): `app.py`

### Autonomous Mode

- [Autonomous CLI](https://github.com/boopathivellaichamy0-png/blue-plus-tech/blob/main/auto_submit.py): `auto_submit.py`
- [CLI Capture](https://github.com/boopathivellaichamy0-png/blue-plus-tech/blob/main/auto_submit.py): `auto_submit.py`
- [CLI Detection](https://github.com/boopathivellaichamy0-png/blue-plus-tech/blob/main/auto_submit.py): `auto_submit.py`
- [CLI Click Loop](https://github.com/boopathivellaichamy0-png/blue-plus-tech/blob/main/auto_submit.py): `auto_submit.py`

### Other components

- **User**
- **Screen**

## Connections

- User → App UI: operates (evidence: `README.md`)
- App UI → Region Selector: requests selection (evidence: `app.py`)
- Region Selector → Click Loop: sets target region (evidence: `README.md`)
- User → Session Controls: starts or pauses (evidence: `README.md`)
- Session Controls → Click Loop: controls session (evidence: `app.py`)
- Global Hotkeys → Session Controls: triggers actions (evidence: `README.md`)
- Click Loop → Screen Capture: grabs screen (evidence: `app.py`)
- Screen Capture → Button Detection: supplies frames (evidence: `app.py`)
- Button Detection → Text Verification: checks candidate text (evidence: `app.py`)
- Click Loop → Button Detection: searches frames (evidence: `app.py`)
- Click Loop → Click Feedback: reports clicks (evidence: `app.py`)
- Click Feedback → Status and Metrics: updates metrics (evidence: `app.py`)
- App UI → Status and Metrics: shows status (evidence: `README.md`)
- Screen → Screen Capture: provides pixels (evidence: `app.py`)
- Click Loop → Screen: clicks targets (evidence: `README.md`)
- User → Autonomous CLI: launches (evidence: `README.md`)
- Autonomous CLI → CLI Capture: scans display (evidence: `auto_submit.py`)
- CLI Capture → CLI Detection: supplies frames (evidence: `auto_submit.py`)
- Autonomous CLI → CLI Detection: finds button (evidence: `auto_submit.py`)
- Autonomous CLI → CLI Click Loop: runs click loop (evidence: `auto_submit.py`)
- CLI Click Loop → Screen: dispatches click (evidence: `auto_submit.py`)
