Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

NeverMendel/heif-convert

Open more actions menu

Repository files navigation

heif-convert

Multi-Platform command line tool written in Python to convert HEIF images.

If you find heif-convert helpful, please consider giving it a star ⭐️. Your support helps me gauge its usage and motivates further development.

📝 Table of Contents

📕 About

heif-convert is a multi-platform tool written in Python to convert High Efficiency Image File (HEIF) images to jpg, png, webp, gif, tiff, bmp, or ico.

heif-convert is designed to make HEIF batch conversion easy.

⚙️ Installation

Python repository

The easiest way to get heif-convert is through the pypi.org repository. Install it by running the following command:

pip install heif-convert

Building from source

To install heif-convert from source, clone this repository and run pip install . as follows:

git clone https://github.com/NeverMendel/heif-convert.git
cd heif-convert
pip install .

Docker image

To pull heif-convert Docker image, run:

docker pull nevermendel/heif-convert

Usage

heif-convert can be used from the command line by invoking the heif-convert command.

Convert an HEIF image to a JPG image:

heif-convert input.heic

Convert all HEIF images in the current folder to JPG images:

heif-convert *.heic

Docker image

Convert an HEIF image to JPG using the Docker image:

docker run -v "$(pwd)":/usr/app/out --rm nevermendel/heif-convert input.heic

Arguments

usage: heif-convert [-h] [-o OUTPUT] [-p PATH]
                    [-f {jpg,png,webp,gif,tiff,bmp,ico}] [-q QUALITY] [-n] [-v]
                    [-vv] [-V]
                    input [input ...]

Command line tool to convert HEIF images

positional arguments:
  input                 HEIF input file(s)

options:
  -h, --help            show this help message and exit
  -o OUTPUT, --output OUTPUT
                        output file name
                        defaults to original file name (default: '{name}')
  -p PATH, --path PATH  output file path
                        defaults to original file path (default: '{path}')
  -f {jpg,png,webp,gif,tiff,bmp,ico}, --format {jpg,png,webp,gif,tiff,bmp,ico}
                        output format (default: jpg)
  -q QUALITY, --quality QUALITY
                        output quality, integer [0, 100] (default: 90)
  -n, --no-exif         Do not include EXIF metadata in the converted image
  -v, --verbose         enable verbose logging
  -vv, --extra-verbose  enable extra verbose logging
  -V, --version         show program's version number and exit

Libraries

heif-convert uses the following libraries:

Supported operating systems

heif-convert works on Linux, Mac OS and Windows systems. For further information refer to the pillow_heif repository.

License

MIT License

Morty Proxy This is a proxified and sanitized view of the page, visit original site.