How velornlabs/velorn works
Velorn is a desktop AI video workstation. A creator starts or opens a project, plans or generates media, organizes the resulting assets, edits a multitrack timeline, previews and captions it, then exports a finished render. The editor also supports standalone imports, stock media, and MCP-driven editorial actions. Generation is an optional branch requiring a local ComfyUI instance; documented cloud and custom workflow routes extend it. The graph combines README-documented product capabilities with source-index and excerpt evidence; some unsampled subsystem links are documented rather than verified in code.
Main entry points: timelineStore.js Timeline Editing · assetsStore.js Asset Library · projectStore.js Project Management · pexelsStock.js Stock Search
Components 21
Project and Editor
- Desktop Workspace
src/App.jsx - Project Management
src/stores/projectStore.js - Project Files
src/services/fileSystem.js - Asset Library
src/stores/assetsStore.js - Timeline Editing
src/stores/timelineStore.js
Planning and Generation
- Generate Workspace
src/components/GenerateWorkspace.jsx - Guided Creators
src/components/generate/MusicVideoEasyMode.jsx - Workflow Setup
src/services/workflowSetupManager.js - Stock Search
src/services/pexelsStock.js
Preview and Finishing
- Timeline Preview
src/components/PreviewPanel.jsx - Canvas Compositor
src/components/CanvasPreviewRenderer.jsx - Preview Cache
src/services/previewCache.js - Caption Workflow
src/services/captionTranscription.js - Timeline Export
src/services/exporter.js - Export Controls
src/components/ExportPanel.jsx
External Integrations
- ComfyUI Client
src/services/comfyui.js - ComfyUI Server
- MCP Editorial Tools
electron/mcpServer.js - Pexels
Other components
- Creator
- Agent Client
Connections 28
- Creator → Desktop Workspace: opens and edits
README.md - Desktop Workspace → Project Management: manages projects
src/App.jsx - Project Management → Project Files: loads and saves
src/stores/projectStore.js - Project Management → Timeline Editing: hydrates project
src/stores/projectStore.js - Project Management → Asset Library: hydrates project
src/stores/projectStore.js - Creator → Generate Workspace: starts generation
README.md - Creator → Guided Creators: plans creation
README.md - Guided Creators → Generate Workspace: prepares workflows
- Generate Workspace → Workflow Setup: checks workflows
- Workflow Setup → ComfyUI Client: checks and loads
src/services/workflowSetupManager.js - ComfyUI Client → ComfyUI Server: submits jobs
README.md - ComfyUI Server → Asset Library: returns outputs
README.md - Creator → Stock Search: searches media
README.md - Stock Search → Pexels: searches catalog
README.md - Stock Search → Asset Library: imports media
README.md - Creator → Timeline Editing: edits clips
README.md - Asset Library → Timeline Editing: supplies media
README.md - Timeline Editing → Timeline Preview: drives playback
src/components/PreviewPanel.jsx - Timeline Preview → Canvas Compositor: renders frames
src/components/PreviewPanel.jsx - Timeline Preview → Preview Cache: renders cached range
src/components/PreviewPanel.jsx - Timeline Editing → Caption Workflow: transcribes audio
README.md - Caption Workflow → Timeline Editing: adds styled captions
README.md - Creator → Export Controls: configures render
README.md - Export Controls → Timeline Export: starts render
- Timeline Export → Timeline Editing: reads edit state
src/services/exporter.js - Timeline Export → Asset Library: reads source media
src/services/exporter.js - Agent Client → MCP Editorial Tools: requests edits
README.md - MCP Editorial Tools → Timeline Editing: controls editorial state
README.md