Metadata-Version: 2.4
Name: imessage-wrapped
Version: 0.1.26
Summary: Export and analyze iMessage conversations from macOS SQLite database
Author: imessage-wrapped contributors
License-Expression: MIT
Project-URL: Homepage, https://github.com/yourusername/imessage-wrapped
Project-URL: Repository, https://github.com/yourusername/imessage-wrapped
Keywords: imessage,export,sqlite,macos,messages
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: rich>=13.0.0
Requires-Dist: questionary>=2.0.0
Requires-Dist: requests>=2.31.0
Requires-Dist: emoji>=2.0.0
Requires-Dist: ruff>=0.14.10
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Requires-Dist: ty>=0.0.7; extra == "dev"
Requires-Dist: build>=1.0.0; extra == "dev"
Requires-Dist: twine>=4.0.0; extra == "dev"
Dynamic: license-file

# iMessage Wrapped

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

<img width="1507" alt="image" src="https://github.com/user-attachments/assets/87f11171-c375-4d62-a41f-9938e798d4a6" />
<img width="1507" height="494" alt="image" src="https://github.com/user-attachments/assets/33cc9f63-5257-4442-9775-477ca7608d43" />

## Quick Start

### 🖥️ Desktop App

[**Download for macOS**](https://imessage-wrapped.fly.dev/api/download)

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

```bash
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:**
```bash
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
