# szokusio/trikizaapka architecture

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

- Interactive diagram: https://gitdiagram.com/szokusio/trikizaapka
- Repository: https://github.com/szokusio/trikizaapka

## Overview

Triki Control Center turns a Bluetooth Triki capsule into a desktop controller. The user connects the capsule, selects a mode, and the mode reads sensor/button state through the device layer to perform an action or display data; holding the button returns to the menu. The graph preserves all five documented modes and separates device handling, configuration, and host integrations. Source excerpts show the main dispatch and mode/device interactions; other mode capabilities are also documented in the README.

Main entry points: [`triki_control/device.py`](https://github.com/szokusio/trikizaapka/blob/maain/triki_control/device.py) (Device and calibration), [`triki_control/__main__.py`](https://github.com/szokusio/trikizaapka/blob/maain/triki_control/__main__.py) (Menu and dispatch), [`triki_control/modes/mouse.py`](https://github.com/szokusio/trikizaapka/blob/maain/triki_control/modes/mouse.py) (Mouse mode), [`triki_control/modes/volume.py`](https://github.com/szokusio/trikizaapka/blob/maain/triki_control/modes/volume.py) (Volume mode)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application flow"]
  node_main["Menu and dispatch<br/>[__main__.py]"]
  node_settings["Settings<br/>[config.py]"]
end

subgraph group_device["Device layer"]
  node_device_api["Device and calibration<br/>[device.py]"]
  node_button["Button tracking<br/>[device.py]"]
end

subgraph group_modes["Control modes"]
  node_mouse["Mouse mode<br/>[mouse.py]"]
  node_volume["Volume mode<br/>[volume.py]"]
  node_timer["Timer mode<br/>[timer.py]"]
  node_repetitions["Repetitions mode<br/>[repetitions.py]"]
  node_sensors["Sensor monitor<br/>[sensors.py]"]
end

subgraph group_host["Desktop integrations"]
  node_desktop{{"Desktop input"}}
  node_audio{{"System audio"}}
end

node_user(("User"))
node_capsule{{"Triki capsule"}}

node_user -->|"selects mode"| node_main
node_main -->|"connects and disconnects"| node_device_api
node_main -->|"creates settings"| node_settings
node_main -->|"dispatches"| node_mouse
node_main -->|"dispatches"| node_volume
node_main -->|"dispatches"| node_timer
node_main -->|"dispatches"| node_repetitions
node_main -->|"dispatches"| node_sensors
node_device_api -->|"reads settings"| node_settings
node_device_api -->|"scans and controls"| node_capsule
node_mouse -->|"reads sensor state"| node_device_api
node_mouse -->|"tracks presses"| node_button
node_mouse -->|"moves and clicks"| node_desktop
node_volume -->|"reads sensor state"| node_device_api
node_volume -->|"tracks presses"| node_button
node_volume -->|"sets volume and mute"| node_audio
node_timer -->|"calibrates and reads"| node_device_api
node_timer -->|"tracks presses"| node_button
node_timer -->|"signals with LED"| node_device_api
node_repetitions -->|"calibrates and reads"| node_device_api
node_repetitions -->|"tracks presses"| node_button
node_repetitions -->|"signals with LED"| node_device_api
node_sensors -->|"reads sensor state"| node_device_api
node_sensors -->|"tracks presses"| node_button

click node_main "https://github.com/szokusio/trikizaapka/blob/maain/triki_control/__main__.py"
click node_settings "https://github.com/szokusio/trikizaapka/blob/maain/triki_control/config.py"
click node_device_api "https://github.com/szokusio/trikizaapka/blob/maain/triki_control/device.py"
click node_button "https://github.com/szokusio/trikizaapka/blob/maain/triki_control/device.py"
click node_mouse "https://github.com/szokusio/trikizaapka/blob/maain/triki_control/modes/mouse.py"
click node_volume "https://github.com/szokusio/trikizaapka/blob/maain/triki_control/modes/volume.py"
click node_timer "https://github.com/szokusio/trikizaapka/blob/maain/triki_control/modes/timer.py"
click node_repetitions "https://github.com/szokusio/trikizaapka/blob/maain/triki_control/modes/repetitions.py"
click node_sensors "https://github.com/szokusio/trikizaapka/blob/maain/triki_control/modes/sensors.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_main,node_settings,node_user toneBlue
class node_device_api,node_button toneAmber
class node_mouse,node_volume,node_timer,node_repetitions,node_sensors toneMint
class node_desktop,node_audio toneRose
class node_capsule toneIndigo
```

## Components

### Application flow

- [Menu and dispatch](https://github.com/szokusio/trikizaapka/blob/maain/triki_control/__main__.py): `triki_control/__main__.py`
- [Settings](https://github.com/szokusio/trikizaapka/blob/maain/triki_control/config.py): `triki_control/config.py`

### Device layer

- [Device and calibration](https://github.com/szokusio/trikizaapka/blob/maain/triki_control/device.py): `triki_control/device.py`
- [Button tracking](https://github.com/szokusio/trikizaapka/blob/maain/triki_control/device.py): `triki_control/device.py`

### Control modes

- [Mouse mode](https://github.com/szokusio/trikizaapka/blob/maain/triki_control/modes/mouse.py): `triki_control/modes/mouse.py`
- [Volume mode](https://github.com/szokusio/trikizaapka/blob/maain/triki_control/modes/volume.py): `triki_control/modes/volume.py`
- [Timer mode](https://github.com/szokusio/trikizaapka/blob/maain/triki_control/modes/timer.py): `triki_control/modes/timer.py`
- [Repetitions mode](https://github.com/szokusio/trikizaapka/blob/maain/triki_control/modes/repetitions.py): `triki_control/modes/repetitions.py`
- [Sensor monitor](https://github.com/szokusio/trikizaapka/blob/maain/triki_control/modes/sensors.py): `triki_control/modes/sensors.py`

### Desktop integrations

- **Desktop input**
- **System audio**

### Other components

- **User**
- **Triki capsule**

## Connections

- User → Menu and dispatch: selects mode (evidence: `README.md`)
- Menu and dispatch → Device and calibration: connects and disconnects (evidence: `triki_control/__main__.py`)
- Menu and dispatch → Settings: creates settings (evidence: `triki_control/__main__.py`)
- Menu and dispatch → Mouse mode: dispatches (evidence: `triki_control/__main__.py`)
- Menu and dispatch → Volume mode: dispatches (evidence: `triki_control/__main__.py`)
- Menu and dispatch → Timer mode: dispatches (evidence: `triki_control/__main__.py`)
- Menu and dispatch → Repetitions mode: dispatches (evidence: `triki_control/__main__.py`)
- Menu and dispatch → Sensor monitor: dispatches (evidence: `triki_control/__main__.py`)
- Device and calibration → Settings: reads settings (evidence: `triki_control/device.py`)
- Device and calibration → Triki capsule: scans and controls (evidence: `triki_control/device.py`)
- Mouse mode → Device and calibration: reads sensor state (evidence: `triki_control/modes/mouse.py`)
- Mouse mode → Button tracking: tracks presses (evidence: `triki_control/modes/mouse.py`)
- Mouse mode → Desktop input: moves and clicks (evidence: `triki_control/modes/mouse.py`)
- Volume mode → Device and calibration: reads sensor state (evidence: `triki_control/modes/volume.py`)
- Volume mode → Button tracking: tracks presses (evidence: `triki_control/modes/volume.py`)
- Volume mode → System audio: sets volume and mute (evidence: `triki_control/modes/volume.py`)
- Timer mode → Device and calibration: calibrates and reads (evidence: `triki_control/modes/timer.py`)
- Timer mode → Button tracking: tracks presses (evidence: `triki_control/modes/timer.py`)
- Timer mode → Device and calibration: signals with LED (evidence: `triki_control/modes/timer.py`)
- Repetitions mode → Device and calibration: calibrates and reads (evidence: `triki_control/modes/repetitions.py`)
- Repetitions mode → Button tracking: tracks presses (evidence: `triki_control/modes/repetitions.py`)
- Repetitions mode → Device and calibration: signals with LED (evidence: `triki_control/modes/repetitions.py`)
- Sensor monitor → Device and calibration: reads sensor state (evidence: `triki_control/modes/sensors.py`)
- Sensor monitor → Button tracking: tracks presses (evidence: `triki_control/modes/sensors.py`)
