macOS Quick Look—the file preview pane you get when you press Space on a file—is useful for quickly checking what is inside an image or document without opening a full editor. For video files, though, it has a limitation: it will not preview video in formats that macOS does not natively support.
This is not a Quick Look bug. It is a framework limitation. Quick Look uses the media codecs built into the operating system. If your video is encoded in a codec that macOS knows about—H.264, HEVC, QuickTime compressed—Quick Look can display a still frame or sometimes play a short preview. If your video uses a less common codec—ProRes, DNxHD, Blackmagic Pocket Cinema format, older DV—Quick Look fails silently and shows nothing.
For a reference library, especially one with professional video formats, this becomes frustrating: you need to open a separate video player for every video you want to check, or convert everything to a format Quick Look understands.
The cause: limited codec support in macOS
Quick Look is a system-wide preview system built into the Finder. It works by calling macOS's media frameworks. Those frameworks know about a specific set of codecs: H.264 and HEVC for video, AAC for audio, and a few container formats like MP4, MOV, and MKV.
A video in ProRes, Avid DNxHD, or any other professional codec is not in that set. When Quick Look encounters it, the frameworks return "cannot read this," and Quick Look displays a generic file icon with no preview.
The codec support does not change much between macOS versions. An M1 Mac and an Intel Mac have roughly the same quick look limitations. A 2024 Mac has the same limitations as a 2020 Mac. The set of codecs is tied to what Apple includes in the operating system, and adding codec support requires an OS update.
This is particularly frustrating for professionals working with video. A motion designer exporting from After Effects as a ProRes file, a cinematographer ingesting from a Blackmagic camera, or an animator working with footage from a DaVinci timeline are all working with formats that Quick Look cannot preview. The file is perfectly accessible and plays in the right player; Quick Look simply does not know the codec.
Symptoms and when they appear
You may see:
- When you select a video file in Finder and press Space, you get a file icon instead of a preview.
- Some video files preview fine (usually H.264 MP4s), but others—usually the ones you exported yourself—show nothing.
- The same MOV file might preview on one Mac (newer, with different OS version or codecs) and not on another.
- You have to open a dedicated video player to check what is in a video file, turning a quick preview into a full application launch.
The severity depends on your source. If you work exclusively with footage downloaded from websites (which is typically H.264), Quick Look usually works fine. If you export from professional tools or ingest from cameras, you are probably using a mezzanine or intermediate format, and Quick Look fails.
Why this matters for reference libraries
Reference libraries that include video are common in animation, motion design, film, and visual effects work. A VFX artist collecting reference videos, a motion designer building a library of motion studies, or a cinematographer organizing camera tests all need to preview those videos to decide what they contain without playing each one in full.
Quick Look is supposed to make that instant checking possible. But when half your video library is in ProRes or DNxHD or cinema formats, Quick Look becomes useless.
The workaround—opening a separate video player for every preview—kills the efficiency quick look was supposed to provide.
Workarounds within the Finder
If you stay in the Finder, your options are limited:
Convert everything to H.264 MP4. The most compatible codec for Quick Look is H.264 video in an MP4 container. Converting your video library to this format before importing means Quick Look will preview everything. The cost is generational loss if you re-encode from lossy codecs, and storage overhead if you keep both originals and converted versions.
Use a third-party video player with more codec support. VLC and similar players support a much wider set of codecs. You can set these as your default video opener, but that takes you out of Quick Look into a full application window.
Accept the limitation and use the player. Use whatever tool you normally edit in to check video files—After Effects, DaVinci Resolve, Final Cut Pro. It is slower than Quick Look, but it works for any format you can edit with.
The real problem is that none of these solutions are quick. A preview pane should be fast enough that you do not think about it. As soon as you are converting files or launching applications, the quick preview is no longer quick.
Why Coii Ref handles this differently
Coii Ref can work with video in any format you store it in—ProRes, DNxHD, DV, H.264, anything macOS can read. When you import a video, Coii Ref extracts a still frame from the beginning (or any frame you choose) and displays that still in the grid with all your other images and videos. The still shows what is in the video without requiring preview of the full format.
You can also play the video directly in Coii Ref's viewer without opening a separate player. That player is format-aware and can handle the same wide range of codecs your editing software can handle.
The key difference: Coii Ref treats video like an image. It shows a still preview in the grid and lets you inspect the full video only when you choose to. There is no codec conversion, no workaround, and no separate application launch.
This is especially important for video professionals. After Effects, Resolve, and Premiere all work with the same broad range of codecs. A reference manager that requires you to convert videos before you can preview them is working against your actual workflow.
What to check before converting
If you are considering converting your video library to make Quick Look work:
Does your reference manager support the format you actually use? Check whether it can import video in the codec you export in. Most modern reference managers can read more formats than Quick Look can.
What is the cost of keeping two versions? If you convert everything, you are either accepting generational loss or maintaining both an original and a converted version. The storage and metadata sync cost adds up fast for a large video library.
Is Quick Look preview actually necessary? If your reference manager can show a still or play the video directly, Quick Look is not a blocker. You have a preview system; it is just not the Finder's.
For video-heavy workflows, the answer is almost always to choose a reference manager that supports your native formats rather than converting the video. The time saved on not converting every file, plus the time saved on not having to open a separate viewer for every check, adds up quickly.
Migration path
If you have been storing video in formats Quick Look cannot handle and have been working around it, you can move to Coii Ref and work with the same files you have today. Index the folder, and every video appears with its still preview extracted automatically. You keep the originals; the app simply reads them.
There is no codec conversion, no storage overhead, and no metadata loss. The video library you have now is the video library you index.
When not having a codec workaround matters
If you work with video in your field and you spend any time checking references, the small friction of "open a video player" compounds. For a design reference library of one hundred stills, this is not important. For a motion design library of two hundred video clips, it becomes your daily workflow. Each clip is maybe fifteen seconds of checking to see if it is the right shot. At two hundred clips, that is fifty minutes of opening and closing a video player instead of pressing Space.
For video professionals, the choice is simple: one system requires conversion before you can preview anything, and another handles your native formats from the start. At scale, format support becomes the deciding factor. A system that cannot work with your delivery or intermediate formats is fighting against your actual workflow, not supporting it.
This friction compounds when you work with video regularly. If you check a reference every few minutes—comparing motion studies, checking timing on a clip, comparing your work to an inspiration—the moment you have to convert or open a separate player becomes noticeable and tiring. Multiply that by a working day, a week, a year, and it becomes a significant portion of your time.
The problem is not unique to Quick Look. Any system that supports a limited set of codecs will have this problem. The solution is to choose a reference system that does not require conversion or codec limitation. It accepts your files as they are and works with them in their native format.
The 30-day trial works with any video format your Mac reads. Download it, open your actual reference library—ProRes, DNxHD, DV, whatever you use—and see how native format support changes your workflow. And if you are comparing options, best reference apps that don't copy your files covers the full landscape.
The cost of conversion is not just technical. It is also organizational. Every format you support in multiple versions—originals plus converted proxies—is a source of confusion. Which version did I edit? Which one is the reference? Are they still in sync? A system that avoids this by working directly with your native formats removes an entire category of potential problems.
For motion designers, animators, and cinematographers, this matters especially. The tools you export from—After Effects, Blender, DaVinci Resolve—all support a wide range of professional codecs. A reference manager that requires you to convert everything to H.264 before you can work with it is introducing friction at a point where your workflow is already defined and working. You export ProRes because ProRes is what makes sense for your pipeline. A reference system should accept that choice, not force you to make a different one.
For reference organizer for motion designers and reference app for concept artists, native format support is essential. These professions depend on reference libraries and need tools that respect the formats they actually use. How to organize video references covers organization strategies specific to motion work. And best reference apps that don't copy your files shows the full range of options. For anyone building a video-heavy library, image organizer that doesn't move your files explains why keeping files in folders matters.
When building a reference library for video work, the system you choose should be invisible to your workflow. You download footage, you ingest it, you organize it, and you search it—all in the formats you received. The moment you have to stop, convert, and re-import, the system is no longer invisible. It is overhead. For small libraries or rare lookups, that overhead is tolerable. For video-heavy workflows where you are checking references constantly, it becomes an every-day friction that adds up.
The 30-day trial includes every feature and works with video in any format your Mac can read—ProRes, DNxHD, H.264, DV, anything. Download Coii Ref and test it with the actual video library you have today, not a converted version. The native-format support will be immediately obvious the first time you open a folder of professional video and see everything indexed and searchable without a single conversion step.