Compatibility guide
Know what the uploader checks before you begin.
ClearFrame validates the file container and its actual media streams. Changing a filename extension does not convert an unsupported video.
Container support still depends on readable codecs and valid media metadata.
MP4
Supported- Recommended source
- H.264 + AAC
- Output handling
- MP4 · H.264 · AAC
MOV
Supported- Recommended source
- Readable video + audio streams
- Output handling
- MP4 · H.264 · AAC
WebM
Supported- Recommended source
- Readable VPx/AV streams
- Output handling
- Audio may transcode to AAC
| Container | Upload | Recommended source | Output handling |
|---|---|---|---|
| MP4 | Supported | H.264 + AAC | MP4 · H.264 · AAC |
| MOV | Supported | Readable video + audio streams | MP4 · H.264 · AAC |
| WebM | Supported | Readable VPx/AV streams | Audio may transcode to AAC |
01
Current MVP containers
MP4
Supported. H.264 video with AAC audio is the most predictable upload combination.
MOV
Supported through the MP4/MOV container family. Compatible video and audio streams are inspected after upload.
WebM
Supported. Opus or Vorbis audio may be transcoded to AAC for the MP4 output.
02
Platform validation defaults
- 1Maximum file size: 500 MB unless the live plan config sets a lower plan limit
- 2Maximum duration: 5 minutes
- 3Maximum resolution: 1920 × 1080
- 4Maximum frame rate: 60 fps
- 5Files must contain a readable video stream
03
Codecs and metadata
Video codecs
The container must be readable by the configured FFmpeg/ffprobe runtime. H.264 is the recommended source codec.
Audio codecs
Compatible AAC audio can be carried through; other supported audio may be transcoded to AAC.
Variable frame rate
Metadata is normalized through ffprobe. Review the preview carefully because output timing follows the processing pipeline.
Rotation metadata
Rotation and dimensions are read from the source metadata. Verify orientation in the project preview before masking.
04
Recommended upload settings
- 1MP4 container
- 2H.264 video
- 3AAC audio
- 4Constant or well-formed frame rate at 60 fps or below
- 51080p or below
- 6A descriptive filename without special control characters
05
Common upload errors
Unsupported format
The extension, MIME declaration, or detected container is outside the allowlist.
File too large
The file exceeds the active plan or platform upload cap.
Duration, resolution, or FPS too high
The probed media metadata exceeds a configured limit.
Metadata error
The runtime could not read a usable video stream or the file is damaged.
06
Output format
Completed jobs are written as MP4 with H.264 video in yuv420p and AAC audio. Aspect ratio and frame rate are preserved where the processing path allows.
Next step
Have an MP4, MOV, or WebM ready?
Create an account and let the uploader validate the actual file.