goimapnotify

README

Go IMAP notify

Execute scripts on IMAP mailbox changes (new/deleted/updated messages) using IDLE, golang version.

Please read the CHANGELOG file to know what's new.

This application is mostly compatible with the configuration of imapnotify made with Python (be sure to change password_eval to passwordCmd, see issue #3), the following are all options available for the configuration:

{
  "host": "",
  "port": 143,
  "tls": false,
  "tlsOptions": {
    "rejectUnauthorized": true
  },
  "username": "",
  "password": "",
  "passwordCmd": ""
  "onNewMail": "",
  "onNewMailPost": "",
  "boxes": [
    "INBOX"
  ]
}

On first start, the application will run onNewMail and onNewMailPost and then wait for events from your IMAP server.

• onNewMail: is an executable or script to run when new mail has arrived.
• onNewMailPost: is an executable or script to run after onNewMail has ran.
• passwordCmd: is an executable or script that retrieves your password from somewhere, we cannot pass arguments to this command from Stdin.

The application will use TLS as long as the IMAP server advertises this capability. If you use self-signed certificates or something, be sure to set rejectUnauthorized as false.

If your host do not offer IDLE, a sane default of checking every 15 minutes will take place instead.

Install

go get -u gitlab.com/shackra/goimapnotify

Usage

Usage of ./goimapnotify:
-conf string
    Configuration file (default "path/to/imapnotify.conf")
-debug
    Output all network activity to the terminal (!! this may leak passwords !!)
-list
    List all mailboxes and exit

As you can notice, -list can help you figure out the mailbox hierarchy of your mail server.