# schabo/orbis-reframe architecture

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

- Interactive diagram: https://gitdiagram.com/schabo/orbis-reframe
- Repository: https://github.com/schabo/orbis-reframe

## Overview

orbis-reframe is a Linux editor for 360° camera footage, centered on importing camera clips, stitching and stabilizing them, authoring a keyframed spherical view, and exporting flat video. The graph preserves the major editing, calibration, privacy, tracking, and audio capabilities identified in the README and source tree. Some of those branches are represented by their implementation paths but have no asserted connections because their source was not sampled; edges are limited to documented or excerpted relationships.

Main entry points: [`src/core/Project.cpp`](https://github.com/schabo/orbis-reframe/blob/main/src/core/Project.cpp) (Project Model), [`src/ui/ReframeExportController.cpp`](https://github.com/schabo/orbis-reframe/blob/main/src/ui/ReframeExportController.cpp) (Export Controller), [`src/ui/PlaybackController.cpp`](https://github.com/schabo/orbis-reframe/blob/main/src/ui/PlaybackController.cpp) (Playback Controller), [`src/ui/MainWindow.cpp`](https://github.com/schabo/orbis-reframe/blob/main/src/ui/MainWindow.cpp) (Editor UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_editing["Project and Editing"]
  node_editor["Editor UI<br/>[MainWindow.cpp]"]
  node_project["Project Model<br/>[Project.cpp]"]
  node_timeline["Timeline<br/>[Timeline.cpp]"]
  node_media_pool["Media Pool<br/>[MediaPool.h]"]
end

subgraph group_media["Camera and Stitching"]
  node_camera_readers["Camera Readers<br/>[Insta360Reader.cpp]"]
  node_stitch_source["Native Stitch Source"]
  node_gpu_stitcher["Vulkan Stitcher"]
end

subgraph group_view["View and Rendering"]
  node_reframe_track["Reframe Keyframes<br/>[ReframeTrack.h]"]
  node_viewport["360 Viewport"]
end

subgraph group_features["Analysis and Effects"]
  node_gyro_stabilizer["Gyro Stabilization<br/>[GyroStabilizer.cpp]"]
  node_calibration["Lens Calibration<br/>[LensFit.cpp]"]
  node_subject_tracking["Subject Tracking<br/>[SubjectTracker.cpp]"]
  node_privacy["Plate Privacy<br/>[PlateScanner.cpp]"]
  node_audio["Audio Processing<br/>[VoiceIsolator.cpp]"]
end

subgraph group_output["Playback and Export"]
  node_playback["Playback Controller"]
  node_export_controller["Export Controller"]
  node_reframe_renderer["Reframe Renderer"]
  node_flatten_writer["Video Encoder<br/>[ReframeFlatten.cpp]"]
end

node_user(("Editor User"))

node_user -->|"edits"| node_editor
node_editor -.->|"manages"| node_project
node_project -->|"owns"| node_timeline
node_project -->|"owns"| node_media_pool
node_user -.->|"imports clips"| node_camera_readers
node_playback -->|"opens source"| node_stitch_source
node_stitch_source -.->|"stitches frames"| node_gpu_stitcher
node_user -->|"sets keyframes"| node_reframe_track
node_user -->|"steers view"| node_viewport
node_user -.->|"calibrates lenses"| node_calibration
node_user -.->|"tracks subjects"| node_subject_tracking
node_user -.->|"blurs plates"| node_privacy
node_user -.->|"processes audio"| node_audio
node_playback -->|"presents frames"| node_viewport
node_user -.->|"exports video"| node_export_controller
node_export_controller -->|"renders views"| node_reframe_renderer
node_export_controller -->|"encodes frames"| node_flatten_writer
node_reframe_renderer -.->|"renders output"| node_flatten_writer

click node_editor "https://github.com/schabo/orbis-reframe/blob/main/src/ui/MainWindow.cpp"
click node_project "https://github.com/schabo/orbis-reframe/blob/main/src/core/Project.cpp"
click node_timeline "https://github.com/schabo/orbis-reframe/blob/main/src/core/Timeline.cpp"
click node_media_pool "https://github.com/schabo/orbis-reframe/blob/main/src/core/MediaPool.h"
click node_camera_readers "https://github.com/schabo/orbis-reframe/blob/main/src/camera/Insta360Reader.cpp"
click node_stitch_source "https://github.com/schabo/orbis-reframe/blob/main/src/stitch/NativeStitchSource.cpp"
click node_gpu_stitcher "https://github.com/schabo/orbis-reframe/blob/main/src/render/VulkanFisheyeStitcher.cpp"
click node_gyro_stabilizer "https://github.com/schabo/orbis-reframe/blob/main/lib/orbis-core/orbis-core/stab/GyroStabilizer.cpp"
click node_reframe_track "https://github.com/schabo/orbis-reframe/blob/main/src/core/ReframeTrack.h"
click node_viewport "https://github.com/schabo/orbis-reframe/blob/main/src/render/EquirectViewportWindow.h"
click node_calibration "https://github.com/schabo/orbis-reframe/blob/main/src/calib/LensFit.cpp"
click node_subject_tracking "https://github.com/schabo/orbis-reframe/blob/main/src/track/SubjectTracker.cpp"
click node_privacy "https://github.com/schabo/orbis-reframe/blob/main/src/privacy/PlateScanner.cpp"
click node_audio "https://github.com/schabo/orbis-reframe/blob/main/lib/orbis-core/orbis-core/audio/VoiceIsolator.cpp"
click node_playback "https://github.com/schabo/orbis-reframe/blob/main/src/ui/PlaybackController.cpp"
click node_export_controller "https://github.com/schabo/orbis-reframe/blob/main/src/ui/ReframeExportController.cpp"
click node_reframe_renderer "https://github.com/schabo/orbis-reframe/blob/main/src/export/ReframeRenderer.cpp"
click node_flatten_writer "https://github.com/schabo/orbis-reframe/blob/main/src/export/ReframeFlatten.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_editor,node_project,node_timeline,node_media_pool,node_user toneBlue
class node_camera_readers,node_stitch_source,node_gpu_stitcher toneAmber
class node_reframe_track,node_viewport toneMint
class node_gyro_stabilizer,node_calibration,node_subject_tracking,node_privacy,node_audio toneRose
class node_playback,node_export_controller,node_reframe_renderer,node_flatten_writer toneIndigo
```

## Components

### Project and Editing

- [Editor UI](https://github.com/schabo/orbis-reframe/blob/main/src/ui/MainWindow.cpp): `src/ui/MainWindow.cpp`
- [Project Model](https://github.com/schabo/orbis-reframe/blob/main/src/core/Project.cpp): `src/core/Project.cpp`
- [Timeline](https://github.com/schabo/orbis-reframe/blob/main/src/core/Timeline.cpp): `src/core/Timeline.cpp`
- [Media Pool](https://github.com/schabo/orbis-reframe/blob/main/src/core/MediaPool.h): `src/core/MediaPool.h`

### Camera and Stitching

- [Camera Readers](https://github.com/schabo/orbis-reframe/blob/main/src/camera/Insta360Reader.cpp): `src/camera/Insta360Reader.cpp`
- [Native Stitch Source](https://github.com/schabo/orbis-reframe/blob/main/src/stitch/NativeStitchSource.cpp): `src/stitch/NativeStitchSource.cpp`
- [Vulkan Stitcher](https://github.com/schabo/orbis-reframe/blob/main/src/render/VulkanFisheyeStitcher.cpp): `src/render/VulkanFisheyeStitcher.cpp`

### View and Rendering

- [Reframe Keyframes](https://github.com/schabo/orbis-reframe/blob/main/src/core/ReframeTrack.h): `src/core/ReframeTrack.h`
- [360 Viewport](https://github.com/schabo/orbis-reframe/blob/main/src/render/EquirectViewportWindow.h): `src/render/EquirectViewportWindow.h`

### Analysis and Effects

- [Gyro Stabilization](https://github.com/schabo/orbis-reframe/blob/main/lib/orbis-core/orbis-core/stab/GyroStabilizer.cpp): `lib/orbis-core/orbis-core/stab/GyroStabilizer.cpp`
- [Lens Calibration](https://github.com/schabo/orbis-reframe/blob/main/src/calib/LensFit.cpp): `src/calib/LensFit.cpp`
- [Subject Tracking](https://github.com/schabo/orbis-reframe/blob/main/src/track/SubjectTracker.cpp): `src/track/SubjectTracker.cpp`
- [Plate Privacy](https://github.com/schabo/orbis-reframe/blob/main/src/privacy/PlateScanner.cpp): `src/privacy/PlateScanner.cpp`
- [Audio Processing](https://github.com/schabo/orbis-reframe/blob/main/lib/orbis-core/orbis-core/audio/VoiceIsolator.cpp): `lib/orbis-core/orbis-core/audio/VoiceIsolator.cpp`

### Playback and Export

- [Playback Controller](https://github.com/schabo/orbis-reframe/blob/main/src/ui/PlaybackController.cpp): `src/ui/PlaybackController.cpp`
- [Export Controller](https://github.com/schabo/orbis-reframe/blob/main/src/ui/ReframeExportController.cpp): `src/ui/ReframeExportController.cpp`
- [Reframe Renderer](https://github.com/schabo/orbis-reframe/blob/main/src/export/ReframeRenderer.cpp): `src/export/ReframeRenderer.cpp`
- [Video Encoder](https://github.com/schabo/orbis-reframe/blob/main/src/export/ReframeFlatten.cpp): `src/export/ReframeFlatten.cpp`

### Other components

- **Editor User**

## Connections

- Editor User → Editor UI: edits
- Editor UI → Project Model: manages
- Project Model → Timeline: owns (evidence: `src/core/Project.cpp`)
- Project Model → Media Pool: owns (evidence: `src/core/Project.cpp`)
- Editor User → Camera Readers: imports clips
- Playback Controller → Native Stitch Source: opens source
- Native Stitch Source → Vulkan Stitcher: stitches frames
- Editor User → Reframe Keyframes: sets keyframes
- Editor User → 360 Viewport: steers view
- Editor User → Lens Calibration: calibrates lenses
- Editor User → Subject Tracking: tracks subjects
- Editor User → Plate Privacy: blurs plates
- Editor User → Audio Processing: processes audio
- Playback Controller → 360 Viewport: presents frames (evidence: `src/ui/PlaybackController.cpp`)
- Editor User → Export Controller: exports video
- Export Controller → Reframe Renderer: renders views (evidence: `src/ui/ReframeExportController.cpp`)
- Export Controller → Video Encoder: encodes frames (evidence: `src/ui/ReframeExportController.cpp`)
- Reframe Renderer → Video Encoder: renders output
