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.40.tar.gz (55.9 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.40-py3-none-any.whl (64.1 kB view details)

Uploaded Python 3

File details

Details for the file imessage_wrapped-1.0.40.tar.gz.

File metadata

  • Download URL: imessage_wrapped-1.0.40.tar.gz
  • Upload date:
  • Size: 55.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.4

File hashes

Hashes for imessage_wrapped-1.0.40.tar.gz
Algorithm Hash digest
SHA256 a0759bee4fa4ab95836461df7b1909fa997715fd22fe93f7e02c8b1bbe6604f9
MD5 bb41abcea76532d73364f990bd1c7ed3
BLAKE2b-256 a4be5743cef24336ab21ed5c4a11a1cb9b55a6c1450e2759e53e51d4ea831127

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for imessage_wrapped-1.0.40-py3-none-any.whl
Algorithm Hash digest
SHA256 aa19e6e05542a35cf1851dc20458fe14f2049c4d88de7639ca50ab1ffda8598b
MD5 6a0f18edfaae3f17c46940e69d45cdfa
BLAKE2b-256 62ee12306c799ea54f997e88a710e9dffe359e448fc341c903e1363377e8e595

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