HEIF-ENC(1)

📦
version 1.23.7 · 3 versions
, in alpine 3.23, alpine 3.24, arch rolling, debian trixie, epel 10, epel 9, fedora 43, fedora 44, nixpkgs unstable, ubuntu questing, ubuntu resolute, ubuntu stonking

🌸 HEIF-ENC(1) — the manual page, but make it cute 🌸

okay bestie, welcome to HEIF-ENC(1), straight outta the General Commands Manual 💖 this is the little tool that takes your pics and turns them into HEIC/HEIF and honestly? it eats.

✨ NAME ✨

heif-enc — convert image to HEIC/HEIF 💅

🦋 SYNOPSIS 🦋

heif-enc [-h|--help] [-q QUALITY|--quality QUALITY] [-L|--lossless] [-t
SIZE|--thumb SIZE] [--no-alpha] [--no-thumb-alpha] [-o FILENAME|--output
FILENAME] [-v|--verbose] [-P|--params] [-b DEPTH] [-p NAME=VALUE]
filename[.jpg|.png|.y4m]

like... that's the whole vibe in one block, no cap.

🎀 DESCRIPTION 🎀

heif-enc converts an image to HEIC/HEIF. that's it, that's the job, and it does it flawlessly. periodt. ✨

👑 OPTIONS 👑

  • -q QUALITY, --quality QUALITY — sets the quality level for the output file, anywhere from 0 to 100. pick your fighter 🫶
  • -L, --lossless — gives you lossless output. and heads up bestie: -q has no effect when you use this one. it's giving "i do what i want". 💀
  • -t SIZE, --thumb SIZE — makes a thumbnail with a maximum size of SIZE pixels. default is off, so if you want thumbnails you gotta ask for them. 🙈
  • --no-alpha — do not save the alpha channel. bye transparency 🦋
  • --no-thumb-alpha — do not save the alpha channel in the thumbnail image either. consistency, we love to see it.
  • -o FILENAME, --output FILENAME — the output filename. it's optional, so like, your call. 💅
  • --verbose — turns on logging output, and more of it cranks the logging level up higher. the way that more --verbose = more talking?? iconic. 📢
  • -P, --params — shows you all the encoder parameters and then exits. and get this: the input file is not required or used. so you can just vibe and read the menu. 🍓
  • -b DEPTH — the bit-depth of the generated HEIF file, used when you're feeding in a 16-bit PNG input. default is 10 bit. ⭐
  • -p NAME=VALUE — set extra encoder parameters. details down in NOTES, keep scrolling bestie 👇

💀 EXIT STATUS 💀

  • 0 — success!! we slayed 💖
  • 1 — failure. and yeah, that covers syntax or usage errors, plus errors while loading, converting or writing the image. it's a whole umbrella of not-today. 😭

🌈 NOTES 🌈

which input formats you get depends on the libraries that were available at compile time, so it's lowkey a mystery until you try. supported are JPEG, PNG and Y4M, and the file type is figured out based on the extension of the input file. 🔍

when you specify multiple source images, they will all be saved into the same HEIF file. one file, many pics, main character energy. 👑

when you're using the x265 encoder, you may pass it any of its parameters by prefixing the parameter name with x265:. so to set the ctu parameter, you'll have to set x265:ctu in libheif — like this:

-p x265:ctu=64
⚠️ and bestie, listen: there is no checking for valid parameters when you use that prefix. it will not hold your hand. it will not warn you. it will simply let you cook. 🔥

🐛 BUGS 🐛

please report bugs or issues at https://github.com/strukturag/libheif — they wanna hear from you fr fr 🫶

🧚 AUTHORS 🧚

Dirk Farin, struktur AG — thank you for your service 🎀

Copyright © 2017 struktur AG

and that's the whole page bestie!! this one came from the General Commands Manual, filed under HEIF-ENC(1) — go forth and convert, you absolute icon 🌸✨💅

📦 where this page comes from