Tools to Inspect AVIF ISOBMFF Box Hierarchy

AVIF (AV1 Image File Format) relies on the ISO Base Media File Format (ISOBMFF) container to package compressed AV1 image data and associated metadata. Inspecting the nested box (atom) structure—such as ftyp, meta, iinf, iloc, and mdat—is essential for debugging encoding anomalies, verifying container compliance, and auditing embedded metadata. This guide covers the most effective command-line utilities, graphical interfaces, and binary analysis tools designed to parse and display the raw ISOBMFF box hierarchy of an AVIF file.

Dedicated AVIF and HEIF CLI Utilities

Because AVIF is a specific profile of HEIF (which is derived from ISOBMFF), specialized image libraries provide native tools to dump container boxes.

  • avifdump (libavif): Distributed with the official AOMedia libavif repository, avifdump is specifically built to parse AVIF files. Running avifdump input.avif parses and prints the structural layout of the file, providing details on item IDs, configurations, color profiles, and the ISOBMFF box tree directly relevant to the AVIF specification.
  • heif-dump (libheif): Since AVIF uses the same underlying container mechanisms as HEIC, the heif-dump command-line utility from libheif can parse AVIF files. It displays a clean, indented text tree of the box hierarchy along with offset addresses, payload sizes, and header flags.

General ISOBMFF Parsers

General-purpose MP4 and ISOBMFF diagnostic utilities can inspect any compliant file format, including AVIF.

  • MP4Box (GPAC): GPAC's MP4Box is a mature and comprehensive tool for inspecting container formats. Running MP4Box -diso input.avif generates an XML-formatted breakdown of every ISOBMFF box in the file, detailing offsets, nested child boxes, and raw property values. The -info flag can also yield a concise human-readable summary.
  • isobmff-box-dump: Available across various open-source language ecosystems (such as Python's isobmff library or Node.js parsers), these lightweight scripts read the four-character codes (4CC) and sizes from the file stream and print out an indented ASCII representation of the tree structure.

Graphical and Web-Based Viewers

For interactive navigation without terminal commands, visual tree explorers simplify collapsing and expanding nested boxes.

  • ISOViewer: A classic Java-based application capable of opening any ISOBMFF-compliant file. It visualizes the nested box hierarchy in a collapsible tree pane on the left, while displaying decoded header fields, hex views, and box attributes in the details pane on the right.
  • Web-Based ISOBMFF Box Viewers: Several browser-based tools run local client-side JavaScript parsers to inspect files without uploading them to external servers. These tools provide instant visualization of the box tree, display raw byte offsets, and parse common item-location boxes (iloc) and item-reference boxes (iref).

Advanced Binary Analysis and Hex Editors

When standard parsers fail due to malformed headers or corrupt byte streams, low-level binary tools with structural templates provide the necessary insight.

  • 010 Editor (with ISOBMFF/QuickTime Template): 010 Editor applies a pre-built binary template to an open AVIF file. It maps out the exact byte boundaries of each box, decodes standard integer fields, and highlights the corresponding raw hex values in real time.
  • ImHex: An open-source hex editor that supports custom pattern languages. Using an ISOBMFF or MP4 pattern, ImHex can parse and label variable-length boxes, flags, and item payloads directly over the raw binary representation of the AVIF container.