avifdec(1) General Commands Manual avifdec(1)
NAME
avifdec - decompress an AVIF file to an image file
SYNOPSIS
avifdec [options] input.avif output.[jpg|jpeg|png|y4m]
avifdec --info input.avif
DESCRIPTION
avifdec decompresses an AVIF file to an image file. Output format can
be either JPEG, PNG or YUV4MPEG2 (Y4M).
OPTIONS
-h, --help
Show syntax help.
-V, --version
Show the version number.
-j, --jobs J
Number of jobs (worker threads), or `all' to potentially use as
many cores as possible. (Default: all).
-c, --codec C
Codec to use.
Possible values depend on the codecs enabled at build time (see
--help or --version for the available codecs). Default is
auto-selected from the available codecs.
Possible values are:
o aom
o dav1d
o libgav1
-d, --depth D
Output depth, either 8 or 16. (PNG only; For y4m, depth is
retained, and JPEG is always 8bpc).
-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.
-i, --info
Decode all frames and display all image information instead of
saving to disk.
--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.
EXAMPLES
Decompress an AVIF file to a PNG file:
$ avifdec input.avif output.png
REPORTING BUGS
Bugs can be reported on GitHub at:
<https://github.com/AOMediaCodec/libavif/issues>
SEE ALSO
avifenc(1)
libavif 1.2.1 2022-04-30 avifdec(1)
libavif 1.2.1 - Generated Thu May 8 10:42:16 CDT 2025