tickle-me-email¶

Toolbox for implementing GTD-like behaviours in your IMAP inbox.

Examples¶

Print the current “TODO” list:
```
$ tickle-me-email todo
```

Send a “TODO” email to yourself, injecting it via IMAP:

$ tickle-me-email todo Empty recycle bin

or:

$ echo Empty recycle bin | tickle-me-email todo -

“Tickler” file email rotation from DELAYED.07 to DELAYED.06 etc. Mail from DELAYED.01 is moved to your main inbox. Use this to “put off” emails until a day they are important. To be run daily from cron(8):
```
$ tickle-me-email rotate Inbox.Mail.DELAYED.%02d 1 7 INBOX
```
Single-folder version of the above to move email for “after” work into your main inbox. Use this when you receive a non-work email during the day. To be run at, say, 6:15pm from cron(8):
```
$ tickle-me-email move Inbox.Mail.DELAYED.18h15 INBOX
```
Send draft emails queued in the LATER.Evening, moving them to Sent Items if successful. Use this to avoid getting replies “too” quickly. To be run at, say, 6:15pm from cron(8):
```
$ tickle-me-email send-later INBOX.Mail.LATER.Evening "INBOX.Sent Items"
```
List all email mailboxes. Use this to find out the “internal” names of your IMAP folders:
```
$ tickle-me-email list
```
Print the current configuration:
```
$ tickle-me-email config
```

Configuration¶

You configure tickle-me-email via the optional configuration files:

~/.config/tickle-me-email/tickle-me-email.cfg
/etc/tickle-me-email/tickle-me-email.cfg

For example:

[imap]
server=imap.example.org
username=lamby
password=secret
secure=true

[smtp]
server=smtp.example.org
username=lamby
password=secret
secure=true

[todo]
mailbox=INBOX
recipient=TODO <your@email.com>

Alternatively, you can define the following environment variables:

IMAP_SERVER (eg. imap.example.org)
IMAP_SECURE (eg. true/false)
IMAP_USERNAME (eg. lamby)
IMAP_PASSWORD (eg. secret)
SMTP_SERVER (eg. smtp.example.org)
SMTP_SECURE (eg. true/false)
SMTP_USERNAME (eg. lamby)
SMTP_PASSWORD (eg. secret)
TODO_EMAIL (eg. TODO <your@email.com>)
TODO_PREFIX (eg. ``TODO: ``)
TODO_MAILBOX (eg. INBOX)