Export basics
Starting an export
Export your project to a video file:Wait for completion
Watch the progress bar as your video renders. This may take several minutes depending on project length and quality.
apps/web/src/components/editor/export-button.tsx:34-144
Export formats
OpenCut supports two video formats:MP4 (H.264)
Best for compatibility
- Most widely supported format
- Works on all devices and platforms
- Better compatibility with video editors
- Slightly larger file size
- Recommended for most use cases
WebM (VP9)
Best for file size
- More efficient compression
- Smaller file sizes
- Open source codec
- Limited compatibility on older devices
- Great for web playback
apps/web/src/types/export.ts:8
Quality settings
Choose the quality level that balances file size and visual quality:| Quality | Bitrate | Use case | File size |
|---|---|---|---|
| Low | Lowest | Preview exports, quick drafts | Smallest |
| Medium | Moderate | General sharing, social media | Balanced |
| High | High | Recommended for most projects | Larger |
| Very High | Highest | Maximum quality, archival | Largest |
High quality is the default and recommended for most projects. It provides excellent visual quality while keeping file sizes reasonable.
apps/web/src/types/export.ts:1-6
Quality vs. file size
Understanding the tradeoffs:- Higher quality = Better visual fidelity, larger files, longer upload times
- Lower quality = Faster exports, smaller files, visible compression artifacts
- Very High is best for archival or when you’ll re-encode later
- Medium is often sufficient for social media (platforms re-encode anyway)
apps/web/src/services/renderer/scene-exporter.ts:29-36
Export options
Frame rate
The export uses your project’s frame rate setting by default:- 24 fps - Film look, smaller file size
- 30 fps - Standard for web video
- 60 fps - Smooth motion, larger file size
apps/web/src/types/export.ts:16
Audio
Control whether audio is included:- Include audio (default) - Exports video with all audio tracks mixed
- Mute audio - Exports silent video (video only)
If your project has no audio tracks or all audio is muted, the audio toggle has no effect.
- All unmuted audio tracks
- Audio from video elements (unless muted)
- Proper volume levels and mixing
- Synchronized to video frames
apps/web/src/components/editor/export-button.tsx:89-91
Export process
Rendering stages
Exports happen in multiple stages:
Source:
apps/web/src/core/managers/renderer-manager.ts:89-184
Progress tracking
Monitor export progress:- Progress bar shows percentage complete
- Current percentage displayed numerically
- Export runs in the background (don’t close the browser tab)
- You can cancel anytime by clicking “Cancel”
apps/web/src/components/editor/export-button.tsx:257-277
Canceling exports
Stop an export in progress:- Click the “Cancel” button during export
- The export stops immediately
- No file is downloaded
- You can start a new export with different settings
apps/web/src/core/managers/renderer-manager.ts:149-165
File naming
Exported files are named automatically:- Uses your project name
- Adds the file extension (
.mp4or.webm) - Invalid characters are replaced with hyphens
- Example:
"My Summer Vacation"→My-Summer-Vacation.mp4
apps/web/src/components/editor/export-button.tsx:134
Snapshot exports
Capture a single frame as an image:
Snapshot features:
- Always exports at project canvas resolution
- PNG format for lossless quality
- Filename includes timecode (e.g.,
Project-00-01-23-15.png) - Perfect for thumbnails or social media posts
apps/web/src/core/managers/renderer-manager.ts:26-87
Troubleshooting exports
Export failed
If an export fails:- Check the error message in the export dialog
- Click “Copy” to copy the error details
- Click “Retry” to try again
- Common causes:
- Browser ran out of memory
- Missing media files
- Corrupted project data
apps/web/src/components/editor/export-button.tsx:293-337
Slow exports
Export speed depends on:- Project length - Longer videos take more time
- Quality setting - Higher quality = slower encoding
- Computer performance - Faster CPU = faster exports
- Project complexity - More tracks and effects slow down rendering
- Format - WebM/VP9 encoding is slower than MP4/H.264
Large file sizes
If exported files are too large:- Try a lower quality setting (High → Medium)
- Consider WebM format for better compression
- Reduce project resolution in settings
- Lower the frame rate if smooth motion isn’t critical
Missing audio
If exported video has no audio:- Check that “Include audio” is enabled
- Verify audio tracks aren’t muted
- Ensure video elements with audio aren’t muted
- Check volume levels (very low volume may seem silent)
apps/web/src/lib/media/audio.ts
Best practices
Test with low quality first
Export a quick Low quality version to check timing and edits before waiting for a High quality render.
Use High quality for finals
The High quality setting provides excellent results for most use cases without excessive file sizes.
Choose MP4 for compatibility
When in doubt, use MP4 format. It works everywhere and is widely supported.
Don't close browser during export
Keep the browser tab open while exporting. Closing it will cancel the export.
Export defaults
Default export settings:apps/web/src/constants/export-constants.ts:3-7
These defaults provide a good balance of quality, compatibility, and file size for most projects.