# johnmwarts/scene-proto architecture

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

- Interactive diagram: https://gitdiagram.com/johnmwarts/scene-proto
- Repository: https://github.com/johnmwarts/scene-proto

## Overview

SCÈNE is a live-performance video playback and projection-mapping application. The principal workflow is to prepare project media, layers, cues and timelines in the control interface, trigger cues or timeline playback, then compose the resulting canvases for mapped outputs while synchronizing audio and show-control systems. The graph retains major documented capabilities, including media conversion, live input and external control. Some subsystems are represented at directory level because their implementation files were not sampled; connections without direct evidence are omitted.

Main entry points: [`src/app/App.cpp`](https://github.com/johnmwarts/scene-proto/blob/main/src/app/App.cpp) (Application runtime), [`src/app/ControlUi.cpp`](https://github.com/johnmwarts/scene-proto/blob/main/src/app/ControlUi.cpp) (Control interface), [`src/core/CueEngine.cpp`](https://github.com/johnmwarts/scene-proto/blob/main/src/core/CueEngine.cpp) (Cue engine), [`src/media/MediaPool.h`](https://github.com/johnmwarts/scene-proto/blob/main/src/media/MediaPool.h) (Media pool)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["Show control"]
  node_ui["Control interface<br/>[ControlUi.cpp]"]
  node_dashboard["Dashboard<br/>[Dashboard.cpp]"]
  node_timeline_ui["Timeline editor<br/>[TimelineEditor.cpp]"]
  node_clip_ui["Clip editor<br/>[ClipEditor.cpp]"]
  node_data_ui["Data panel<br/>[DataPanel.cpp]"]
  node_outputs_ui["Outputs panel<br/>[OutputsPanel.cpp]"]
  node_app["Application runtime<br/>[App.cpp]"]
end

subgraph group_project["Project and cues"]
  node_project["Project model<br/>[Project.cpp]"]
  node_cue["Cue engine<br/>[CueEngine.cpp]"]
  node_timeline["Timeline evaluation<br/>[Timeline.cpp]"]
end

subgraph group_media["Media and audio"]
  node_media_pool["Media pool<br/>[MediaPool.h]"]
  node_hap["HAP playback<br/>[HapPlayer.cpp]"]
  node_ffmpeg["FFmpeg media<br/>[Ffmpeg.cpp]"]
  node_live["Live capture<br/>[LiveInput.cpp]"]
  node_conversion["HAP conversion<br/>[HapConvert.cpp]"]
  node_audio["Audio engine<br/>[AudioEngine.cpp]"]
end

subgraph group_visual["Composition and outputs"]
  node_renderer["GPU composition<br/>[Renderer.cpp]"]
  node_outputs["Display outputs<br/>[Outputs.cpp]"]
end

subgraph group_integration["External control"]
  node_osc["OSC control<br/>[Osc.cpp]"]
  node_osc_receiver["OSC receiver<br/>[OscReceiver.cpp]"]
  node_show_io["Show-control I/O"]
  node_projectors["PJLink control<br/>[PjLink.cpp]"]
end

node_operator(("Operator"))

node_operator -->|"operates"| node_ui
node_ui -->|"controls"| node_app
node_dashboard -.->|"edits show"| node_app
node_timeline_ui -.->|"edits timeline"| node_app
node_clip_ui -->|"edits clips"| node_app
node_data_ui -.->|"configures actions"| node_app
node_outputs_ui -.->|"configures outputs"| node_app
node_app -->|"loads project"| node_project
node_app -->|"drives cues"| node_cue
node_cue -->|"updates state"| node_project
node_app -.->|"evaluates playback"| node_timeline
node_app -->|"opens media"| node_media_pool
node_media_pool -->|"uses player"| node_hap
node_app -->|"decodes audio"| node_ffmpeg
node_app -->|"captures inputs"| node_live
node_app -.->|"converts media"| node_conversion
node_app -.->|"sends mix"| node_audio
node_app -->|"composes frames"| node_renderer
node_app -->|"syncs displays"| node_outputs
node_renderer -.->|"renders to"| node_outputs
node_app -.->|"sends messages"| node_osc
node_osc_receiver -.->|"delivers input"| node_app
node_app -.->|"handles show control"| node_show_io
node_app -->|"controls projectors"| node_projectors
node_operator -->|"requests conversion"| node_conversion
node_operator -->|"selects input"| node_live
node_operator -->|"triggers cues"| node_show_io

click node_ui "https://github.com/johnmwarts/scene-proto/blob/main/src/app/ControlUi.cpp"
click node_dashboard "https://github.com/johnmwarts/scene-proto/blob/main/src/app/ui/Dashboard.cpp"
click node_timeline_ui "https://github.com/johnmwarts/scene-proto/blob/main/src/app/ui/TimelineEditor.cpp"
click node_clip_ui "https://github.com/johnmwarts/scene-proto/blob/main/src/app/ui/ClipEditor.cpp"
click node_data_ui "https://github.com/johnmwarts/scene-proto/blob/main/src/app/ui/DataPanel.cpp"
click node_outputs_ui "https://github.com/johnmwarts/scene-proto/blob/main/src/app/ui/OutputsPanel.cpp"
click node_app "https://github.com/johnmwarts/scene-proto/blob/main/src/app/App.cpp"
click node_project "https://github.com/johnmwarts/scene-proto/blob/main/src/core/Project.cpp"
click node_cue "https://github.com/johnmwarts/scene-proto/blob/main/src/core/CueEngine.cpp"
click node_timeline "https://github.com/johnmwarts/scene-proto/blob/main/src/core/Timeline.cpp"
click node_media_pool "https://github.com/johnmwarts/scene-proto/blob/main/src/media/MediaPool.h"
click node_hap "https://github.com/johnmwarts/scene-proto/blob/main/src/media/HapPlayer.cpp"
click node_ffmpeg "https://github.com/johnmwarts/scene-proto/blob/main/src/media/Ffmpeg.cpp"
click node_live "https://github.com/johnmwarts/scene-proto/blob/main/src/media/LiveInput.cpp"
click node_conversion "https://github.com/johnmwarts/scene-proto/blob/main/src/media/HapConvert.cpp"
click node_audio "https://github.com/johnmwarts/scene-proto/blob/main/src/audio/AudioEngine.cpp"
click node_renderer "https://github.com/johnmwarts/scene-proto/blob/main/src/render/Renderer.cpp"
click node_outputs "https://github.com/johnmwarts/scene-proto/blob/main/src/app/Outputs.cpp"
click node_osc "https://github.com/johnmwarts/scene-proto/blob/main/src/osc/Osc.cpp"
click node_osc_receiver "https://github.com/johnmwarts/scene-proto/blob/main/src/osc/OscReceiver.cpp"
click node_show_io "https://github.com/johnmwarts/scene-proto/tree/main/src/app"
click node_projectors "https://github.com/johnmwarts/scene-proto/blob/main/src/core/PjLink.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_ui,node_dashboard,node_timeline_ui,node_clip_ui,node_data_ui,node_outputs_ui,node_app toneBlue
class node_project,node_cue,node_timeline toneAmber
class node_media_pool,node_hap,node_ffmpeg,node_live,node_conversion,node_audio toneMint
class node_renderer,node_outputs toneRose
class node_osc,node_osc_receiver,node_show_io,node_projectors,node_operator toneIndigo
```

## Components

### Show control

- [Control interface](https://github.com/johnmwarts/scene-proto/blob/main/src/app/ControlUi.cpp): `src/app/ControlUi.cpp`
- [Dashboard](https://github.com/johnmwarts/scene-proto/blob/main/src/app/ui/Dashboard.cpp): `src/app/ui/Dashboard.cpp`
- [Timeline editor](https://github.com/johnmwarts/scene-proto/blob/main/src/app/ui/TimelineEditor.cpp): `src/app/ui/TimelineEditor.cpp`
- [Clip editor](https://github.com/johnmwarts/scene-proto/blob/main/src/app/ui/ClipEditor.cpp): `src/app/ui/ClipEditor.cpp`
- [Data panel](https://github.com/johnmwarts/scene-proto/blob/main/src/app/ui/DataPanel.cpp): `src/app/ui/DataPanel.cpp`
- [Outputs panel](https://github.com/johnmwarts/scene-proto/blob/main/src/app/ui/OutputsPanel.cpp): `src/app/ui/OutputsPanel.cpp`
- [Application runtime](https://github.com/johnmwarts/scene-proto/blob/main/src/app/App.cpp): `src/app/App.cpp`

### Project and cues

- [Project model](https://github.com/johnmwarts/scene-proto/blob/main/src/core/Project.cpp): `src/core/Project.cpp`
- [Cue engine](https://github.com/johnmwarts/scene-proto/blob/main/src/core/CueEngine.cpp): `src/core/CueEngine.cpp`
- [Timeline evaluation](https://github.com/johnmwarts/scene-proto/blob/main/src/core/Timeline.cpp): `src/core/Timeline.cpp`

### Media and audio

- [Media pool](https://github.com/johnmwarts/scene-proto/blob/main/src/media/MediaPool.h): `src/media/MediaPool.h`
- [HAP playback](https://github.com/johnmwarts/scene-proto/blob/main/src/media/HapPlayer.cpp): `src/media/HapPlayer.cpp`
- [FFmpeg media](https://github.com/johnmwarts/scene-proto/blob/main/src/media/Ffmpeg.cpp): `src/media/Ffmpeg.cpp`
- [Live capture](https://github.com/johnmwarts/scene-proto/blob/main/src/media/LiveInput.cpp): `src/media/LiveInput.cpp`
- [HAP conversion](https://github.com/johnmwarts/scene-proto/blob/main/src/media/HapConvert.cpp): `src/media/HapConvert.cpp`
- [Audio engine](https://github.com/johnmwarts/scene-proto/blob/main/src/audio/AudioEngine.cpp): `src/audio/AudioEngine.cpp`

### Composition and outputs

- [GPU composition](https://github.com/johnmwarts/scene-proto/blob/main/src/render/Renderer.cpp): `src/render/Renderer.cpp`
- [Display outputs](https://github.com/johnmwarts/scene-proto/blob/main/src/app/Outputs.cpp): `src/app/Outputs.cpp`

### External control

- [OSC control](https://github.com/johnmwarts/scene-proto/blob/main/src/osc/Osc.cpp): `src/osc/Osc.cpp`
- [OSC receiver](https://github.com/johnmwarts/scene-proto/blob/main/src/osc/OscReceiver.cpp): `src/osc/OscReceiver.cpp`
- [Show-control I/O](https://github.com/johnmwarts/scene-proto/tree/main/src/app): `src/app`
- [PJLink control](https://github.com/johnmwarts/scene-proto/blob/main/src/core/PjLink.cpp): `src/core/PjLink.cpp`

### Other components

- **Operator**

## Connections

- Operator → Control interface: operates
- Control interface → Application runtime: controls
- Dashboard → Application runtime: edits show
- Timeline editor → Application runtime: edits timeline
- Clip editor → Application runtime: edits clips (evidence: `src/app/ui/ClipEditor.cpp`)
- Data panel → Application runtime: configures actions
- Outputs panel → Application runtime: configures outputs
- Application runtime → Project model: loads project
- Application runtime → Cue engine: drives cues
- Cue engine → Project model: updates state (evidence: `src/core/CueEngine.cpp`)
- Application runtime → Timeline evaluation: evaluates playback
- Application runtime → Media pool: opens media (evidence: `src/app/App.cpp`)
- Media pool → HAP playback: uses player (evidence: `src/media/MediaPool.h`)
- Application runtime → FFmpeg media: decodes audio (evidence: `src/app/App.cpp`)
- Application runtime → Live capture: captures inputs
- Application runtime → HAP conversion: converts media
- Application runtime → Audio engine: sends mix
- Application runtime → GPU composition: composes frames
- Application runtime → Display outputs: syncs displays
- GPU composition → Display outputs: renders to
- Application runtime → OSC control: sends messages
- OSC receiver → Application runtime: delivers input
- Application runtime → Show-control I/O: handles show control (evidence: `src/app/App.cpp`)
- Application runtime → PJLink control: controls projectors (evidence: `src/app/App.cpp`)
- Operator → HAP conversion: requests conversion
- Operator → Live capture: selects input
- Operator → Show-control I/O: triggers cues
