How to use imessage-exporter on a Mac (step by step)
imessage-exporter is a free command-line tool: install it with Homebrew or Cargo, give Terminal Full Disk Access, then run a command such as imessage-exporter -f html -c basic -t "5558675309" to export one person's conversations to HTML in ~/imessage_export. If you would rather not use Terminal, Command-P in Messages prints a conversation free, and TextExhibit ($24.99, Mac app) exports PDF, CSV and HTML from a window.
Before you start
- Your messages must be on the Mac: turn on Messages in iCloud (Messages, Settings, iMessage, Enable Messages in iCloud) and let it sync, or have an iPhone backup folder.
- Terminal needs Full Disk Access to read ~/Library/Messages: System Settings, Privacy & Security, Full Disk Access, add Terminal.
- Enough free disk space; the tool checks before exporting.
Install
- With Homebrew: brew install imessage-exporter (the README notes it may lag the latest release).
- Or with Rust's Cargo (recommended by the README): cargo install --locked imessage-exporter.
- Or download a prebuilt binary for Apple Silicon or Intel from the releases page.
- Check it runs: imessage-exporter -V.
Common commands (from the README)
- Everything as HTML with web-friendly attachments: imessage-exporter -f html -c full
- One contact by number: imessage-exporter -f html -c clone -t "5558675309"
- One contact by name, text only: imessage-exporter -f txt -t "Jane Smith"
- A date range: add -s 2025-01-01 -e 2025-07-01 (the end date is exclusive: messages before it).
- Custom folder: -o ~/Desktop/export (default ~/imessage_export).
- From an iPhone backup: -p path/to/backup -a iOS; for an encrypted backup it prompts for the password. Avoid -x, which leaves the password in your shell history.
Turning the HTML into a PDF
- Export with -f html and add --no-lazy so images load for printing.
- Open the conversation's HTML file in Safari or Chrome.
- File, Print, then Save as PDF. Turn on headers and footers if you want page numbers.
- Check the PDF: dates, times, senders, photos.
Where it falls short for legal use
It does not add a cover page, Bates numbers or a hash list, and senders show as names from Contacts or as numbers depending on your Contacts. That is fine for an archive. For a lawyer, compare it with a tool that adds those details, such as TextExhibit.
What to keep in mind
- Commands are from the imessage-exporter README on 2026-11-15 (release 5.0.1). Options can change between versions; run imessage-exporter -h.
- Remove Full Disk Access from Terminal afterwards if you do not need it.
- Not legal advice.
Questions
Do I need Full Disk Access?
Yes, for the Mac's Messages database. macOS blocks apps without it from reading ~/Library/Messages.
Where do the files go?
By default to ~/imessage_export, or the folder you give with -o.
Can it export only one conversation?
Use -t with a name, number or email. It exports all conversations with that participant, including group chats.
Does it change my messages?
It reads the database and writes files elsewhere. It does not edit Messages.
Sources
- imessage-exporter command-line README (checked November 15, 2026)
- imessage-exporter on GitHub (ReagentX) (checked November 15, 2026)
- imessage-exporter releases (checked November 15, 2026)
- Set up Messages in iCloud (Apple) (checked November 15, 2026)
Export the whole conversation
TextExhibit turns a conversation into one PDF with exact times, names and numbers, photos in place and page numbers, on your Mac. Free to preview; $24.99 once to export.