# Install deadfinder with Homebrew

Finds broken links. Version 2.0.2 via Homebrew; verified 2026-06-15.

## Install

```sh
sudo av install brew:deadfinder
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install deadfinder
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:deadfinder
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/deadfinder>
- **Version:** 2.0.2
- **Source summary:** Finds broken links
- **Homepage:** <https://deadfinder.hahwul.com>
- **Repository:** <https://github.com/hahwul/deadfinder>
- **Upstream docs:** <https://deadfinder.hahwul.com>
- **License:** MIT
- **Source archive:** <https://github.com/hahwul/deadfinder/archive/refs/tags/2.0.2.tar.gz>
- **Last updated:** 2026-06-15T10:20:14-04:00
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- deadfinder (cli)
- deadfinder (alias)

## Dependencies

- bdw-gc
- libevent
- libyaml
- openssl@3
- pcre2

## Build dependencies

- cmake
- crystal
- pkgconf

## Uses from macOS

- libxml2

## 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-07-08
- Package-manager version: 2.0.2
- Package-manager updated: 2026-06-15
- Local data: ok
- Upstream repository: https://github.com/hahwul/deadfinder
- Upstream latest detected: 2.0.2 (current)
## Project history and usage

DeadFinder is a command-line broken-link scanner for web pages, URL lists, and sitemaps. Its package-manager appeal is straightforward: it is a single-purpose audit tool that can run locally, in Docker, or inside CI.

### Project history

The project began as a Ruby-gem lineage and later moved active development to a Crystal implementation for version 2.0.0 and later. The official changelog describes the Crystal rewrite, root-level Crystal project layout, compatibility harness against v1 Ruby output, and migration of the GitHub Action away from a Docker entrypoint toward a composite action that downloads release binaries.

### Adoption history

The project documents Homebrew, Docker, prebuilt release binaries, Nix, source builds, distro release artifacts, AUR, and Snap as installation routes. It also ships an official GitHub Action interface, which made it natural for package users to wire dead-link checks into documentation and website workflows.

### How it is used

Common CLI use is organized around subcommands for scanning a single URL, a sitemap, a file, or piped standard input. Output can be written as structured formats including JSON, YAML, TOML, CSV, and SARIF, with options for concurrency, timeouts, filtering, custom headers, proxy use, coverage reporting, and visualization.

### Why package nerds care

DeadFinder sits in the practical overlap between web maintenance, SEO hygiene, security review, and CI automation. For package nerds, the v1-to-v2 runtime change is also a tidy example of a tool keeping its command-line contract while swapping implementation language and release packaging model.

### Timeline

- 2025: 1.10.0 release continued the Ruby-gem lineage while noting active development had moved to the Crystal rewrite.
- 2026: 2.0.0 made the Crystal implementation the supported runtime and moved Ruby gem publishing to the legacy branch.
- 2026: 2.0.2 fixed composite GitHub Action release-asset handling.

### Related projects

- Related link-checking and site-quality tools include generic HTTP link checkers, sitemap crawlers, and CI documentation validators; DeadFinder distinguishes itself with a small native CLI plus an official GitHub Action path.

### Sources

- <https://deadfinder.hahwul.com>
- <https://deadfinder.hahwul.com/docs/getting-started/installation/>
- <https://github.com/hahwul/deadfinder/blob/main/CHANGELOG.md>
- <https://github.com/hahwul/deadfinder/releases>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** deadfinder
- **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


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [libevent](https://www.automicvault.com/pkg/brew/libevent/) - Runtime dependency declared by Homebrew.
- [openssl@3](https://www.automicvault.com/pkg/brew/openssl-3/) - Runtime dependency declared by Homebrew.
- [pcre2](https://www.automicvault.com/pkg/brew/pcre2/) - Runtime dependency declared by Homebrew.
- [cmake](https://www.automicvault.com/pkg/brew/cmake/) - Build dependency declared by Homebrew.
- [crystal](https://www.automicvault.com/pkg/brew/crystal/) - Build dependency declared by Homebrew.
- [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew.
- [mlc](https://www.automicvault.com/pkg/brew/mlc/) - Shares av.db curated category or tags: cli, developer-tools, link-checker, link-checking.
- [lychee](https://www.automicvault.com/pkg/brew/lychee/) - Shares av.db curated category or tags: broken-links, cli, developer-tools, link-checker.
- [act](https://www.automicvault.com/pkg/brew/act/) - Shares av.db curated category or tags: cli, developer-tools, github-actions.
- [action-docs](https://www.automicvault.com/pkg/brew/action-docs/) - Shares av.db curated category or tags: cli, developer-tools, github-actions.
- [action-validator](https://www.automicvault.com/pkg/brew/action-validator/) - Shares av.db curated category or tags: cli, developer-tools, github-actions.
- [actionlint](https://www.automicvault.com/pkg/brew/actionlint/) - Shares av.db curated category or tags: cli, developer-tools, github-actions.
- [actions-up](https://www.automicvault.com/pkg/brew/actions-up/) - Shares av.db curated category or tags: cli, developer-tools, github-actions.
- [chezmoi](https://www.automicvault.com/pkg/brew/chezmoi/) - Shares av.db curated category or tags: cli, developer-tools, security.
- [amber](https://www.automicvault.com/pkg/brew/amber/) - Local package facts share a topical domain. Shared terms: bdw, bdw-gc, cli, developer, developer-tools.

## Combined YAML source

View the package source record on GitHub. [combined/deadfinder.yml](https://github.com/automic-vault/db/blob/main/combined/deadfinder.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
