# Install imgdiff with Homebrew, apk

Pixel-by-pixel image difference tool. Version 1.0.2 via Homebrew; verified 2026-07-26. Also installable with apk: sudo apk add imgdiff.

## Install

```sh
sudo av install brew:imgdiff
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install imgdiff
```

  Evidence: local Homebrew formula metadata

### Linux

- apk (92%):

```sh
sudo apk add imgdiff
```

  Evidence: Alpine Linux edge package indexes: imgdiff from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz

## Package facts

- **Package key:** brew:imgdiff
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/imgdiff>
- **Version:** 1.0.2
- **Source summary:** Pixel-by-pixel image difference tool
- **Homepage:** <https://github.com/n7olkachev/imgdiff>
- **Repository:** <https://github.com/n7olkachev/imgdiff>
- **License:** MIT
- **Source archive:** <https://github.com/n7olkachev/imgdiff/archive/refs/tags/v1.0.2.tar.gz>
- **Last updated:** 2026-07-26T04:07:47+02:00
- **Generated:** 2026-08-04T22:13:35+00:00

## Executables

- imgdiff (cli)
- imgdiff (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_big_sur, arm64_linux, arm64_monterey, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, big_sur, monterey, sonoma, ventura, x86_64_linux

## Freshness

- Page generated: 2026-08-04
- Package-manager version: 1.0.2
- Package-manager updated: 2026-07-26
- Local data: ok
- Upstream repository: https://github.com/n7olkachev/imgdiff
- Upstream latest detected: v1.0.2 (current)
## Project history and usage

imgdiff is a small Go command-line utility for pixel-by-pixel image comparison. Its public README frames the project as a faster response to odiff, another visual-diff tool used in image-regression and screenshot-testing workflows.

### Project history

The GitHub repository was created on 2020-12-12, and the v1.0.0 release was published the same day as an initial release with pre-built binaries. Follow-up releases in February and March 2021 fixed package-path and output-writing issues, after which the package remained a compact single-purpose visual comparison tool.

### Adoption history

Adoption appears niche but visible: the repository has roughly 1.7k GitHub stars in repository metadata, and Homebrew publishes a formula for macOS users. Homebrew analytics for the formula show low install counts, which fits a developer-tooling utility used mainly inside visual test and image-comparison workflows.

### How it is used

The README documents a CLI that accepts base, compare, and output image paths, with options for color-difference threshold, diff-image rendering, and layout-failure behavior. The intended use is direct image comparison rather than general image editing.

### Why package nerds care

imgdiff is package-nerd interesting because it is a tiny Go binary competing on startup simplicity and benchmark performance against heavier image-processing stacks. It represents the class of single-binary tools that package managers can expose for CI and screenshot-regression jobs without pulling in a larger application.

### Timeline

- 2020-12-12: GitHub repository created and v1.0.0 initial release published.
- 2021-02-17: v1.0.1 fixed the package path.
- 2021-03-25: v1.0.2 fixed output writing.
- 2026: Homebrew formula metadata lists imgdiff as a pixel-by-pixel image difference tool.

### Related projects

- The README explicitly compares imgdiff with odiff. It also fits the broader visual-regression ecosystem around screenshot testing and pixel-diff utilities.

### Sources

- <https://formulae.brew.sh/formula/imgdiff>
- <https://github.com/n7olkachev/imgdiff>
- <https://github.com/n7olkachev/imgdiff/releases>


## Security Notes

broad file, network, media, or database tool signal.

- **Geiger risk:** blue / medium
- broad file, network, media, or database tool signal

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** imgdiff
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- apk - imgdiff - 1.0.2-r37: normalized package name match | Alpine Linux edge package indexes: imgdiff from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Fast pixel-by-pixel image difference tool | https://github.com/n7olkachev/imgdiff
- apk - imgdiff-doc - 1.0.2-r37: normalized package name match | Alpine Linux edge package indexes: imgdiff-doc from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Fast pixel-by-pixel image difference tool (documentation) | https://github.com/n7olkachev/imgdiff


## Related links

- [Source-control packages](https://pkg.so/source-control-tools/) - Belongs to a source-control command family.
- [Secret-risk packages](https://pkg.so/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://pkg.so/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://pkg.so/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [go](https://pkg.so/brew/go/) - Build dependency declared by Homebrew.
- [lcov](https://pkg.so/brew/lcov/) - Shares pkgdb curated category or tags: cli, developer-tools, testing.
- [bats-core](https://pkg.so/brew/bats-core/) - Shares pkgdb curated category or tags: cli, developer-tools, testing.
- [allure](https://pkg.so/brew/allure/) - Shares pkgdb curated category or tags: cli, developer-tools, testing.
- [kind](https://pkg.so/brew/kind/) - Shares pkgdb curated category or tags: cli, developer-tools, testing.
- [kcov](https://pkg.so/brew/kcov/) - Shares pkgdb curated category or tags: cli, developer-tools, testing.
- [expect](https://pkg.so/brew/expect/) - Shares pkgdb curated category or tags: cli, developer-tools, testing.
- [mockolo](https://pkg.so/brew/mockolo/) - Shares pkgdb curated category or tags: cli, developer-tools, testing.
- [gcovr](https://pkg.so/brew/gcovr/) - Shares pkgdb curated category or tags: cli, developer-tools, testing.
- [odiff](https://pkg.so/brew/odiff/) - Both packages work with overlapping file formats or content types. Shared terms: cli, comparison, developer, developer-tools, image.
- [cypress-image-diff-html-report](https://pkg.so/npm/cypress-image-diff-html-report/) - Both packages work with overlapping file formats or content types. Shared terms: cli, comparison, developer, developer-tools, diff.
- [cypress-image-diff-js](https://pkg.so/npm/cypress-image-diff-js/) - Both packages work with overlapping file formats or content types. Shared terms: cli, comparison, developer, developer-tools, diff.

## Combined YAML source

View the package source record on GitHub. [combined/imgdiff.yml](https://github.com/mxcl/pkgdb/blob/main/combined/imgdiff.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- pkgdb category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph