avifdec

avifdec [options] <infile.avif> [outfile.png|outfile.y4m]

-h, --help
    Show help message and exit

-j, --jobs N
    Decode using N jobs (default: 4)

-s, --speed N
    Decoder speed (0-10, default: 7; lower=slower/better quality)

-l, --limit N
    Stop after N images/tiles (default: 0=no limit)

--cppps
    Print CICP, aspect ratio, clean aperture properties

-y, --yes
    Overwrite output file without prompting

-cc, --no-colr-cleanup
    Skip color profile cleanup (default: cleanup)

-ci, --colr-icc
    Export ICC profile to <basename>.icc

--colr-profiles-only
    Export only ICC/XML profiles (no image)

-v, --verbose / -vv
    Verbose (-v) or very verbose (-vv) output

--version
    Print version and exit

avifdec is a command-line tool from the libavif library for decoding AVIF (AV1 Image File Format) images. AVIF is a modern image format based on the AV1 video codec, offering superior compression compared to JPEG, WebP, or PNG while supporting HDR, wide color gamut, and transparency.

avifdec converts AVIF files to portable formats like PNG (lossless RGB) or Y4M (YUV video stream for further processing). It leverages high-performance AV1 decoders like dav1d for fast decoding. Key features include multi-threaded decoding with configurable job counts, speed vs. quality trade-offs, and handling of advanced metadata like color profiles (ICC/XML export). It supports progressive decoding limits for large files and verbose logging for debugging.

Ideal for batch conversion, web optimization, or integration in pipelines. Install via package managers (e.g., apt install libavif-bin) or build from source. Outputs preserve quality unless speed-optimized.

Requires libavif and AV1 decoder (e.g., dav1d). Large files may consume high memory. Speed 0 prioritizes quality over speed. PNG output is lossless; Y4M for video pipelines.

PNG for still images (outfile.png); Y4M for YUV streams (outfile.y4m). Defaults to PNG if unspecified.

Built on libavif; needs AV1 decoder like dav1d, rav1e. Check with avifdec --version.

Part of libavif (Netflix, 2020+), implementing AVIF spec from Alliance for Open Media. Integrated dav1d for speed. Actively maintained for AVIF adoption in browsers/apps.

avifenc(1), ffmpeg(1), ImageMagick(1), pngcrush(1)