A certain cellphone maker has changed the default format of taking pictures to HEIF (.HEIC, High Efficiency Image File Format), without asking the users (although there is still the option to use jpeg/jpg).

Is there an app/program on Ubuntu that can open and/or convert HEIF-pictures and even let them be edited?


6 Answers 6


In recent Ubuntu versions (>= 18.04):

sudo apt-get install libheif-examples

And then

for file in *.heic; do heif-convert $file ${file/%.heic/.jpg}; done

In older Ubuntu or Mint versions, first add this PPA and then do the above steps.

sudo add-apt-repository ppa:strukturag/libheif
sudo apt-get update
  • 24
    1) This is an official package of 18.04 (packages.ubuntu.com/bionic/libheif-examples) and 2) I had to change .heic to .HEIC in both places since mine were capitalized. Thank you!! This worked so well!
    – Native Dev
    May 21, 2019 at 10:21
  • 6
    for file in *.HEIC; do heif-convert -q 100 $file $file.jpg; done
    – SD.
    Feb 7, 2020 at 14:19
  • 3
    Thanks for this post, it was helpful! A small note that might help someone else: I'm not that familiar with Bash and terminal scripting and it took me more than 30 minutes to figure out that pasting this command caused the error Input file is not an HEIF file because my files had UPPER case extension HEIC and the command used lower-case..
    – hallvors
    Aug 31, 2020 at 15:46
  • 6
    This answer won't work with files with spaces/newlines in their names. This version would work: for file in *.HEIC; do heif-convert "$file" "${file/%.HEIC/.jpg}"; done Apr 5, 2021 at 8:28
  • 1
    Don't forget to specify JPEG quality and quote the parameters if there are any spaces or other special characters in the file names: for file in *.heic; do heif-convert -q 97 "$file" "${file/%.heic/.jpg}"; done Feb 20, 2023 at 18:19

Ubuntu 22.04 quick start

  • install heif-gdk-pixbuf for support in at least eog (Eye of GNOME, GNOME Image Viewer).
  • install heif-thumbnailer for file manager (nautilus, nemo) thumbnails.
  • The available versions of Geeqie, ImageMagick, gThumb and many more (see below) have built-in support.

Official packages

Starting with Ubuntu 20.04: At least for eog (Eye of GNOME, GNOME Image Viewer), you have to install the package heif-gdk-pixbuf (no PPA needed). In a terminal run:

sudo apt install heif-gdk-pixbuf

This will install libheif1 and libde265-0 along.

Apparently KDE distros with KDE Frameworks 5.80 have added support for HEIF and HEIC Image Formats to all KDE Apps (news, KDE announcement, MR), but the support flag is not enabled yet in the default (K)ubuntu packages (ubuntu bug).

Programs/Apps that support HEIF via libheif1 include:

See How best to search for dependencies?

