imaprowl(1)

Usage

imaprowl -c FILENAME [--config FILENAME] [{-q | --daemon}] [{-d | --debug}]

imaprowl [{{-h | --help} | {-v | --version}}]

Overview

This manual page documents briefly the imaprowl command.

This manual page was written for the Debian distribution because the original program does not have a manual page.

imaprowl is an IMAP new mail notification utility for iPhone using Prowl Public API

Prowl is a service and an App for iPhone's Push Notification service.(APNs) See idm70 for more about Prowl.

IMAProwl is an utility script to notify new mail of IMAP server with Prowl service. It's very useful to push notification of GMail or any other IMAP mail service to your iPhone.

This program uses IMAP/IDLE(RFC2177) or IMAP/NOOP to check the new mail on IMAP server and uses Prowl Public API via HTTPS.

Requirements

Ruby script language version >= 1.9.0

OpenSSL extenstion library for Ruby

IMAP server must support SSL/TLS connection.

The Prowl service account. It's free, you can register at http://prowl.weks.net/

Your iPhone deveice and the Prowl.app from AppStore.

Options

The program follows the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of options is included below.

-c FILENAME, --config FILENAME: Configuration file to load.

-q, --daemon: Enable daemon mode. imaprowl will launch as background process.

-d, --debug: Enable debug output.

-h, --help: Show summary of options.

-v, --version: Show version of program.

Files

${HOME}/.imaprowl.conf

The per-user configuration file to control the behaviour of imaprowl. See /usr/share/doc/imaprowl/examples/config.yml for further details.

Issues

The program is currently limited to only work with the ruby1.9.

The upstreams Issue tracker can be found at http://github.com/takuo/IMAProwl/issues.

Releases

8 releases since Debian 6.0 (Squeeze); the text changed 3 times.