iMessage & Signal Analyzer

Analyze iMessage (macOS) and Signal conversations to produce relationship reports.

Prerequisites

macOS (iMessage)

iMessage data is stored locally on macOS. Depending on your security settings, you may need to grant Full Disk Access:

Option 1: Run the script directly with Python (no special permissions needed if you have read access to ~/Library/Messages/chat.db)

Option 2: If you get a permission error, grant Full Disk Access:

• Open System Settings → Privacy & Security → Full Disk Access
• Click + and add Python or your terminal app

Linux / Windows (Signal only)

• iMessage is not available on Linux/Windows
• Signal analysis works via exported JSON