You press the spacebar on a video file, expecting an instant preview — and nothing happens. Quick Look shows a generic file icon or a frozen thumbnail, and the play button never responds. Before you assume the file is broken, know this: Quick Look on Mac understands only a small set of video formats. That is usually the entire problem.
This guide explains why Quick Look refuses to play certain videos, how to check exactly what format you are dealing with, and three practical fixes — from a one-time conversion to simply using a better player.
Why Quick Look won’t play your video
Quick Look natively supports only the video formats that are native to Apple devices: .mov files and other QuickTime-family videos, plus .mp4 files encoded with standard H.264/H.265 settings. The moment a file uses a container or codec Apple never adopted — .mkv, .avi, .wmv, or an .mp4 with unusual encoding — Quick Look simply cannot decode it. It will show the file icon or a still first frame, but pressing play does nothing.
This is not a bug and not something you broke. Apple’s documentation lists the file types Quick Look can preview, and video beyond the Apple-native set is not on the short list.
Step 1: check what format the file actually is
- Right-click the video file in the Finder and choose Get Info.
- Expand “More Info” and read the format and codec lines — the container and codec names tell you exactly what you are dealing with.
- Read the verdict. If you see Matroska (.mkv), AVI, WMV, DivX, or Xvid anywhere in that section, you have found the reason: Quick Look does not handle those natively.
Step 2: pick your fix
- Convert the video to a supported format. Converting to .mov or a standard H.264 .mp4 with a free converter or ffmpeg makes the file work everywhere on your Mac — Quick Look, the TV app, even your iPhone — and one conversion fixes it for good.
- Add codec support to macOS. Codec packs and Quick Look preview extensions can teach the system to recognize more containers, so previews start working for files Quick Look previously ignored — no conversion needed.
- Just use a different player. VLC or IINA play practically everything — .mkv, .avi, .wmv — without any setup. If you only need to watch the movie rather than preview it in the Finder, a broad player is faster than fighting formats.
If it still doesn’t work
If a converted .mov still will not preview, the file itself may be corrupted or only partially downloaded — try downloading it again. If no video previews at all, even files that worked yesterday, restart the Finder (hold Option, right-click the Finder icon in the Dock, choose Relaunch) or reboot the Mac. And if you are sorting out other Mac quirks, this guide to quickly opening the installed apps list in macOS 26 will get you to the right settings faster.
Frequently asked questions
Can I make Quick Look play MKV files directly?
Only with extra software, such as a Quick Look extension that adds Matroska support. Out of the box, Quick Look cannot decode .mkv files, so converting the file or opening it in VLC or IINA is simpler and more reliable. MacRumors also covers macOS media features and utilities.
Why do some MP4 files play and others don’t?
Because .mp4 is just a container — what is inside matters. An .mp4 with standard H.264 video previews instantly; one packed with a codec Apple does not support (or encoded with unusual settings) will not. Checking the codec under Get Info → More Info tells you which case you are in.
Conclusion
Quick Look’s video support is deliberately narrow: .mov and standard .mp4 preview instantly, and everything else needs conversion, a codec extension, or a player like VLC. For most readers the practical answer is simple — convert the file once, or skip the preview and open it in IINA. And if you use your Mac for video calls too, here is how to enable face lighting during video calls on Mac for a better picture.
