DragonFly On-Line Manual Pages

Search: Section:  

WMBIFF(1)              DragonFly General Commands Manual             WMBIFF(1)


NAME

       WMBiff - A dockable Mailbox Monitor


SYNOPSIS

       wmbiff [-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
       automatically. 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
       session, 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
       mailbox, 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
              overridden.

       -font <font>
              Use specified X11 font instead of the LED pixmap.  This may be
              more readable or suitable for some non-US characters.  The
              special 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
              certificate 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
              consistency 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 ALSO

       wmbiffrc(5)
       /usr/share/doc/wmbiff/examples/sample.wmbiffrc (or equivalent for your
       system)

wmbiff                          October 4, 2001                      WMBIFF(1)

Search: Section: