# b-editor/beutl architecture

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

- Interactive diagram: https://gitdiagram.com/b-editor/beutl
- Repository: https://github.com/b-editor/beutl

## Overview

Beutl is a cross-platform video editor and compositor. Users arrange media, text, shapes, and audio into layered, animated compositions, preview the result, and export video; the README also documents node graphs, effects, audio tools, extensions, version control, and AI-assisted editing. The graph preserves these major capabilities and core runtime modules. Several feature implementations were not sampled, so README-backed relationships are cited to the README; unsampled internal call paths are not inferred.

Main entry points: [`src/Beutl.ProjectSystem`](https://github.com/b-editor/beutl/tree/main/src/Beutl.ProjectSystem) (Timeline editing), [`src/Beutl.Engine/Engine/EngineObject.cs`](https://github.com/b-editor/beutl/blob/main/src/Beutl.Engine/Engine/EngineObject.cs) (Engine objects), [`src/Beutl.Engine/Graphics/Shaders/Graph/ShaderGraphPipeline.cs`](https://github.com/b-editor/beutl/blob/main/src/Beutl.Engine/Graphics/Shaders/Graph/ShaderGraphPipeline.cs) (GPU rendering), [`src/Beutl.Extensibility/EncodingController.cs`](https://github.com/b-editor/beutl/blob/main/src/Beutl.Extensibility/EncodingController.cs) (Video export)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_editor["Editing experience"]
  node_app["Beutl app"]
  node_timeline["Timeline editing"]
  node_history["Undo history<br/>[HistoryManager.cs]"]
  node_versioncontrol["Version control"]
end

subgraph group_composition["Composition and rendering"]
  node_nodegraph["Node graphs"]
  node_engineobject["Engine objects<br/>[EngineObject.cs]"]
  node_coreobject["Core objects<br/>[CoreObject.cs]"]
  node_expressions["Expressions<br/>[IExpression.cs]"]
  node_gpu["GPU rendering"]
  node_mediatime["Media time<br/>[MediaTime.cs]"]
  node_size["Graphics size<br/>[Size.cs]"]
  node_token["JSON type tokens<br/>[Token.cs]"]
end

subgraph group_media["Media and export"]
  node_audio["Audio tools<br/>[AudioBuffer.cs]"]
  node_mediaresources["Media resources<br/>[Bitmap.cs]"]
  node_export["Video export"]
  node_ffmpeg["FFmpeg worker"]
  node_ipc["Worker IPC<br/>[MessageType.cs]"]
  node_sampleprovider["Audio samples<br/>[ISampleProvider.cs]"]
  node_frameprovider["Video frames<br/>[IFrameProvider.cs]"]
end

subgraph group_platform["Platform and assistance"]
  node_extensions["Extensions<br/>[PackageManager.cs]"]
  node_agent["AI agent editing<br/>[EditTools.cs]"]
  node_agenthistory["Agent edit recording"]
  node_cloud["Cloud storage"]
  node_api["Beutl services"]
  node_dispatch["Thread dispatcher<br/>[Dispatcher.cs]"]
end

node_user(("Editor"))

node_user -->|"edits with"| node_app
node_app -->|"edits layers"| node_timeline
node_timeline -->|"builds visuals"| node_nodegraph
node_timeline -.->|"composes objects"| node_engineobject
node_timeline -->|"supports undo"| node_history
node_timeline -->|"tracks project"| node_versioncontrol
node_nodegraph -->|"binds expressions"| node_expressions
node_engineobject -->|"extends core"| node_coreobject
node_engineobject -->|"uses expressions"| node_expressions
node_engineobject -->|"uses time"| node_mediatime
node_nodegraph -->|"adapts properties"| node_engineobject
node_timeline -->|"previews composition"| node_gpu
node_gpu -.->|"renders media"| node_mediaresources
node_timeline -->|"mixes audio"| node_audio
node_gpu -->|"exports composition"| node_export
node_export -->|"consumes frames"| node_frameprovider
node_export -->|"consumes samples"| node_sampleprovider
node_export -.->|"encodes media"| node_ffmpeg
node_ffmpeg -->|"communicates via"| node_ipc
node_app -->|"loads extensions"| node_extensions
node_user -->|"requests edits"| node_agent
node_agent -->|"edits project"| node_timeline
node_agent -->|"records edits"| node_agenthistory
node_agenthistory -->|"shares undo history"| node_history
node_user -.->|"manages files"| node_cloud
node_cloud -.->|"transfers files"| node_api
node_engineobject -.->|"dispatches resources"| node_dispatch
node_gpu -.->|"uses dimensions"| node_size
node_coreobject -.->|"serializes types"| node_token

click node_app "https://github.com/b-editor/beutl/tree/main/src/Beutl"
click node_timeline "https://github.com/b-editor/beutl/tree/main/src/Beutl.ProjectSystem"
click node_history "https://github.com/b-editor/beutl/blob/main/src/Beutl.Editor/HistoryManager.cs"
click node_versioncontrol "https://github.com/b-editor/beutl/blob/main/src/Beutl.Configuration/VersionControlConfig.cs"
click node_nodegraph "https://github.com/b-editor/beutl/blob/main/src/Beutl.NodeGraph/EnginePropertyBackedInputPort.cs"
click node_engineobject "https://github.com/b-editor/beutl/blob/main/src/Beutl.Engine/Engine/EngineObject.cs"
click node_coreobject "https://github.com/b-editor/beutl/blob/main/src/Beutl.Core/CoreObject.cs"
click node_expressions "https://github.com/b-editor/beutl/blob/main/src/Beutl.Core/Expressions/IExpression.cs"
click node_gpu "https://github.com/b-editor/beutl/blob/main/src/Beutl.Engine/Graphics/Shaders/Graph/ShaderGraphPipeline.cs"
click node_audio "https://github.com/b-editor/beutl/blob/main/src/Beutl.Engine/Audio/AudioBuffer.cs"
click node_mediaresources "https://github.com/b-editor/beutl/blob/main/src/Beutl.Engine/Media/Bitmap.cs"
click node_export "https://github.com/b-editor/beutl/blob/main/src/Beutl.Extensibility/EncodingController.cs"
click node_ffmpeg "https://github.com/b-editor/beutl/blob/main/src/Beutl.FFmpegWorker/Handlers/CodecQueryHandler.cs"
click node_ipc "https://github.com/b-editor/beutl/blob/main/src/Beutl.FFmpegIpc/Protocol/MessageType.cs"
click node_extensions "https://github.com/b-editor/beutl/blob/main/src/Beutl.Api/Services/PackageManager.cs"
click node_agent "https://github.com/b-editor/beutl/blob/main/src/Beutl.AgentToolkit/Tools/EditTools.cs"
click node_agenthistory "https://github.com/b-editor/beutl/blob/main/src/Beutl.AgentToolkit/Sessions/RecordingPipeline.cs"
click node_cloud "https://github.com/b-editor/beutl/blob/main/src/Beutl/ViewModels/Tools/CloudStorageViewModel.Transfers.cs"
click node_api "https://github.com/b-editor/beutl/blob/main/src/Beutl.Api/BeutlApiApplication.cs"
click node_dispatch "https://github.com/b-editor/beutl/blob/main/src/Beutl.Threading/Dispatcher.cs"
click node_mediatime "https://github.com/b-editor/beutl/blob/main/src/Beutl.Core/MediaTime.cs"
click node_size "https://github.com/b-editor/beutl/blob/main/src/Beutl.Engine/Graphics/Size.cs"
click node_token "https://github.com/b-editor/beutl/blob/main/src/Beutl.Core/JsonDiscriminator/Token.cs"
click node_sampleprovider "https://github.com/b-editor/beutl/blob/main/src/Beutl.Extensibility/ISampleProvider.cs"
click node_frameprovider "https://github.com/b-editor/beutl/blob/main/src/Beutl.Extensibility/IFrameProvider.cs"

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_app,node_timeline,node_history,node_versioncontrol toneBlue
class node_nodegraph,node_engineobject,node_coreobject,node_expressions,node_gpu,node_mediatime,node_size,node_token toneAmber
class node_audio,node_mediaresources,node_export,node_ffmpeg,node_ipc,node_sampleprovider,node_frameprovider toneMint
class node_extensions,node_agent,node_agenthistory,node_cloud,node_api,node_dispatch toneRose
class node_user toneIndigo
```

## Components

### Editing experience

- [Beutl app](https://github.com/b-editor/beutl/tree/main/src/Beutl): `src/Beutl`
- [Timeline editing](https://github.com/b-editor/beutl/tree/main/src/Beutl.ProjectSystem): `src/Beutl.ProjectSystem`
- [Undo history](https://github.com/b-editor/beutl/blob/main/src/Beutl.Editor/HistoryManager.cs): `src/Beutl.Editor/HistoryManager.cs`
- [Version control](https://github.com/b-editor/beutl/blob/main/src/Beutl.Configuration/VersionControlConfig.cs): `src/Beutl.Configuration/VersionControlConfig.cs`

### Composition and rendering

- [Node graphs](https://github.com/b-editor/beutl/blob/main/src/Beutl.NodeGraph/EnginePropertyBackedInputPort.cs): `src/Beutl.NodeGraph/EnginePropertyBackedInputPort.cs`
- [Engine objects](https://github.com/b-editor/beutl/blob/main/src/Beutl.Engine/Engine/EngineObject.cs): `src/Beutl.Engine/Engine/EngineObject.cs`
- [Core objects](https://github.com/b-editor/beutl/blob/main/src/Beutl.Core/CoreObject.cs): `src/Beutl.Core/CoreObject.cs`
- [Expressions](https://github.com/b-editor/beutl/blob/main/src/Beutl.Core/Expressions/IExpression.cs): `src/Beutl.Core/Expressions/IExpression.cs`
- [GPU rendering](https://github.com/b-editor/beutl/blob/main/src/Beutl.Engine/Graphics/Shaders/Graph/ShaderGraphPipeline.cs): `src/Beutl.Engine/Graphics/Shaders/Graph/ShaderGraphPipeline.cs`
- [Media time](https://github.com/b-editor/beutl/blob/main/src/Beutl.Core/MediaTime.cs): `src/Beutl.Core/MediaTime.cs`
- [Graphics size](https://github.com/b-editor/beutl/blob/main/src/Beutl.Engine/Graphics/Size.cs): `src/Beutl.Engine/Graphics/Size.cs`
- [JSON type tokens](https://github.com/b-editor/beutl/blob/main/src/Beutl.Core/JsonDiscriminator/Token.cs): `src/Beutl.Core/JsonDiscriminator/Token.cs`

### Media and export

- [Audio tools](https://github.com/b-editor/beutl/blob/main/src/Beutl.Engine/Audio/AudioBuffer.cs): `src/Beutl.Engine/Audio/AudioBuffer.cs`
- [Media resources](https://github.com/b-editor/beutl/blob/main/src/Beutl.Engine/Media/Bitmap.cs): `src/Beutl.Engine/Media/Bitmap.cs`
- [Video export](https://github.com/b-editor/beutl/blob/main/src/Beutl.Extensibility/EncodingController.cs): `src/Beutl.Extensibility/EncodingController.cs`
- [FFmpeg worker](https://github.com/b-editor/beutl/blob/main/src/Beutl.FFmpegWorker/Handlers/CodecQueryHandler.cs): `src/Beutl.FFmpegWorker/Handlers/CodecQueryHandler.cs`
- [Worker IPC](https://github.com/b-editor/beutl/blob/main/src/Beutl.FFmpegIpc/Protocol/MessageType.cs): `src/Beutl.FFmpegIpc/Protocol/MessageType.cs`
- [Audio samples](https://github.com/b-editor/beutl/blob/main/src/Beutl.Extensibility/ISampleProvider.cs): `src/Beutl.Extensibility/ISampleProvider.cs`
- [Video frames](https://github.com/b-editor/beutl/blob/main/src/Beutl.Extensibility/IFrameProvider.cs): `src/Beutl.Extensibility/IFrameProvider.cs`

### Platform and assistance

- [Extensions](https://github.com/b-editor/beutl/blob/main/src/Beutl.Api/Services/PackageManager.cs): `src/Beutl.Api/Services/PackageManager.cs`
- [AI agent editing](https://github.com/b-editor/beutl/blob/main/src/Beutl.AgentToolkit/Tools/EditTools.cs): `src/Beutl.AgentToolkit/Tools/EditTools.cs`
- [Agent edit recording](https://github.com/b-editor/beutl/blob/main/src/Beutl.AgentToolkit/Sessions/RecordingPipeline.cs): `src/Beutl.AgentToolkit/Sessions/RecordingPipeline.cs`
- [Cloud storage](https://github.com/b-editor/beutl/blob/main/src/Beutl/ViewModels/Tools/CloudStorageViewModel.Transfers.cs): `src/Beutl/ViewModels/Tools/CloudStorageViewModel.Transfers.cs`
- [Beutl services](https://github.com/b-editor/beutl/blob/main/src/Beutl.Api/BeutlApiApplication.cs): `src/Beutl.Api/BeutlApiApplication.cs`
- [Thread dispatcher](https://github.com/b-editor/beutl/blob/main/src/Beutl.Threading/Dispatcher.cs): `src/Beutl.Threading/Dispatcher.cs`

### Other components

- **Editor**

## Connections

- Editor → Beutl app: edits with (evidence: `README.md`)
- Beutl app → Timeline editing: edits layers (evidence: `README.md`)
- Timeline editing → Node graphs: builds visuals (evidence: `README.md`)
- Timeline editing → Engine objects: composes objects
- Timeline editing → Undo history: supports undo (evidence: `README.md`)
- Timeline editing → Version control: tracks project (evidence: `README.md`)
- Node graphs → Expressions: binds expressions (evidence: `src/Beutl.NodeGraph/EnginePropertyBackedInputPort.cs`)
- Engine objects → Core objects: extends core (evidence: `src/Beutl.Engine/Engine/EngineObject.cs`)
- Engine objects → Expressions: uses expressions (evidence: `src/Beutl.Engine/Engine/EngineObject.cs`)
- Engine objects → Media time: uses time (evidence: `src/Beutl.Engine/Engine/EngineObject.cs`)
- Node graphs → Engine objects: adapts properties (evidence: `src/Beutl.NodeGraph/EnginePropertyBackedInputPort.cs`)
- Timeline editing → GPU rendering: previews composition (evidence: `README.md`)
- GPU rendering → Media resources: renders media
- Timeline editing → Audio tools: mixes audio (evidence: `README.md`)
- GPU rendering → Video export: exports composition (evidence: `README.md`)
- Video export → Video frames: consumes frames (evidence: `src/Beutl.Extensibility/EncodingController.cs`)
- Video export → Audio samples: consumes samples (evidence: `src/Beutl.Extensibility/EncodingController.cs`)
- Video export → FFmpeg worker: encodes media
- FFmpeg worker → Worker IPC: communicates via (evidence: `README.md`)
- Beutl app → Extensions: loads extensions (evidence: `README.md`)
- Editor → AI agent editing: requests edits (evidence: `README.md`)
- AI agent editing → Timeline editing: edits project (evidence: `README.md`)
- AI agent editing → Agent edit recording: records edits (evidence: `src/Beutl.AgentToolkit/Sessions/RecordingPipeline.cs`)
- Agent edit recording → Undo history: shares undo history (evidence: `README.md`)
- Editor → Cloud storage: manages files
- Cloud storage → Beutl services: transfers files
- Engine objects → Thread dispatcher: dispatches resources
- GPU rendering → Graphics size: uses dimensions
- Core objects → JSON type tokens: serializes types
