# arekkozuch/vbooverlay architecture

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

- Interactive diagram: https://gitdiagram.com/arekkozuch/vbooverlay
- Repository: https://github.com/arekkozuch/vbooverlay

## Overview

Flapped Ear Telemetry is a native desktop app for editing video telemetry overlays and analyzing motorsport recordings. The user workflow runs from opening/importing media or event recordings, through project and source management, to synchronized preview, lap/outing analysis, and—on the overlay side—FFmpeg export. The graph preserves the documented editor, analysis, project, and export capabilities. Some subsystem links are based on README descriptions or SOURCE INDEX references; unsampled implementation details are not assumed.

Main entry points: [`native/src/app/AppController.cpp`](https://github.com/arekkozuch/vbooverlay/blob/main/native/src/app/AppController.cpp) (App controller), [`native/src/export/ExportEngine.cpp`](https://github.com/arekkozuch/vbooverlay/blob/main/native/src/export/ExportEngine.cpp) (Export engine), [`native/src/app/DocumentController.cpp`](https://github.com/arekkozuch/vbooverlay/blob/main/native/src/app/DocumentController.cpp) (Document controller), [`native/src/app/AnalysisController.h`](https://github.com/arekkozuch/vbooverlay/blob/main/native/src/app/AnalysisController.h) (Analysis controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Desktop app"]
  node_desktop["Application entry<br/>[main.cpp]"]
  node_controller["App controller<br/>[AppController.cpp]"]
  node_analysis["Analysis controller"]
  node_preview["Preview playback"]
end

subgraph group_projects["Projects"]
  node_documents["Document controller"]
  node_eventcodec["Event codec"]
  node_projectstate["Project state and recovery"]
end

subgraph group_telemetry["Telemetry analysis"]
  node_telemetryimport["Telemetry import"]
  node_source["Telemetry sources<br/>[TelemetrySource.h]"]
  node_session["Telemetry session<br/>[TelemetrySession.h]"]
  node_sync["Telemetry synchronization"]
  node_laps["Lap timing<br/>[LapTiming.h]"]
  node_outing["Outing laps<br/>[OutingLaps.h]"]
  node_track["Track inference and review<br/>[TrackInference.cpp]"]
  node_gopro["GoPro telemetry"]
end

subgraph group_media["Overlay and export"]
  node_widgets["Widget model<br/>[WidgetModel.cpp]"]
  node_export["Export engine<br/>[ExportEngine.cpp]"]
  node_diagnostics["Export diagnostics"]
  node_probe["Media probe<br/>[MediaProbe.h]"]
end

node_user(("User"))
node_ffmpeg["FFmpeg tools"]
node_mediafiles["Video and telemetry files"]

node_user -->|"opens and operates"| node_desktop
node_desktop -->|"starts"| node_controller
node_controller -->|"delegates document actions"| node_documents
node_documents -->|"loads and saves events"| node_eventcodec
node_documents -->|"manages project state"| node_projectstate
node_user -->|"selects"| node_mediafiles
node_documents -->|"imports recordings"| node_telemetryimport
node_telemetryimport -.->|"creates source records"| node_source
node_source -->|"provides telemetry"| node_session
node_controller -->|"coordinates synchronization"| node_sync
node_controller -->|"extracts GoPro telemetry"| node_gopro
node_analysis -->|"derives lap timing"| node_laps
node_analysis -->|"builds outing views"| node_outing
node_analysis -->|"reviews track segments"| node_track
node_laps -->|"reads telemetry"| node_session
node_outing -->|"uses lap sessions"| node_laps
node_controller -->|"exposes analysis"| node_analysis
node_controller -->|"controls playback"| node_preview
node_preview -.->|"renders overlays"| node_widgets
node_controller -->|"runs exports"| node_export
node_export -->|"renders telemetry overlays"| node_widgets
node_export -->|"probes media"| node_probe
node_export -->|"encodes with"| node_ffmpeg
node_export -->|"records diagnostics"| node_diagnostics
node_probe -.->|"inspects video"| node_mediafiles

click node_desktop "https://github.com/arekkozuch/vbooverlay/blob/main/native/src/main.cpp"
click node_controller "https://github.com/arekkozuch/vbooverlay/blob/main/native/src/app/AppController.cpp"
click node_documents "https://github.com/arekkozuch/vbooverlay/blob/main/native/src/app/DocumentController.cpp"
click node_eventcodec "https://github.com/arekkozuch/vbooverlay/blob/main/native/src/project/EventProjectCodec.cpp"
click node_projectstate "https://github.com/arekkozuch/vbooverlay/blob/main/native/src/project/ProjectDocumentState.cpp"
click node_telemetryimport "https://github.com/arekkozuch/vbooverlay/tree/main/native/src/telemetry"
click node_source "https://github.com/arekkozuch/vbooverlay/blob/main/native/src/telemetry/TelemetrySource.h"
click node_session "https://github.com/arekkozuch/vbooverlay/blob/main/native/src/telemetry/TelemetrySession.h"
click node_sync "https://github.com/arekkozuch/vbooverlay/blob/main/native/src/telemetry/TelemetrySyncEngine.cpp"
click node_laps "https://github.com/arekkozuch/vbooverlay/blob/main/native/src/telemetry/LapTiming.h"
click node_outing "https://github.com/arekkozuch/vbooverlay/blob/main/native/src/telemetry/OutingLaps.h"
click node_track "https://github.com/arekkozuch/vbooverlay/blob/main/native/src/telemetry/TrackInference.cpp"
click node_analysis "https://github.com/arekkozuch/vbooverlay/blob/main/native/src/app/AnalysisController.h"
click node_widgets "https://github.com/arekkozuch/vbooverlay/blob/main/native/src/widgets/WidgetModel.cpp"
click node_preview "https://github.com/arekkozuch/vbooverlay/blob/main/native/src/app/PreviewPlayback.cpp"
click node_gopro "https://github.com/arekkozuch/vbooverlay/blob/main/native/src/gopro/GoProTelemetrySource.cpp"
click node_export "https://github.com/arekkozuch/vbooverlay/blob/main/native/src/export/ExportEngine.cpp"
click node_diagnostics "https://github.com/arekkozuch/vbooverlay/blob/main/native/src/export/ExportDiagnostics.h"
click node_probe "https://github.com/arekkozuch/vbooverlay/blob/main/native/src/export/MediaProbe.h"

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_desktop,node_controller,node_analysis,node_preview,node_user toneBlue
class node_documents,node_eventcodec,node_projectstate toneAmber
class node_telemetryimport,node_source,node_session,node_sync,node_laps,node_outing,node_track,node_gopro toneMint
class node_widgets,node_export,node_diagnostics,node_probe toneRose
class node_ffmpeg,node_mediafiles toneIndigo
```

## Components

### Desktop app

- [Application entry](https://github.com/arekkozuch/vbooverlay/blob/main/native/src/main.cpp): `native/src/main.cpp`
- [App controller](https://github.com/arekkozuch/vbooverlay/blob/main/native/src/app/AppController.cpp): `native/src/app/AppController.cpp`
- [Analysis controller](https://github.com/arekkozuch/vbooverlay/blob/main/native/src/app/AnalysisController.h): `native/src/app/AnalysisController.h`
- [Preview playback](https://github.com/arekkozuch/vbooverlay/blob/main/native/src/app/PreviewPlayback.cpp): `native/src/app/PreviewPlayback.cpp`

### Projects

- [Document controller](https://github.com/arekkozuch/vbooverlay/blob/main/native/src/app/DocumentController.cpp): `native/src/app/DocumentController.cpp`
- [Event codec](https://github.com/arekkozuch/vbooverlay/blob/main/native/src/project/EventProjectCodec.cpp): `native/src/project/EventProjectCodec.cpp`
- [Project state and recovery](https://github.com/arekkozuch/vbooverlay/blob/main/native/src/project/ProjectDocumentState.cpp): `native/src/project/ProjectDocumentState.cpp`

### Telemetry analysis

- [Telemetry import](https://github.com/arekkozuch/vbooverlay/tree/main/native/src/telemetry): `native/src/telemetry`
- [Telemetry sources](https://github.com/arekkozuch/vbooverlay/blob/main/native/src/telemetry/TelemetrySource.h): `native/src/telemetry/TelemetrySource.h`
- [Telemetry session](https://github.com/arekkozuch/vbooverlay/blob/main/native/src/telemetry/TelemetrySession.h): `native/src/telemetry/TelemetrySession.h`
- [Telemetry synchronization](https://github.com/arekkozuch/vbooverlay/blob/main/native/src/telemetry/TelemetrySyncEngine.cpp): `native/src/telemetry/TelemetrySyncEngine.cpp`
- [Lap timing](https://github.com/arekkozuch/vbooverlay/blob/main/native/src/telemetry/LapTiming.h): `native/src/telemetry/LapTiming.h`
- [Outing laps](https://github.com/arekkozuch/vbooverlay/blob/main/native/src/telemetry/OutingLaps.h): `native/src/telemetry/OutingLaps.h`
- [Track inference and review](https://github.com/arekkozuch/vbooverlay/blob/main/native/src/telemetry/TrackInference.cpp): `native/src/telemetry/TrackInference.cpp`
- [GoPro telemetry](https://github.com/arekkozuch/vbooverlay/blob/main/native/src/gopro/GoProTelemetrySource.cpp): `native/src/gopro/GoProTelemetrySource.cpp`

### Overlay and export

- [Widget model](https://github.com/arekkozuch/vbooverlay/blob/main/native/src/widgets/WidgetModel.cpp): `native/src/widgets/WidgetModel.cpp`
- [Export engine](https://github.com/arekkozuch/vbooverlay/blob/main/native/src/export/ExportEngine.cpp): `native/src/export/ExportEngine.cpp`
- [Export diagnostics](https://github.com/arekkozuch/vbooverlay/blob/main/native/src/export/ExportDiagnostics.h): `native/src/export/ExportDiagnostics.h`
- [Media probe](https://github.com/arekkozuch/vbooverlay/blob/main/native/src/export/MediaProbe.h): `native/src/export/MediaProbe.h`

### Other components

- **User**
- **FFmpeg tools**
- **Video and telemetry files**

## Connections

- User → Application entry: opens and operates (evidence: `README.md`)
- Application entry → App controller: starts (evidence: `native/src/main.cpp`)
- App controller → Document controller: delegates document actions
- Document controller → Event codec: loads and saves events (evidence: `native/src/app/DocumentController.cpp`)
- Document controller → Project state and recovery: manages project state
- User → Video and telemetry files: selects (evidence: `README.md`)
- Document controller → Telemetry import: imports recordings
- Telemetry import → Telemetry sources: creates source records (evidence: `native/src/telemetry/TelemetrySource.h`)
- Telemetry sources → Telemetry session: provides telemetry (evidence: `native/src/telemetry/TelemetrySource.h`)
- App controller → Telemetry synchronization: coordinates synchronization (evidence: `native/src/app/AppController.cpp`)
- App controller → GoPro telemetry: extracts GoPro telemetry (evidence: `native/src/app/AppController.cpp`)
- Analysis controller → Lap timing: derives lap timing (evidence: `native/src/app/AnalysisController.h`)
- Analysis controller → Outing laps: builds outing views (evidence: `native/src/app/AnalysisController.h`)
- Analysis controller → Track inference and review: reviews track segments
- Lap timing → Telemetry session: reads telemetry (evidence: `native/src/telemetry/LapTiming.h`)
- Outing laps → Lap timing: uses lap sessions (evidence: `native/src/telemetry/OutingLaps.h`)
- App controller → Analysis controller: exposes analysis
- App controller → Preview playback: controls playback (evidence: `native/src/app/AppController.cpp`)
- Preview playback → Widget model: renders overlays (evidence: `README.md`)
- App controller → Export engine: runs exports (evidence: `native/src/app/AppController.cpp`)
- Export engine → Widget model: renders telemetry overlays (evidence: `native/src/export/ExportEngine.cpp`)
- Export engine → Media probe: probes media
- Export engine → FFmpeg tools: encodes with (evidence: `native/src/export/ExportEngine.cpp`)
- Export engine → Export diagnostics: records diagnostics (evidence: `native/src/export/ExportEngine.cpp`)
- Media probe → Video and telemetry files: inspects video
