# criespy/fantechvenomii-vx8 architecture

> Architecture diagram of the GitHub repository criespy/fantechvenomii-vx8, 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/criespy/fantechvenomii-vx8
- Repository: https://github.com/criespy/fantechvenomii-vx8

## Overview

Fantech Venom II VX8 Mouse Utilities is a Qt/Linux configuration app for supported A704F and A704 mouse devices. Users configure DPI profiles, RGB lighting, button actions, scroll behavior, and fire rate in the GUI, then apply settings over USB HID; settings can also be applied unattended with `--apply`. With `--daemon`, the app monitors the mouse’s keyboard interface and emits configured keyboard or multimedia inputs. The graph preserves these distinct configuration, preview, persistence, and input-handling responsibilities. Some implementation details are unsampled; edges reflect excerpts or README statements, not assumptions about the unseen code.

Main entry points: [`src/mainwindow.cpp`](https://github.com/criespy/fantechvenomii-vx8/blob/main/src/mainwindow.cpp) (Settings window), [`src/main.cpp`](https://github.com/criespy/fantechvenomii-vx8/blob/main/src/main.cpp) (CLI and tray), [`src/custominputhandler.cpp`](https://github.com/criespy/fantechvenomii-vx8/blob/main/src/custominputhandler.cpp) (Input monitor), [`src/hidhelper.cpp`](https://github.com/criespy/fantechvenomii-vx8/blob/main/src/hidhelper.cpp) (HID operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application and UI"]
  node_main["CLI and tray<br/>[main.cpp]"]
  node_window["Settings window<br/>[mainwindow.cpp]"]
  node_dialog["Key binding dialog"]
end

subgraph group_config["Settings and features"]
  node_settings["Mouse settings<br/>[mousesettings.cpp]"]
  node_preview["RGB preview<br/>[rgbpreview.cpp]"]
  node_keymap["HID key mappings<br/>[data.cpp]"]
end

subgraph group_device["HID device access"]
  node_hid["HID operations<br/>[hidhelper.cpp]"]
end

subgraph group_input["Custom input handling"]
  node_handler["Input monitor"]
end

node_user(("User"))
node_mouse{{"Supported mouse"}}
node_desktop(("Linux desktop"))

node_user -->|"launches"| node_main
node_main -->|"opens interfaces"| node_hid
node_main -->|"loads settings"| node_settings
node_main -->|"applies settings"| node_hid
node_main -->|"launches window"| node_window
node_main -.->|"starts daemon"| node_handler
node_window -->|"loads and saves"| node_settings
node_window -->|"opens binding dialog"| node_dialog
node_window -->|"updates preview"| node_preview
node_window -->|"applies settings"| node_hid
node_window -->|"starts monitoring"| node_handler
node_handler -->|"sends input reports"| node_hid
node_handler -->|"maps key codes"| node_keymap
node_keymap -->|"uses settings types"| node_settings
node_hid -->|"communicates by HID"| node_mouse
node_handler -->|"emits input events"| node_window
node_user -.->|"uses application"| node_desktop

click node_main "https://github.com/criespy/fantechvenomii-vx8/blob/main/src/main.cpp"
click node_window "https://github.com/criespy/fantechvenomii-vx8/blob/main/src/mainwindow.cpp"
click node_dialog "https://github.com/criespy/fantechvenomii-vx8/blob/main/src/customkeyboarddialog.cpp"
click node_settings "https://github.com/criespy/fantechvenomii-vx8/blob/main/src/mousesettings.cpp"
click node_preview "https://github.com/criespy/fantechvenomii-vx8/blob/main/src/rgbpreview.cpp"
click node_keymap "https://github.com/criespy/fantechvenomii-vx8/blob/main/src/data.cpp"
click node_hid "https://github.com/criespy/fantechvenomii-vx8/blob/main/src/hidhelper.cpp"
click node_handler "https://github.com/criespy/fantechvenomii-vx8/blob/main/src/custominputhandler.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_window,node_dialog,node_user toneBlue
class node_settings,node_preview,node_keymap toneAmber
class node_hid toneMint
class node_handler toneRose
class node_mouse,node_desktop toneIndigo
```

## Components

### Application and UI

- [CLI and tray](https://github.com/criespy/fantechvenomii-vx8/blob/main/src/main.cpp): `src/main.cpp`
- [Settings window](https://github.com/criespy/fantechvenomii-vx8/blob/main/src/mainwindow.cpp): `src/mainwindow.cpp`
- [Key binding dialog](https://github.com/criespy/fantechvenomii-vx8/blob/main/src/customkeyboarddialog.cpp): `src/customkeyboarddialog.cpp`

### Settings and features

- [Mouse settings](https://github.com/criespy/fantechvenomii-vx8/blob/main/src/mousesettings.cpp): `src/mousesettings.cpp`
- [RGB preview](https://github.com/criespy/fantechvenomii-vx8/blob/main/src/rgbpreview.cpp): `src/rgbpreview.cpp`
- [HID key mappings](https://github.com/criespy/fantechvenomii-vx8/blob/main/src/data.cpp): `src/data.cpp`

### HID device access

- [HID operations](https://github.com/criespy/fantechvenomii-vx8/blob/main/src/hidhelper.cpp): `src/hidhelper.cpp`

### Custom input handling

- [Input monitor](https://github.com/criespy/fantechvenomii-vx8/blob/main/src/custominputhandler.cpp): `src/custominputhandler.cpp`

### Other components

- **User**
- **Supported mouse**
- **Linux desktop**

## Connections

- User → CLI and tray: launches (evidence: `README.md`)
- CLI and tray → HID operations: opens interfaces (evidence: `src/main.cpp`)
- CLI and tray → Mouse settings: loads settings (evidence: `src/main.cpp`)
- CLI and tray → HID operations: applies settings (evidence: `src/main.cpp`)
- CLI and tray → Settings window: launches window (evidence: `src/main.cpp`)
- CLI and tray → Input monitor: starts daemon (evidence: `README.md`)
- Settings window → Mouse settings: loads and saves (evidence: `src/mainwindow.cpp`)
- Settings window → Key binding dialog: opens binding dialog (evidence: `src/mainwindow.cpp`)
- Settings window → RGB preview: updates preview (evidence: `src/mainwindow.cpp`)
- Settings window → HID operations: applies settings (evidence: `src/mainwindow.cpp`)
- Settings window → Input monitor: starts monitoring (evidence: `src/mainwindow.cpp`)
- Input monitor → HID operations: sends input reports (evidence: `src/custominputhandler.cpp`)
- Input monitor → HID key mappings: maps key codes (evidence: `src/custominputhandler.cpp`)
- HID key mappings → Mouse settings: uses settings types
- HID operations → Supported mouse: communicates by HID (evidence: `README.md`)
- Input monitor → Settings window: emits input events (evidence: `src/mainwindow.cpp`)
- User → Linux desktop: uses application
