Skip to main content

Export and analyze iMessage conversations from macOS SQLite database

Project description

iMessage Wrapped

Export and analyze your iMessage conversations from the macOS SQLite database.

image image

Quick Start

🖥️ Desktop App

Download for macOS

  1. Download and open iMessage-Wrapped.dmg
  2. Drag to Applications folder
  3. Launch the app and click "Analyze My Messages"
  4. 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 only
  • imexport --year 2024 - Analyze specific year
  • imexport --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:

  1. Open System Settings → Privacy & Security → Full Disk Access
  2. Add Terminal (for CLI) or the Desktop App
  3. Restart the application

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

imessage_wrapped-1.0.42.tar.gz (60.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

imessage_wrapped-1.0.42-py3-none-any.whl (69.0 kB view details)

Uploaded Python 3

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

Hashes for imessage_wrapped-1.0.42.tar.gz
Algorithm Hash digest
SHA256 79f3abfc7c1688c082832770b4618f7e31504181cb774dc3e3553fd0ce7299c4
MD5 0d78c1cdfd87f666ea263609606ff886
BLAKE2b-256 ffb2b8644b30c1e855e15317c3c80278798c21b375c4bd1eb231d1284400b70c

See more details on using hashes here.

File details

Details for the file imessage_wrapped-1.0.42-py3-none-any.whl.

File metadata

File hashes

Hashes for imessage_wrapped-1.0.42-py3-none-any.whl
Algorithm Hash digest
SHA256 5da4520c79c77488ffb0fb037751e6600f2a3fcef59323996adff2109f52536a
MD5 45bb9e1b24d5f939abd6cb2a89b02267
BLAKE2b-256 0124a6200950cd3e958867524b7afb41f9c8e26123a6df7ee0e36ee746ad32a5

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page