WMBIFFRC(5)

💖 NAME 💖

wmbiffrc — bestie, this is the config file for wmbiff(1). This whole page is wmbiffrc(5), filed under File Formats Manual, and it's about to be your new favorite read, no cap ✨

---

🦋 DESCRIPTION 🦋

Okay so. WMbiff is a mail notification tool for the WindowMaker and AfterStep window managers. It can handle up to 5 mailboxes — and honestly more than that when you run it under other window managers, because it's flexible like that 💅

You can define actions on mouse clicks for the different mailboxes. And this manpage right here explains all the different options you can drop into a user's wmbiffrc. Let's get into it, bestie 🫶

---

✨ OPTIONS ✨

Every option is shaped like this:

option[.mbox] = value

Comments must be preceded by pound signs (#). Yes, #, the classic. 🔥

The supported configuration options are:

• certfile — the file that holds your TLS (SSL) certificates. If you specify it, wmbiff will actually check certificates and exit on a failure, so your password stays secure. If it's not present, wmbiff will trust all certificates and may be vulnerable to a man-in-the-middle attack 😭 WMbiff's will not prompt if you want to accept new certificates. Instead, wmbiff expects your mail client to keep certificates in a file. So like, for example, if mutt is your mailreader, you may add:

certfile=/home/<me>/.muttsslcerts

• tls — specify cipher suite preferences on a TLS session. Can be a predefined value from gnults or a custom value. Default value is:

NORMAL

The gnutls predefined values are, and I'm listing every single one because we do not gatekeep:

PERFORMANCE (gnutls >= 2.2.0)
NORMAL (gnutls >= 2.2.0)
SECURE128 (gnutls >= 2.2.0)
SECURE192 (gnutls >= 3.0.0)
SECURE256 (gnutls >= 2.2.0)
SUITEB128 (gnutls >= 3.0.0)
SUITEB192 (gnutls >= 3.0.0)
EXPORT (gnutls >= 2.2.0)
NONE (gnutls >= 2.2.0)

See http://gnutls.org/manual/gnutls.html#Priority-Strings for more details 👑

• interval — global interval between mailbox checking. The value is the number of seconds, and 5 is the default. Five. FIVE. So impatient 💀
• askpass — the program run to ask for IMAP passwords, if it's left empty in the configuration file. The default is /usr/bin/ssh-askpass. Can be specified on a per-mailbox basis.
• skinfile — the XPM pixmap file to load for the background. If it's not a full path, wmbiff will search these, in order, for the pixmap file:
  • /usr/share/wmbiff/skins
  • /usr/share/wmbiff
  • /usr/local/share/wmbiff
  • and the current directory

go find your lewk, bestie 🎀

• globalnotify — command to be executed when new mail is received in any mailbox. Set notify.n to override this option for mailbox n.
• label.n — specifies the displayed label for a mailbox. It can be up to five characters long. Five. That's the whole vibe budget.
• path.n — the 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. Local mboxes may be specified using shell commands enclosed in back-ticks. (`s.)

mbox:/path/to/mail/debian-devel

• maildir — this works just like mbox above.

maildir:[:flags:]/path/to/mail/bugtraq/

flags can be one or more of:

• F — Flush directory caches by creating (then deleting) a temporary file in each maildir prior to checking. This hack speeds up checking network-mounted maildirs in cases where directory caching can cause unwanted delays (eg. SFS-mounted maildirs).

• pop3 — using this type, WMBiff will check for mail on a pop3 server using the specified username, password, host and an optional port number (defaulting to 110). If your password contains a special character, eg. '@' or ':', use the second path format. See Authentication below for a description of the auth field.

pop3:user:passwd@server[:port] [auth]
pop3:user passwd server[ port] [auth]

• pop3s — exactly like pop3, only uses TLS (SSL) when built with gnutls and defaults to port 995. This copy of WMBiff was compiled with GNUTLS. 💅
• imap — these are IMAP4 boxes. As with pop3, WMBiff will report the status of an IMAP4 mbox using the given values. This type accepts user, optional password, host and optional path to mailbox and port number. See Authentication below for a description of the auth field. The password may be left empty: see askpass above for information on password prompting. If your password includes a @, use the space delimited form. If it contains a space or #, use the askpass option instead. The mailbox field may be quoted, e.g., server/"Mail/Eggs and Spam". Mailboxes in subfolders may be described as /INBOX.subfolder by some servers and /Mail/subfolder by others.

imap:user:passwd@server[/mailbox][:port] [auth]
imap:user:@server[/mailbox][:port] [auth]
imap:user passwd server[/mailbox][ port] [auth]
imap:user:passwd@server[/"mail box"][:port] [auth]

• imaps — these are IMAP4 boxes wrapped in a TLS (SSL) connection. This copy of WMBiff was compiled with GNUTLS. 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. See the imap format above for additional detail about specifying your password.

imaps:user:passwd@server[/mailbox][:port] [auth]
imaps:user:@server[/mailbox][:port] [auth]
imaps:user passwd server[/mailbox][ port] [auth]

• shell — with this keyword, wmbiff will launch the specified shell command and read its output (STDOUT) expecting an integer message count or a three-character string. If "new" is in the first line, the string or number will be displayed in yellow. The behavior of this experimental keyword is likely to change in future revisions. ⚠️

shell:::/path/to/command
shell:::lpq | grep Queue | awk '{print $2}'

• notify.n — command to be executed on new mail arrival in the given mailbox. Accepts the special keyword "beep" to use the pc speaker. beep beep, that's the sound of being perceived 🔔
• action.n — 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.
• buttontwo.n — 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.
• interval.n — per mailbox check interval. The value is the amount of seconds between checkings, and the 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. 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.
• debug.n — 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

okay so the manpage literally just ends there, mid-sentence 😭 iconic behavior honestly. I'm not gonna invent an ending for it, bestie — that's exactly what it says.

---

📐 SIZING 📐

WMBiff will automatically size its window to the number of configured mailboxes. While WindowMaker's Dock and AfterStep's 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 don't 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. main character energy, truly 👑

---

🔐 AUTHENTICATION 🔐

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 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 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. noted 💅

---

🩹 TROUBLESHOOTING 🩹

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. 💀 (servers lying?? in this economy??)

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. periodt ✨

---

📁 FILES 📁

• ~/.wmbiffrc — per-user wmbiff configuration file.

---

💌 AUTHOR 💌

This manual page was written by Jordi Mallach <jordi@debian.org>, originally for the Debian system (but may be used by others). king behavior honestly 👑

---

🌈 SEE ALSO 🌈

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

---

okay bestie that's the whole page 🫶 this one came from wmbiff, dated November 11, 2002, and it's WMBIFFRC(5) — go configure your mailboxes and slay 💅💖✨