Repair a corrupted HEVC (H.265) video
HEVC (H.265) videos from iPhones, drones, GoPros and many cameras fail for two very different reasons. Most often the file is fine and the player or computer lacks HEVC support, which is common on Windows and in some browsers. When the file is really damaged, it is usually because recording was interrupted and the index was never written. An HEVC index can be rebuilt, but it needs a healthy reference clip from the same device and settings, because the codec configuration is stored in the missing index.
Step 1: rule out missing HEVC support
- Play the file in VLC. VLC decodes HEVC on every platform.
- On Windows, install HEVC Video Extensions from the Microsoft Store; see MP4 won't play on Windows.
- In browsers, HEVC support depends on the OS and GPU; Firefox has limited support.
- On macOS and Apple apps, HEVC tagged
hev1instead ofhvc1is rejected; remux withffmpeg -i in.mp4 -c copy -tag:v hvc1 out.mp4; see QuickTime file isn't compatible. - Sound but black picture is a classic symptom; see black screen with sound.
Step 2: check the file
Run the free MP4 file checker. It reports the codec (hvc1 or hev1) when the index is present. If it reports "index missing, media data present", the recording was cut off.
Why HEVC repair needs a reference
H.264 and HEVC both store their decoder configuration outside the frames. In HEVC this is the VPS, SPS and PPS (video, sequence and picture parameter sets) inside the hvcC box, which is part of the index. When the index is lost:
- the frames are still in the media data, each prefixed with its length;
- the configuration needed to decode them is gone.
A reference clip recorded on the same device, with the same resolution, frame rate, HDR or SDR setting and bit depth, contains an identical configuration. The repair takes it from the reference and uses it to index and decode the broken file. A reference with different settings (for example 4K 60 instead of 4K 30, or HDR instead of SDR) generally fails or produces garbled video.
Step 3: repair
- Record or find a reference: a short clip from the same device with the same settings. On iPhone, check Settings > Camera > Record Video and the HDR Video toggle; on DJI and GoPro, check resolution, frame rate, codec and colour profile.
- Open the repair tool, add the broken file and the reference.
- Watch the free 15-second preview. If it looks right, export.
Everything runs in your browser; the video is not uploaded, which matters for large 4K files.
Device notes
- iPhone: records HEVC by default ("High Efficiency"), with HDR (Dolby Vision, 10-bit) on newer models. Use a reference with the same HDR setting. See fix iPhone video.
- DJI drones and Osmo: HEVC is optional (H.264 is default on some models); D-Log and HLG profiles count as different settings. See fix DJI video.
- GoPro: newer models use HEVC for high resolutions and frame rates and split long recordings into chapters. See fix GoPro video.
- Samsung and other Android phones: HEVC is an option in camera settings; 8K recording usually uses HEVC.
- Security cameras: many record H.265 in proprietary containers; those need the vendor's player or export tool. See fix CCTV/DVR video.
Converting after repair
If the repaired HEVC file needs to play on older devices, convert it to H.264:
`` ffmpeg -i repaired.mp4 -c:v libx264 -crf 18 -pix_fmt yuv420p -c:a copy h264.mp4 ``
-pix_fmt yuv420p converts 10-bit HDR to 8-bit for compatibility; colours will look flatter without tone mapping.
What cannot be fixed
- Frames that were never written or were overwritten.
- Encrypted or DRM-protected HEVC files.
- HEVC inside proprietary containers that are not MP4 or MOV.
- A repair without any matching reference: if the camera is lost and no other clip with the same settings exists, a rebuild is often not possible.
HEVC and file size
HEVC compresses about twice as efficiently as H.264 at similar quality, which is why phones and drones use it. It also means each frame depends more heavily on others: a single damaged region can affect more of the following frames until the next keyframe. In practice, a repaired HEVC clip with a small damaged section may show a few seconds of smearing around that point, while the rest of the clip is clean. Re-encoding the repaired file with FFmpeg conceals such moments if they bother you.
If the reference does not match
When the preview looks garbled or green, the reference settings differ from the broken clip. Check resolution, frame rate, HDR, bit depth and stabilisation mode, record a new reference that matches exactly, and try again. The diagnosis in the repair tool lists what it detected in both files, which helps to find the mismatch.
FixMP4 compared with other options
| Feature | FixMP4 | Desktop repair suites | untrunc (CLI) | VLC |
|---|---|---|---|---|
| Runs where | Browser, on your device | Desktop app | Command line | Desktop player |
| Keeps your file on your device | ✓ | ✓ | ✓ | ✓ |
| Nothing to install | ✓ | ✕ | ✕ | ✕ |
| Rebuilds a missing MP4/MOV index | ✓ | ✓ | ✓ | ✕ |
| Preview of your own repaired file before paying | ✓ | Trial (varies) | Free tool | n/a |
| Voice Memos / AAC without a reference | Usually | Varies | ✕ | ✕ |
| Formats beyond MP4/MOV/M4A | ✕ | ✓ | Many (FFmpeg) | Plays many |
Frequently asked questions
Is my HEVC video corrupted or just unsupported?
Play it in VLC. If it plays there, it is healthy and your other player lacks HEVC support.
Can untrunc repair HEVC?
Some untrunc builds support HEVC, but support has historically been weaker than for H.264.
Does FixMP4 support HEVC?
Yes. FixMP4 rebuilds the index of HEVC (hvc1/hev1) and H.264 MP4 and MOV files, with AAC audio, in your browser.
Why do I need a reference file for HEVC?
The codec settings (parameter sets VPS, SPS, PPS) are stored in the missing index. A healthy clip from the same camera and settings provides them.