imessage-exporter Review (2026): How to Use It, and Its Limits

If you have looked for a way to export your iMessages, you have probably come across imessage-exporter, a free, open-source tool on GitHub. This review covers what it does, how to install and use it on a Mac or a Windows PC, how to get a PDF out of it, and where it falls short.
The short answer: imessage-exporter is the most thorough free iMessage exporter there is, if you are comfortable typing commands. It reads your Mac's Messages or an iPhone backup and writes every conversation to HTML or TXT, keeping details like Tapbacks and edit history that most tools drop. It has no buttons, no PDF and no CSV. If you'd rather click through an app, TextPort for Mac and TextPort for Windows export the same messages to PDF, CSV or TXT for free.
What imessage-exporter is and who makes it
imessage-exporter is a command-line program and a code library for reading iMessage data, written in Rust by Christopher Sardegna (ReagentX on GitHub). He started it in May 2022. It is released under the GPL-3.0 open-source licence, has about 5,800 stars on GitHub, and is actively maintained: version 5.0.1 came out on October 29, 2026, the ninth release of the year.
It is read-only. It never writes to your Messages database, so it can't change or delete anything, and it can't move a conversation back onto another Apple ID either. Everything runs on your computer; nothing is uploaded.
What it reads and what it exports
imessage-exporter reads three kinds of source:
- The Messages database on a Mac, which holds your iPhone's history too if Messages in iCloud is on.
- A local iPhone backup, encrypted or not, on a Mac, Windows or Linux computer.
- A jailbroken iPhone's message database, for the few people who have one.
It can't read anything that exists only in iCloud. It covers iMessage, SMS, MMS and RCS, and messages sent by satellite.
It writes one file per conversation, in HTML or TXT, plus an "orphaned" file for messages it can't match to a conversation. The HTML looks like a Messages window in your browser, with bubbles coloured by service and photos, videos and voice messages embedded. The TXT is plain text, with file paths where attachments were.
What sets it apart is how much of iMessage it keeps. Per its feature list, exports show Tapbacks, each version of an edited message, unsent messages, threaded replies, link previews, polls, stickers and Genmoji, handwritten messages, Digital Touch and Apple Pay messages, and when each message was read. Names come from your Contacts, and since version 5.0 it merges conversations that Messages split across someone's phone number and email address. It also restores messages still in Messages' Recently Deleted list, which keeps them for up to 30 days.
Attachments are not copied unless you ask. The -c option controls them:
-c value |
What happens to attachments |
|---|---|
disabled (default) |
Not copied; the export points to the files where Messages keeps them |
clone |
Copied as they are |
basic |
Copied, with HEIC photos converted to JPEG |
full |
Copied, with HEIC to JPEG, and audio and MOV video to MP4 |
On a Mac the conversions use tools built into macOS, except video, which needs ffmpeg. On Windows and Linux, photo conversion needs ImageMagick and audio and video conversion need ffmpeg.
How to install and use imessage-exporter on a Mac
- Install it. The quickest way is Homebrew: with Homebrew installed, run
brew install imessage-exporterin Terminal. If you have Rust,cargo install --locked imessage-exportergets the newest release. There are also ready-built files for Apple silicon and Intel Macs on its releases page. - Give Terminal Full Disk Access. macOS protects the Messages folder, so open System Settings > Privacy & Security > Full Disk Access, turn on Terminal (or the terminal app you use), then quit and reopen it.
- Run an export. This exports every conversation as HTML and copies the attachments:
imessage-exporter -f html -c clone
The files land in a folder called imessage_export in your home folder. Double-click a conversation's HTML file to open it in your browser.
Two things to know: it won't start if the export folder already holds files of the same format, so give each new export its own folder with -o, and by default it won't run if your disk doesn't have room for the export.
How to export one conversation or a date range
By default it exports everything. To narrow it down, filter by person with -t and by date with -s (start) and -e (end):
imessage-exporter -f html -c clone -t "5558675309"
imessage-exporter -f txt -t "Jane Appleseed" -s 2025-01-01 -e 2026-01-01
-t matches names, phone numbers and email addresses, including partial ones, and exports every conversation that person is in, group chats included. Separate several people with commas. The end date is exclusive: -e 2026-01-01 stops at the end of December 31, 2025.
How to use imessage-exporter on Windows
A Windows PC has no Messages app, so imessage-exporter reads an iPhone backup instead:
- Back up your iPhone with Apple's Apple Devices app or iTunes. If you encrypt the backup, keep the password.
- Download
imessage-exporter-x86_64-pc-windows-gnu.exefrom the releases page. - Run it in PowerShell from the folder you downloaded it to, with
-ppointing at the backup's folder:
.\imessage-exporter-x86_64-pc-windows-gnu.exe -f html -c clone -p "C:\Users\you\Apple\MobileSync\Backup\<backup folder>"
Apple Devices and the Microsoft Store version of iTunes keep backups under Apple\MobileSync\Backup in your user folder; older iTunes installs use AppData\Roaming\Apple Computer\MobileSync\Backup. If the path is wrong, version 5.0 suggests where backups are. For an encrypted backup it asks for the password; avoid the -x option, which leaves the password in your command history.
With -c clone, iPhone photos stay in HEIC format, which many Windows browsers won't show. -c basic converts them to JPEG but needs ImageMagick installed.
How to get a PDF from imessage-exporter
imessage-exporter has no PDF export. Its developer writes that he "could not get PDF export to work in a reasonable way," and recommends printing the HTML instead:
- Export HTML with attachments copied and lazy image loading turned off, so every photo is in the page when you print:
imessage-exporter -f html -c basic --no-lazy -t "5558675309" - Open the conversation's HTML file in Safari.
- Choose File > Print, then PDF > Save as PDF.
If messages split across pages, the documentation suggests a style.css file in the export folder containing .message { break-inside: avoid; }.
Useful imessage-exporter options
| Option | What it does |
|---|---|
-f html or -f txt |
The export format |
-c |
How attachments are copied (see the table above) |
-o |
The folder to export to |
-p |
A different database or an iPhone backup folder |
-t |
Only conversations with these people |
-s and -e |
Only messages from this date, and before that date |
-l (--no-lazy) |
Load every image at once, for printing to PDF |
-m |
A name to show instead of "Me" |
-d |
Print a summary of the database without exporting |
The full list is in its usage guide.
How fast is imessage-exporter?
Very. On an M1 Max MacBook Pro, its developer measured over 145,000 messages a second with attachments left in place, about 42,000 with -c clone, and a few hundred a second when photos and videos are converted. Conversion is the slow part, so a big history with -c full can take a while.
What imessage-exporter can't do
- No app. Every export is a command in Terminal or PowerShell.
- No PDF or CSV. HTML and TXT only, so a printable document or a spreadsheet takes extra steps.
- It doesn't make backups. On Windows and Linux you need an iPhone backup made with another tool first.
- Apple Messages only. No WhatsApp, Messenger, Instagram, Signal or Telegram.
- Only what's on the device. Messages kept only in iCloud, voice messages that expired, and messages deleted more than 30 days ago aren't there to export.
- No search. It builds exports; its developer searches the files with a separate tool.
- No iPhone version. You need a computer.
imessage-exporter vs TextPort
Both are free on a computer and both read your messages locally. The difference is how you use them and what comes out.
On a Mac. TextPort for Mac reads the same Messages database, from the Mac App Store, with no Terminal or Full Disk Access: you choose your Messages folder once. Open a chat, pick dates on a calendar, and export a PDF, CSV, TXT or a ZIP of the attachments, or use Export All for every chat.
On a Windows PC. TextPort for Windows is free from the Microsoft Store and makes the iPhone backup itself over USB, showing the first messages in about 10 minutes. It also opens unencrypted backups made with Apple Devices or iTunes.
With only your iPhone. The TextPort iPhone app needs no computer. It pulls a conversation straight out of Messages, word for word, and exports a PDF, CSV or TXT on the phone. It also takes WhatsApp chats from WhatsApp's Export Chat file, and other apps from a screen recording. Your first three conversations import free; after that it's a subscription.
What TextPort doesn't do. Its exports leave out edit history, TextPort for Mac doesn't show Tapbacks yet, neither desktop app recovers deleted messages or opens an encrypted backup, and there's no Linux version or HTML export.
For the device-by-device breakdown, see imessage-exporter vs TextPort, and for other options, the imessage-exporter alternatives page.
Verdict: imessage-exporter or TextPort
imessage-exporter is excellent at what it sets out to do: a complete, read-only, open-source archive of your iMessage history, with more detail than any other tool we have compared. For developers, people on Linux and anyone who wants their whole Messages history as plain files, it is the right pick. If you need one conversation as a PDF for a lawyer, a spreadsheet, or you just don't want to use the Terminal, TextPort's free Mac and Windows apps get you there in a few clicks.
| If you... | Best pick |
|---|---|
| Are comfortable in Terminal and want an HTML archive of everything | imessage-exporter |
| Use Linux, or want to script your exports | imessage-exporter |
| Have an encrypted iPhone backup | imessage-exporter |
| Have a Mac and want a PDF or CSV without the Terminal | TextPort for Mac (free) |
| Have a Windows PC and an iPhone | TextPort for Windows (free) |
| Have only your iPhone, or need WhatsApp or another chat app | TextPort |
Frequently asked questions
-
Yes. It is free, open-source software under the GPL-3.0 licence, written by Christopher Sardegna and developed in public on GitHub since 2022, so anyone can read its code. It only reads your messages: it never writes to the Messages database, and it runs on your computer without uploading anything. Download it from Homebrew, crates.io or its GitHub releases page rather than from a copy elsewhere.
-
No. It is a command-line program that you run in Terminal on a Mac or PowerShell on Windows, with options such as
-f htmlfor the format. Its project ships no app with buttons. If you'd rather click, TextPort for Mac and TextPort for Windows are free apps that do the same export. -
Not directly. It exports HTML and TXT only, and its developer writes that he couldn't get PDF export to work in a reasonable way. The workaround is to export HTML with the
--no-lazyoption, open the file in Safari and print it to PDF. -
Yes. Its GitHub releases include a Windows .exe, and you run it in PowerShell. Windows has no Messages app, so you first back up your iPhone with Apple Devices or iTunes and point imessage-exporter at the backup folder with the
-poption. It reads encrypted backups if you give it the password. -
Add
-tfollowed by the person's name, phone number or email address, for exampleimessage-exporter -f html -c clone -t "5558675309". It exports every conversation that person is in, including group chats. Add-sand-ewith dates in YYYY-MM-DD format to limit the date range. -
No. It reads only what is on the Mac or in the iPhone backup you give it. Messages kept only in iCloud have to download to the Mac or iPhone first. On a Mac, turning on Messages in iCloud and letting it sync brings your iPhone's history down.
Start exporting your messages
Available for iPhone, Mac, and Windows. No computer required.