# storytold/filmcraft architecture

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

- Interactive diagram: https://gitdiagram.com/storytold/filmcraft
- Repository: https://github.com/storytold/filmcraft

## Overview

FilmCraft is a professional non-linear video editor for desktop and browser, with a headless CLI for scripts and agents. Its main workflow is to import media, arrange and refine a project on a timeline, preview composited frames, and export a finished sequence. The graph includes the project/editing core and major documented capabilities such as color, audio, interchange, and automation. Some domain links are dashed because the sampled source does not show the runtime wiring; README statements support the product-level workflow.

Main entry points: [`crates/engine/src/commands.rs`](https://github.com/storytold/filmcraft/blob/main/crates/engine/src/commands.rs) (Command engine), [`crates/export/src/pipeline.rs`](https://github.com/storytold/filmcraft/blob/main/crates/export/src/pipeline.rs) (Export pipeline), [`apps/filmcraft/src/main.rs`](https://github.com/storytold/filmcraft/blob/main/apps/filmcraft/src/main.rs) (FilmCraft desktop), [`apps/filmcraft-cli/src/main.rs`](https://github.com/storytold/filmcraft/blob/main/apps/filmcraft-cli/src/main.rs) (Headless CLI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Applications"]
  node_editor["FilmCraft desktop<br/>[main.rs]"]
  node_webapp["Browser editor<br/>[lib.rs]"]
  node_cli["Headless CLI<br/>[main.rs]"]
end

subgraph group_edit["Editing"]
  node_ui["Editing interface<br/>[lib.rs]"]
  node_engine["Command engine<br/>[commands.rs]"]
  node_project["Project model<br/>[lib.rs]"]
  node_timeline["Timeline edits<br/>[lib.rs]"]
end

subgraph group_media["Media and rendering"]
  node_media["Media ingest<br/>[reader.rs]"]
  node_browser["Media browser<br/>[media_browser.rs]"]
  node_preview["Preview rendering<br/>[previews.rs]"]
  node_renderer["Frame compositor<br/>[lib.rs]"]
  node_coloraudio["Color and audio<br/>[effects.rs]"]
end

subgraph group_output["Output and integration"]
  node_export["Export pipeline<br/>[pipeline.rs]"]
  node_settings["Export settings<br/>[settings.rs]"]
  node_formats["Media codecs<br/>[lib.rs]"]
  node_interchange["Project interchange<br/>[lib.rs]"]
  node_automation["Agent automation<br/>[server.rs]"]
  node_autosave[("Save and recovery<br/>[autosave.rs]")]
end

node_user(("Editor user"))
node_agent(("Script or agent"))

node_user -->|"edits with"| node_editor
node_editor -.->|"presents interface"| node_ui
node_ui -.->|"issues commands"| node_engine
node_engine -.->|"updates project"| node_project
node_engine -.->|"applies edits"| node_timeline
node_engine -->|"supports browsing"| node_browser
node_browser -.->|"opens media"| node_media
node_engine -->|"requests previews"| node_preview
node_preview -.->|"renders frames"| node_renderer
node_project -.->|"stores effects"| node_coloraudio
node_engine -.->|"starts export"| node_export
node_export -->|"resolves settings"| node_settings
node_export -.->|"renders sequence"| node_renderer
node_export -.->|"encodes output"| node_formats
node_engine -.->|"exchanges projects"| node_interchange
node_engine -.->|"saves recovery data"| node_autosave
node_agent -->|"drives commands"| node_cli
node_cli -.->|"executes commands"| node_engine
node_agent -.->|"issues requests"| node_automation
node_editor -->|"also runs in browser"| node_webapp

click node_editor "https://github.com/storytold/filmcraft/blob/main/apps/filmcraft/src/main.rs"
click node_webapp "https://github.com/storytold/filmcraft/blob/main/apps/filmcraft-web/src/lib.rs"
click node_cli "https://github.com/storytold/filmcraft/blob/main/apps/filmcraft-cli/src/main.rs"
click node_ui "https://github.com/storytold/filmcraft/blob/main/crates/ui-egui/src/lib.rs"
click node_engine "https://github.com/storytold/filmcraft/blob/main/crates/engine/src/commands.rs"
click node_project "https://github.com/storytold/filmcraft/blob/main/crates/project/src/lib.rs"
click node_timeline "https://github.com/storytold/filmcraft/blob/main/crates/edit/src/lib.rs"
click node_media "https://github.com/storytold/filmcraft/blob/main/crates/media/src/reader.rs"
click node_browser "https://github.com/storytold/filmcraft/blob/main/crates/engine/src/media_browser.rs"
click node_preview "https://github.com/storytold/filmcraft/blob/main/crates/engine/src/previews.rs"
click node_renderer "https://github.com/storytold/filmcraft/blob/main/crates/gpu/src/lib.rs"
click node_coloraudio "https://github.com/storytold/filmcraft/blob/main/crates/render/src/effects.rs"
click node_export "https://github.com/storytold/filmcraft/blob/main/crates/export/src/pipeline.rs"
click node_settings "https://github.com/storytold/filmcraft/blob/main/crates/export/src/settings.rs"
click node_formats "https://github.com/storytold/filmcraft/blob/main/crates/codecs/src/lib.rs"
click node_interchange "https://github.com/storytold/filmcraft/blob/main/crates/interchange/src/lib.rs"
click node_automation "https://github.com/storytold/filmcraft/blob/main/crates/automation/src/server.rs"
click node_autosave "https://github.com/storytold/filmcraft/blob/main/crates/format/src/autosave.rs"

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_webapp,node_cli,node_user toneBlue
class node_ui,node_engine,node_project,node_timeline toneAmber
class node_media,node_browser,node_preview,node_renderer,node_coloraudio toneMint
class node_export,node_settings,node_formats,node_interchange,node_automation,node_autosave toneRose
class node_agent toneIndigo
```

## Components

### Applications

- [FilmCraft desktop](https://github.com/storytold/filmcraft/blob/main/apps/filmcraft/src/main.rs): `apps/filmcraft/src/main.rs`
- [Browser editor](https://github.com/storytold/filmcraft/blob/main/apps/filmcraft-web/src/lib.rs): `apps/filmcraft-web/src/lib.rs`
- [Headless CLI](https://github.com/storytold/filmcraft/blob/main/apps/filmcraft-cli/src/main.rs): `apps/filmcraft-cli/src/main.rs`

### Editing

- [Editing interface](https://github.com/storytold/filmcraft/blob/main/crates/ui-egui/src/lib.rs): `crates/ui-egui/src/lib.rs`
- [Command engine](https://github.com/storytold/filmcraft/blob/main/crates/engine/src/commands.rs): `crates/engine/src/commands.rs`
- [Project model](https://github.com/storytold/filmcraft/blob/main/crates/project/src/lib.rs): `crates/project/src/lib.rs`
- [Timeline edits](https://github.com/storytold/filmcraft/blob/main/crates/edit/src/lib.rs): `crates/edit/src/lib.rs`

### Media and rendering

- [Media ingest](https://github.com/storytold/filmcraft/blob/main/crates/media/src/reader.rs): `crates/media/src/reader.rs`
- [Media browser](https://github.com/storytold/filmcraft/blob/main/crates/engine/src/media_browser.rs): `crates/engine/src/media_browser.rs`
- [Preview rendering](https://github.com/storytold/filmcraft/blob/main/crates/engine/src/previews.rs): `crates/engine/src/previews.rs`
- [Frame compositor](https://github.com/storytold/filmcraft/blob/main/crates/gpu/src/lib.rs): `crates/gpu/src/lib.rs`
- [Color and audio](https://github.com/storytold/filmcraft/blob/main/crates/render/src/effects.rs): `crates/render/src/effects.rs`

### Output and integration

- [Export pipeline](https://github.com/storytold/filmcraft/blob/main/crates/export/src/pipeline.rs): `crates/export/src/pipeline.rs`
- [Export settings](https://github.com/storytold/filmcraft/blob/main/crates/export/src/settings.rs): `crates/export/src/settings.rs`
- [Media codecs](https://github.com/storytold/filmcraft/blob/main/crates/codecs/src/lib.rs): `crates/codecs/src/lib.rs`
- [Project interchange](https://github.com/storytold/filmcraft/blob/main/crates/interchange/src/lib.rs): `crates/interchange/src/lib.rs`
- [Agent automation](https://github.com/storytold/filmcraft/blob/main/crates/automation/src/server.rs): `crates/automation/src/server.rs`
- [Save and recovery](https://github.com/storytold/filmcraft/blob/main/crates/format/src/autosave.rs): `crates/format/src/autosave.rs`

### Other components

- **Editor user**
- **Script or agent**

## Connections

- Editor user → FilmCraft desktop: edits with
- FilmCraft desktop → Editing interface: presents interface
- Editing interface → Command engine: issues commands
- Command engine → Project model: updates project
- Command engine → Timeline edits: applies edits
- Command engine → Media browser: supports browsing (evidence: `crates/engine/src/export_tools.rs`)
- Media browser → Media ingest: opens media
- Command engine → Preview rendering: requests previews (evidence: `crates/engine/src/project_manager.rs`)
- Preview rendering → Frame compositor: renders frames
- Project model → Color and audio: stores effects
- Command engine → Export pipeline: starts export
- Export pipeline → Export settings: resolves settings (evidence: `crates/export/src/pipeline.rs`)
- Export pipeline → Frame compositor: renders sequence
- Export pipeline → Media codecs: encodes output
- Command engine → Project interchange: exchanges projects
- Command engine → Save and recovery: saves recovery data
- Script or agent → Headless CLI: drives commands (evidence: `apps/filmcraft-cli/src/main.rs`)
- Headless CLI → Command engine: executes commands
- Script or agent → Agent automation: issues requests
- FilmCraft desktop → Browser editor: also runs in browser
