Notifo IMAP Listener

IMPORTANT NOTICE

As of September 8, 2011 notifo is no longer being actively developed (source). I will do my best to hammer out the remaining big bugs this has but you should look into other services. I've started to use boxcar and may make a similar project for that as boxcar's email notification also does not send the content of the email.

As the name suggests, this connects to a mail server over IMAP and waits for any incoming emails. When it receives a message it sends it off to notifo.

While notifo has a built in email notification this script is still useful since you can send the content of the message where notifo's built in notification only parses the subject (as of Aug 2011).

Requirements

• Python 2.x (May work with 2.5 but development is done on 2.6)
• An email that receives incoming messages
• An account on http://notifo.com

Usage

Please note that during development some options may not actually do anything.

• Create an email that will be the listener
• Copy config.ini.sample to config.ini and edit with connection info
• test with ./notifo-imap-listener.py.
• if no errors use ctrl-c and then start with ./notifo-imap-listener.py --quiet &
• test it by sending an email to the address and it should show up on phone within a second or two.
• to properly kill use either ctrl-c if interactive or send SIGINT to process kill -INT 123 where 123 is process id

Config.ini Options

• mail.ssl is if the client should connect to the server via SSL (highly recommended).
• notifo.username is your api username which is usually the same as your actual username
• notifo.secret is your api secret which you can get from logging in to notifo and click on settings.
• notifo.label will prefix the subject of the message.
• security.from if set to something other than None, will require messages to come from the specified email. All others will be silently dropped
• logging.file is the file to log to. If you don't want to log to a file use /dev/null
• logging.level one of debug, info, warning, error, or critical. Used for log file. To turn off pretty much all logging set this to critical.

Initial Goals

• constantly listens for new mail to relay the message as quick as possible
• single user for now
• basic user validation (must come from an authorized email address)

Future Goals

• multi-user (using twisted)