“The file isn’t compatible with QuickTime Player”: what it means and how to fix it
QuickTime Player shows "The file isn't compatible with QuickTime Player" in two very different situations: the file is healthy but uses a codec or container QuickTime does not support (for example MKV, AVI, WebM, VP9, AV1 in some macOS versions, or DTS audio), or the file is an MP4/MOV whose index is missing because the recording was interrupted. The first case is fixed by using another player or converting; the second needs the file's index rebuilt.
Quick test: does it open in VLC or IINA?
Install VLC or IINA (both free) and open the file.
- Plays normally: the file is fine. QuickTime just does not support its format. Keep using VLC, or convert it (see convert MOV to MP4 for the commands).
- Will not open, or shows 0:00: the file is probably damaged. Continue below.
Check the format
In Finder, select the file and press Cmd+I. The "More Info" section shows the codecs if macOS can read them. For full detail use MediaInfo or:
`` ffprobe -hide_banner video.mp4 ``
QuickTime on current macOS plays H.264, HEVC (H.265) and ProRes video with AAC, ALAC or PCM audio in MP4, MOV and M4V containers. Anything else may trigger the message even though the file is intact.
When the file is corrupted
Typical signs: the recording stopped because the camera, phone or screen recorder crashed, lost power or ran out of storage; the file has a large size but no duration; FFmpeg reports "moov atom not found" (what that means).
In that case the frames are usually still there. FixMP4 rebuilds the missing index in your browser, without uploading the file, using a short healthy clip from the same device as a reference. Check the free preview first.
Other causes worth checking
- The file is still downloading or syncing from iCloud Drive, Google Drive or Dropbox; wait until it is fully local.
- The extension is wrong: a file renamed to .mp4 that is really an MKV or a TS stream.
- An incomplete AirDrop or USB transfer: copy it again from the original device.
Formats that commonly trigger the message
| File | Typical content | Why QuickTime refuses it | What to do |
|---|---|---|---|
| .mkv | H.264/HEVC + AAC/AC-3/Opus | Container not supported | Play in VLC/IINA, or remux to MP4 |
| .avi | Xvid, DivX, MJPEG | Old codecs not supported | Re-encode to H.264 |
| .webm | VP8/VP9/AV1 + Opus | Codec/container support varies | Play in a browser or VLC, or re-encode |
| .mp4 from some cameras | H.264 + PCM or AC-3 | Audio codec not supported | Convert the audio to AAC |
| .mp4/.mov from an interrupted recording | H.264/HEVC + AAC | Index missing | Repair the file |
| .mts/.m2ts (AVCHD) | H.264 + AC-3 | Transport stream | Remux or re-encode with HandBrake |
Remux an MKV to MP4 for QuickTime
If ffprobe shows H.264 or HEVC video and AAC audio in an MKV, a remux is enough:
`` ffmpeg -i input.mkv -c copy -tag:v hvc1 output.mp4 ``
Use -tag:v hvc1 only for HEVC video: QuickTime requires the hvc1 tag and refuses HEVC tagged hev1, which is a frequent reason a seemingly valid HEVC MP4 will not open on a Mac. For H.264, drop that option. If the audio is AC-3 or Opus, add -c:a aac -b:a 192k after -c copy.
HEVC files that play everywhere except QuickTime
As mentioned above, HEVC tagged hev1 instead of hvc1 is refused by QuickTime and other Apple frameworks even though the video data is identical. Fix it without re-encoding:
`` ffmpeg -i input.mp4 -c copy -tag:v hvc1 output.mp4 ``
Screen recordings and iPhone videos
macOS screen recordings and iPhone videos that QuickTime suddenly cannot open after the recording was stopped abnormally (the Mac slept, ran out of disk space or the app crashed) are almost always missing their index. The same applies to iPhone videos that were cut off when the phone shut down. In those cases see fix iPhone video and repair MOV file, which explain the reference-file approach in detail.
Summary
- Try VLC or IINA. If it plays, it is a format issue, not corruption.
- Check the codecs with MediaInfo or ffprobe.
- Remux or convert to H.264/HEVC + AAC in MP4/MOV (with the hvc1 tag for HEVC).
- If nothing opens it and the recording was interrupted, rebuild the index.
Why QuickTime is stricter than other players
QuickTime Player relies on Apple's AVFoundation framework, which only accepts formats Apple has chosen to support and validates the file structure strictly before it plays anything. VLC, IINA and MPV are built on FFmpeg's libraries, which support hundreds of codecs and try hard to play damaged or unusual files. That is why the same file can play in VLC but be rejected by QuickTime, and why "plays in VLC" is a reliable sign that the data itself is fine.
Apple's other apps (Photos, iMovie, Final Cut Pro, Safari) use the same framework, so a file QuickTime rejects is usually rejected by them too. Fixing the format once (remux, hvc1 tag or AAC audio) makes it work across all of them. Final Cut Pro and iMovie are also strict about variable frame rate and odd resolutions; HandBrake's "Constant Framerate" option produces files they import reliably.
Before you repair or convert
Work on a copy, never the only original. If the file came from a camera card, copy the whole card folder to the Mac first; if it came from an iPhone, export the unmodified original from Photos (File > Export > Export Unmodified Original) rather than the version Photos may have re-encoded.
If the clip opens in QuickTime but Final Cut Pro still refuses it, see Final Cut Pro won't import an MP4 or MOV.
FixMP4 compared with other options
| Feature | FixMP4 | Desktop repair suites | untrunc (CLI) | VLC |
|---|---|---|---|---|
| Runs where | Browser, on your device | Desktop app | Command line | Desktop player |
| Keeps your file on your device | ✓ | ✓ | ✓ | ✓ |
| Nothing to install | ✓ | ✕ | ✕ | ✕ |
| Rebuilds a missing MP4/MOV index | ✓ | ✓ | ✓ | ✕ |
| Preview of your own repaired file before paying | ✓ | Trial (varies) | Free tool | n/a |
| Voice Memos / AAC without a reference | Usually | Varies | ✕ | ✕ |
| Formats beyond MP4/MOV/M4A | ✕ | ✓ | Many (FFmpeg) | Plays many |
Frequently asked questions
Is my video corrupted if QuickTime says it is not compatible?
Not necessarily. Most often the codec is unsupported. If the file plays in VLC, it is not corrupted.
Which formats does QuickTime Player support?
Mainly H.264, HEVC and ProRes video with AAC, ALAC or PCM audio in MOV, MP4 and M4V files. MKV, AVI, WebM and DTS audio generally are not supported.
How do I make a video compatible with QuickTime?
Convert it to H.264 or HEVC with AAC audio in an MP4 or MOV container, using HandBrake or FFmpeg.
Can FixMP4 repair a MOV that QuickTime will not open?
Yes, if the MOV is damaged because recording was interrupted and it still contains H.264 or HEVC frames. The free preview shows whether it can be recovered.