heic2rgb

heic2rgb is a Python package which does exactly one thing: convert the main image in a HEIC file to raw RGB pixels.

Usage

Simply pass the HEIC file as bytes to the decode function:

import heic2rgb
image = heic2rgb.decode(heic_bytes)

This will return a RgbImage object with width, height and data properties, where data is the decoded image as bytes.

Benchmark

Decoding a 5632x4352 image on a i5-4440:

Library	Mean	Std. dev.
heic2rgb 0.1	0.59 s	0.01 s
pyheif 0.7.1	1.53 s	0.11 s
pillow-heif 0.6.1	1.85 s	0.05 s

Build

Linux

0) Install prerequisites:

sudo apt update
sudo apt install make cmake g++ python3-pip ffmpeg libavcodec-dev libswscale-dev
pip install scikit-build

1) Clone heic2rgb:

git clone https://github.com/sk-zk/heic2rgb.git

2) Clone and build ISOBMFF:

git clone https://github.com/sk-zk/ISOBMFF.git --recursive
cd ISOBMFF
make
cp ./Build/Release/Products/x86_64/libISOBMFF.a ../heic2rgb/lib/
cp -r ./ISOBMFF/include/* ../heic2rgb/lib/headers/

3) Build heic2rgb:

cd ../heic2rgb
python3 setup.py bdist_wheel
pip install ./dist/[name of wheel]

Windows

TODO: Describe Windows build steps

Credits

heic2rgb is based on tifig by monostream GmbH.

This software uses code of FFmpeg licensed under the LGPLv2.1.