Skip to main content

A tool to export and search iMessages from local chat.db

Project description

iMessage Exporter

A Python tool to search and export iMessages from your local macOS chat.db.

Installation

  1. Clone this repository.
  2. Install in editable mode:
    pip install -e .
    

Usage

The tool provides a CLI command imessage-exporter.

List Recent Chats

imessage-exporter --list-chats

Search Messages

Search for a specific term:

imessage-exporter --search "hello"

Filter by Date

Get messages from today:

imessage-exporter --today

Get messages from a specific date:

imessage-exporter --date 2023-10-27

Combine Filters

Search for "meeting" in messages from today:

imessage-exporter --search "meeting" --today

Permissions

This tool requires Full Disk Access for the terminal or IDE running it, as it reads directly from ~/Library/Messages/chat.db.

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_exporter-0.2.0.tar.gz (6.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_exporter-0.2.0-py3-none-any.whl (5.3 kB view details)

Uploaded Python 3

File details

Details for the file imessage_exporter-0.2.0.tar.gz.

File metadata

  • Download URL: imessage_exporter-0.2.0.tar.gz
  • Upload date:
  • Size: 6.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for imessage_exporter-0.2.0.tar.gz
Algorithm Hash digest
SHA256 c31bcb11cc63764d101b1899bb3b989b64aa76c8092808715d6c4c150d12bd94
MD5 4b8009a793dfce6cf576a01117c82bc5
BLAKE2b-256 76ff2cb85d2bfe29f812b336fd6ee37427c9454b57e9ff1ac0175f313b478a86

See more details on using hashes here.

File details

Details for the file imessage_exporter-0.2.0-py3-none-any.whl.

File metadata

File hashes

Hashes for imessage_exporter-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3bedd70b87f8bf81a0fc9e77f5f0d086132a5fbf573618088cf85118330fff64
MD5 eead85a4acb686cf89a8c653db73762a
BLAKE2b-256 5d85485cce4dc18461a05157a9c7ab878ee21f7679a25021d3ce94d37c4affec

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