image-diff is a high-performance CLI tool designed for visual regression testing and dataset validation. It provides structural and pixel-level comparison of images with instant terminal-native previews.

• Blazing Fast: Parallel directory processing using Rust's Rayon.
• High-Res Previews: Support for Sixel, Kitty, and iTerm2 graphics protocols for near-perfect terminal previews (with automatic ANSI fallback).
• Perceptual Accuracy: Uses CIEDE2000 color difference formula for human-centric comparison.
• Anti-Aliasing Detection: Intelligent heuristic to ignore sub-pixel rendering artifacts in UI tests.
• Directory Diffing: Recursively compare folders of images with summary reporting.
• Interactive Review: Step through differences and accept/reject changes on the fly.
• CI/CD Ready: Support for JSON output and semantic exit codes.

Ensure you have Rust installed, then clone and build:

git clone https://github.com/cachevector/image-diff
cd image-diff
cargo build --release

The binary will be available at ./target/release/image-diff.

image-diff baseline.png screenshot.png --preview --output diff.png

image-diff ./goldens/ ./screenshots/ --threshold 0.1

Fail the build if any differences are found and output machine-readable results:

image-diff a.png b.png --json --fail-on-diff

Ignore parts of the image that change frequently using coordinates:

image-diff a.png b.png --ignore 0,0,100,50

Use an image as a mask. Black pixels in the mask image will be ignored in the comparison:

image-diff a.png b.png --mask mask.png