Export and analyze iMessage conversations from macOS SQLite database
Project description
iMessage Wrapped
Export and analyze your iMessage conversations from the macOS SQLite database.
Quick Start
🖥️ Desktop App
- Download and open
iMessage-Wrapped.dmg - Drag to Applications folder
- Launch the app and click "Analyze My Messages"
- Your wrapped opens in browser automatically
💻 Command Line
pip install imessage-wrapped
imexport
That's it! The command will auto-export your messages, analyze patterns, upload anonymized statistics, and give you a shareable URL.
Common options:
imexport --no-share- View results in terminal onlyimexport --year 2024- Analyze specific yearimexport --help- See all options
Features
✅ Interactive Dashboard - Visualizations of your messaging patterns
✅ Easy Sharing - One command to get a shareable link
✅ Privacy First - Your message content never leaves your computer
✅ Favorite Phrases - Automatically surfaces your most-used sayings
🔒 Data Privacy
Your message content NEVER leaves your computer.
We only upload aggregated statistics (counts, averages, distributions, emojis, dates). We never upload:
- Message text or content (except for a few most common patterns)
- Contact names (unless exclicitly allowed)
- Phone numbers or emails (hashed only)
- Attachments or personal information
Requirements & Installation
- macOS with Full Disk Access permission
- Python 3.10+ (for CLI only)
Installation:
pip install imessage-wrapped
macOS Permissions:
- Open System Settings → Privacy & Security → Full Disk Access
- Add Terminal (for CLI) or the Desktop App
- Restart the application
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file imessage_wrapped-1.0.42.tar.gz.
File metadata
- Download URL: imessage_wrapped-1.0.42.tar.gz
- Upload date:
- Size: 60.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
79f3abfc7c1688c082832770b4618f7e31504181cb774dc3e3553fd0ce7299c4
|
|
| MD5 |
0d78c1cdfd87f666ea263609606ff886
|
|
| BLAKE2b-256 |
ffb2b8644b30c1e855e15317c3c80278798c21b375c4bd1eb231d1284400b70c
|
File details
Details for the file imessage_wrapped-1.0.42-py3-none-any.whl.
File metadata
- Download URL: imessage_wrapped-1.0.42-py3-none-any.whl
- Upload date:
- Size: 69.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5da4520c79c77488ffb0fb037751e6600f2a3fcef59323996adff2109f52536a
|
|
| MD5 |
45bb9e1b24d5f939abd6cb2a89b02267
|
|
| BLAKE2b-256 |
0124a6200950cd3e958867524b7afb41f9c8e26123a6df7ee0e36ee746ad32a5
|