# Email Analytics

A short script to do simple analysis of mbox email files.

Currently the script:

* plots time vs day of all emails, optionally color-coded by user-specified sender information (example below)
* plots the number of emails delivered to specified domains, as a function of time

In the future, I would like to add capabilities to:

* histograms collapsed along different axes
* histogram of popular email addresses
* gant chart of when email addresses were being emailed
* histogram of number of attachments and size of attachments
* histogram of number of recipients
* word count of emails?
* python natural language toolkit analysis?

## Usage

For usage information:

```
$ python email_stats.py -h
usage: email_stats.py [-h] [--plotroot PLOTROOT] [--title TITLE]
                      [--sendercolors SENDERCOLORS]
                      mbox

positional arguments:
  mbox                  Mailbox to analyze.

optional arguments:
  -h, --help            show this help message and exit
  --plotroot PLOTROOT, -p PLOTROOT
                        Root name for output plots.
  --title TITLE, -t TITLE
                        Plot title root.
  --sendercolors SENDERCOLORS, -s SENDERCOLORS
                        Comma separated list of search strings for the sender
                        field. Each will be displayed with a different color.
```

## Sample Output

<img src="https://raw.githubusercontent.com/privong/email_analytics/master/sample.png">

## License

The script is licensed under the GPLv3.