# Install mail-deduplicate with Homebrew

CLI to deduplicate mails from mail boxes. Version 8.1.2 via Homebrew; verified 2026-05-22.

## Install

```sh
sudo av install brew:mail-deduplicate
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install mail-deduplicate
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:mail-deduplicate
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/mail-deduplicate>
- **Version:** 8.1.2
- **Source summary:** CLI to deduplicate mails from mail boxes
- **Homepage:** <https://kdeldycke.github.io/mail-deduplicate/>
- **Repository:** <https://github.com/kdeldycke/mail-deduplicate>
- **Upstream docs:** <https://kdeldycke.github.io/mail-deduplicate>
- **License:** GPL-2.0-or-later
- **Source archive:** <https://files.pythonhosted.org/packages/0c/0c/0e83bc1a549394b6c372caa8e6e5859020d23f470362d02276f1d2d56645/mail_deduplicate-8.1.2.tar.gz>
- **Last updated:** 2026-05-22T10:11:45Z
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- mdedup (cli)
- mdedup (alias)

## Dependencies

- certifi
- libyaml
- python@3.14

## Build dependencies

- rust

## Install behavior

- Post-install hook: not defined
- Bottle: available on all

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 8.1.2
- Package-manager updated: 2026-05-22
- Local data: ok
- Upstream repository: https://kdeldycke.github.io/mail-deduplicate/
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

Mail Deduplicate provides the `mdedup` CLI for finding and acting on duplicate messages across mailbox formats. Official docs describe support for mbox, maildir, babyl, mh, and mmdf, with duplicate detection based on normalized mail headers plus configurable safeguards.

### Project history

The GitHub repository was created in March 2013 by Kevin Deldycke. The project presents itself as a maintained Python command-line utility rather than a mail-client plugin: it reads mailboxes, hashes normalized headers and optionally body content, groups duplicates, applies a selection strategy, and then copies, moves, or deletes selected messages.

Its later documentation shows a mature packaging setup around the `mdedup` executable: cross-platform Python support, Homebrew installation, shell completion, standalone executables for Linux, macOS, and Windows, and a documented TOML configuration system.

### Adoption history

The official documentation states that `mdedup` is part of Homebrew's default tap, and the README badges point users to PyPI versioning and download statistics. The input package-manager facts confirm Homebrew packaging.

Repository metadata shows a smaller but durable utility audience, with active updates into 2026 and almost two hundred GitHub stars. That adoption pattern fits a focused maintenance tool: not a mass-market app, but a packaged command that users reach for when mailbox archives need cleanup.

### How it is used

Typical usage starts with `uvx --from mail-deduplicate -- mdedup`, `brew install mail-deduplicate`, or a standalone binary. Users point the command at mailbox sources, choose deduplication strategies such as size, content, timestamp, path, or random choice, and run a dry run before moving or deleting duplicates.

The docs are unusually explicit about tradeoffs: the implementation keeps data in memory and is considered naive but adequate for mailbox volumes of a few gigabytes. For package users, that warning is important operational documentation, because it tells them when the simple CLI is enough and when very large archives need caution.

### Why package nerds care

Mail Deduplicate is a good example of a niche CLI becoming package-manager-worthy by handling old mailbox formats and modern packaging expectations at once. It does not try to be a mail client; it is a scriptable maintenance tool with predictable inputs, dry-run support, and standalone builds.

The package is also interesting because its core duplicate logic is documented rather than hidden: the project explains why Message-ID alone is insufficient, how mailing lists perturb headers and bodies, and why size/content safeguards are needed before deleting mail.

### Timeline

- 2013: Public GitHub repository created.
- 2020: Historical GitHub releases were published for v2 through v5 series.
- 2023: v7.x releases continue the maintained CLI line.
- 2024: Documentation shows Homebrew default-tap installation and standalone executables.
- 2025: v8.x releases published.
- 2026: Repository metadata shows active maintenance.

### Related projects

- Mail Deduplicate belongs to the mailbox-maintenance family of tools around mbox, maildir, mh, babyl, and mmdf formats.
- Its design references common mail infrastructure behavior such as mailing-list footers, Message-ID unreliability, and MTA-added headers.

### Sources

- <https://api.github.com/repos/kdeldycke/mail-deduplicate>
- <https://api.github.com/repos/kdeldycke/mail-deduplicate/releases>
- <https://github.com/kdeldycke/mail-deduplicate>
- <https://kdeldycke.github.io/mail-deduplicate>
- <https://kdeldycke.github.io/mail-deduplicate/configuration.html>
- <https://kdeldycke.github.io/mail-deduplicate/design.html>
- source_facts.package-manager


## Security Notes

No matching local secret-handling manifest was found for mail-deduplicate. Nucleus package metadata is still published here so future coverage has a stable package URL.



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- macOS: ~/Library/Application Support/mdedup/
- Unix: ~/.config/mdedup/
- Windows: C:\Users\<user>\AppData\Roaming\mdedup\
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** mail-deduplicate
- **Version Scheme:** 0
- **Revision:** 5
- **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.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Productivity CLI packages](https://www.automicvault.com/pkg/productivity-cli-packages/) - Matched curated productivity category metadata from av.db.
- [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew.
- [mailcheck](https://www.automicvault.com/pkg/brew/mailcheck/) - Shares av.db curated category or tags: cli, email, mailbox, maildir, productivity.
- [mairix](https://www.automicvault.com/pkg/brew/mairix/) - Shares av.db curated category or tags: cli, email, maildir, productivity.
- [meli](https://www.automicvault.com/pkg/brew/meli/) - Shares av.db curated category or tags: cli, email, maildir, productivity.
- [mu](https://www.automicvault.com/pkg/brew/mu/) - Shares av.db curated category or tags: cli, email, maildir, productivity.
- [offlineimap](https://www.automicvault.com/pkg/brew/offlineimap/) - Shares av.db curated category or tags: cli, email, maildir, productivity.
- [aerc](https://www.automicvault.com/pkg/brew/aerc/) - Shares av.db curated category or tags: cli, email, productivity.
- [alot](https://www.automicvault.com/pkg/brew/alot/) - Shares av.db curated category or tags: cli, email, productivity.
- [alpine](https://www.automicvault.com/pkg/brew/alpine/) - Shares av.db curated category or tags: cli, email, productivity.
- [gyb](https://www.automicvault.com/pkg/brew/gyb/) - Both packages touch the same language runtime or ecosystem. Shared terms: certifi, cli, email, productivity, python.

## Combined YAML source

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


## Sources

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