How storytold/effectcraft works
EffectCraft is a motion-graphics compositor for building animated compositions, applying effects, previewing frames, and exporting media. The principal workflow is documented in the README; the source index and excerpts additionally establish browser persistence, file handling, worker offload, and rendering internals. Several major capabilities are documented but their implementation was not sampled, so those subsystem links cite the README rather than implying that their source was inspected.
Main entry points: src/lib.rs Project model · app.rs Browser app · commands Command registry · src/lib.rs CPU compositor
Components 22
User interfaces
- Desktop shell
apps/effectcraft/src/main.rs - Browser app
apps/effectcraft-web/src/app.rs - Editor panels
crates/ui-egui/src/panels - Command-line client
apps/effectcraft-cli/src/main.rs
Composition authoring
- Command registry
crates/engine/src/commands - Project model
crates/project/src/lib.rs - Keyframes
crates/keyframe/src/lib.rs - Expressions
crates/expr/src/runtime.rs - Effect catalog
crates/effects/src/catalog.rs - Tracking and masks
crates/track/src
Compositing and export
- Media decoding
crates/media/src - CPU compositor
crates/render/src/lib.rs - GPU pipelines
crates/gpu/src/context.rs - Render queue
crates/project/src/render_queue.rs - Export pipeline
crates/export/src/pipeline.rs - Lottie interchange
crates/lottie/src
Storage and automation
- Browser file service
apps/effectcraft-web/src/files.rs - Browser file store
apps/effectcraft-web/src/store.rs - Browser persistence
apps/effectcraft-web/src/persist.rs - Web workers
apps/effectcraft-web/src/worker.rs - Agent control server
crates/automation/src/server.rs
Other components
- Artist
Connections 25
- Artist → Desktop shell: opens project
- Artist → Browser app: creates composition
- Desktop shell → Editor panels: presents editor
- Browser app → Editor panels: presents editor
- Editor panels → Command registry: dispatches actions
- Command-line client → Command registry: runs commands
- Agent control server → Command registry: exposes actions
- Command registry → Project model: edits document
- Project model → Keyframes: stores animation
- Project model → Expressions: evaluates expressions
- Project model → Effect catalog: stacks effects
- Command registry → Tracking and masks: runs tracking tools
- Project model → CPU compositor: renders composition
crates/render/src/lib.rs - CPU compositor → Media decoding: requests footage
- CPU compositor → Effect catalog: applies effects
- CPU compositor → GPU pipelines: dispatches kernels
- Project model → Render queue: defines render jobs
crates/project/src/lib.rs - Render queue → Export pipeline: exports output
- Project model → Lottie interchange: imports and exports
- Browser app → Browser file service: reads and downloads
apps/effectcraft-web/src/app.rs - Browser file service → Browser file store: reads and writes
apps/effectcraft-web/src/files.rs - Browser app → Browser persistence: restores session
apps/effectcraft-web/src/app.rs - Browser persistence → Browser file store: flushes changes
apps/effectcraft-web/src/persist.rs - Browser app → Web workers: offloads jobs
apps/effectcraft-web/src/app.rs - Web workers → Browser file service: transfers job files
apps/effectcraft-web/src/worker.rs