QuickTime Error 2048 — How to Fix

Error 2048 is QuickTime's way of saying I don't recognise this as a file I can open. The full message is usually Couldn't open the file. The file isn't a file that QuickTime understands. It appears for several distinct underlying causes, all reported with the same generic code.

If you're seeing 2048, this page tells you what's actually wrong and how to fix it.

What 2048 actually means

QuickTime's parser tried to open the file and failed at one of the early checks:

1. File extension says MOV / MP4 but the content isn't. A renamed MKV, AVI, WebM, or raw H.264 stream. QuickTime doesn't speak those formats.
2. The ftyp atom (file type declaration) is missing or unrecognised. Without ftyp, QuickTime can't confirm what kind of file it is.
3. The codec inside is one QuickTime doesn't natively decode. HEVC on older macOS, AV1 on Intel Macs, VP9, Cineform without codec pack — all produce 2048.
4. MOOV atom missing or unparseable. Same as the canonical MOOV not found case, sometimes manifesting as 2048 instead of a more specific message.
5. File is partially downloaded / partially copied. The file size on disk is less than the file size the source thought it was sending.

How to figure out which one

file your_file.mov

If the output isn't ISO Media, MP4 ... or Apple QuickTime movie ..., the file isn't actually MOV / MP4 — that's cause 1.

ffprobe -v error -show_format -show_streams your_file.mov

• No output, "moov atom not found" → cause 4.
• "Invalid major brand" or similar → cause 2.
• Stream info that's valid but with an unsupported codec for QuickTime's macOS version → cause 3.

Compare file size with the original source size:

ls -l your_file.mov

If the size is less than expected (you remember the original was 2 GB, the file on disk is 1.4 GB), → cause 5.

What to do per cause

Cause 1 — wrong file format

mv your_file.mov your_file.mkv  # or .avi / .webm / .h264

Then play with VLC, IINA, or transcode:

ffmpeg -i your_file.mkv -c copy your_file.mp4

Cause 2 — missing/wrong ftyp

Re-mux through FFmpeg, which writes a fresh ftyp:

ffmpeg -i broken.mov -c copy -f mov fixed.mov

Cause 3 — codec not supported on your macOS version

• HEVC on older macOS: update to macOS 10.13+ (HEVC was added then), or transcode to H.264:

ffmpeg -i hevc.mov -c:v libx264 -crf 18 -c:a copy h264.mov

• AV1 on Intel Mac: transcode similarly. Apple Silicon Macs have hardware AV1 decode on recent macOS.
• VP9, Cineform: transcode with FFmpeg.

Cause 4 — MOOV missing

See the canonical MOOV recovery guide. This is real recovery territory.

Cause 5 — partial download / copy

Re-download or re-copy from the source. If the source is gone, the file is permanently incomplete; recovery may save what's there.

How our recovery handles 2048 cases

The diagnostic pass identifies which underlying cause is producing 2048:

• File format identification by content, not extension. We see through cause 1 and cause 2.
• Codec identification from frame markers — we know what's actually in the file, even when QuickTime won't say.
• MOOV synthesis from observed frames for cause 4.
• Partial-file detection for cause 5: we report what fraction of the file is present and what's salvageable.
• Output is QuickTime-friendly by default. The recovered file uses standard ftyp and yuv420p H.264 for the preview, so QuickTime opens it without issue.

What you do

1. Upload the file.
2. The diagnostic identifies cause and tells you whether recovery applies (causes 2, 4, 5) or whether you just need to transcode (causes 1, 3). For the transcode-only cases, we'll tell you and not charge.
3. If recovery applies, you preview, pay only if it works.

FAQ

Error 2048 only happens on one Mac, not on others. Likely cause 3 — codec compatibility differs between macOS versions and Intel vs Apple Silicon. Update macOS or transcode.

The file plays in Resolve / Premiere but QuickTime gives 2048. Resolve and Premiere are more permissive than QuickTime. Re-mux through FFmpeg with -c copy to clean up the metadata; QuickTime usually accepts the result.

Same file plays on iPhone but not on Mac, both via QuickTime. iPhone's media playback uses a slightly different codec stack than Mac QuickTime in some edge cases. Transcoding to standard H.264 + AAC + yuv420p produces a file both will play.

Error 2048 only on download, not on a freshly recorded file from the same camera. The downloaded file is partially transferred or modified by the transfer process. Check file size against source and re-download if possible.

Is my footage safe? Server in France, auto-deleted after 48 hours, never used to train anything or shared. Privacy policy.

Related

• MOOV atom not found
• The document could not be opened
• This file is not supported
• How our recovery engine works

Upload your file →