Manatee

An MP4 with no thumbnail or preview in Finder on a Mac

The video plays fine when you double-click it, but in the Finder it shows a generic movie icon instead of a frame from the footage, and Quick Look either spins or shows nothing. That combination almost always means one of two things: the file’s index sits at the end rather than the start, or the video inside uses a codec the Finder’s preview machinery will not decode.

Neither is a sign that the file is damaged. A missing thumbnail is a reading problem, not a content problem, and it is usually fixable in one pass.

What the Finder is actually doing

When the Finder needs an icon for a video, it does not play the file. It asks a preview service for a single frame, and that service is deliberately impatient: it reads a small amount from the front of the file, and if it cannot find what it needs quickly, it gives up and hands back the generic icon.

To produce a frame, it has to find the file’s index first. In an MP4 or MOV, that index is a block called the moov atom, and it lists where every frame and audio packet lives. The moov atom can legally sit at the start of the file or at the end. Players that load the whole file do not care. A preview service reading the first chunk of a multi-gigabyte file very much does.

So the two failure modes are:

  • The moov atom is at the end. The preview service reads the front, finds only raw data, and stops.
  • The moov atom is at the front but the video codec is one the system cannot decode, so there is nothing to draw.

Tell the two apart in under a minute

Start with the codec, because it is the quicker check.

  1. Select the file in the Finder and press Command-I for Get Info.
  2. Open the More Info section and look for a codec line.

If Get Info names something the Mac handles natively, such as H.264 or HEVC, the codec is not your problem and the index placement is. If Get Info shows nothing useful, or names something older or unusual, the codec is the likely culprit. Container vs codec: why an MP4 can still refuse to play explains why the extension on the end of the filename tells you almost nothing about this.

A second signal: try dragging the file into QuickTime Player. If it plays with picture, the Mac can decode the codec, which points back at index placement. If it plays with sound and a black screen, the codec is the problem, and how to fix a video that plays audio but shows a black screen covers that case specifically.

A third signal that is easy to miss: the thumbnail may be absent because the file is still being written or was never finished. If the file came off a camera that lost power, or a transfer that stopped partway, you are looking at a different problem. The index was never written at all, and the file needs repair rather than a rewrite.

Fixing an index that sits at the end

Moving the moov atom to the front is often called faststart, because the same change is what lets a video begin playing before it has fully downloaded over a network. It rewrites the file’s structure while leaving every video and audio frame byte-for-byte identical, so there is no quality cost and no re-encoding wait.

The practical way to get there on a Mac is to run the file through a conversion to the same container. Converting an MP4 to MP4, or a MOV to MOV, rebuilds the structure and writes a clean index at the front.

Manatee does this in Convert mode: drop the file on the menu bar icon, choose MP4 or MOV as the target, and it writes a new file alongside the original. Your original is never modified, which matters when you are troubleshooting and want to be able to go back. Everything runs on your Mac, so a large camera file is not uploaded anywhere.

Once the new file exists, the Finder usually picks up a thumbnail within a few seconds. If it does not, the icon cache may be holding the old answer. Move the file to another folder and back, or log out and in.

Fixing a codec the Finder cannot read

If Get Info named a codec the Mac does not handle for previews, no amount of index shuffling will help. The fix is to convert the video stream into something the system decodes everywhere, which in practice means H.264 in an MP4.

That is a real re-encode, so it takes longer than a faststart rewrite and it does cost some quality. How much depends on what you set, and remux versus re-encode is worth reading before you commit a whole folder of footage to it.

Two codecs come up constantly here. AV1 files, common from web downloads, preview poorly on older Macs. Camera formats such as MXF or XAVC variants often carry video the Finder will not touch even when a player handles the file.

When the thumbnail is missing because the file is broken

A file that was interrupted mid-write is a separate situation. The symptoms overlap: no thumbnail, no Quick Look, and Get Info showing a duration of zero or something absurd. The difference is that the file will not play properly either.

In that case the index was never written, and a conversion will fail because there is nothing to read. What you need is a repair pass that reconstructs an index by scanning the frames that did make it to disk. Manatee’s Repair mode does exactly that and reports the result honestly as Fixed, Partial or Not fixable. Partial is common with an interrupted recording: the first stretch of footage comes back and the rest does not, because it never reached the disk. Video file is 0 bytes or shows the wrong length goes through that diagnosis in detail.

Questions

Does a missing thumbnail mean the video is damaged? Usually not. A file that plays correctly but shows no thumbnail is almost always a structure or codec issue, not damage. Damage tends to announce itself during playback.

Will rewriting the file to get a thumbnail reduce quality? Converting to the same container does not, because the frames are copied rather than re-encoded. Converting to a different codec does, because the picture is rebuilt from scratch.

Why do some of my videos show thumbnails and others do not, from the same camera? Cameras often write the index at the end while recording and move it to the front when the recording stops cleanly. Clips that ended with a battery pull or a card removal keep the index where it was.

Can I make the Finder show thumbnails for every video format? No. The preview service only draws what the system can decode, and that set is fixed by macOS. Converting the file is the only reliable route.