All options

Props of <VideoEditor />. Every one is documented in its type too — see the API reference.

PropTypeWhat it does
initialProjectProject | stringProject to open. Without it the last autosaved project reopens, or a new one starts.
onSave(project) => void | Promise<void>About a second after each edit — the durable save.
onExport(result: ExportResult) => voidAn export finished: the video file and its details.
onExportAudio(result: AudioExportResult) => voidA sound-only export finished.
onSaveFrame(image: FrameImage) => voidA frame was saved as a picture.
onClose() => voidShows a close button that calls it.
onUnsupported(capabilities) => voidThe device can't run the editor.
onReady(controller) => voidThe editor is ready; its controller for programmatic control.
onEvent(event: EditorEvent) => voidEdits, selection, playback, commands, imports, exports, panels.
resolveMedia(asset) => Promise<Blob | null>Bytes for media you store yourself (url sources).
autosavebooleanLocal autosave and crash recovery (default true).
proxies'auto' | 'always' | 'off'Lighter editing copies of heavy videos (default auto). Exports always use the original.
audioLibraryAudioLibraryA music and sound-effects source for the Audio panel (createStarterSounds() is a small CC0 set).
stickerLibrarystring | falseWhere 3D stickers come from (a base URL to self-host), or false.
animatedStickerLibrarystring | falseWhere animated emoji come from, or false to hide the tab.
transcriberTranscriberAuto captions: createOnDeviceTranscriber() from @video-ultra/captions (English), or your own service (any language).
backgroundRemoverBackgroundRemoverPhoto background removal: createBackgroundRemover() from @video-ultra/ai.
assistantEditingAssistantAI editing through your server: createChatAssistant() from @video-ultra/ai.
speechSpeechGeneratorText to speech through your server: createSpeechEndpoint() from @video-ultra/ai.
customizeEditorCustomizationHide or reorder tools; your own panels, buttons and media sources.
theme'dark' | 'light' | 'auto'Colour theme (default dark).
themeOverridesThemeOverridesTyped overrides for the common theme tokens.
contrast'normal' | 'high' | 'auto'High contrast for low vision or bright sunlight.
density'auto' | 'touch' | 'compact'Control sizes (default: thumb-sized on touch screens).
labelsPartial<Labels>Replace any text (translation).
dir'ltr' | 'rtl'Direction of the editor chrome (the timeline always runs left to right).
backend'auto' | 'webgpu' | 'webgl2'Force a renderer (testing). Default: WebGPU when available.
className / styleOn the editor root.