WMBIFF(1)WMBIFF(1)NAME
WMBiff - A dockable Mailbox Monitor
SYNOPSISwmbiff [-display <display name>] [-geometry +XPOS+YPOS] [-c <filename>]
[-h] [-v] [-debug] [-fg <foreground-color>] [-font <X11 font>|default]
[-hi <highlight-color>] [+w]
DESCRIPTION
WMbiff displays the status of up to five mailboxes. It shows the number
of new mail messages, if any, or the total number of messages. It also
has mail retrieval capabilies, and can be configured to do this auto‐
matically. At the moment, UNIX-style, maildir, POP3, APOP and IMAP4
mailboxes are supported. WMbiff also supports Licq history files and
gnomeicu, displaying the number of new messages in your running ses‐
sion, as if they were mail.
The mailboxes are displayed in 5 different lines, each one with its own
description of up to five chars. If no mail is present in a given mail‐
box, WMbiff will display the total number of mails in cyan. If there's
new mail in the box, the number of new messages will be displayed in
yellow. When new mail arrives, this number will optionally flash for a
small period of time, and also optionally, a command can be executed on
mail arrival (for example, opening your mail reader or playing a sound
file).
Pressing mouse button 1 will execute a command, defined in the user's
config file. Mouse button 3 will execute a command to fetch mail, if
defined. To restart wmbiff, press mouse button 1 while holding control
and shift keys, or send it SIGUSR1.
OPTIONS-h Show summary of options.
-v Show version of program.
-display <display name>
Use an alternate X Display.
-geometry <geometry>
Initial window position.
-c <filename>
Use specified configuration file instead of ~/.wmbiffrc.
-debug Print verbose log of progress.
-fg <color>
Use specified X11 color. Implies -font default, unless overrid‐
den.
-font <font>
Use specified X11 font instead of the LED pixmap. This may be
more readable or suitable for some non-US characters. The spe‐
cial font "default" tells wmbiff to use a compile time default.
-hi <color>
Use specified X11 color for new mail counters. Implies -font
default, unless overridden.
-skip-certificate-check
When using TLS (IMAPS), keep going, even if the server's cer‐
tificate is invalid. Invalid certificates have expired, have a
different hostname than you connected to, are corrupt, or have
been revoked. Do not use this option unless wmbiff fails and
suggests it to you, and even then, be careful and consider
alerting your mail system administrator first. The need to use
this option is a sign of server misconfiguration.
+w Do not use the "withdrawn" state: the wmbiff window will not be
captured as an icon and placed in the dock, but will instead
have its own window. This option starts with a '+' for consis‐
tency with other software programs: many use '-w' to mean the
opposite.
BUGS
Send bug reports or suggestions to the WMBiff Development Mailing List
<wmbiff-devel@lists.sourceforge.net>. Consider attaching a transcript
of your session, generated using:
wmbiff-debug | tee wmbiff-log
Be sure to remove any instances of your password.
FILES
~/.wmbiffrc
peruser wmbiff configuration file.
AUTHOR
This manual page was written by Jordi Mallach <jordi@sindominio.net>,
originally for the Debian system (but may be used by others).
WMBiff was first maintained by Gennady Belyakov. Since January 2001 it
is maintained group of people that have added lots of new features to
the original program. Please see the README document for a list of all
the people involved.
SEE ALSOwmbiffrc(5)
/usr/share/doc/wmbiff/examples/sample.wmbiffrc (or equivalent for your
system)
wmbiff October 4, 2001 WMBIFF(1)
