From Gentoo Wiki
Jump to:navigation Jump to:search
This article is a stub. Please help out by expanding it - how to get started.

This article provides configuration information to add HEIF container format support to desktop environments supporting its integration.

HEIF formatted files can be generated by Apple or Android phones and typically end with a .heic file extension suffix.

USE flags

Global =

Several packages are aware of the global heif USE flag. Enable it in /etc/portage/make.conf like:

FILE /etc/portage/make.conf
USE="... heif ..."

Then perform a world upgrade:

root #emerge --ask --changed-use --deep --update @world

Desktop environments


In order for software in the GNOME suite of desktop applications to display HEIF encoded files (typically ending with the .heic file extension suffix), the gdk-pixbuf USE flag must be enabled for the media-libs/libheif package.

It is likely that users of GNOME will want to enable gdk-pixbuf globally in /etc/portage/make.conf for general better integration.

This example will only enable support for the libheif library itself:

FILE /etc/portage/package.use/libheifEnable libheif's gdk-pixbuf plugin to be built
# Enable support for rendering HEIF/HEIC for GNOME apps
media-libs/libheif gdk-pixbuf

Rebuild the world set so that the changes take effect:

root #emerge -uND --with-bdeps=y @world

Update the loaders.cache file in order to discover the newly added plugin:

root #gdk-pixbuf-query-loaders --update-cache

Image files of the HEIF type should now properly open and render in GNOME's Image Viewer (media-gfx/eog).

See also

  • Multimedia container formats — adds clarity and insight for end-users (generally on desktop profiles) on how enable Gentoo to display multimedia.