Skip to content

Latest commit

 

History

History
66 lines (44 loc) · 1.59 KB

README.md

File metadata and controls

66 lines (44 loc) · 1.59 KB
Raw

iPhone Message Extractor

Simple CLI written in Python to extract messages (SMS/iMessage) to CSV from iPhone backups. Apologies if my Python is rusty; it's been a while.

As a note, this is (deliberately) not yet available via setuptools.

Setup

After cloning run pip3 install virtualenv and then set up your virtual environment

virtualenv -p python3 venv

(.If you have trouble building the virtalenv, try running pip3 install --upgrade pip and pip3 install --upgrade setuptools to install the latest version of pip3 and setuptools respectively.)

Active the virtual environment by running:

source ./venv/bin/activate

Then install the necessary dependencies.

pip3 install -r requirements.txt

Running

Ensure that you are using your virtual environment (see above)

source ./venv/bin/activate

Then run

./iphone_message_extractor.py [-v] [-c COUNTRY] [-p BACKUP_PATH] device_hash output_path

Run ./iphone_message_extractor.py -h for a full explanation of options

Running tests

source ./venv/bin/activate

python -m unittest discover

Release Notes:

New in version 0.1.1:

  • Emojis actually work (very important, I know)! 🎉
  • Added fixtures and integration tests for phone_db.py

New in version 0.1.0:

  • Basic CLI works!

TODO

Planned features, in rough priority:

  • Support for group conversations
  • Get working for encrypted backups
  • Add support for images
  • Make verbosity actually do something
  • Pull voicemail
  • E2E test for message_extractor.py
  • Add some sort of progress spinner to indicate the script is doing work
  • Fix emoji output