The Mutt E-Mail Client : Reference : Configuration variables : status_format
Previous: status_chars
Next: status_on_top

## 6.3.254. status_format

Type: string
Default: "-%r-Mutt: %f [Msgs:%?M?%M/?%m%?n? New:%n?%?o? Old:%o?%?d? Del:%d?%?F? Flag:%F?%?t? Tag:%t?%?p? Post:%p?%?b? Inc:%b?%?l? %l?]---(%s/%S)-%>-(%P)---"

Controls the format of the status line displayed in the index menu. This string is similar to `` $index_format'', but has its own set of printf()-like sequences:

%b

  number of mailboxes with new mail *

%d

  number of deleted messages *

%f

  the full pathname of the current mailbox

%F

  number of flagged messages *

%h

  local hostname

%l

  size (in bytes) of the current mailbox *

%L

  size (in bytes) of the messages shown (i.e., which match the current limit) *

%m

  the number of messages in the mailbox *

%M

  the number of messages shown (i.e., which match the current limit) *

%n

  number of new messages in the mailbox *

%o

  number of old unread messages

%p

  number of postponed messages *

%P

  percentage of the way through the index

%r

  modified/read-only/won't-write/attach-message indicator, according to $status_chars

%s

  current sorting mode ( $sort)

%S

  current aux sorting method ( $sort_aux)

%t

  number of tagged messages *

%u

  number of unread messages *

%v

  Mutt version string

%V

  currently active limit pattern, if any *

%>X

  right justify the rest of the string and pad with "X"

%|X

  pad to the end of the line with "X"

* = can be optionally printed if nonzero

Some of the above sequences can be used to optionally print a string if their value is nonzero. For example, you may only want to see the number of flagged messages if such messages exist, since zero is not particularly meaningful. To optionally print a string based upon one of the above sequences, the following construct is used

%?<sequence_char>?<optional_string>?

where sequence_char is a character from the table above, and optional_string is the string you would like printed if status_char is nonzero. optional_string may contain other sequence as well as normal text, but you may not nest optional strings.

Here is an example illustrating how to optionally print the number of new messages in a mailbox: %?n?%n new messages.?

Additionally you can switch between two strings, the first one, if a value is zero, the second one, if the value is nonzero, by using the following construct: %?<sequence_char>?<if_string>&<else_string>?

You can additionally force the result of any printf-like sequence to be lowercase by prefixing the sequence character with an underscore (_) sign. For example, if you want to display the local hostname in lowercase, you would use: %_h

If you prefix the sequence character with a colon (:) character, mutt will replace any dots in the expansion by underscores. This might be helpful with IMAP folders that don't like dots in folder names.

The Mutt E-Mail Client : Reference : Configuration variables : status_format
Previous: status_chars
Next: status_on_top