File that holds TLS (SSL) certificates. If specified,
wmbiff will check certificates and exit on a failure, so
your password is secure. If not present, wmbiff will trust
all certificates and may be vulnerable to a
man-in-the-middle attack. WMbiffs will not prompt if you
want to accept new certificates. Instead, wmbiff expects
your mail client to keep certificates in a file. For
example, if mutt is your mailreader, you may add:
|Global interval between mailbox checking. Value is the number of seconds, 5 is the default.|
|Program run to ask for IMAP passwords, if left empty in the configuration file. The default is /usr/bin/ssh-askpass. Can be specified on a per-mailbox basis.|
|XPM pixmap file to load for the background. If not a full path, wmbiff will search /usr/local/share/wmbiff/skins, /usr/share/wmbiff, /usr/local/share/wmbiff, and the current directory for the pixmap file.|
|Command to be executed when new mail is recieved in any mailbox. Set notify.n to override this option for mailbox n.|
|Specifies the displayed label for a mailbox. It can be up to five characters long.|
Path to the mailbox, local or remote one. Path lines start with a prefix,
which specifies the type of wmbiff box youre setting up. The following types
|Command to be executed on new mail arrival in the given mailbox. Accepts the special keyword "beep" to use the pc speaker.|
|Command to be executed on left mouse click on a mailbox label. Accepts the special keyword "msglst" to pop up a window of recent message headers from IMAP or POP3 mailboxes when the left mouse button is held.|
|Command to be executed on middle mouse click on a mailbox level. Accepts the special keyword "msglst" to pop up a window of recent message headers from IMAP or POP3 mailboxes when the middle mouse button is held.|
|Per mailbox check interval. Value is the amount of seconds between checkings, default is the global interval.|
|Interval between mail auto-fetching. Values accept 0 to disable, -1 for autofetching on new mail arrival, and positive values for a given interval in seconds.|
|Command to be executed to fetch mail. If not specified, fetching through wmbiff is disabled completely. Accepts the special keyword "msglst" to pop up a window of recent message headers from IMAP and POP3 mailboxes when the right mouse button is held down, though not when fetchinterval is nonzero.|
Show debugging messages from this mailbox. Currently
supported values are "all" and "none". The -debug option
to wmbiff overrides this setting. Since IMAP uses a single
connection per server, per-mailbox debugging may not
WMBiff will automatically size its window to the number of configured mailboxes. While WindowMakers Dock and AfterSteps Wharf expect square, 64x64 applets, other window managers, such as Blackbox or Openbox do not have this limitation. This uncharacteristic "dockapp" behavior is intended to help those users who dont have exactly five mailboxes to watch.
To preserve the old-style five-mailbox window even when you have only two, add path.4=<space><space> to configure a blank 5th mailbox.
To use the new-style sizing, just configure as many mailboxes as you want.
Authentication methods include "cram-md5", "apop" (for Pop3), and "plaintext". "cram-md5" and "apop" are only available when wmbiff is compiled with libgcrypt. This copy of WMBiff was not compiled with gcrypt. Authentication methods are tried in the following order: cram-md5, apop, plaintext.
Each authentication method will be tried unless a list is included in the [auth] field. For example, append "cram-md5 apop" if you dont want your password to be sent in cleartext over the network. Conversely, append "plaintext" if you dont want wmbiff to bother with other authentication methods. Leaving authentication methods unspecified should be reasonably safe. The order of entries in the [auth] list is not currently considered.
For problems authenticating to servers, try specifying the authentication method explicitly as described above: sometimes a failed attempt to authenticate can cause later failures. Some servers claim to support cram-md5 but fail: telling wmbiff not to try can help.
For other problems, run wmbiff with the -debug option. See wmbiff(1) for details.
While editing .wmbiffrc, you may find it useful to restart wmbiff using either control-shift mouse button 1, or killall -USR1 wmbiff.
~/.wmbiffrc per-user wmbiff configuration file.
This manual page was written by Jordi Mallach <firstname.lastname@example.org>, originally for the Debian system (but may be used by others).
/usr/share/doc/wmbiff/examples/sample.wmbiffrc (or equivalent on your system)
|wmbiff||WMBIFFRC (5)||November 11, 2002|