How marshiyar/mpvfx works
MpVFX is a desktop video/composition editor. The principal workflow is editing a project on the timeline and canvas, persisting project changes, then exporting media. The graph also preserves animation, media import, color grading, preview, and history as distinct capabilities. Edges are limited to relationships visible in the supplied excerpts or SOURCE INDEX; unsampled runtime wiring is left unverified.
Main entry points: service.ts Runtime service · useFileManager.ts Project file manager · playerStore.ts Timeline state · useTimelineKeyframeHandlers.ts Keyframe editing
Components 22
Desktop and runtime
- Desktop app
studio/desktop/main.ts - Editor runtime
studio/desktop/editorRuntime.ts - Runtime service
studio/runtime/service.ts - Desktop bridge
studio/shared/desktopBridge.ts
Editing workspace
- Editor shell
studio/src/app/EditorShell.tsx - Timeline state
studio/src/player/store/playerStore.ts - Timeline editing
studio/src/player/components/useTimelineClipDrag.ts - Keyframe editing
studio/src/player/components/useTimelineKeyframeHandlers.ts - Animation controls
studio/src/features/animation/GSAP/useGsapSelectionHandlers.ts - Canvas editing
studio/src/features/canvas/domEditing.ts - Color grading
studio/src/features/inspector/useColorGradingController.ts
Project and media
- Project file manager
studio/src/features/history/useFileManager.ts - Edit history
studio/src/features/history/editHistory.ts - Media import
studio/shared/media/mediaImportPolicy.ts - Block placement
studio/src/features/media/useBlockHandlers.ts - Native project model
studio/shared/project/nativeProjectDocument.ts
Preview and export
- Preview interaction
studio/src/features/preview/usePreviewInteraction.ts - Preview runtime support
studio/runtime/preview/nativePicture.ts - Export queue
studio/src/features/export/useRenderQueue.ts - Media export
studio/runtime/export/directMediaExport.ts
Other components
- Editor user
- Social publishing
Crosspost/gui.py
Connections 20
- Editor user → Editor shell: edits project
- Desktop app → Editor runtime: starts runtime
studio/desktop/main.ts - Editor runtime → Runtime service: launches service
- Editor shell → Timeline state: uses state
- Timeline editing → Timeline state: updates state
studio/src/player/components/useTimelineClipDrag.ts - Keyframe editing → Timeline state: updates state
studio/src/player/components/useTimelineKeyframeHandlers.ts - Keyframe editing → Animation controls: uses keyframe tools
studio/src/player/components/useTimelineKeyframeHandlers.ts - Animation controls → Canvas editing: reads selection
studio/src/features/animation/GSAP/useGsapSelectionHandlers.ts - Canvas editing → Project file manager: persists edits
- Color grading → Runtime service: requests metadata
studio/src/features/inspector/useColorGradingController.ts - Project file manager → Runtime service: requests file operations
- Project file manager → Edit history: coordinates edits
- Media import → Runtime service: sets import policy
- Block placement → Project file manager: installs project content
studio/src/features/media/useBlockHandlers.ts - Project file manager → Native project model: reads and writes
- Preview interaction → Timeline state: uses playback state
studio/src/features/preview/usePreviewInteraction.ts - Runtime service → Preview runtime support: configures preview
studio/runtime/service.ts - Export queue → Runtime service: requests export
- Runtime service → Media export: dispatches export
- Editor user → Social publishing: publishes videos