Programs/Apps to CONVERT HEIF/HEIC-pictures:
Most of the above mentioned apps support to convert a HEIC-photo, e.g. eog (Eye of GNOME, GIMP, Krita, GPicView.
Open the photo via one of these image viewer/editor, then select Export to JPG (or another image format like PNG) or Save as (choose a different image format then HEIC).

For batch conversion on the command-line, use heif-convert or ImageMagick's convert.

Unofficial Packages and older Ubuntu versions

If one is willing to install a Flatpak, Snap app, or PPA:

  • GNOME Image Viewer (Eye of GNOME - eog) can handle HEIF pictures with an updated gdk-pixbuf plugin which can be installed/updated with the above mentioned libheif-PPA on Ubuntu 14.04, 16.04, and 18.04. In a terminal run:

    sudo add-apt-repository ppa:strukturag/libheif

    Install the package heif-gdk-pixbuf. In a terminal run:

    sudo apt install heif-gdk-pixbuf
  • gThumb Image Viewer & Organizer has an unofficial PPA for Ubuntu 18.04, Ubuntu 20.04, Ubuntu 21.04, Ubuntu 21.10, Linux Mint 20 and derivatives:

    sudo add-apt-repository ppa:ubuntuhandbook1/apps  
    sudo apt update  
    sudo apt install gthumb 
  • Geeqie 1.6 has HEIF support. It is available in 22.04 ; it may be installed from AppImage, or on ubuntu 18.04 and 20.04 from PPA.

  • ImageMagick 6.9 with HEIF support is available on ubuntu 22.04 ; on ubuntu 18.04 and 20.04 from bleeding edge PPA which also provides an updated libheif1 (1.12 instead of 1.6 as of October'21). If the colors seem wrong/inverted, you may need to convert from YCbCr with e.g. display -colorspace sRGB (source: github)

  • Qt image plugin wraps libheif. It was created by jakar, and may be installed on ubuntu 14.04 to 19.04 from PPA. On more recent versions you may instead rebuild kimageformats as per bug 1951278.

Ubuntu 19.10
There are some prominent bugs in the shipped version of libheif1, so update to the latest version available from the PPA libheif by “struktur AG” team:
In a terminal: sudo add-apt-repository ppa:strukturag/libheif

Upgrade of packages (Sept 2020)
You also need to add the PPA strukturag/libde265 to get the correct dependencies:

sudo add-apt-repository ppa:strukturag/libde265  
sudo apt update  
sudo apt upgrade  

(If you get the error add-apt-repository: not found, make sure software-properties-common is installed, e.g. sudo apt install software-properties-common)

Those who do not wish to install a PPA may download the packages directly from the PPA webpages to install (dpkg -i) or recompile. Packages installed this way will not be automatically updated.

Online Tools

  • Google Photos and Dropbox both support HEIF.

  • There are other online converters (e.g. HEICtoJPEG), but check their privacy policies before use.


  • 1
    Not sure what the proper etiquette to mention this is (maybe I should edit instead of comment?), but I created a Qt image plugin that wraps libheif. I would like to create a PPA, but that hasn't happened yet.
    – jakar
    Jul 1, 2018 at 21:53
  • 2
    The Qt plugin PPA is now up.
    – jakar
    Jul 19, 2018 at 21:54
  • 1
    I'm using Ubuntu 19.10, and I was able to open a HEIF image in "Image Viewer" without needing to do anything special – no extra PPAs
    – seanlano
    Feb 6, 2020 at 10:23
  • 1
    Huh, I tried again today and this time it's working, even though I just repeated the same eog command in the same terminal as yesterday... Ah well, it works now, thank you for your patience with my weird problems!
    – weronika
    Feb 5, 2021 at 20:37
  • 2
    Thank youuuuuu!
    – Ryan
    Jun 12, 2022 at 23:35

On Ubuntu 20.04 Focal Fossa:

$ sudo apt install heif-gdk-pixbuf heif-thumbnailer gimagereader gpicview

then find an HEIC file in the file manager, right click, select Properties then Open With and select Image Viewer (if there's two of them, select the one with the more colourful icon) and then select Set as default (or Add if that's the only option.) example of setting the HEIF MIME type

After that you can double-click HEIF files to view them:

example of an HEIF image opened from the file manager

Older Ubuntu LTS:

On Ubuntu 18.04 you can sudo snap install gimp to get the latest version (2.10.10 8 as of May 2019) which can open and edit HEIC files.

On Ubuntu 18.04 there's also a commandline tool to convert HEIC:

sudo apt install libheif-examples
heif-convert IMG_1605.HEIC IMG_1605.jpg

NOTE: you must use lowercase .jpg or it will complain that it doesn't recognise the file format. That message is almost as misleading as the package name, and I can easily understand given these two papercuts why so few people have figured out how to use this tool.

For anyone who doubts that this is an official Ubuntu package:

user@host:~/Desktop$ dpkg -s libheif-examples 
Package: libheif-examples
Status: install ok installed
Priority: optional
Section: video
Installed-Size: 91
Maintainer: Ubuntu Developers <[email protected]>
Architecture: amd64
Source: libheif
Version: 1.1.0-2
Depends: libheif1 (= 1.1.0-2), libc6 (>= 2.14), libgcc1 (>= 1:3.0), libjpeg8 (>= 8c), libpng16-16 (>= 1.6.2-1), libstdc++6 (>= 5.2)
Description: ISO/IEC 23008-12:2017 HEIF file format decoder - examples
 libheif is an ISO/IEC 23008-12:2017 HEIF file format decoder. HEIF is a new
 image file format employing HEVC (h.265) image coding for the best compression
 ratios currently possible.
 Sample applications using libheif are provided by this package.
Original-Maintainer: Debian Multimedia Maintainers <[email protected]>
Homepage: http://www.libheif.org

OK so now the punchline of this joke. ;-)

You can use fuseflt or yacufs FUSE filesystems to mount your pictures folder with automated temporary cached conversion of your HEIC files so all the stock Linux desktop apps can open the HEIC files without ever knowing they're doing it.

Mark Deven below says that he only needed to install libheif via aptitude to get these commands, though he didn't mention what distro he's running.

  • After installing these packages, libheif-examples and heif-convert are not found commands.
    – Mark Deven
    Feb 13, 2019 at 15:17
  • 1
    I got it working using aptitude and installing just libheif
    – Mark Deven
    Feb 15, 2019 at 21:06
  • 1
    FWIW, Debian 10 (Buster) includes, in its standard repo, the libheif-examples package, which lists the libheif1 package as a dependency. Note that I've not tested said package, as I'm still (sadly) languishing in Debian 7 (Wheezy).
    – Digger
    Mar 4, 2019 at 16:48
  • 1
    @Óscar: please read the first line of the post again. snap is off the shelf. gimp comes with snap. 2.10.10 is the current version for 18.04 via snap
    – Wil
    May 23, 2019 at 17:40
  • 1
    For Ubuntu 20.04 it's now working in GNOME Image Viewer (Eye of GNOME - eog)
    – adasiko
    May 16, 2020 at 9:07

GIMP 2.10.2 now reads, writes, and edits .HEIC container files, and ImageMagick will convert from .HEIC image container files.


While not really a local conversion, it is possible to view .heic images using Dropbox.

Simply upload the subject images to your Dropbox account, then click on the desired image to view it. You can even right-click on the image to save the .jpeg file back to your local machine in JPEG format. (Note: don't click on the Dropbox's Download button, as that will just get the original .HEIC file.)

  • 1
    I voted you up solely because syncing your photos to the cloud is a great idea, keeping them in HEIC format saves space without degrading quality, and being able to access them via a browser means you can access and share them more easily. So it's win win win even if it doesn't really answer the question.
    – Wil
    Dec 8, 2018 at 13:31

This is how I convert .HEIC files into .jpeg.

  1. Download and install tifig package.

    wget https://github.com/monostream/tifig/releases 
    gunzip tifig-static-0.2.2.tar.gz #or the downloaded tifig file name
  2. make tifig executable.

    mv ./tifig ~/tools/tifig
    sudo chmod +x  ~/tools/tifig
  3. Now you can use tifig to convert your .heic files.

    for f in *.HEIC; do mv "$f" "\`echo $f | sed s/.HEIC/.heic/`"; done
    for file in *.heic; do echo $file | xargs ~/tools/tifig -v -p $file ${file%.heic}.jpg; done


  • Did you really need to rename them from .HEIC to .heic before converting them?
    – RonJohn
    May 8, 2023 at 6:50

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .