OS Manuals

/usr/bin/odiff

SIMD-first pixel-by-pixel image comparison tool

From odiff 4.5.0-r0 (enterprise-packages), captured 2026-11-08 by running odiff --help (exit 0). permalink

Usage: /usr/bin/odiff <base_image> <comp_image> [diff_output] [options]

Options:
  -t, --threshold <value>     Color difference threshold (0.0-1.0, default: 0.1)
  --diff-mask                 Output only changed pixels over transparent background
  --diff-overlay <value?>     Render diff output on the white background
  --fail-on-layout            Fail if image dimensions differ
  --parsable-stdout           Machine-readable output format
  --diff-color <hex string>   Color for highlighting differences (e.g., #cd2cc9)
  --aa, --antialiasing        Ignore antialiased pixels in diff
  --output-diff-lines         Output line numbers with differences
  --output-diff-cols          Output column numbers with differences
  --reduce-ram-usage          Use less memory (slower)
  --enable-asm                Enable AVX-512 optimized asm path when supported (x86_64 only)
  --server                    Run in server mode (reads JSON from stdin)
  -i, --ignore <regions[]>    Ignore regions (format: x1:y1-x2:y2,x3:y3-x4:y4)
  -h, --help                  Show this help message
  --version                   Show version

Exit codes:
  0  - Images match
  21 - Layout difference (when --fail-on-layout is used)
  22 - Pixel differences found
Options (15)
OptionDescriptionSource
-t, --threshold valueColor difference threshold (0.0-1.0, default: 0.1)help
--diff-maskOutput only changed pixels over transparent backgroundhelp
--diff-overlay value?Render diff output on the white backgroundhelp
--fail-on-layoutFail if image dimensions differhelp
--parsable-stdoutMachine-readable output formathelp
--diff-color hexColor for highlighting differences (e.g., #cd2cc9)help
--aa, --antialiasingIgnore antialiased pixels in diffhelp
--output-diff-linesOutput line numbers with differenceshelp
--output-diff-colsOutput column numbers with differenceshelp
--reduce-ram-usageUse less memory (slower)help
--enable-asmEnable AVX-512 optimized asm path when supported (x86_64 only)help
--serverRun in server mode (reads JSON from stdin)help
-i, --ignore regionsIgnore regions (format: x1:y1-x2:y2,x3:y3-x4:y4)help
-h, --helpShow this help messagehelp
--versionShow versionhelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.