# Install blockhash with Homebrew, Nix

Perceptual image hash calculation tool. Version 0.3.3 via Homebrew; verified 2026-07-06. Also installable with nix: nix profile install nixpkgs#blockhash.

## Install

```sh
sudo av install brew:blockhash
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install blockhash
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#blockhash
```

  Evidence: nixpkgs package indexes: pkgs/by-name/bl/blockhash/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:blockhash
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/blockhash>
- **Version:** 0.3.3
- **Source summary:** Perceptual image hash calculation tool
- **Homepage:** <https://github.com/commonsmachinery/blockhash>
- **Repository:** <https://github.com/commonsmachinery/blockhash>
- **License:** MIT
- **Source archive:** <https://github.com/commonsmachinery/blockhash/archive/refs/tags/v0.3.3.tar.gz>
- **Last updated:** 2026-07-06T11:06:08Z
- **Generated:** 2026-08-04T22:13:35+00:00

## Executables

- blockhash (cli)
- blockhash (alias)

## Dependencies

- imagemagick

## Build dependencies

- pkgconf

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-08-04
- Package-manager version: 0.3.3
- Package-manager updated: 2026-07-06
- Local data: ok
- Upstream repository: https://github.com/commonsmachinery/blockhash
- Upstream latest detected: v0.3.3 (current)
## Project history and usage

blockhash is a small Commons Machinery command-line tool for computing perceptual image hashes. It packages the block mean value perceptual-hashing algorithm into a Unix-style utility that can hash one or more images from the shell.

### Project history

The official README says blockhash is based on the algorithm described in 'Block Mean Value Based Image Perceptual Hashing' by Bian Yang, Fan Gu, and Xiamu Niu. GitHub metadata dates the repository to September 2014, and the README copyright line names Commons Machinery in 2014.

The release history shows v0.1 in December 2014, follow-up 0.2 releases in January 2017, v0.3 in November 2017, and later maintenance releases through v0.3.3 in January 2023.

### Adoption history

blockhash has narrow but durable package adoption. The input metadata records Homebrew and Nix packages, which is enough for scripts and reproducible media-processing environments to depend on the CLI without building the ImageMagick-backed source manually.

### How it is used

The README documents a direct CLI workflow: run `blockhash` with a list of images to calculate hashes, or `blockhash --help` for options. Building from source requires ImageMagick's MagickWand development library and the waf build script.

### Why package nerds care

blockhash matters as a compact packaged implementation of perceptual hashing, useful for duplicate detection, image comparison, media archives, and content pipelines where cryptographic hashes are too brittle because visually similar images may have different bytes.

### Timeline

- 2014: Official repository created and v0.1 released.
- 2017: 0.2 and v0.3 releases published.
- 2023: v0.3.3 maintenance release published.

### Related projects

- ImageMagick/MagickWand is the image-processing dependency named in the README.
- The underlying perceptual-hashing method comes from the block mean value image hashing paper cited by the README.
- Other perceptual-hash tools and media duplicate-detection pipelines are adjacent use cases.

### Sources

- GitHub repository metadata via gh api repos/commonsmachinery/blockhash
- <https://github.com/commonsmachinery/blockhash#readme>
- <https://github.com/commonsmachinery/blockhash/releases>
- source_facts.package-manager


## 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:** blockhash
- **Version Scheme:** 0
- **Revision:** 6
- **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

- Nix - blockhash: normalized package name match | nixpkgs package indexes: pkgs/by-name/bl/blockhash/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## 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.
- [Networking and protocol packages](https://pkg.so/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [imagemagick](https://pkg.so/brew/imagemagick/) - Runtime dependency declared by Homebrew.
- [pkgconf](https://pkg.so/brew/pkgconf/) - Build dependency declared by Homebrew.
- [ffmpeg](https://pkg.so/brew/ffmpeg/) - Shares pkgdb curated category or tags: cli, media.
- [libpng](https://pkg.so/brew/libpng/) - Shares pkgdb curated category or tags: cli, media.
- [jpeg-turbo](https://pkg.so/brew/jpeg-turbo/) - Shares pkgdb curated category or tags: cli, media.
- [fontconfig](https://pkg.so/brew/fontconfig/) - Shares pkgdb curated category or tags: cli, media.
- [freetype](https://pkg.so/brew/freetype/) - Shares pkgdb curated category or tags: cli, media.
- [little-cms2](https://pkg.so/brew/little-cms2/) - Shares pkgdb curated category or tags: cli, media.
- [openexr](https://pkg.so/brew/openexr/) - Shares pkgdb curated category or tags: cli, media.
- [giflib](https://pkg.so/brew/giflib/) - Shares pkgdb curated category or tags: cli, media.
- [lsix](https://pkg.so/brew/lsix/) - Both packages work with overlapping file formats or content types. Shared terms: cli, image, imagemagick, media.
- [pqiv](https://pkg.so/brew/pqiv/) - Both packages work with overlapping file formats or content types. Shared terms: cli, image, imagemagick, media.
- [spaceman-diff](https://pkg.so/brew/spaceman-diff/) - Both packages work with overlapping file formats or content types. Shared terms: cli, image, imagemagick, media.

## Combined YAML source

View the package source record on GitHub. [combined/blockhash.yml](https://github.com/mxcl/pkgdb/blob/main/combined/blockhash.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
