QuickTime Player on macOS does not support the Matroska (.mkv) container. Double-click an MKV file and you get an error, even when the file is perfectly healthy. This is a compatibility limitation, not corruption. The fix is simple: use a player that handles MKV natively, or remux the file into a container QuickTime understands.

Why QuickTime Won't Open MKV Files

QuickTime Player supports a limited set of containers and codecs. MKV is not among them. When you double-click an MKV, QuickTime shows "cannot open" or "unsupported format." The file is fine; the player is the problem.

Quick Look uses the same system frameworks as QuickTime, so the space bar preview in Finder also fails. Apple's Photos app and iMovie do not import MKV directly. Do not try to open an MKV with any of these.

Free Players That Open MKV Natively

Install VLC or IINA

Install a free player that supports MKV. VLC and IINA both handle the container and most common codecs without extra setup.

  1. Download VLC or IINA from their official websites.
  2. Open the app, then drag your MKV file onto its window, or use File > Open.
  3. If the video plays, the file is not corrupt. It was a QuickTime limitation.

Both players handle subtitles, audio tracks, and chapters embedded in MKV files.

Why Some MKV Files Play in VLC and Others Don't

VLC and IINA play most MKV files. They are not magic. If an MKV fails even in VLC, the video or audio codec may be unsupported, or the file may be corrupted. Some MKV files contain unusual codecs that no player bundles.

If a file plays in one player but not another, it is a codec issue. If it fails in all players, corruption is more likely. Check the file's integrity before concluding it is dead.

Check If Your MKV is Actually Corrupted

Run a Diagnostic Command

Use ffprobe or mkvinfo to determine whether an MKV file is damaged or merely incompatible. MKVToolNix has a native macOS build; install it and run mkvinfo from the terminal.

Run this command in Terminal:

ffprobe file.mkv

or

mkvinfo file.mkv

If the tool reads the file's structure and lists tracks without errors, the file is not corrupted. Errors like "invalid data" or "muxing failed" point to damage.

Test for Partial Playback

If the file plays but stops or freezes at a certain point, it could be truncated or have a bad section. That is a separate problem from QuickTime incompatibility.

Remux MKV to MP4 for QuickTime

Copy Streams Without Re-encoding

To play MKV files in QuickTime, Photos, or iMovie, remux the MKV into an MP4 container. Remuxing copies the video and audio streams without re-encoding. It is fast and lossless.

Use FFmpeg with this command:

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

This works only if the codecs are MP4-compatible, such as H.264 or HEVC video with AAC audio. If the MKV contains a codec MP4 does not support, like DTS audio, the copy will fail or produce a file QuickTime cannot play.

Convert the Audio Codec When Needed

MKV files often contain audio codecs QuickTime cannot play inside MP4, such as DTS. Convert the audio while leaving the video untouched. The command is:

ffmpeg -i input.mkv -c:v copy -c:a aac output.mp4

This copies the video stream without re-encoding and converts only the audio to AAC. Quality is preserved. Speed and compatibility stay balanced.

If the video codec itself is not MP4-compatible, re-encode the video too. That is slower and reduces quality. For most MKV files, converting the audio is all you need.

Spot a Genuinely Damaged File

Signs of Real Corruption

If VLC, IINA, and remuxing all fail, the file may be damaged. Look for these signs:

  • The file size is much smaller than expected for its duration. A 90-minute movie that is only 10 MB is a red flag.
  • ffprobe or mkvinfo reports errors or fails to read the file.
  • The file fails in every player, and the error is consistent.
  • You downloaded the file from an incomplete source, or the transfer was interrupted.

What to Do If It Is Corrupted

Try repairing the file with MKVToolNix's mkvmerge tool. It can sometimes rebuild the file structure. If the data is truly lost, no player can fix it. Re-download or re-encode the original source.

An MKV that will not open in QuickTime is not broken. It is a compatibility issue. The solutions above let you play or convert it on your Mac.