NAME
wmmaiload - A dockapp to monitor mailboxes
SYNOPSIS
wmmaiload [options]
DESCRIPTION
This manual page documents briefly the wmmaiload command.
WMMaiLoad is a program to monitor mailboxes. It is a dockapp that is
supported by X window managers such as Window Maker, AfterStep,
BlackBox, and Enlightenment.
The new mails number is displayed in the top half. The total mails
number is in the bottom half. It has an LCD look-alike user interface.
The back-light may be turned on/off by clicking the mouse button 1
(left) over the application. If there is new mail, an alarm-mode will
alert you by turning on and off back-light. This can be stopped (and
restarted) by clicking the mouse button 3 (right) over the application.
An application can be launched with the mouse button 2 (middle) such as
a mail user agent. When clicking on the dockapp with button 2 and the
control key pressed, it launches wmmaiload-config, the WMMaiLoad
configuration tool (if it can be found in the PATH). One can cycle
through individual mail boxes by clicking on the "-" or "+" signs in
the window (can display up to 99 mailbox numbers even if more can be
put in the list). The "--" mailbox number is for displaying the global
values. No cycle can be done if there’s only one mailbox :) Using
button 3 cycles mailboxes by 10.
Command-line options override the default configuration file options
(see FILE section below).
There are 3 alarm modes. First when there is new mail either if the
global mailbox is displayed or a mailbox that has no new mail is
currently displayed, then the background blinks. Second, when there is
new mail only in the mailbox that is currently displayed, then the new
mails count blinks. Last, when there is new mail in the currently
displayed mailbox and in another mailboxe, then the background and the
new mails count blink.
WMMaiLoad can monitor mbox-format files, MAILDIRS, MH, POP3, HOTMAIL
and IMAP mailboxes...
OPTIONS
This program follows the usual GNU command line syntax. A summary of
options is included below.
-h show help text and exit.
-v show program version and exit.
-w run the application in windowed mode.
-k activate broken window manager fix.
-b turn on back-light.
-s disable blinking when there is new mail.
-r run command (see -n) only once : not each time new mail arrives,
but only when new mails count change from 0 to not 0 :)
-z use files’ size to check for new mails instead of time.
-t don’t use threads for mail boxes checking.
-d <string>
Attempt to open a window on the named X display. If this option
is not present, the display specified by the DISPLAY environment
variable is used.
-c <color>
back-light color (rgb:6E/C6/3B is default).
-x <string>
command to launch with button 3.
-n <string>
command to launch each time there is new mail.
-f load configuration file.
-i <number>
number of secs between updates (1 is default).
-o <number>
display specified box infos directly (0 is the default for
global counts). This option should be put AFTER any addition to
the mail box list in order to verify mailbox number validity.
-l <number>
delay in seconds between pop3/hotmail and imap checks.
-m <string>
use that mail box (may be used more than once -- see section
FILE below).
FILE
wmmaiload uses one default file : ~/.wmmailoadrc. Empty lines or lines
begining with a # are ignored. Entries are summarized below (default
value in parenthesis). Booleans can be either 1/0 or true/false or
yes/no or on/off, case insensitive. A sample file is given in the
source package. The configuration entries are overwritten by command
line arguments. But if configuration is changed via the graphical
configuration tool in runtime, configuration options are then read from
the file if it has been saved.
Backlight =
Boolean (off).
Color =
String (#6EC63B).
Interval =
Integer (1).
Mailbox =
String (noting). You can have several Mailbox entries. A mailbox
is defined with a maximum of 5 space-separated fields : type,
file-or-url, username, password and folder. Types are MBOX,
POP3, MAILDIR, MH, HOTMAIL and IMAP. For an MBOX, MH and
MAILDIR mail boxes, the file-or-url field is the filename (or
directory name) of the mbox file and other fields are not used.
For POP3, HOTMAIL and IMAP boxes, the file-or-url field is the
server url, other fields are used as normal. Note that in the
latter case, you can use the standard server:port specification.
The folder field is used for IMAP only.
Command =
String (nothing).
Notify =
String (nothing).
Blink =
Boolean (yes).
DefaultBox =
Integer (0).
CheckDelay =
Integer (30, min = 15).
RunOnce =
Boolean (False).
CheckSize =
Boolean (False). For mbox files : if False, check mbox mtime.
UseThreads =
Boolean (True). Use threads for mail boxes checking or not.
MAILBOXES
Mail boxes are more willingly configured from within the configuration
file for ease of use rather than from command line. A configuration
option for a mail box is following the next scheme :
Mailbox = TYPE FILE-OR-URL [USERNAME] [PASSWORD] [FOLDER]
TYPE must be one of MBOX, POP3, MAILDIR, MH, HOTMAIL and IMAP.
FILE-OR-URL
is where to get the mailbox data :
- MBOX : the mailbox filename.
- MAILDIR : the mailbox directory name
- MH : the mailbox directory name
- POP3 : the url of the POP3 server
- HOTMAIL : the url of hotmail
- IMAP : the url of the IMAP server
server can be specified as server:port.
USERNAME
is an optional parameter used for POP3, HOTMAIL and IMAP box
types.
PASSWORD
is an optional parameter used for POP3, HOTMAIL and IMAP box
types.
FOLDER is an optional parameter only used for IMAP box types. If not
present, it defaults to INBOX.
SEE ALSO
wmmaiload-config(1).
AUTHOR
WMMaiLoad was assembled by Thomas Nemeth <tnemeth@free.fr>. It is
largely based on WMMemMon and WMCPULoad by Seiichi SATO
<ssato@sh.rim.or.jp> and WMMemLoad by Mark Staggs <me@markstaggs.net>.
September 25, 2002