Skip to content
This repository

IMAP new mail notification utility for iPhone using Prowl Public API

branch: master

Fetching latest commit…


Cannot retrieve the latest commit at this time

Octocat-spinner-32 debian
Octocat-spinner-32 .gitignore
Octocat-spinner-32 AUTHORS
Octocat-spinner-32 ChangeLog
Octocat-spinner-32 GPL
Octocat-spinner-32 LICENSE
Octocat-spinner-32 README
Octocat-spinner-32 config.yml
Octocat-spinner-32 imapidle.rb
Octocat-spinner-32 imaprowl.rb
IMAProwl Version 1.2

 * Requirements

  - Ruby 1.9.0 or later with OpenSSL module.
  - Prowl service account. (free to get your account,
  - Prowl iPhone application from AppStore, not free.
  - IMAP server should support IMAPs(IMAP over SSL) or TLS.

 * Instruction

  - edit example configuration file and copy it to ~/.imaprowl.conf
  - execute imaprowl.rb with ruby1.9

 * Command line option

  -  -c, --config FILENAME       Specify configuration file.
  -  -q, --daemon                Enable daemon mode.
  -  -d, --debug                 Enable debug mode.

 * Configuration file

  - load path order. (it'll be overridden with -c option)

    1. -c option
    2. $HOME/.imaprowl.conf
    3. `pwd`/imaprowl.conf
    4. `pwd`/config.yml (deprecated)
    5. dirname($0)/imaprowl.conf

  - config description

  LogDir: <String>
   log directory, ex: "/home/foo/logs/".
   If it's not defined, output all logs into STDOUT/ERR and turn on debug mode forcefully.
  Debug: <Boolean>
    [optional] to enable debug output, default: false
  Daemon: <Boolean>
    [optional] to enable daemon mode, default: false

   APIKey: <String>
    The prowl apikey of your account
   ProxyHost: <String>
   ProxyPort: <Int>
   ProxyUser: <String>
   ProxyPass: <String>
    [optional] HTTP Proxy settings if it's available.

    Appication: <String>
     application name for prowl. (Identity of account)
    User: <String>
     username for IMAP server.
    Pass: <String>
     password for IMAP server.
    Host: <String>
     hostname or IP address of IMAP server, SSL/TLS support is required.
    Port: <Int>
     [optional] TCP port number of IMAP server, default: 993
    Priority: <Int>
     [optional] Notification Priority: -2(low) to 2(high), default: 0
    MailBox: <String>
     [optional] mailbox to check UNSEEN, default: INBOX
    BodyLength: <Int>
     [optional] body length for prowl notification, default: 100, Max: 1000
    SubjectLength: <Int>
     [optional] subject length for prowl notification, default: 20
    Format: <string>
     [optional] prowl text format, you can use "%{subject}", "%{from}", "%{name}" and "%{addr}" keyword in the format string.  default: "%{subject} (%{from})"
    Timeout: <Int> (in minutes)
     [optional] Timeout for No-Response, default: 20
    NOOPInterval: <Int> (in seconds)
     [optional] NOOP interval for no-IDLE mode, it should be really short about 30 or so. default: 30
    NoIDLE: <Boolean>
     [optional] force no-IDLE mode, default: false.
    Enable: <Boolean>
     [optional] false to disable this account, default: true

Takuo Kitame.
Something went wrong with that request. Please try again.