https://github.com/chronicle-app/chronicle-imessage
chronicle-etl plugin for accessing your iMessage messages and attachments using the command line
https://github.com/chronicle-app/chronicle-imessage
chronicle-etl chronicle-plugin data-liberation digital-history icloud imessage personal-data
Last synced: 8 months ago
JSON representation
chronicle-etl plugin for accessing your iMessage messages and attachments using the command line
- Host: GitHub
- URL: https://github.com/chronicle-app/chronicle-imessage
- Owner: chronicle-app
- Created: 2022-02-03T05:04:09.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-04-28T04:28:57.000Z (over 1 year ago)
- Last Synced: 2024-08-09T10:52:37.359Z (about 1 year ago)
- Topics: chronicle-etl, chronicle-plugin, data-liberation, digital-history, icloud, imessage, personal-data
- Language: Ruby
- Homepage:
- Size: 52.7 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Chronicle::Imessage
[](https://badge.fury.io/rb/chronicle-imessage)
Access your iMessage messages and attachments using the command line with this plugin for [chronicle-etl](https://github.com/chronicle-app/chronicle-etl).
## Usage
```sh
# Install chronicle-etl and this plugin
$ gem install chronicle-etl
$ chronicle-etl plugins:install imessage
# Load messages from the last week
$ chronicle-etl --extractor imessage --schema chronicle --since 1w
# Of the latest 1000 messages received, who were the top senders?
$ chronicle-etl -e imessage --schema chronicle --limit 1000 --fields agent.name | sort | uniq -c | sort -nr
```
## Available Connectors
### Extractors
#### `message`
Extractor for importing messages and attachments from local macOS iMessage install (via local cache at `~/Library/Messages/chat.db`)
##### Settings
- `input`: (default: ~/Library/Messages/chat.db) Local iMessage sqlite database
- `load_attachments`: (default: false) Whether to load message attachments
- `only_attachments`: (default: false) Whether to load only messages with attachments
We want messages to have sender/receiver information set properly so we try to infer your iCloud information and phone number automatically. If these fail, you can provide the necessary information with:
- `my_phone_number`: Your phone number (for setting messages's actor fields properly)
- `my_name`: Your name (for setting messages's actor fields properly)
- `icloud_account_id`: Specify an email address that represents your iCloud account ID
- `icloud_account_dsid`: Specify iCloud DSID
- Can find in Keychain or by running `$ defaults read MobileMeAccounts Accounts`