How b-editor/beutl works
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: Beutl.ProjectSystem Timeline editing · EngineObject.cs Engine objects · ShaderGraphPipeline.cs GPU rendering · EncodingController.cs Video export
Components 26
Editing experience
- Beutl app
src/Beutl - Timeline editing
src/Beutl.ProjectSystem - Undo history
src/Beutl.Editor/HistoryManager.cs - Version control
src/Beutl.Configuration/VersionControlConfig.cs
Composition and rendering
- Node graphs
src/Beutl.NodeGraph/EnginePropertyBackedInputPort.cs - Engine objects
src/Beutl.Engine/Engine/EngineObject.cs - Core objects
src/Beutl.Core/CoreObject.cs - Expressions
src/Beutl.Core/Expressions/IExpression.cs - GPU rendering
src/Beutl.Engine/Graphics/Shaders/Graph/ShaderGraphPipeline.cs - Media time
src/Beutl.Core/MediaTime.cs - Graphics size
src/Beutl.Engine/Graphics/Size.cs - JSON type tokens
src/Beutl.Core/JsonDiscriminator/Token.cs
Media and export
- Audio tools
src/Beutl.Engine/Audio/AudioBuffer.cs - Media resources
src/Beutl.Engine/Media/Bitmap.cs - Video export
src/Beutl.Extensibility/EncodingController.cs - FFmpeg worker
src/Beutl.FFmpegWorker/Handlers/CodecQueryHandler.cs - Worker IPC
src/Beutl.FFmpegIpc/Protocol/MessageType.cs - Audio samples
src/Beutl.Extensibility/ISampleProvider.cs - Video frames
src/Beutl.Extensibility/IFrameProvider.cs
Platform and assistance
- Extensions
src/Beutl.Api/Services/PackageManager.cs - AI agent editing
src/Beutl.AgentToolkit/Tools/EditTools.cs - Agent edit recording
src/Beutl.AgentToolkit/Sessions/RecordingPipeline.cs - Cloud storage
src/Beutl/ViewModels/Tools/CloudStorageViewModel.Transfers.cs - Beutl services
src/Beutl.Api/BeutlApiApplication.cs - Thread dispatcher
src/Beutl.Threading/Dispatcher.cs
Other components
- Editor
Connections 29
- Editor → Beutl app: edits with
README.md - Beutl app → Timeline editing: edits layers
README.md - Timeline editing → Node graphs: builds visuals
README.md - Timeline editing → Engine objects: composes objects
- Timeline editing → Undo history: supports undo
README.md - Timeline editing → Version control: tracks project
README.md - Node graphs → Expressions: binds expressions
src/Beutl.NodeGraph/EnginePropertyBackedInputPort.cs - Engine objects → Core objects: extends core
src/Beutl.Engine/Engine/EngineObject.cs - Engine objects → Expressions: uses expressions
src/Beutl.Engine/Engine/EngineObject.cs - Engine objects → Media time: uses time
src/Beutl.Engine/Engine/EngineObject.cs - Node graphs → Engine objects: adapts properties
src/Beutl.NodeGraph/EnginePropertyBackedInputPort.cs - Timeline editing → GPU rendering: previews composition
README.md - GPU rendering → Media resources: renders media
- Timeline editing → Audio tools: mixes audio
README.md - GPU rendering → Video export: exports composition
README.md - Video export → Video frames: consumes frames
src/Beutl.Extensibility/EncodingController.cs - Video export → Audio samples: consumes samples
src/Beutl.Extensibility/EncodingController.cs - Video export → FFmpeg worker: encodes media
- FFmpeg worker → Worker IPC: communicates via
README.md - Beutl app → Extensions: loads extensions
README.md - Editor → AI agent editing: requests edits
README.md - AI agent editing → Timeline editing: edits project
README.md - AI agent editing → Agent edit recording: records edits
src/Beutl.AgentToolkit/Sessions/RecordingPipeline.cs - Agent edit recording → Undo history: shares undo history
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