QuickTime: "This File Is Not Supported" — What to Do

QuickTime Player on macOS shows this message when it identifies a file as something it knows about but can't decode. It's deliberately vague. The exact phrasing varies by macOS version: "the file isn't compatible with QuickTime Player," "this file is not supported," "the document could not be opened" (slightly different — see that page).

Three categories of underlying cause, in order of frequency:

1. Codec QuickTime doesn't natively decode

QuickTime doesn't include every codec. Common ones it refuses:

• HEVC (H.265) in some macOS versions and configurations. Modern macOS supports HEVC natively; older versions don't.
• AV1 is supported on Apple Silicon Macs running recent macOS, but not always on Intel Macs.
• VP9 is generally not supported.
• Cineform, DNxHR / DNxHD, ProRes RAW require additional codec support beyond default macOS.
• MPEG-2, DV, MJPEG older variants sometimes need third-party codec packs.

In this case, the file isn't broken — QuickTime just can't decode the codec. Try VLC or IINA first. Both have wider codec support out of the box. If VLC plays it, you can transcode with FFmpeg to a QuickTime-friendly format:

ffmpeg -i input.mov -c:v libx264 -c:a aac out.mp4

If VLC also can't play it, you're more likely in category 2 or 3.

2. File is corrupted (the real problem)

QuickTime returns the same generic message for several actually-broken-file cases:

• MOOV atom missing. See MOOV atom not found.
• File truncated mid-recording. See MP4 file truncated.
• Container/codec mismatch after a botched conversion or partial recovery.
• Codec parameter set damage — the SPS / PPS / VPS in H.264 / H.265 is gone.

These cases need actual repair, not a transcoding workaround.

3. Container that QuickTime doesn't open

QuickTime only opens MOV, MP4, M4V, and a handful of related containers. It doesn't open:

• MKV (Matroska)
• AVI
• WebM
• FLV

If your file is one of these and you saw "this file is not supported," it's not corrupted — QuickTime just doesn't speak the format. Use VLC, or transcode:

ffmpeg -i input.mkv -c copy out.mp4

(-c copy does no re-encoding; this is fast.)

How to figure out which category

Quickest test:

file your_file.mov
ffprobe -v error -show_format -show_streams your_file.mov

The first command tells you what kind of file it actually is (sometimes it's not what the extension claims). The second tells you what FFmpeg thinks.

If ffprobe returns valid stream info → category 1 or 3 (codec / container limitation, not broken file). If ffprobe returns errors → category 2 (broken file, real recovery needed).

When it's a real recovery case

If the file is genuinely broken — ffprobe errors, FFmpeg can't read it, VLC won't play it — then automated container reconstruction is the next step. The QuickTime "not supported" message is just QuickTime's polite way of saying the file's metadata is gone.

How our recovery handles it

• Container scan independent of file extension. We identify the actual format from the byte content, not from .mov vs .mp4 vs .MOV.
• Codec detection from frame data. When the codec parameter set is damaged, we re-derive parameters from the first valid frame.
• Output is a QuickTime-friendly MOV / MP4 by default. If you want a different container or codec, the recovered file can be transcoded after — but the output we give you mounts in QuickTime.

What you do

1. Upload the file.
2. ~1 minute later you get a diagnostic. The diagnostic specifically tells you whether the file is broken (recovery applies) or whether it's a codec / container limitation (no recovery needed; use VLC and transcode).
3. If recovery applies, you preview, pay only if it works.

FAQ

My file plays in VLC but not QuickTime. Codec QuickTime doesn't decode. Not a recovery case — just transcode with FFmpeg. We can't help with this and won't charge you for the diagnostic.

My file plays in QuickTime on my friend's newer Mac but not on my older Mac. HEVC compatibility issue. Update macOS or transcode the file to H.264.

My file is a .mp4 but file your_file.mp4 says "Matroska data" or similar. Container mismatch. The file extension is wrong. Rename it (mv file.mp4 file.mkv) or transcode.

Recovery returned a file QuickTime still rejects. Tell us in the escalation — we may need to rerun with a different output container. We aim for QuickTime-mountable output by default.

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

Related

• The document could not be opened (related QuickTime error)
• MOOV atom not found
• How our recovery engine works

Upload your file →