OS Manuals

/usr/bin/heif-convert

libheif is an HEIF and AVIF file format decoder and encoder.

From libheif 1.23.7-r1 (os), captured 2026-11-05 by running heif-convert --help (exit 0). permalink

 heif-convert  libheif version: 1.23.7
---------------------------------------
Usage: heif-convert [options]  <input-image> [output-image]

The program determines the output file format from the output filename suffix.
These suffixes are recognized: jpeg, jpg, png, tif, tiff, webp, y4m. If no output filename is specified, 'jpg' is used.

Options:
  -h, --help                     show help
  -v, --version                  show version
  -q, --quality                  quality (for JPEG output)
  -o, --output FILENAME          write output to FILENAME (optional)
  -d, --decoder ID               use a specific decoder (see --list-decoders)
      --with-aux                 also write auxiliary images (e.g. depth images)
      --with-xmp                 write XMP metadata to file (output filename with .xmp suffix)
      --with-exif                write EXIF metadata to file (output filename with .exif suffix)
      --skip-exif-offset         skip EXIF metadata offset bytes
      --no-colons                replace ':' characters in auxiliary image filenames with '_'
      --list-decoders            list all available decoders (built-in and plugins)
      --tiles                    output all image tiles as separate images
      --quiet                    do not output status messages to console
  -S, --sequence                 decode image sequence instead of still image
      --ignore-editlist          show the raw media sequence timeline without repetitions
  -C, --chroma-upsampling ALGO   Force chroma upsampling algorithm (nn = nearest-neighbor / bilinear)
      --png-compression-level #  Set to integer between 0 (fastest) and 9 (best). Use -1 for default.
      --transparency-composition-mode MODE  Controls how transparent images are rendered when the output format
                                            support transparency. MODE must be one of: white, black, checkerboard.
      --disable-limits           disable all security limits (do not use in production environment)
      --auto-correct             work around known broken-input quirks (e.g. Sony HIF full-range flag mismatch)
      --codec-threads #          number of threads to use in the codec plugin (0 = default)
      --tile-threads #           max number of tiles to decode in parallel (default = 4)
      --extract-mime-item TYPE   extract the MIME item with the given content type into a file (mime-item.data)
Options (23)
OptionDescriptionSource
-h, --helpshow helphelp
-v, --versionshow versionhelp
-q, --qualityquality (for JPEG output)help
-o, --output FILENAMEwrite output to FILENAME (optional)help
-d, --decoder IDuse a specific decoder (see --list-decoders)help
--with-auxalso write auxiliary images (e.g. depth images)help
--with-xmpwrite XMP metadata to file (output filename with .xmp suffix)help
--with-exifwrite EXIF metadata to file (output filename with .exif suffix)help
--skip-exif-offsetskip EXIF metadata offset byteshelp
--no-colonsreplace ':' characters in auxiliary image filenames with '_'help
--list-decoderslist all available decoders (built-in and plugins)help
--tilesoutput all image tiles as separate imageshelp
--quietdo not output status messages to consolehelp
-S, --sequencedecode image sequence instead of still imagehelp
--ignore-editlistshow the raw media sequence timeline without repetitionshelp
-C, --chroma-upsampling ALGOForce chroma upsampling algorithm (nn = nearest-neighbor / bilinear)help
--png-compression-level #Set to integer between 0 (fastest) and 9 (best).help
--transparency-composition-mode MODEControls how transparent images are rendered when the output format support transparency.help
--disable-limitsdisable all security limits (do not use in production environment)help
--auto-correctwork around known broken-input quirks (e.g. Sony HIF full-range flag mismatch)help
--codec-threads #number of threads to use in the codec plugin (0 = default)help
--tile-threads #max number of tiles to decode in parallel (default = 4)help
--extract-mime-item TYPEextract the MIME item with the given content type into a file (mime-item.data)help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.