WMBIFFRC(5)

NAME
wmbiffrc - configuration file for wmbiff(1)

DESCRIPTION
WMbiff is a mail notification tool for the WindowMaker and AfterStep window managers. It can handle up to 5 mailboxes, and you can define actions on mouse clicks for the different mailboxes. This manpage explains the different options which can be specified in a user's wmbiffrc.

OPTIONS
Each option takes the form option[.mbox] = value. Comment must be preceeded by pound signs (#). The supported configuration options are:

interval
    Global interval between mailbox checking. Value is the number of seconds, 5 is the default.

label.n
    Specifies the displayed label for a mailbox. It can be up to five characters long.

path.n
    Path to the mailbox, local or remote one. Path lines start with a prefix, which specifies the type of wmbiff box you're setting up. The following types are supported:

    mbox
        This is a local mbox mailbox. After the prefix, you only need to put the path to the mailbox wmbiff needs to read. This is also the default.
        mbox:/path/to/mail/debian-devel
            - or -
        /path/to/mail/debian-devel

    maildir
        Maildir mailboxes are now supported! This works just like mbox above. After the prefix, you need to put the path to the maildir wmbiff will read.
        maildir:/path/to/mail/bugtraq/

    pop3
        Using this type, wmbiff will fetch mail from a pop3 server, using the specified username, password, host and an optional port number (defaulting to 110). If your password contained special character, eg. '@' or ':', use another path format. See Authentication below for a description of the auth field.
        pop3:user:passwd@server[:port] [auth]
        pop3:user passwd server[ port] [auth]

    imap
        These are IMAP4 boxes. As with pop3, wmbiff will read a imap4 mbox using the given values and will display info about the remote mail. This type accepts user, password, host and optional path to mailbox and port number. See Authentication below for a description of the auth field.
        imap:user:passwd@server[/mailbox][:port] [auth]
        imap:user passwd server[/mailbox][ port] [auth]

    imaps
        These are IMAP4 boxes wrapped in a TLS (SSL) connection, only available if wmbiff was compiled with TLS support. Parameters are the same as those for ordinary IMAP4 boxes. Port defaults to 993. If 143 is specified, wmbiff will attempt to connect unencrypted but negotiate TLS using IMAP's STARTTLS command. TLS support uses gnutls, which is under development and may be insecure. TLS support is only for encryption: since certificates are not yet checked, it is vulnerable to man-in-the-middle attack.
        imaps:user:passwd@server[/mailbox][:port] [auth]
        imaps:user passwd server[/mailbox][ port] [auth]

    licq
        With this box type, wmbiff will read the given history file and track the number of messages in it. It just needs a path to a given licq history file.
        licq:/path/to/.licq/history/file.history

notify.n
    Command to be executed on new mail arrival in the given mailbox. Accepts the special keyword "beep" to use the pc speaker.

action.n
    Command to be executed on left mouse click on a mailbox label.

interval.n
    Per mailbox check interval. Value is the amount of seconds between checkings, default is the global interval.

fetchinterval.n
    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.

fetchcmd.n
    Command to be executed to fetch mail. If not specified, fetching through wmbiff is disabled completely.

AUTHENTICATION
Authentication methods include "cram-md5", "apop" (for Pop3), and "plaintext". "cram-md5" and "apop" are only available when wmbiff is compiled with libgcrypt. 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 don't want your password to be sent in cleartext over the network. Conversely, append "plaintext" if you don't 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.

FILES

~/.wmbiffrc
    peruser wmbiff configuration file.

AUTHOR
This manual page was written by Jordi Mallach <jordi@debian.org>, originally for the Debian GNU/Linux system (but may be used by others).

SEE ALSO
wmbiff(1)
/usr/share/doc/wmbiff/examples/sample.wmbiffrc (or equivalent on your system)