How storytold/filmcraft works
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: commands.rs Command engine · pipeline.rs Export pipeline · src/main.rs FilmCraft desktop · src/main.rs Headless CLI
Components 20
Applications
- FilmCraft desktop
apps/filmcraft/src/main.rs - Browser editor
apps/filmcraft-web/src/lib.rs - Headless CLI
apps/filmcraft-cli/src/main.rs
Editing
- Editing interface
crates/ui-egui/src/lib.rs - Command engine
crates/engine/src/commands.rs - Project model
crates/project/src/lib.rs - Timeline edits
crates/edit/src/lib.rs
Media and rendering
- Media ingest
crates/media/src/reader.rs - Media browser
crates/engine/src/media_browser.rs - Preview rendering
crates/engine/src/previews.rs - Frame compositor
crates/gpu/src/lib.rs - Color and audio
crates/render/src/effects.rs
Output and integration
- Export pipeline
crates/export/src/pipeline.rs - Export settings
crates/export/src/settings.rs - Media codecs
crates/codecs/src/lib.rs - Project interchange
crates/interchange/src/lib.rs - Agent automation
crates/automation/src/server.rs - Save and recovery
crates/format/src/autosave.rs
Other components
- Editor user
- Script or agent
Connections 20
- 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
crates/engine/src/export_tools.rs - Media browser → Media ingest: opens media
- Command engine → Preview rendering: requests previews
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
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
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