Manatee

How to fix a HEIC photo that won't open on Mac

A HEIC that will not open on a Mac is rarely a damaged photo. Most of the time it is a file that is not actually a HEIC (a JPEG or AVIF with the wrong extension), a cloud placeholder that never finished downloading, or an HEIF variant from a non-Apple device that macOS does not fully decode. Run file on it, make sure it is fully on disk, then convert it to JPEG. A HEIC that is truly truncated cannot be repaired, but even then the embedded thumbnail is often recoverable.

First, rule out the boring causes

Any Mac on macOS 10.13 High Sierra or later opens HEIC natively, so on a current machine the format itself is not the problem. Check these before anything else.

  1. Is it fully downloaded? Photos that live in iCloud Drive, a synced cloud folder, or a Photos library set to Optimize Mac Storage may exist only as placeholders. Press Command+I on the file. A size of 0 bytes, or a few kilobytes with a cloud icon next to the name in Finder, means the photo has not arrived. Click the cloud icon or choose File, Download Now, wait, and try again.
  2. Is it fully transferred? A HEIC from a phone is typically one to three megabytes. A 40 KB file was cut short during a transfer and contains only the start of the image.
  3. Does it open in Photos? Drag it onto the Photos icon in the Dock. Photos uses a different import path from Preview and sometimes succeeds where Preview does not.

Step 1: check what the file actually is

Open Terminal, type file with a trailing space, drag the photo into the window, press Return:

file ~/Desktop/IMG_4821.heic
  • “ISO Media, HEIF Image HEVC Main or Main Still Picture Profile” is a genuine HEIC. Move to Step 2.
  • “JPEG image data” means it is a JPEG with a .heic extension. Rename it to .jpg and it will open. This is common with photos that passed through a website, a Windows PC, or a chat app that converts and mislabels.
  • “ISO Media, AVIF Image” is an AVIF, a different format that shares the HEIF container family. Recent macOS versions open AVIF, older ones do not; see how to convert AVIF images to JPEG on a Mac.
  • “ISO Media, HEIF Image” without the HEVC wording, or with an unfamiliar brand, usually means an HEIF from an Android phone or a camera using a flavor macOS only partly supports. Step 3 applies.
  • “data” means the header is gone, which points at a truncated or damaged file. Skip to Step 4.

Step 2: convert a real HEIC to JPEG

If the file is a real HEIC and still refuses to open, converting it often works anyway, because the conversion tools go straight to the decoder and skip some of the checks Preview applies.

With sips, which ships with macOS:

sips -s format jpeg ~/Desktop/IMG_4821.heic --out ~/Desktop/IMG_4821.jpg

If sips reports an error, the decoder could not read the image data and the file is damaged rather than merely awkward.

For a folder of photos, or if you prefer not to use Terminal, Manatee converts HEIC and HEIF to JPEG, PNG or TIFF in one drop: drag the photos onto its menu bar icon or into its window, pick the target, and it writes new files beside the originals without modifying them. It also converts the other direction if you need HEIC. Be clear about the limit: Manatee’s Repair mode covers video, PDF and Word documents, not images. If a HEIC is truncated or has damaged image data, Convert will report that it could not read the file rather than produce a blank picture. Everything runs on your Mac and nothing is uploaded. Free for 24 hours with every feature, then $9 once.

For the full set of conversion routes, including the Finder Quick Action, see how to convert HEIC to JPEG on a Mac.

Step 3: HEIF from non-Apple devices

Android phones, some cameras, and some image editors write HEIF files that use different internal arrangements from Apple’s: a different codec inside the container, a 10-bit or HDR image, a grid of tiles Apple’s decoder does not expect, or an image sequence in a single file. macOS opens many of these but not all, and support varies by version.

  1. Try sips from Step 2; it uses the same system decoder but sometimes succeeds on the main image where Preview fails on the metadata.
  2. Try opening it in a browser. Safari opens HEIC on recent macOS; the others generally do not, but it costs nothing to check.
  3. Ask the sender to export as JPEG, or to change the phone’s camera setting to a compatible format. On Android this is usually under Camera settings, “HEIF pictures” or “High efficiency pictures”, which you turn off.
  4. Update macOS. Each major version has widened HEIF support.

HEIC explained: why iPhone photos won’t open everywhere has the background on why the same extension hides several different things.

Step 4: when the HEIC really is damaged

A truncated HEIC behaves differently from a truncated JPEG. A JPEG decodes top to bottom, so a cut-off JPEG shows the top half. A HEIC stores its index and metadata in one place and the image data in another, and the image is compressed as a single HEVC frame, so a cut-off HEIC usually shows nothing at all.

What remains recoverable:

  • The embedded thumbnail. HEIC files carry a reduced-size preview near the start of the file. It is a few hundred pixels across, but it is the photo. Quick Look (select the file, press Space) will sometimes show it even when Preview refuses. Metadata tools that can extract embedded previews will pull it out as a JPEG.
  • The original elsewhere. If the photo was taken on an iPhone, it is almost certainly still in the phone’s library, in iCloud Photos, or in a backup. Re-export from there rather than fighting the damaged copy. In Photos on the iPhone, sharing a photo with “Most Compatible” selected sends a JPEG.
  • Nothing more. If the only copy is a truncated HEIC and the thumbnail is not enough, the full-resolution image is not on any disk and no tool can rebuild it.

Preventing it next time

If you regularly send photos to Windows users or to web forms, set the iPhone to capture JPEG: Settings, Camera, Formats, Most Compatible. Or leave it on High Efficiency (HEIC takes about half the space) and convert on the Mac before sharing. When transferring from the phone, AirDrop and a cable preserve the file exactly; chat apps and email may convert, recompress or truncate.

Questions

Preview opens the HEIC but the colors look washed out. Is it damaged? No. It is probably an HDR or wide-color photo being shown in an app or on a display that is not color managing it. The file is fine. Converting to JPEG with sips or Manatee produces a standard-color version that looks the same everywhere.

The HEIC opens on my iPhone but not on my Mac. Why? Either the Mac copy is incomplete (check its size against the phone’s) or the Mac is on an older macOS than the phone’s iOS, and the photo uses a newer feature such as HDR gain maps. Update macOS, or send it again with “Most Compatible” selected.

Can Manatee repair a HEIC? No. Its Repair mode handles video, PDF and Word documents. For HEIC it converts readable files to JPEG, PNG, TIFF or other targets; it does not reconstruct image data that is missing.

Is it safe to just rename .heic to .jpg? Only if file says it is actually a JPEG. Renaming a real HEIC to .jpg does not change the contents, and apps that check the header will still treat it as HEIC or refuse it.