iPhone video won't play: the checklist

In short: Before you think about repair, rule out the harmless causes — with iPhone videos it’s usually an iCloud download that never finished, or a missing HEVC codec on the target device. Only when the video won’t play on the iPhone itself is the file genuinely damaged.

First: is the file even broken?

With iPhone videos, people google “repair” incredibly often when nothing is actually broken. These four cases look like a defect but aren’t:

1. The video only lives in iCloud. In Photos you see a preview, but the full file was never downloaded. On the iPhone: open the video and wait for the loading circle to disappear. On the Mac: in Photos, right-click → Download Originals.
2. The transfer broke off. Copying over USB or AirDrop only transferred the file halfway. You can often tell from a file size smaller than expected. Fix: transfer again — this time completely.
3. Missing HEVC codec. iPhones record in HEVC (H.265) by default. Windows and older players can’t handle that without an extension. The video is completely intact — it’s just missing the codec. VLC plays it instantly.
4. “Optimize Storage” is on. Under Settings → Photos, the iPhone only downloads originals on demand. A bit of Wi-Fi and patience, and the full resolution is there.

If the video plays cleanly on the iPhone itself, it is not damaged. In that case the problem is with the target device, not the file.

When it won’t play on the iPhone either

Now we’re talking about real damage. The most common causes:

• The Camera app crashed during recording
• Storage filled up mid-recording
• A ProRes video (iPhone 15 Pro and newer) was interrupted — the files are huge and the recording cuts off faster than you’d think
• The file was restored incompletely after a backup or a restore

The technical core is always the same as with any interrupted recording: the header (moov atom) is missing, but the actual video stream is still there.

Why iPhone videos are a special case

There’s a reason so many free repair tools fail specifically on iPhones. Apple writes the individual video frames with a slightly different byte structure (length-prefixed NAL units instead of start codes). Tools like untrunc, built for GoPro and older cameras, often trip over this — the reconstruction runs through, but the result stutters or stays black.

That’s why iPhone material needs either a very closely matching reference or a tool that knows about this quirk.

What actually works

If the file really is damaged, the orderly path goes like this:

1. Make a copy. Never work on the original. Pull the broken file onto the computer once and leave the original alone.
2. Try VLC. If VLC opens the video (even if it stutters), the streams are intact — then an ffmpeg remux is often enough. If it stays black, the header is gone.
3. Reconstruct the header. That’s what Haven is built for: it recognizes iPhone material, brings matching references along, and pulls the audio back into sync. Locally, without uploading your private videos to any cloud. The preview shows you upfront whether it’ll work.

→ Repair an iPhone video with Haven

What to avoid

• Deleting the video on the iPhone to “make room” before you have a working copy. From “Recently Deleted” it’s gone after 30 days.
• Sketchy “iPhone Video Repair” apps that upload the video to a server to repair it. Your private footage doesn’t belong on someone else’s machine.
• Recording again as a “test” with a full camera — if storage was the problem, worst case you overwrite something recoverable.

---

Bottom line: With iPhone videos, the first step is almost always ruling out the harmless causes — iCloud download, codec, transfer. If the video won’t play on the iPhone either, the header is gone, and then only a reconstruction helps. The key thing: repair private material locally, don’t upload it.