Metadata-Version: 2.1
Name: imessage-conversation-analyzer
Version: 1.0.1
Summary: Analyzes the entire history of a macOS Messages conversation
Home-page: https://github.com/caleb531/imessage-conversation-analyzer
Author: Caleb Evans
Author-email: caleb@calebevans.me
License: MIT
Description: # iMessage Conversation Analyzer
        
        *Copyright 2020 Caleb Evans*  
        *Released under the MIT license*
        
        This macOS CLI program will read the contents of an iMessage conversation via
        the Messages app's database on your Mac. You can then gather various metrics of
        interest on the messages and attachments collected.
        
        Much of this program was inspired by and built using findings from [this blog post by Yorgos Askalidis][blog-post].
        
        [blog-post]: https://towardsdatascience.com/heres-how-you-can-access-your-entire-imessage-history-on-your-mac-f8878276c6e9
        
        ### Caveats
        
        Please note that currently, you can only query conversations between you and a
        single other person (i.e. group chats are currently unsupported).
        
        ## Installation
        
        ### 1. Install Python 3
        
        macOS does not include Python 3 out of the box, but you can install Python 3
        with the [Homebrew][homebrew] package manager.
        
        [homebrew]: https://brew.sh/
        
        ```sh
        brew install python@3
        ```
        
        ### 2. Set up virtualenv
        
        ```sh
        pip3 install virtualenv
        ```
        
        ```sh
        virtualenv --python=python3 .virtualenv
        source .virtualenv/bin/activate
        ```
        
        ### 3. Install project depdendencies
        
        ```sh
        pip install -r requirements.txt
        ```
        
        ## Usage
        
        #### -c / --contact-name
        
        Required; the combined first and last name of the macOS contact whose
        conversation you want to fetch (e.g. `John Doe`).
        
        ```sh
        ica -c 'John Doe' -m ica/metrics/message_totals.py
        ```
        
        #### -m / --metric-file
        
        Required; a Python file with an `analyze()` function; this file must return a
        pandas `DataFrame`. See the examples in `ica/metrics`.
        
        ```sh
        ica -c 'John Doe' -m ica/metrics/most_frequent_emojis.py
        ```
        
        #### -f / --format
        
        Optional; the output format of the result. Omit this argument for a simple
        textual table, or specify `csv` to print output as CSV.
        
        ```sh
        ica -c 'John Doe' -m ica/metrics/message_totals.py -f csv
        ```
        
        You can also output as CSV and use the `pbcopy` command for easy copy/pasting
        into a spreadsheet program (like Excel or Numbers).
        
        ```sh
        ica -c 'John Doe' -m ica/metrics/message_totals.py -f csv | pbcopy
        ```
        
Keywords: apple imessage macos conversation chat analysis pandas
Platform: UNKNOWN
Description-Content-Type: text/markdown
