How martindelophy/ai-video-editor works
Timeline Studio is a local-first browser video editor. Users import media, arrange and refine clips on a multitrack timeline, apply AI-assisted audio, caption, visual, and avatar workflows, preview the composition, then export a portable result. The map includes the documented AI branches and the separate MCP editing interface. Source excerpts are partial, so uncertain connections among UI hooks, workers, and export are omitted; README capabilities identify unsampled feature branches.
Main entry points: App.jsx Editor app · PreviewStage.jsx Preview stage · useVoiceGeneration.js Voice generation · useAiMusicGeneration.js AI music
Components 24
Editing and preview
- Editor app
src/App.jsx - Timeline UI
src/components/Timeline.jsx - Preview stage
src/components/PreviewStage.jsx - Timeline model
src/hooks/useTimelineModel.js
AI media workflows
- Automatic captions
src/hooks/useAutoCaptions.js - Voice generation
src/hooks/useVoiceGeneration.js - Voice profiles
src/lib/voiceProfileStorage.js - AI music
src/hooks/useAiMusicGeneration.js - Music inference
src/workers/ai-music.worker.js - AI repair
src/hooks/useMiganRepair.js - Video restoration
src/hooks/useNanoVsrRestoration.js - Smart framing
src/hooks/useSmartFrame.js - Visual analysis
src/hooks/useVisionAnalysis.js - Vocal separation
src/hooks/useVocalSeparation.js - Talking avatar
src/hooks/useAvatarGeneration.js - LivePortrait inference
src/workers/liveportrait.worker.js
Projects and export
- Project commands
src/lib/projectCommandEngine.js - Video export
src/hooks/useVideoExport.js - Project archives
src/lib/projectArchive.js
External editing interfaces
- MCP editing server
skills/edit-timeline-studio/mcp/server.mjs - Timeline command
scripts/timeline-command.mjs
Other components
- Editor user
- Model hosts
- Browser runtime
Connections 26
- Editor user → Editor app: edits media
- Editor app → Timeline UI: renders timeline
- Editor app → Preview stage: renders preview
- Editor app → Timeline model: uses timeline state
- Preview stage → Timeline model: shows composition
- Editor app → Automatic captions: requests captions
- Editor app → Voice generation: requests voiceover
- Voice generation → Voice profiles: loads profiles
- Editor app → AI music: requests music
- AI music → Music inference: dispatches inference
- Music inference → Model hosts: fetches models
- Editor app → AI repair: requests repair
- Editor app → Video restoration: requests restoration
- Editor app → Smart framing: requests framing
- Editor app → Visual analysis: requests analysis
- Editor app → Vocal separation: requests separation
- Editor app → Talking avatar: requests avatar
- Talking avatar → LivePortrait inference: dispatches rendering
- LivePortrait inference → Model hosts: fetches models
- Editor app → Video export: exports composition
- Video export → Browser runtime: encodes media
- Editor app → Project archives: loads and saves
- Editor user → MCP editing server: sends edit requests
- MCP editing server → Timeline command: executes commands
- Timeline command → Project commands: applies operations
- Project commands → Project archives: reads and writes