+4
日增长
5,760
stars
322
forks
39
watchers
400
prs
270
issues
49
releases
README
imessage-exporter This crate provides both a library to interact with iMessage data as well as a binary that can perform some useful read-only operations using that data. The aim of this project is to provide the most comprehensive and accurate representation of iMessage data available. This free and open-source software can: - Save, export, backup, and archive iMessage data to open, portable formats - Preserve multimedia content (images, videos, audio) from conversations - Facilitate easy migration of message history between devices and platforms - Run diagnostics on the iMessage database - Give you full ownership and control over your communication history - Support compliance with data retention policies or legal requirements - Run on macOS, Linux, and Windows Example Export !HTML Export Sample Binary The imessage-exporter binary exports iMessage data to txt or html formats. It can also run diagnostics to find problems with the iMessage database. Installation instructions for the binary are located here. Library The imessage_database library provides models that allow us to access iMessage information as native, cross-platform data structures. Documentation for the library is located here. Supported Features Support for every iMessage feature as of macOS Golden Gate 27.2 (26B123) and iOS 27.2 (24B119): - iMessage, RCS, SMS, and MMS - Multi-part messages - Replies/Threads - Formatted text - Attachments - Expressives - Tapbacks - Stickers - Apple Pay - Group chats - Digital Touch - URL Previews - Audio messages - App Integrations - Edited messages - Business messages - Handwritten messages See more detail about supported features here. Frequently Asked Questions The FAQ document is located here. Special Thanks - All of my friends, for putting up with me sending them random messages to test things - SQLiteFlow, the SQL viewer I used to explore and reverse engineer the iMessage database - Xplist, an invaluable tool for reverse engineering the payload_data plist format - Compart, an amazing resource for looking up esoteric unicode details - GNU Project and Archive.org, for hosting source code referenced to reverse engineer the typedstream format
Top issues
#872Option to omit the "(Read by … after …)" note in unattended exports1 comments · 2026-11-11#865Fix handling of unsent messages without `date_edited`0 comments · 2026-10-31#864Support Satellite (`iMessageLite`) emergency transcript sharing attribution0 comments · 2026-10-31
Discussions
#835Small front end for the generated files2 comments · 2026-10-25#829Issue finding files1 comments · 2026-10-18#813Deleted messages1 comments · 2026-10-10#808is not a valid SQLite database file or unexpected argument1 comments · 2026-09-16#806How Do I Use iMessage-Exporter on Windows? Where Does chat.db Come From?1 comments · 2026-09-16#803Codex skill for querying local iMessage history with imessage-exporter0 comments · 2026-09-07#786Link Error with Cargo Install1 comments · 2026-08-16#777thank you 🩵1 comments · 2026-06-28
Latest release
Speckled Clarkia 5.0.1 2026-10-29iMessage Exporter 5.0.1: Speckled Clarkia) contains the following fixes and improvements:
- New Features
- Contacts-based conversation merging
- Combine phone numbers and email addresses belonging to one person, including linked Contacts cards on macOS and iOS
- Merge conversations split across those addresses, including group chats
- Preserve separate group chats with different names unless Messages explicitly links them
- Skip ambiguous identity matches when an address belongs to multiple Contacts cards
- Allow --contacts-path (-n) to override the Contacts databa