# Install imessage-exporter with Homebrew Command-line tool to export and inspect local iMessage database. Version 4.2.0 via Homebrew; verified 2026-06-19. ## Install ```sh sudo av install brew:imessage-exporter ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install imessage-exporter ``` Evidence: local Homebrew formula metadata ## Package facts - **Package key:** brew:imessage-exporter - **Package manager:** Homebrew - **Package manager page:** - **Version:** 4.2.0 - **Source summary:** Command-line tool to export and inspect local iMessage database - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** GPL-3.0-only - **Source archive:** - **Last updated:** 2026-06-19T01:16:53Z - **Generated:** 2026-07-08T18:08:21+00:00 ## Executables - imessage-exporter (cli) - imessage-exporter (alias) ## Build dependencies - rust ## 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: 4.2.0 - Package-manager updated: 2026-06-19 - Local data: ok - Upstream repository: https://github.com/ReagentX/imessage-exporter - Upstream latest detected: 4.2.0 (current) ## Project history and usage iMessage Exporter is a Rust CLI and library for reading Apple's Messages databases and exporting message history to portable formats. It is package-nerd interesting because it turns a private, shifting Apple data store into a reproducible command-line archive workflow. ### Project history The repository was created in May 2022. Its README describes a dual crate: a binary named imessage-exporter and a library named imessage_database for accessing iMessage data as native cross-platform structures. The project grew from basic export into detailed reverse engineering of Messages.app data. The feature docs cover macOS chat.db, iOS backups, jailbroken iOS filesystem data, typedstream message bodies, attachments, edited and unsent messages, tapbacks, stickers, URL previews, Apple Pay messages, Digital Touch, and many other message forms. Release 3.0.0 in June 2025 adopted the crabstep typedstream deserializer and emphasized performance. Release 4.0.0 in March 2026 added jailbroken iOS filesystem support, restructured diagnostics, dependency reductions, API breaks, and HTML-output hardening. ### Adoption history The binary docs list installation through Cargo, Homebrew, prebuilt macOS binaries, and source builds. Homebrew formula metadata records bottled distribution, while the GitHub repository has accumulated several thousand stars, indicating visibility beyond a narrow personal script. The project also accumulated a small ecosystem around the author's reverse-engineering work: crabstep for typedstream parsing and crabapple for encrypted iOS backup handling are both referenced by the documentation. ### How it is used The CLI exports local macOS Messages data or iOS backup data to txt or html, can copy or convert attachments, and can run diagnostics against the message database. The documented default macOS source is ~/Library/Messages/chat.db and the default export directory is ~/imessage_export. It is mostly read-only archival tooling: useful for personal backups, migration, compliance retention, legal discovery preparation, and diagnostics, rather than for sending messages or modifying Apple's database. ### Why package nerds care iMessage Exporter is significant because the hard part is not the CLI wrapper; it is the encoded domain knowledge about Apple's SQLite schemas, binary typedstream payloads, attachment formats, and platform-specific backup layouts. For package managers, it packages a high-churn reverse-engineering project into a normal command. That makes a local-data liberation workflow installable with brew or cargo instead of a pile of ad hoc scripts. ### Timeline - 2022: The GitHub repository is created. - 2025: Version 3.0.0 adopts crabstep typedstream deserialization and reports large export performance gains. - 2026: Version 4.0.0 adds jailbroken iOS filesystem data support, diagnostics changes, dependency reductions, API changes, and HTML security work. - 2026: Version 4.2.0 is published after the 4.x series has expanded support for modern Messages features. ### Related projects - imessage_database is the library crate in the same repository. - crabstep is used for typedstream deserialization. - crabapple is referenced for encrypted iOS backup handling. - SQLite viewers, Xplist, GNUstep/libobjc sources, and preserved Darwin sources are credited by the project as reverse-engineering aids. ### Sources - - - - - - - ## 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:** imessage-exporter - **Version Scheme:** 0 - **Revision:** 0 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals. - [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. - [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew. - [gurk](https://www.automicvault.com/pkg/brew/gurk/) - Shares av.db curated category or tags: cli, messaging, productivity. - [clipper](https://www.automicvault.com/pkg/brew/clipper/) - Shares av.db curated category or tags: cli, macos, productivity. - [clippy](https://www.automicvault.com/pkg/brew/clippy/) - Shares av.db curated category or tags: cli, macos, productivity. - [dockutil](https://www.automicvault.com/pkg/brew/dockutil/) - Shares av.db curated category or tags: cli, macos, productivity. - [fcitx-remote-for-osx](https://www.automicvault.com/pkg/brew/fcitx-remote-for-osx/) - Shares av.db curated category or tags: cli, macos, productivity. - [ical-buddy](https://www.automicvault.com/pkg/brew/ical-buddy/) - Shares av.db curated category or tags: cli, macos, productivity. - [mackup](https://www.automicvault.com/pkg/brew/mackup/) - Shares av.db curated category or tags: cli, macos, productivity. - [webarchiver](https://www.automicvault.com/pkg/brew/webarchiver/) - Shares av.db curated category or tags: cli, macos, productivity. - [imessage-ruby](https://www.automicvault.com/pkg/brew/imessage-ruby/) - Package names and metadata indicate a similar tool family. Shared terms: cli, command-line, imessage, line, macos. - [gotify](https://www.automicvault.com/pkg/brew/gotify/) - Local package facts share a topical domain. Shared terms: cli, command-line, line, messaging, productivity. ## Combined YAML source View the package source record on GitHub. [combined/imessage-exporter.yml](https://github.com/automic-vault/db/blob/main/combined/imessage-exporter.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