AVIFDEC(1)

📦
version 1.4.2 · 7 versions
, in ubuntu stonking

💖 AVIFDEC — the decompress girlie ✨

okay so bestie, welcome to avifdec, part of the General Commands Manual lineup 😌 this is the libavif tool that takes your AVIF files and turns them back into actual images. she's giving reverse-makeover energy and honestly? iconic.

🎀 NAME 🎀

avifdec — decompress an AVIF file to an image file 💅

🌸 SYNOPSIS 🌸

avifdec [options] input.avif output.[jpg|jpeg|png|y4m]

avifdec --info input.avif

like. give her an input, give her an output, optionally whisper some options at her. that's the whole relationship fr fr 🫶

🦋 DESCRIPTION 🦋

avifdec decompresses an AVIF file to an image file. no cap, that's the job. the output format can be JPEG, PNG or YUV4MPEG2 (Y4M) — she reads the vibe of your output filename and just... knows ✨

💅 OPTIONS 💅

so many little knobs and honestly each one ate:

  • -h, --help — show syntax help. your girl explains herself.
  • -V, --version — show the version number. for the nosy besties.
  • -j, --jobs J — number of jobs (worker threads), or all to potentially use as many cores as possible. (Default: all). she will absolutely use your whole CPU and she's not sorry 🔥
  • -c, --codec C — codec to use. possible values depend on the codecs enabled at build time (peep --help or --version for the available codecs). default is auto-selected from the available codecs. the possible values are:
    • aom
    • dav1d
    • libgav1
  • -d, --depth D — output depth, either 8 or 16. (PNG only; for y4m, depth is retained, and JPEG is always 8bpc). soz jpeg girlies, 8 is all you get.
  • -q, --quality Q — output quality in 0..100. (JPEG only, default: 90).
  • --png-compress L — PNG compression level in 0..9 (PNG only; 0=none, 9=max). defaults to libpng's builtin default.
  • -u, --upsampling U — chroma upsampling (for 420/422). one of automatic (default), fastest, best, nearest, or bilinear.
  • -r, --raw-color — output raw RGB values instead of multiplying by alpha when saving to opaque formats (JPEG only; not applicable to y4m).
  • --index I — when decoding an image sequence or progressive image, specify which frame index to decode, where the first frame has index 0, or all to decode all frames. (Default: 0).
  • --progressive — enable progressive AVIF processing. if a progressive image is encountered and --progressive is passed, avifdec will use --index to choose which layer to decode (in progressive order).
  • --no-strict — disable strict decoding, which disables strict validation checks and errors. living dangerously, love that for you 🙈
  • -i, --info — decode all frames and display all image information instead of saving to disk. the ~look but don't touch~ option.
  • --icc FILENAME — provide an ICC profile payload (implies --ignore-icc).
  • --ignore-icc — if the input file contains an embedded ICC profile, ignore it (no-op if absent).
  • --size-limit C — maximum image size (in total pixels) that should be tolerated. (Default: 268435456).
  • --dimension-limit C — maximum image dimension (width or height) that should be tolerated. set to 0 to ignore. (Default: 32768).
  • -- — signal the end of options. everything after this is interpreted as file names. the classic "okay we're done with flags now" divider ✋
tiny note bestie: if anything in here is about strict validation or limits, take it seriously — those exist to stop cursed files from ruining your day 💀

🍓 EXAMPLES 🍓

decompress an AVIF file to a PNG file:

$ avifdec input.avif output.png

one line. one slay. go off 👑

🌈 REPORTING BUGS 🌈

bugs can be reported on GitHub at:

https://github.com/AOMediaCodec/libavif/issues

if she did something weird, tell the devs, not me 😭 they're very nice.

⭐ SEE ALSO ⭐

avifenc(1) — the other half of the duo, the one who puts AVIFs together. sibling energy fr.

mwah 💜 this page is from libavif 1.4.2, dated 2022-04-30 — so if you're reading this in the future, hi, you're a time traveler, and this manual was still serving. 🎀✨

📦 where this page comes from