1muttrc(5)                        User Manuals                        muttrc(5)
2
3
4

NAME

6       muttrc - Configuration file for the Mutt Mail User Agent
7

DESCRIPTION

9       A  mutt  configuration  file  consists of a series of “commands”.  Each
10       line of the file may contain one or more commands.  When multiple  com‐
11       mands are used, they must be separated by a semicolon (“;”).
12
13       The  hash  mark, or pound sign (“#”), is used as a “comment” character.
14       You can use it to annotate your initialization file. All text after the
15       comment character to the end of the line is ignored.
16
17       Single  quotes  (“'”)  and  double  quotes  (“"”)  can be used to quote
18       strings which contain spaces or other special characters.  The  differ‐
19       ence between the two types of quotes is similar to that of many popular
20       shell programs, namely that a single quote is used to specify a literal
21       string (one that is not interpreted for shell variables or quoting with
22       a backslash [see next  paragraph]),  while  double  quotes  indicate  a
23       string which should be evaluated.  For example, backticks are evaluated
24       inside of double quotes, but not single quotes.
25
26       \ quotes the next character, just as in shells such as  bash  and  zsh.
27       For  example,  if  want to put quotes (“"”) inside of a string, you can
28       use “\” to force the next character to be a literal instead  of  inter‐
29       preted character.
30
31\\”  means  to insert a literal “\” into the line.  “\n” and “\r” have
32       their usual C meanings of linefeed and carriage-return, respectively.
33
34       A “\” at the end of a line can be used to split commands over  multiple
35       lines,  provided  that  the  split points don't appear in the middle of
36       command names.
37
38       It is also possible to substitute the output of a Unix  command  in  an
39       initialization  file.  This is accomplished by enclosing the command in
40       backticks (`command`).
41
42       UNIX environment variables can be accessed like the way it is  done  in
43       shells  like  sh and bash: Prepend the name of the variable by a dollar
44       (“$”) sign.
45

COMMANDS

47       alias [-group name [...]] key address [, address [ ... ]]
48       unalias [ *  | key ]
49
50              alias defines an alias key for the given addresses. Each address
51              will be resolved into either an email address (user@example.com)
52              or a named email address (User Name <user@example.com>). The ad‐
53              dress  may  be  specified  in  either  format,  or in the format
54              “user@example.com (User Name)”.  unalias removes the alias  cor‐
55              responding  to  the given key or all aliases when “*” is used as
56              an argument. The optional -group argument to  alias  causes  the
57              aliased address(es) to be added to the named group.
58
59       group [-group name] [-rx EXPR [ ... ]] [-addr address [ ... ]]
60       ungroup [-group name ] [ * | [[-rx EXPR [ ... ]] [-addr address [ ... ]]]
61
62              group  is  used  to directly add either addresses or regular ex‐
63              pressions to the specified group or groups. The different  cate‐
64              gories  of  arguments  to the group command can be in any order.
65              The flags -rx and -addr specify what the following strings (that
66              cannot  begin  with a hyphen) should be interpreted as: either a
67              regular expression or an email address,  respectively.   ungroup
68              is  used  to  remove  addresses  or regular expressions from the
69              specified group or groups. The syntax is similar  to  the  group
70              command,  however the special character * can be used to empty a
71              group of all of its contents.
72
73              These address groups can  also  be  created  implicitly  by  the
74              alias,  lists,  subscribe  and alternates commands by specifying
75              the optional -group option.
76
77              Once defined, these address groups can be used  in  patterns  to
78              search for and limit the display to messages matching a group.
79
80       alternates [-group name] regexp [ regexp [ ... ]]
81       unalternates [ *  | regexp [ regexp [ ... ]] ]
82
83              alternates  is  used  to  inform  mutt about alternate addresses
84              where you receive mail; you can use regular expressions to spec‐
85              ify  alternate  addresses.   This affects mutt's idea about mes‐
86              sages from you, and messages addressed to you.  unalternates re‐
87              moves  a  regular  expression from the list of known alternates.
88              The -group flag causes all of the subsequent regular expressions
89              to be added to the named group.
90
91       alternative_order type[/subtype] [ ... ]
92       unalternative_order [ *  | type/subtype] [...]
93
94              alternative_order  command  permits  you  to  define an order of
95              preference which is used by mutt to determine which  part  of  a
96              multipart/alternative body to display.  A subtype of “*” matches
97              any subtype, as does an empty subtype.   unalternative_order re‐
98              moves  entries  from the ordered list or deletes the entire list
99              when “*” is used as an argument.
100
101       attachments [ + | - ]disposition mime-type
102       unattachments [ + | - ]disposition mime-type
103       attachments ?
104       unattachments *
105
106              attachments specifies what kinds of  attachments  are  used  for
107              Mutt's attachment counting and searching support.
108
109              disposition  is  the attachment's Content-Disposition type - ei‐
110              ther inline or attachment. You can abbreviate this to I or A.
111
112              The first part of a message or multipart group,  if  inline,  is
113              counted  separately  than  other inline parts. Specify root or R
114              for disposition to count these as  attachments.  If  this  first
115              part  is  of type multipart/alternative, note that its top-level
116              inline  parts  are  also  counted  via  root   disposition   (if
117              $count_alternatives is set).
118
119              disposition  is  prefixed by either a + symbol or a - symbol. If
120              it's a +, you're saying that you want to allow this  disposition
121              and  MIME  type to qualify. If it's a -, you're saying that this
122              disposition and MIME type is an exception to previous + rules.
123
124              mime-type is the MIME type of the attachment you want  the  com‐
125              mand to affect. A MIME type is always of the format major/minor,
126              where major describes the  broad  category  of  document  you're
127              looking  at,  and  minor describes the specific type within that
128              category. The major part of mime-type must be literal  text  (or
129              the  special  token  *), but the minor part may be a regular ex‐
130              pression. (Therefore, */.* matches any MIME type.)
131
132              The MIME types you give to the attachments directive are a  kind
133              of pattern. When you use the attachments directive, the patterns
134              you specify are added to a list. When you use unattachments, the
135              pattern  is removed from the list. The patterns are not expanded
136              and matched to specific MIME types at this time -  they're  just
137              text  in a list. They're only matched when actually evaluating a
138              message.
139
140       auto_view type[/subtype] [ ... ]
141       unauto_view type[/subtype] [ ... ]
142
143              This commands permits you to specify that mutt should  automati‐
144              cally convert the given MIME types to text/plain when displaying
145              messages.  For this to work, there must be  a  mailcap(5)  entry
146              for the given MIME type with the copiousoutput flag set.  A sub‐
147              type of “*” matches any subtype, as does an empty subtype.
148
149       mime_lookup type[/subtype] [ ... ]
150       unmime_lookup type[/subtype] [ ... ]
151
152              This command permits you to define a list of "data" MIME content
153              types  for which mutt will try to determine the actual file type
154              from the file name, and not use a mailcap(5) entry given for the
155              original  MIME  type.   For  instance,  you may add the applica‐
156              tion/octet-stream MIME type to this list.
157
158       bind map1,map2,... key function
159              This command binds the given key for the given map  or  maps  to
160              the given function. Multiple maps may be specified by separating
161              them with commas (no whitespace is allowed).
162
163              Valid maps are: generic, alias, attach, browser, editor,  index,
164              compose, pager, pgp, postpone, mix.
165
166              For  more  information on keys and functions, please consult the
167              Mutt Manual. Note that the function  name  is  to  be  specified
168              without angle brackets.
169
170       account-hook [!]regexp command
171              This hook is executed whenever you access a remote mailbox. Use‐
172              ful to adjust configuration settings to different  IMAP  or  POP
173              servers.
174
175       charset-hook alias charset
176              This command defines an alias for a character set.  This is use‐
177              ful to properly display messages which are tagged with a charac‐
178              ter set name not known to mutt.
179
180       iconv-hook charset local-charset
181              This command defines a system-specific name for a character set.
182              This is useful when your system's iconv(3)  implementation  does
183              not  understand  MIME  character set names (such as iso-8859-1),
184              but instead insists on being  fed  with  implementation-specific
185              character  set  names  (such as 8859-1).  In this specific case,
186              you'd put this into your configuration file:
187
188              iconv-hook iso-8859-1 8859-1
189
190       message-hook [!]pattern command
191              Before mutt displays (or formats for replying or  forwarding)  a
192              message which matches the given pattern (or, when it is preceded
193              by an exclamation mark, does not match the pattern),  the  given
194              command  is  executed.   When multiple message-hooks match, they
195              are  executed  in  the order in which they occur in the configu‐
196              ration file.
197
198       folder-hook [!]regexp command
199              When  mutt enters a folder which matches regexp (or, when regexp
200              is preceded by an exclamation mark, does not match regexp),  the
201              given command is executed.
202
203              When  several  folder-hooks  match a given mail folder, they are
204              executed in the order given in the configuration file.
205
206       macro map key sequence [ description ]
207              This command binds the given sequence of keys to the  given  key
208              in  the given map or maps.  For valid maps, see bind. To specify
209              multiple maps, put only a comma between the maps.
210
211       color object [ attribute ... ] foreground background [ regexp ]
212       color index [ attribute ... ] foreground background [ pattern ]
213       color compose composeobject [ attribute ... ] foreground background
214       uncolor index pattern [ pattern ... ]
215
216              If your terminal supports color, these commands can be  used  to
217              assign  foreground/background  combinations  to certain objects.
218              Valid objects are: attachment, body, bold, error, header, hdrde‐
219              fault,  index,  indicator,  markers,  message,  normal,  prompt,
220              quoted, quotedN, search, signature, status, tilde, tree,  under‐
221              line.   If the sidebar is enabled the following objects are also
222              valid:  sidebar_divider,   sidebar_flagged,   sidebar_highlight,
223              sidebar_indicator, sidebar_new, sidebar_spoolfile.  The body and
224              header objects allow you to restrict the colorization to a regu‐
225              lar  expression.  The index object permits you to select colored
226              messages by pattern.
227
228              Valid composeobjects  include  header,  security_encrypt,  secu‐
229              rity_sign, security_both, security_none.
230
231              Valid  colors include: white, black, green, magenta, blue, cyan,
232              yellow, red, default, colorN.
233
234              Valid attributes include: none, bold,  underline,  reverse,  and
235              standout.
236
237       mono object attribute [ regexp ]
238       mono index attribute [ pattern ]
239
240              For  terminals  which  don't support color, you can still assign
241              attributes to objects.
242
243       [un]ignore pattern [ pattern ... ]
244              The ignore command permits you to specify  header  fields  which
245              you  usually  don't wish to see.  Any header field whose tag be‐
246              gins with an “ignored” pattern will be ignored.
247
248              The unignore command permits you to define exceptions  from  the
249              above mentioned list of ignored headers.
250
251       lists [-group name] regexp [ regexp ... ]
252       unlists regexp [ regexp ... ]
253       subscribe [-group name] regexp [ regexp ... ]
254       unsubscribe regexp [ regexp ... ]
255
256              Mutt  maintains  two  lists  of mailing list address patterns, a
257              list of subscribed mailing lists, and a list  of  known  mailing
258              lists.   All  subscribed  mailing lists are known.  Patterns use
259              regular expressions.
260
261              The lists command adds a mailing list address  to  the  list  of
262              known mailing lists.  The unlists command removes a mailing list
263              from the lists of known and subscribed mailing lists.  The  sub‐
264              scribe  command  adds  a  mailing list to the lists of known and
265              subscribed mailing lists.  The unsubscribe  command  removes  it
266              from  the list of subscribed mailing lists. The -group flag adds
267              all of the subsequent regular expressions to the named group.
268
269       mbox-hook [!]regexp mailbox
270              When mutt changes to a mail folder which matches regexp, mailbox
271              will  be  used as the “mbox” folder, i.e., read messages will be
272              moved to that folder when the mail folder is left.
273
274              The first matching mbox-hook applies.
275
276       mailboxes [[-notify | -nonotify]
277                  [-poll | -nopoll]
278                  [[-label label] | -nolabel]
279                  filename] [ ... ]
280       unmailboxes [ * | filename ... ]
281
282              The mailboxes specifies folders which can receive mail and which
283              will be checked for new messages.  When changing folders, press‐
284              ing space will cycle through folders with new mail.  The unmail‐
285              boxes  command  is  used  to remove a file name from the list of
286              folders which can receive mail.  If "*" is specified as the file
287              name, the list is emptied.
288
289       my_hdr string
290       unmy_hdr field
291
292              Using  my_hdr, you can define headers which will be added to the
293              messages you compose.  unmy_hdr will remove the  given  user-de‐
294              fined headers.
295
296       hdr_order header1 header2 [ ... ]
297              With  this  command, you can specify an order in which mutt will
298              attempt to present headers to you when viewing messages.
299
300       save-hook [!]pattern filename
301              When a message matches pattern, the default file name when  sav‐
302              ing it will be the given filename.
303
304       fcc-hook [!]pattern filename
305              When  an outgoing message matches pattern, the default file name
306              for storing a copy (fcc) will be the given filename.
307
308       fcc-save-hook [!]pattern filename
309              This command is an abbreviation for identical fcc-hook and save-
310              hook commands.
311
312       send-hook [!]pattern command
313              When  composing a message matching pattern, command is executed.
314              When multiple send-hooks match, they are executed in  the  order
315              in which they occur in the configuration file.
316
317       send2-hook [!]pattern command
318              Whenever  a message matching pattern is changed (either by edit‐
319              ing it or by using the compose menu), command is executed.  When
320              multiple  send2-hooks  match,  they are executed in the order in
321              which they occur in the configuration file.   Possible  applica‐
322              tions  include  setting  the $sendmail variable when a message's
323              from header is changed.
324
325              send2-hook execution is not triggered by  use  of  enter-command
326              from the compose menu.
327
328       reply-hook [!]pattern command
329              When  replying  to  a  message matching pattern, command is exe‐
330              cuted.  When multiple reply-hooks match, they  are  executed  in
331              the order in which they occur in the configuration file, but all
332              reply-hooks are matched and executed before send-hooks,  regard‐
333              less of their order in the configuration file.
334
335       crypt-hook regexp key-id
336              The  crypt-hook command provides a method by which you can spec‐
337              ify the ID of the public key to be used when encrypting messages
338              to  a certain recipient.  The meaning of "key ID" is to be taken
339              broadly: This can be a different e-mail address, a numerical key
340              ID, or even just an arbitrary search string.  You may use multi‐
341              ple crypt-hooks with the same regexp; multiple  matching  crypt-
342              hooks result in the use of multiple key-ids for a recipient.
343
344       index-format-hook name [!]pattern format-string
345              This  command  is used to inject format strings dynamically into
346              $index_format based on pattern matching against the current mes‐
347              sage.
348
349              The  $index_format  expando  %@name@ specifies a placeholder for
350              the injection. Index-format-hooks with the same name are matched
351              using  pattern  against the current message. Matching is done in
352              the order specified in the .muttrc, with the first  match  being
353              used.  The  hook's  format-string is then substituted and evalu‐
354              ated.
355
356       open-hook regexp "command"
357       close-hook regexp "command"
358       append-hook regexp "command"
359
360              These commands provide a way to handle compressed  folders.  The
361              given  regexp  specifies  which  folders are taken as compressed
362              (e.g.  "\\.gz$"). The commands tell Mutt  how  to  uncompress  a
363              folder  (open-hook),  compress a folder (close-hook) or append a
364              compressed mail to a compressed folder (append-hook).  The  com‐
365              mand  string  is the printf(3) like format string, and it should
366              accept two parameters: %f, which  is  replaced  with  the  (com‐
367              pressed)  folder name, and %t which is replaced with the name of
368              the temporary folder to which to write.
369
370       push string
371       exec function [ ... ]
372
373              push adds the named string to the keyboard buffer.  “exec  func‐
374              tion” is equivalent to “push <function>”.
375
376       run MuttLisp
377
378              The  run  command evaluates the MuttLisp argument. The output of
379              the MuttLisp is then executed as a Mutt command, as if  it  were
380              typed in the muttrc instead.
381
382       score pattern value
383       unscore [ * | pattern ... ]
384
385              The  score  commands  adds value to a message's score if pattern
386              matches it.  The unscore command removes score entries from  the
387              list.
388
389       set [no|inv|&|?]variable[=value] [ ... ]
390       toggle variable [ ... ]
391       unset variable [ ... ]
392       reset variable [ ... ]
393
394              These  commands  are  used  to  set and manipulate configuration
395              variables.
396
397              Mutt knows four  basic  types  of  variables:  boolean,  number,
398              string and quadoption.  Boolean variables can be set (true), un‐
399              set (false), or toggled. Number variables can be assigned a pos‐
400              itive integer value.
401
402              String  variables consist of any number of printable characters.
403              Strings must be enclosed in quotes if  they  contain  spaces  or
404              tabs.   You  may also use the “C” escape sequences \n and \t for
405              newline and tab, respectively.
406
407              Quadoption variables are used to control whether or  not  to  be
408              prompted for certain actions, or to specify a default action.  A
409              value of yes will cause the action to be carried  out  automati‐
410              cally  as if you had answered yes to the question.  Similarly, a
411              value of no will cause the action to be carried out  as  if  you
412              had answered “no.” A value of ask-yes will cause a prompt with a
413              default answer of “yes” and ask-no will provide a default answer
414              of “no.”
415
416              The reset command resets all given variables to the compile time
417              defaults.  If you reset the special variable all, all  variables
418              will reset to their compile time defaults.
419
420       setenv [?]variable [ value ]
421       unsetenv variable
422
423              These  alter  the  environment  that Mutt passes on to its child
424              processes.  You can also query  current  environment  values  by
425              prefixing a “?” character.
426
427       sidebar_whitelist mailbox [ mailbox ...]
428       unsidebar_whitelist [ * | mailbox ... ]
429
430              sidebar_whitelist  specifies  mailboxes that will always be dis‐
431              played in the sidebar, even if $sidebar_new_mail_only is set and
432              the mailbox does not contain new mail.
433
434              unsidebar_whitelist is used to remove a mailbox from the list of
435              whitelisted mailboxes. Use unsidebar_whitelist * to  remove  all
436              mailboxes.
437
438       source filename
439              The given file will be evaluated as a configuration file.
440
441       spam pattern format
442       nospam pattern
443
444              These commands define spam-detection patterns from external spam
445              filters, so that mutt can sort,  limit,  and  search  on  ``spam
446              tags'' or ``spam attributes'', or display them in the index. See
447              the Mutt manual for details.
448
449       subjectrx pattern replacement
450       unsubjectrx [ * | pattern ]
451
452              subjectrx specifies a regular expression pattern which,  if  de‐
453              tected  in  a message subject, causes the subject to be replaced
454              with the replacement value. The replacement is subject  to  sub‐
455              stitutions  in  the same way as for the spam command: %L for the
456              text to the left of the match, %R for text to the right  of  the
457              match,  and %1 for the first subgroup in the match (etc). If you
458              simply want to erase the match, set it to “%L%R”. Any number  of
459              subjectrx commands may coexist.
460
461              Note  this  well: the replacement value replaces the entire sub‐
462              ject, not just the match!
463
464              unsubjectrx removes a  given  subjectrx  from  the  substitution
465              list. If * is used as the pattern, all substitutions will be re‐
466              moved.
467
468       unhook [ *  | hook-type ]
469              This command will remove all hooks of a given type, or all hooks
470              when  “*”  is  used as an argument.  hook-type can be any of the
471              -hook commands documented above.
472
473       mailto_allow header-field [ ... ]
474       unmailto_allow [ * | header-field ... ]
475
476              These commands allow the user to  modify  the  list  of  allowed
477              header fields in a mailto: URL that Mutt will include in the the
478              generated message.  By default the list  contains  only  subject
479              and body, as specified by RFC2368.
480
481       echo message
482              Prints  message  to  the message window. After printing the mes‐
483              sage, echo will pause for the number  of  seconds  specified  by
484              $sleep_time.
485
486       cd directory
487              Changes the current working directory.
488

PATTERNS

490       In various places with mutt, including some of the above mentioned hook
491       commands, you can specify patterns to match messages.
492
493   Constructing Patterns
494       A simple pattern consists of a modifier of the form “~character”,  pos‐
495       sibly  followed  by a parameter against which mutt is supposed to match
496       the object specified by this modifier.  For some characters, the ~  may
497       be  replaced  by  another character to alter the behavior of the match.
498       These are described in the list of modifiers, below.
499
500       With some of these modifiers, the object to be matched consists of sev‐
501       eral  e-mail  addresses.   In  these cases, the object is matched if at
502       least one of these e-mail addresses matches.  You  can  prepend  a  hat
503       (“^”)  character  to such a pattern to indicate that all addresses must
504       match in order to match the object.
505
506       You can construct complex patterns by combining  simple  patterns  with
507       logical  operators.   Logical  AND is specified by simply concatenating
508       two simple patterns, for instance “~C mutt-dev ~s bug”.  Logical OR  is
509       specified  by  inserting a vertical bar (“|”) between two patterns, for
510       instance “~C mutt-dev | ~s bug”.  Additionally, you can negate  a  pat‐
511       tern  by  prepending a bang (“!”) character.  For logical grouping, use
512       braces (“()”). Example: “!(~t mutt|~c mutt) ~f elkins”.
513
514   Simple Patterns
515       Mutt understands the following simple patterns:
516
517       ~A          all messages
518       ~b EXPR     messages which contain EXPR in the message body.
519       =b STRING   If IMAP is enabled, like ~b but searches for STRING on  the
520                   server,  rather than downloading each message and searching
521                   it locally.
522       ~B EXPR     messages which contain EXPR in the whole message.
523       =B STRING   If IMAP is enabled, like ~B but searches for STRING on  the
524                   server,  rather than downloading each message and searching
525                   it locally.
526       ~c EXPR     messages carbon-copied to EXPR
527       %c GROUP    messages carbon-copied to any member of GROUP
528       ~C EXPR     messages either to: or cc: EXPR
529       %C GROUP    messages either to: or cc: to any member of GROUP
530       ~d MIN-MAX  messages with “date-sent” in a Date range
531       ~D          deleted messages
532       ~e EXPR     messages which contain EXPR in the “Sender” field
533       %e GROUP    messages which contain a member of GROUP  in  the  “Sender”
534                   field
535       ~E          expired messages
536       ~f EXPR     messages originating from EXPR
537       %f GROUP    messages originating from any member of GROUP
538       ~F          flagged messages
539       ~g          PGP signed messages
540       ~G          PGP encrypted messages
541       ~h EXPR     messages which contain EXPR in the message header
542       =h STRING   If  IMAP is enabled, like ~h but searches for STRING on the
543                   server, rather than downloading each message and  searching
544                   it locally.  STRING must be of the form “header: substring”
545       ~H EXPR     messages with spam tags matching EXPR
546       ~i EXPR     messages which match EXPR in the “Message-ID” field
547       ~k          messages containing PGP key material
548       ~l          messages  addressed to a known mailing list (defined by ei‐
549                   ther subscribe or list)
550       ~L EXPR     messages either originated or received by EXPR
551       %L GROUP    messages either originated or received  by  any  member  of
552                   GROUP
553       ~m MIN-MAX  message in the range MIN to MAX
554       ~M EXPR     messages which contain a mime Content-Type matching EXPR
555       ~n MIN-MAX  messages with a score in the range MIN to MAX
556       ~N          new messages
557       ~O          old messages
558       ~p          messages  addressed to you (consults $from, alternates, and
559                   local account/hostname information)
560       ~P          messages from you (consults $from,  alternates,  and  local
561                   account/hostname information)
562       ~Q          messages which have been replied to
563       ~r MIN-MAX  messages with “date-received” in a Date range
564       ~R          read messages
565       ~s EXPR     messages having EXPR in the “Subject” field.
566       ~S          superseded messages
567       ~t EXPR     messages addressed to EXPR
568       ~T          tagged messages
569       ~u          messages addressed to a subscribed mailing list (defined by
570                   subscribe commands)
571       ~U          unread messages
572       ~v          message is part of a collapsed thread.
573       ~V          cryptographically verified messages
574       ~x EXPR     messages which contain EXPR in the “References” or  “In-Re‐
575                   ply-To” field
576       ~X MIN-MAX  messages with MIN - MAX attachments
577       ~y EXPR     messages which contain EXPR in the “X-Label” field
578       ~z MIN-MAX  messages with a size in the range MIN to MAX
579       ~=          duplicated messages (see $duplicate_threads)
580       ~$          unreferenced message (requires threaded view)
581       ~(PATTERN)  messages  in threads containing messages matching a certain
582                   pattern, e.g. all threads  containing  messages  from  you:
583                   ~(~P)
584       ~<(PATTERN) messages  whose  immediate  parent  matches  PATTERN,  e.g.
585                   replies to your messages: ~<(~P)
586       ~>(PATTERN) messages having an immediate child matching  PATTERN,  e.g.
587                   messages you replied to: ~>(~P)
588
589       In the above, EXPR is a regular expression.
590
591       With  the  ~d,  ~m,  ~n, ~r, ~X, and ~z modifiers, you can also specify
592       ranges in the forms <MAX, >MIN, MIN-, and -MAX.
593
594       With the ~z modifier, the suffixes “K” and “M” are allowed  to  specify
595       kilobyte and megabyte respectively.
596
597       The  ~b,  ~B, ~h, ~M, and ~X modifiers require reading each message in,
598       which can be much slower.
599
600       You can force Mutt to treat EXPR as a simple string instead of a  regu‐
601       lar expression by using = instead of ~ in the pattern name.
602
603   Matching dates
604       The ~d and ~r modifiers are used to match date ranges, which are inter‐
605       preted to be given in your local time zone.
606
607       A date is of the form DD[/MM[/[cc]YY]], that is, a two-digit date,  op‐
608       tionally  followed  by a two-digit month, optionally followed by a year
609       specifications.  Omitted fields default to the current month and year.
610
611       Mutt understands either two or four digit  year  specifications.   When
612       given  a two-digit year, mutt will interpret values less than 70 as ly‐
613       ing in the 21st century (i.e., “38” means 2038 and not 1938,  and  “00”
614       is  interpreted as 2000), and values greater than or equal to 70 as ly‐
615       ing in the 20th century.
616
617       Note that this behavior is Y2K compliant, but that  mutt  does  have  a
618       Y2.07K problem.
619
620       Alternatively, you may use YYYYMMDD to specify a date.
621
622       If  a  date  range  consists of a single date, the modifier in question
623       will match that precise date.  If the date range  consists  of  a  dash
624       (“-”), followed by a date, this range will match any date before and up
625       to the date given.  Similarly, a date followed by a  dash  matches  the
626       date  given  and  any  later  point of time.  Two dates, separated by a
627       dash, match any date which lies in the given range of time.
628
629       You can also modify any absolute date by giving an error range.  An er‐
630       ror range consists of one of the characters +, -, *, followed by a pos‐
631       itive number, followed by one of the unit characters y,  m,  w,  or  d,
632       specifying  a  unit  of years, months, weeks, or days.  + increases the
633       maximum date matched by the given interval of  time,  -  decreases  the
634       minimum date matched by the given interval of time, and * increases the
635       maximum date and decreases the minimum date matched by the given inter‐
636       val  of time.  It is possible to give multiple error margins, which cu‐
637       mulate.  Example: 1/1/2001-1w+2w*3d
638
639       You can also specify offsets relative to the current date.   An  offset
640       is  specified  as one of the characters <, >, =, followed by a positive
641       number, followed by one of the unit characters y, m, w, d, H, M, or  S.
642       >  matches  dates which are older than the specified amount of time, an
643       offset which begins with the character < matches dates which  are  more
644       recent  than  the  specified amount of time, and an offset which begins
645       with the character = matches points of time  which  are  precisely  the
646       given amount of time ago.
647

CONFIGURATION VARIABLES

649       abort_noattach
650              Type: quadoption
651              Default: no
652
653              When  the body of the message matches $abort_noattach_regexp and
654              there are no attachments, this quadoption  controls  whether  to
655              abort sending the message.
656
657
658
659       abort_noattach_regexp
660              Type: regular expression
661              Default: “attach”
662
663              Specifies  a regular expression to match against the body of the
664              message, to determine if an attachment was mentioned but mistak‐
665              enly  forgotten.   If  it  matches, $abort_noattach will be con‐
666              sulted to determine if message sending will be aborted.
667
668              Like other regular expressions in Mutt, the search is case  sen‐
669              sitive  if  the pattern contains at least one upper case letter,
670              and case insensitive otherwise.
671
672
673
674       abort_nosubject
675              Type: quadoption
676              Default: ask-yes
677
678              If set to yes, when composing messages and no subject  is  given
679              at  the  subject prompt, composition will be aborted.  If set to
680              no, composing messages with no  subject  given  at  the  subject
681              prompt will never be aborted.
682
683
684
685       abort_unmodified
686              Type: quadoption
687              Default: yes
688
689              If  set to yes, composition will automatically abort after edit‐
690              ing the message body if no changes are made to  the  file  (this
691              check  only happens after the first edit of the file).  When set
692              to no, composition will never be aborted.
693
694
695
696       alias_file
697              Type: path
698              Default: “~/.muttrc”
699
700              The default file in which to save aliases created by  the  <cre‐
701              ate-alias>  function.  Entries added to this file are encoded in
702              the character set specified by $config_charset if it is  set  or
703              the current character set otherwise.
704
705              Note: Mutt will not automatically source this file; you must ex‐
706              plicitly use the “source” command for it to be executed in  case
707              this option points to a dedicated alias file.
708
709              The  default  for this option is the currently used muttrc file,
710              or “~/.muttrc” if no user muttrc was found.
711
712
713
714       alias_format
715              Type: string
716              Default: “%4n %2f %t %-10a   %r”
717
718              Specifies the format of the data displayed for the “alias” menu.
719              The following printf(3)-style sequences are available:
720              %a     alias name
721              %f     flags - currently, a “d” for an alias marked for deletion
722              %n     index number
723              %r     address which alias expands to
724              %t     character  which indicates if the alias is tagged for in‐
725                     clusion
726
727
728       allow_8bit
729              Type: boolean
730              Default: yes
731
732              Controls whether 8-bit data is converted to 7-bit  using  either
733              Quoted- Printable or Base64 encoding when sending mail.
734
735
736
737       allow_ansi
738              Type: boolean
739              Default: no
740
741              Controls whether ANSI color codes in messages (and color tags in
742              rich text messages) are to be interpreted.  Messages  containing
743              these codes are rare, but if this option is set, their text will
744              be colored accordingly. Note that this may override  your  color
745              choices,  and  even  present a security problem, since a message
746              could include a line like
747
748
749              [-- PGP output follows ...
750
751
752              and give it the same color as your attachment  color  (see  also
753              $crypt_timestamp).
754
755
756
757       arrow_cursor
758              Type: boolean
759              Default: no
760
761              When  set,  an arrow (“->”) will be used to indicate the current
762              entry in menus instead of highlighting the whole line.  On  slow
763              network  or  modem  links this will make response faster because
764              there is less that has to be redrawn on the screen  when  moving
765              to the next or previous entries in the menu.
766
767
768
769       ascii_chars
770              Type: boolean
771              Default: no
772
773              If  set,  Mutt  will  use plain ASCII characters when displaying
774              thread and attachment trees, instead of the default ACS  charac‐
775              ters.
776
777
778
779       askbcc
780              Type: boolean
781              Default: no
782
783              If set, Mutt will prompt you for blind-carbon-copy (Bcc) recipi‐
784              ents before editing an outgoing message.
785
786
787
788       askcc
789              Type: boolean
790              Default: no
791
792              If set, Mutt will prompt you for carbon-copy (Cc) recipients be‐
793              fore editing the body of an outgoing message.
794
795
796
797       assumed_charset
798              Type: string
799              Default: “”
800
801              This  variable  is  a colon-separated list of character encoding
802              schemes for  messages  without  character  encoding  indication.
803              Header  field  values and message body content without character
804              encoding indication would be assumed that they  are  written  in
805              one of this list.  By default, all the header fields and message
806              body without  any  charset  indication  are  assumed  to  be  in
807              “us-ascii”.
808
809              For example, Japanese users might prefer this:
810
811
812              set assumed_charset=”iso-2022-jp:euc-jp:shift_jis:utf-8”
813
814
815              However, only the first content is valid for the message body.
816
817
818
819       attach_charset
820              Type: string
821              Default: “”
822
823              This  variable  is  a colon-separated list of character encoding
824              schemes for text file attachments. Mutt  uses  this  setting  to
825              guess which encoding files being attached are encoded in to con‐
826              vert them to a proper character set given in $send_charset.
827
828              If unset, the value of $charset will be used instead.  For exam‐
829              ple,  the  following  configuration would work for Japanese text
830              handling:
831
832
833              set attach_charset=”iso-2022-jp:euc-jp:shift_jis:utf-8”
834
835
836              Note: for Japanese users, “iso-2022-*” must be put at  the  head
837              of the value as shown above if included.
838
839
840
841       attach_format
842              Type: string
843              Default: “%u%D%I %t%4n %T%.40d%> [%.7m/%.10M, %.6e%?C?, %C?, %s] ”
844
845              This  variable  describes  the  format of the “attachment” menu.
846              The following printf(3)-style sequences are understood:
847              %C     charset
848              %c     requires charset conversion (“n” or “c”)
849              %D     deleted flag
850              %d     description (if none, falls back to %F)
851              %e     MIME content-transfer-encoding
852              %F     filename in content-disposition header  (if  none,  falls
853                     back to %f)
854              %f     filename
855              %I     disposition (“I” for inline, “A” for attachment)
856              %m     major MIME type
857              %M     MIME subtype
858              %n     attachment number
859              %Q     “Q”, if MIME part qualifies for attachment counting
860              %s     size (see formatstrings-size)
861              %t     tagged flag
862              %T     graphic tree characters
863              %u     unlink (=to delete) flag
864              %X     number  of  qualifying  MIME  parts  in this part and its
865                     children (please see the “attachments” section for possi‐
866                     ble speed effects)
867              %>X    right justify the rest of the string and pad with charac‐
868                     ter “X”
869              %|X    pad to the end of the line with character “X”
870              %*X    soft-fill with character “X” as pad
871
872              For an explanation of “soft-fill”, see the  $index_format  docu‐
873              mentation.
874
875
876
877       attach_save_dir
878              Type: path
879              Default: “”
880
881              The  default directory to save attachments from the “attachment”
882              menu.  If it doesn't exist, Mutt will prompt to create  the  di‐
883              rectory before saving.
884
885              If  the  path  is  invalid  (e.g.  not a directory, or cannot be
886              chdir'ed to), Mutt will fall back to using  the  current  direc‐
887              tory.
888
889
890
891       attach_sep
892              Type: string
893              Default: “\n”
894
895              The separator to add between attachments when operating (saving,
896              printing, piping, etc) on a list of tagged attachments.
897
898
899
900       attach_split
901              Type: boolean
902              Default: yes
903
904              If this variable is unset,  when  operating  (saving,  printing,
905              piping, etc) on a list of tagged attachments, Mutt will concate‐
906              nate the attachments and will operate on them as  a  single  at‐
907              tachment.  The $attach_sep separator is added after each attach‐
908              ment. When set, Mutt will operate on the attachments one by one.
909
910
911
912       attribution
913              Type: string (localized)
914              Default: “On %d, %n wrote:”
915
916              This is the string that will precede a message  which  has  been
917              included   in   a   reply.    For  a  full  listing  of  defined
918              printf(3)-like sequences see the section on $index_format.
919
920
921
922       attribution_locale
923              Type: string
924              Default: “”
925
926              The locale used by strftime(3) to format dates in  the  attribu‐
927              tion  string.   Legal values are the strings your system accepts
928              for the locale environment variable $LC_TIME.
929
930              This variable is to allow the attribution date format to be cus‐
931              tomized  by  recipient  or folder using hooks.  By default, Mutt
932              will use your locale environment, so there is  no  need  to  set
933              this except to override that default.
934
935
936
937       auto_subscribe
938              Type: boolean
939              Default: no
940
941              When  set, Mutt assumes the presence of a List-Post header means
942              the recipient is subscribed to the  list.   Unless  the  mailing
943              list is in the “unsubscribe” or “unlist” lists, it will be added
944              to the “subscribe” list.   Parsing  and  checking  these  things
945              slows  header  reading  down,  so this option is disabled by de‐
946              fault.
947
948
949
950       auto_tag
951              Type: boolean
952              Default: no
953
954              When set, functions in the index menu  which  affect  a  message
955              will be applied to all tagged messages (if there are any).  When
956              unset, you must first use the <tag-prefix>  function  (bound  to
957              “;”  by  default)  to make the next function apply to all tagged
958              messages.
959
960
961
962       autocrypt
963              Type: boolean
964              Default: no
965
966              When set, enables autocrypt, which provides  passive  encryption
967              protection  with keys exchanged via headers.  See “autocryptdoc”
968              for more details.  (Autocrypt only)
969
970
971
972       autocrypt_acct_format
973              Type: string
974              Default: “%4n %-30a %20p %10s”
975
976              This variable describes the format of  the  “autocrypt  account”
977              menu.  The following printf(3)-style sequences are understood
978              %a     email address
979              %k     gpg keyid
980              %n     current entry number
981              %p     prefer-encrypt flag
982              %s     status flag (active/inactive)
983
984              (Autocrypt only)
985
986
987
988       autocrypt_dir
989              Type: path
990              Default: “~/.mutt/autocrypt”
991
992              This  variable  sets where autocrypt files are stored, including
993              the GPG keyring and sqlite  database.   See  “autocryptdoc”  for
994              more details.  (Autocrypt only)
995
996
997
998       autocrypt_reply
999              Type: boolean
1000              Default: yes
1001
1002              When  set,  replying to an autocrypt email automatically enables
1003              autocrypt in the reply.  You may want to unset  this  if  you're
1004              using the same key for autocrypt as normal web-of-trust, so that
1005              autocrypt isn't forced on for all encrypted replies.  (Autocrypt
1006              only)
1007
1008
1009
1010       autoedit
1011              Type: boolean
1012              Default: no
1013
1014              When  set  along  with $edit_headers, Mutt will skip the initial
1015              send-menu (prompting for subject and recipients) and  allow  you
1016              to  immediately  begin  editing  the  body of your message.  The
1017              send-menu may still be accessed once you have  finished  editing
1018              the body of your message.
1019
1020              Note:  when  this  option is set, you cannot use send-hooks that
1021              depend on the recipients when composing a new  (non-reply)  mes‐
1022              sage, as the initial list of recipients is empty.
1023
1024              Also see $fast_reply.
1025
1026
1027
1028       background_edit
1029              Type: boolean
1030              Default: no
1031
1032              When set, Mutt will run $editor in the background during message
1033              composition.  A landing page will display, waiting for the $edi‐
1034              tor  to  exit.  The landing page may be exited, allowing perusal
1035              of the mailbox, or even  for  other  messages  to  be  composed.
1036              Backgrounded   sessions  may  be  returned  to  via  the  <back‐
1037              ground-compose-menu> function.
1038
1039              For background editing to work properly, $editor must be set  to
1040              an  editor that does not try to use the Mutt terminal: for exam‐
1041              ple a graphical editor, or a script launching (and waiting  for)
1042              the editor in another Gnu Screen window.
1043
1044              For more details, see “bgedit” (”Background Editing” in the man‐
1045              ual).
1046
1047
1048
1049       background_confirm_quit
1050              Type: boolean
1051              Default: yes
1052
1053              When set, if there are any background edit sessions, you will be
1054              prompted  to  confirm  exiting  Mutt,  in  addition to the $quit
1055              prompt.
1056
1057
1058
1059       background_format
1060              Type: string
1061              Default: “%10S %7p %s”
1062
1063              This variable describes the format of the  “background  compose”
1064              menu.  The following printf(3)-style sequences are understood:
1065              %i     parent message id (for replies and forwarded messages)
1066              %n     the running number on the menu
1067              %p     pid of the $editor process
1068              %r     comma separated list of “To:” recipients
1069              %R     comma separated list of “Cc:” recipients
1070              %s     subject of the message
1071              %S     status of the $editor process: running/finished
1072
1073
1074       beep
1075              Type: boolean
1076              Default: yes
1077
1078              When this variable is set, mutt will beep when an error occurs.
1079
1080
1081
1082       beep_new
1083              Type: boolean
1084              Default: no
1085
1086              When  this  variable is set, mutt will beep whenever it prints a
1087              message notifying you of new mail.  This is independent  of  the
1088              setting of the $beep variable.
1089
1090
1091
1092       bounce
1093              Type: quadoption
1094              Default: ask-yes
1095
1096              Controls whether you will be asked to confirm bouncing messages.
1097              If set to yes you don't get asked if you want to bounce  a  mes‐
1098              sage.  Setting  this variable to no is not generally useful, and
1099              thus not recommended, because you are unable to bounce messages.
1100
1101
1102
1103       bounce_delivered
1104              Type: boolean
1105              Default: yes
1106
1107              When this variable is set, mutt will include Delivered-To  head‐
1108              ers  when  bouncing  messages.   Postfix users may wish to unset
1109              this variable.
1110
1111
1112
1113       braille_friendly
1114              Type: boolean
1115              Default: no
1116
1117              When this variable is set, mutt will place the cursor at the be‐
1118              ginning  of the current line in menus, even when the $arrow_cur‐
1119              sor variable is unset, making it easier for blind persons  using
1120              Braille  displays to follow these menus.  The option is unset by
1121              default because many visual terminals don't  permit  making  the
1122              cursor invisible.
1123
1124
1125
1126       browser_abbreviate_mailboxes
1127              Type: boolean
1128              Default: yes
1129
1130              When this variable is set, mutt will abbreviate mailbox names in
1131              the browser mailbox list, using '~' and '=' shortcuts.
1132
1133              The default ”alpha” setting of $sort_browser  uses  locale-based
1134              sorting  (using  strcoll(3)),  which  ignores  some punctuation.
1135              This can lead to some situations where the  order  doesn't  make
1136              intuitive  sense.   In those cases, it may be desirable to unset
1137              this variable.
1138
1139
1140
1141       browser_sticky_cursor
1142              Type: boolean
1143              Default: yes
1144
1145              When this variable is set, the browser will attempt to keep  the
1146              cursor  on  the  same mailbox when performing various functions.
1147              These include moving up a directory, toggling between  mailboxes
1148              and  directory  listing,  creating/renaming  a mailbox, toggling
1149              subscribed mailboxes, and entering a new mask.
1150
1151
1152
1153       certificate_file
1154              Type: path
1155              Default: “~/.mutt_certificates”
1156
1157              This variable specifies the  file  where  the  certificates  you
1158              trust are saved. When an unknown certificate is encountered, you
1159              are asked if you accept it or not. If you accept  it,  the  cer‐
1160              tificate  can also be saved in this file and further connections
1161              are automatically accepted.
1162
1163              You can also manually add CA  certificates  in  this  file.  Any
1164              server  certificate that is signed with one of these CA certifi‐
1165              cates is also automatically accepted.
1166
1167              Example:
1168
1169
1170              set certificate_file=~/.mutt/certificates
1171
1172
1173
1174
1175       change_folder_next
1176              Type: boolean
1177              Default: no
1178
1179              When this variable is set, the <change-folder> function  mailbox
1180              suggestion  will  start  at  the next folder in your “mailboxes”
1181              list, instead of starting at the first folder in the list.
1182
1183
1184
1185       charset
1186              Type: string
1187              Default: “”
1188
1189              Character set your terminal uses to display  and  enter  textual
1190              data.  It is also the fallback for $send_charset.
1191
1192              Upon  startup  Mutt  tries to derive this value from environment
1193              variables such as $LC_CTYPE or $LANG.
1194
1195              Note: It should only be set in case Mutt isn't able to determine
1196              the character set used correctly.
1197
1198
1199
1200       check_mbox_size
1201              Type: boolean
1202              Default: no
1203
1204              When this variable is set, mutt will use file size attribute in‐
1205              stead of access time when checking for new mail in mbox and mmdf
1206              folders.
1207
1208              This  variable  is  unset  by default and should only be enabled
1209              when new mail detection for these folder types is unreliable  or
1210              doesn't work.
1211
1212              Note that enabling this variable should happen before any “mail‐
1213              boxes” directives occur in configuration files regarding mbox or
1214              mmdf  folders  because  mutt  needs to determine the initial new
1215              mail status of such a mailbox by performing a fast mailbox  scan
1216              when  it  is defined.  Afterwards the new mail status is tracked
1217              by file size changes.
1218
1219
1220
1221       check_new
1222              Type: boolean
1223              Default: yes
1224
1225              Note: this option only affects maildir and MH style mailboxes.
1226
1227              When set, Mutt will check for new mail delivered while the mail‐
1228              box  is  open.  Especially with MH mailboxes, this operation can
1229              take quite some time since it involves  scanning  the  directory
1230              and  checking each file to see if it has already been looked at.
1231              If this variable is unset, no check for new  mail  is  performed
1232              while the mailbox is open.
1233
1234
1235
1236       collapse_unread
1237              Type: boolean
1238              Default: yes
1239
1240              When  unset,  Mutt will not collapse a thread if it contains any
1241              unread messages.
1242
1243
1244
1245       compose_format
1246              Type: string (localized)
1247              Default: “-- Mutt: Compose  [Approx. msg size: %l   Atts: %a]%>-”
1248
1249              Controls the format of the status line displayed  in  the  “com‐
1250              pose”  menu.   This string is similar to $status_format, but has
1251              its own set of printf(3)-like sequences:
1252              %a     total number of attachments
1253              %h     local hostname
1254              %l     approximate size (in bytes) of the current  message  (see
1255                     formatstrings-size)
1256              %v     Mutt version string
1257
1258              See  the  text describing the $status_format option for more in‐
1259              formation on how to set $compose_format.
1260
1261
1262
1263       config_charset
1264              Type: string
1265              Default: “”
1266
1267              When defined, Mutt will recode commands in rc  files  from  this
1268              encoding  to  the current character set as specified by $charset
1269              and aliases written to $alias_file from  the  current  character
1270              set.
1271
1272              Please note that if setting $charset it must be done before set‐
1273              ting $config_charset.
1274
1275              Recoding should be avoided as it may render unconvertable  char‐
1276              acters  as  question  marks which can lead to undesired side ef‐
1277              fects (for example in regular expressions).
1278
1279
1280
1281       confirmappend
1282              Type: boolean
1283              Default: yes
1284
1285              When set, Mutt will prompt for confirmation when appending  mes‐
1286              sages to an existing mailbox.
1287
1288
1289
1290       confirmcreate
1291              Type: boolean
1292              Default: yes
1293
1294              When set, Mutt will prompt for confirmation when saving messages
1295              to a mailbox which does not yet exist before creating it.
1296
1297
1298
1299       connect_timeout
1300              Type: number
1301              Default: 30
1302
1303              Causes Mutt to timeout a network connection (for  IMAP,  POP  or
1304              SMTP)  after  this many seconds if the connection is not able to
1305              be established.  A negative value causes Mutt  to  wait  indefi‐
1306              nitely for the connection attempt to succeed.
1307
1308
1309
1310       content_type
1311              Type: string
1312              Default: “text/plain”
1313
1314              Sets  the  default  Content-Type  for the body of newly composed
1315              messages.
1316
1317
1318
1319       copy
1320              Type: quadoption
1321              Default: yes
1322
1323              This variable controls whether or not copies  of  your  outgoing
1324              messages  will be saved for later references.  Also see $record,
1325              $save_name, $force_name and “fcc-hook”.
1326
1327
1328
1329       copy_decode_weed
1330              Type: boolean
1331              Default: no
1332
1333              Controls whether Mutt will weed headers when invoking  the  <de‐
1334              code-copy> or <decode-save> functions.
1335
1336
1337
1338       count_alternatives
1339              Type: boolean
1340              Default: no
1341
1342              When  set, Mutt will recurse inside multipart/alternatives while
1343              performing attachment searching and counting (see attachments).
1344
1345              Traditionally, multipart/alternative parts  have  simply  repre‐
1346              sented  different  encodings  of  the main content of the email.
1347              Unfortunately, some mail clients have started to place email at‐
1348              tachments  inside  one of alternatives.  Setting this will allow
1349              Mutt to find and count matching attachments  hidden  there,  and
1350              include them in the index via %X or through ~X pattern matching.
1351
1352
1353
1354       cursor_overlay
1355              Type: boolean
1356              Default: no
1357
1358              When  set,  Mutt will overlay the indicator, tree, sidebar_high‐
1359              light, and sidebar_indicator colors onto the currently  selected
1360              line.  This will allow default colors in those to be overridden,
1361              and for attributes to be merged between the layers.
1362
1363
1364
1365       crypt_autoencrypt
1366              Type: boolean
1367              Default: no
1368
1369              Setting this variable will cause Mutt to always attempt  to  PGP
1370              encrypt outgoing messages.  This is probably only useful in con‐
1371              nection to the “send-hook” command.  It can be overridden by use
1372              of  the  pgp menu, when encryption is not required or signing is
1373              requested as well.  If $smime_is_default is set, then OpenSSL is
1374              used instead to create S/MIME messages and settings can be over‐
1375              ridden by use of the smime menu instead.  (Crypto only)
1376
1377
1378
1379       crypt_autopgp
1380              Type: boolean
1381              Default: yes
1382
1383              This variable controls whether or not mutt may automatically en‐
1384              able  PGP  encryption/signing for messages.  See also $crypt_au‐
1385              toencrypt,  $crypt_replyencrypt,   $crypt_autosign,   $crypt_re‐
1386              plysign and $smime_is_default.
1387
1388
1389
1390       crypt_autosign
1391              Type: boolean
1392              Default: no
1393
1394              Setting this variable will cause Mutt to always attempt to cryp‐
1395              tographically sign outgoing messages.  This can be overridden by
1396              use  of the pgp menu, when signing is not required or encryption
1397              is requested as well. If $smime_is_default is set, then  OpenSSL
1398              is  used  instead  to create S/MIME messages and settings can be
1399              overridden by use of the smime menu instead  of  the  pgp  menu.
1400              (Crypto only)
1401
1402
1403
1404       crypt_autosmime
1405              Type: boolean
1406              Default: yes
1407
1408              This variable controls whether or not mutt may automatically en‐
1409              able S/MIME encryption/signing for messages. See also $crypt_au‐
1410              toencrypt,   $crypt_replyencrypt,   $crypt_autosign,  $crypt_re‐
1411              plysign and $smime_is_default.
1412
1413
1414
1415       crypt_confirmhook
1416              Type: boolean
1417              Default: yes
1418
1419              If set, then you will be prompted for confirmation of keys  when
1420              using  the  crypt-hook  command.  If unset, no such confirmation
1421              prompt will be presented.  This is generally considered  unsafe,
1422              especially where typos are concerned.
1423
1424
1425
1426       crypt_opportunistic_encrypt
1427              Type: boolean
1428              Default: no
1429
1430              Setting  this  variable  will cause Mutt to automatically enable
1431              and disable encryption, based on whether all  message  recipient
1432              keys can be located by Mutt.
1433
1434              When this option is enabled, Mutt will enable/disable encryption
1435              each time the TO, CC, and BCC lists are edited.  If  $edit_head‐
1436              ers  is  set,  Mutt  will  also  do  so each time the message is
1437              edited.
1438
1439              While this is set, encryption  can't  be  manually  enabled/dis‐
1440              abled.   The pgp or smime menus provide a selection to temporar‐
1441              ily disable this option for the current message.
1442
1443              If $crypt_autoencrypt or $crypt_replyencrypt  enable  encryption
1444              for  a  message,  this option will be disabled for that message.
1445              It can be  manually  re-enabled  in  the  pgp  or  smime  menus.
1446              (Crypto only)
1447
1448
1449
1450       crypt_opportunistic_encrypt_strong_keys
1451              Type: boolean
1452              Default: no
1453
1454              When set, this modifies the behavior of $crypt_opportunistic_en‐
1455              crypt to only search for ”strong keys”, that is, keys with  full
1456              validity  according  to  the web-of-trust algorithm.  A key with
1457              marginal or no validity will not  enable  opportunistic  encryp‐
1458              tion.
1459
1460              For S/MIME, the behavior depends on the backend.  Classic S/MIME
1461              will filter for certificates with the 't' (trusted) flag in  the
1462              .index  file.   The  GPGME  backend will use the same filters as
1463              with OpenPGP, and depends on GPGME's  logic  for  assigning  the
1464              GPGME_VALIDITY_FULL and GPGME_VALIDITY_ULTIMATE validity flag.
1465
1466
1467
1468       crypt_protected_headers_read
1469              Type: boolean
1470              Default: yes
1471
1472              When  set, Mutt will display protected headers in the pager, and
1473              will update the index and header  cache  with  revised  headers.
1474              Protected headers are stored inside the encrypted or signed part
1475              of an an email, to prevent disclosure or  tampering.   For  more
1476              information  see https://github.com/autocrypt/protected-headers.
1477              Currently Mutt only supports the Subject header.
1478
1479              Encrypted messages using protected headers often substitute  the
1480              exposed  Subject  header  with  a  dummy  value (see $crypt_pro‐
1481              tected_headers_subject).  Mutt will update its  concept  of  the
1482              correct  subject after the message is opened, i.e. via the <dis‐
1483              play-message> function.  If you reply to a message before  open‐
1484              ing  it,  Mutt will end up using the dummy Subject header, so be
1485              sure to open such a message first.  (Crypto only)
1486
1487
1488
1489       crypt_protected_headers_save
1490              Type: boolean
1491              Default: no
1492
1493              When $crypt_protected_headers_read is set, and a message with  a
1494              protected  Subject is opened, Mutt will save the updated Subject
1495              into the header cache by default.  This allows  searching/limit‐
1496              ing  based  on  the  protected  Subject header if the mailbox is
1497              re-opened, without having to  re-open  the  message  each  time.
1498              However,  for mbox/mh mailbox types, or if header caching is not
1499              set up, you would need to re-open  the  message  each  time  the
1500              mailbox was reopened before you could see or search/limit on the
1501              protected subject again.
1502
1503              When this variable is set, Mutt additionally saves the protected
1504              Subject  back  in the clear-text message headers.  This provides
1505              better usability, but with the  tradeoff  of  reduced  security.
1506              The protected Subject header, which may have previously been en‐
1507              crypted, is now stored in clear-text  in  the  message  headers.
1508              Copying the message elsewhere, via Mutt or external tools, could
1509              expose this previously encrypted data.  Please make sure you un‐
1510              derstand  the  consequences of this before you enable this vari‐
1511              able.  (Crypto only)
1512
1513
1514
1515       crypt_protected_headers_subject
1516              Type: string
1517              Default: “...”
1518
1519              When $crypt_protected_headers_write is set, and the  message  is
1520              marked for encryption, this will be substituted into the Subject
1521              field in the message headers.  To prevent a subject  from  being
1522              substituted, unset this variable, or set it to the empty string.
1523              (Crypto only)
1524
1525
1526
1527       crypt_protected_headers_write
1528              Type: boolean
1529              Default: no
1530
1531              When set, Mutt will generate protected headers  for  signed  and
1532              encrypted  emails.   Protected headers are stored inside the en‐
1533              crypted or signed part of an an email, to prevent disclosure  or
1534              tampering.   For  more  information  see  https://github.com/au
1535              tocrypt/protected-headers.  Currently  Mutt  only  supports  the
1536              Subject header.  (Crypto only)
1537
1538
1539
1540       crypt_replyencrypt
1541              Type: boolean
1542              Default: yes
1543
1544              If set, automatically PGP or OpenSSL encrypt replies to messages
1545              which are encrypted.  (Crypto only)
1546
1547
1548
1549       crypt_replysign
1550              Type: boolean
1551              Default: no
1552
1553              If set, automatically PGP or OpenSSL sign  replies  to  messages
1554              which are signed.
1555
1556              Note:  this  does  not  work  on messages that are encrypted and
1557              signed!  (Crypto only)
1558
1559
1560
1561       crypt_replysignencrypted
1562              Type: boolean
1563              Default: no
1564
1565              If set, automatically PGP or OpenSSL sign  replies  to  messages
1566              which  are  encrypted.  This  makes  sense  in  combination with
1567              $crypt_replyencrypt, because it allows you to sign all  messages
1568              which  are automatically encrypted.  This works around the prob‐
1569              lem noted in $crypt_replysign, that mutt is not able to find out
1570              whether an encrypted message is also signed.  (Crypto only)
1571
1572
1573
1574       crypt_timestamp
1575              Type: boolean
1576              Default: yes
1577
1578              If  set, mutt will include a time stamp in the lines surrounding
1579              PGP or S/MIME output, so spoofing such lines is more  difficult.
1580              If  you are using colors to mark these lines, and rely on these,
1581              you may unset this setting.  (Crypto only)
1582
1583
1584
1585       crypt_use_gpgme
1586              Type: boolean
1587              Default: no
1588
1589              This variable controls the use of the GPGME-enabled crypto back‐
1590              ends.   If  it is set and Mutt was built with gpgme support, the
1591              gpgme code for S/MIME and PGP will be used instead of the  clas‐
1592              sic  code.  Note that you need to set this option in .muttrc; it
1593              won't have any effect when used interactively.
1594
1595              Note that the GPGME backend does not support creating  old-style
1596              inline  (traditional)  PGP  encrypted  or  signed  messages (see
1597              $pgp_autoinline).
1598
1599
1600
1601       crypt_use_pka
1602              Type: boolean
1603              Default: no
1604
1605              Controls      whether       mutt       uses       PKA       (see
1606              http://www.g10code.de/docs/pka-intro.de.pdf)   during  signature
1607              verification (only supported by the GPGME backend).
1608
1609
1610
1611       crypt_verify_sig
1612              Type: quadoption
1613              Default: yes
1614
1615              If “yes”, always attempt to verify PGP or S/MIME signatures.  If
1616              “ask-*”,  ask  whether or not to verify the signature.  If “no”,
1617              never attempt to verify cryptographic signatures.  (Crypto only)
1618
1619
1620
1621       date_format
1622              Type: string
1623              Default: “!%a, %b %d, %Y at %I:%M:%S%p %Z”
1624
1625              This variable controls the format of the  date  printed  by  the
1626              “%d”  sequence  in  $index_format.   This is passed to the strf‐
1627              time(3) function to process the date, see the man page  for  the
1628              proper syntax.
1629
1630              Unless  the  first  character in the string is a bang (“!”), the
1631              month and week day names are expanded according to  the  locale.
1632              If the first character in the string is a bang, the bang is dis‐
1633              carded, and the month and week day names  in  the  rest  of  the
1634              string are expanded in the C locale (that is in US English).
1635
1636
1637
1638       default_hook
1639              Type: string
1640              Default: “~f %s !~P | (~P ~C %s)”
1641
1642              This  variable controls how “message-hook”, “reply-hook”, “send-
1643              hook”, “send2-hook”, “save-hook”, and “fcc-hook” will be  inter‐
1644              preted  if they are specified with only a simple regexp, instead
1645              of a matching pattern.  The hooks are expanded when they are de‐
1646              clared,  so a hook will be interpreted according to the value of
1647              this variable at the time the hook is declared.
1648
1649              The default value matches if the message is either from  a  user
1650              matching  the regular expression given, or if it is from you (if
1651              the from address matches “alternates”) and is to or cc'ed  to  a
1652              user matching the given regular expression.
1653
1654
1655
1656       delete
1657              Type: quadoption
1658              Default: ask-yes
1659
1660              Controls whether or not messages are really deleted when closing
1661              or synchronizing a mailbox.  If set to yes, messages marked  for
1662              deleting will automatically be purged without prompting.  If set
1663              to no, messages marked for deletion will be kept in the mailbox.
1664
1665
1666
1667       delete_untag
1668              Type: boolean
1669              Default: yes
1670
1671              If this option is set, mutt will  untag  messages  when  marking
1672              them  for  deletion.   This  applies  when you either explicitly
1673              delete a message, or when you save it to another folder.
1674
1675
1676
1677       digest_collapse
1678              Type: boolean
1679              Default: yes
1680
1681              If this option is set, mutt's received-attachments menu will not
1682              show  the subparts of individual messages in a multipart/digest.
1683              To see these subparts, press “v” on that menu.
1684
1685
1686
1687       display_filter
1688              Type: path
1689              Default: “”
1690
1691              When set, specifies a command used to filter messages.   When  a
1692              message  is  viewed  it  is  passed  as  standard input to $dis‐
1693              play_filter, and the filtered message is read from the  standard
1694              output.
1695
1696
1697
1698       dotlock_program
1699              Type: path
1700              Default: “/usr/bin/mutt_dotlock”
1701
1702              Contains  the  path  of the mutt_dotlock(1) binary to be used by
1703              mutt.
1704
1705
1706
1707       dsn_notify
1708              Type: string
1709              Default: “”
1710
1711              This variable sets the request  for  when  notification  is  re‐
1712              turned.   The string consists of a comma separated list (no spa‐
1713              ces!) of one or more of the following: never, to  never  request
1714              notification,  failure,  to request notification on transmission
1715              failure, delay, to be notified of message delays, success, to be
1716              notified of successful transmission.
1717
1718              Example:
1719
1720
1721              set dsn_notify=”failure,delay”
1722
1723
1724              Note:  when  using $sendmail for delivery, you should not enable
1725              this unless you are either using Sendmail 8.8.x or greater or  a
1726              MTA  providing a sendmail(1)-compatible interface supporting the
1727              -N option for DSN. For SMTP delivery, DSN  support  is  auto-de‐
1728              tected so that it depends on the server whether DSN will be used
1729              or not.
1730
1731
1732
1733       dsn_return
1734              Type: string
1735              Default: “”
1736
1737              This variable controls how much of your message is  returned  in
1738              DSN  messages.   It may be set to either hdrs to return just the
1739              message header, or full to return the full message.
1740
1741              Example:
1742
1743
1744              set dsn_return=hdrs
1745
1746
1747              Note: when using $sendmail for delivery, you should  not  enable
1748              this  unless you are either using Sendmail 8.8.x or greater or a
1749              MTA providing a sendmail(1)-compatible interface supporting  the
1750              -R  option  for  DSN. For SMTP delivery, DSN support is auto-de‐
1751              tected so that it depends on the server whether DSN will be used
1752              or not.
1753
1754
1755
1756       duplicate_threads
1757              Type: boolean
1758              Default: yes
1759
1760              This  variable  controls  whether  mutt,  when  $sort  is set to
1761              threads, threads messages with the same Message-Id together.  If
1762              it  is  set, it will indicate that it thinks they are duplicates
1763              of each other with an equals sign in the thread tree.
1764
1765
1766
1767       edit_headers
1768              Type: boolean
1769              Default: no
1770
1771              This option allows you to edit the header of your outgoing  mes‐
1772              sages along with the body of your message.
1773
1774              Although  the compose menu may have localized header labels, the
1775              labels passed to your editor will be standard RFC 2822  headers,
1776              (e.g.  To:,  Cc:,  Subject:).  Headers added in your editor must
1777              also be RFC 2822 headers, or one of the pseudo headers listed in
1778              “edit-header”.   Mutt  will  not understand localized header la‐
1779              bels, just as it would not when parsing an actual email.
1780
1781              Note that changes made to the References: and Date: headers  are
1782              ignored for interoperability reasons.
1783
1784
1785
1786       editor
1787              Type: path
1788              Default: “”
1789
1790              This  variable  specifies  which editor is used by mutt.  It de‐
1791              faults to the value of  the  $VISUAL,  or  $EDITOR,  environment
1792              variable, or to the string “vi” if neither of those are set.
1793
1794              The  $editor  string  may contain a %s escape, which will be re‐
1795              placed by the name of the file to be edited.  If the  %s  escape
1796              does  not  appear  in $editor, a space and the name to be edited
1797              are appended.
1798
1799              The resulting string is then executed by running
1800
1801
1802              sh -c 'string'
1803
1804
1805              where string is the expansion of $editor described above.
1806
1807
1808
1809       encode_from
1810              Type: boolean
1811              Default: no
1812
1813              When set, mutt will quoted-printable encode messages  when  they
1814              contain  the string “From ” (note the trailing space) in the be‐
1815              ginning of a line.  This is useful to avoid the  tampering  cer‐
1816              tain mail delivery and transport agents tend to do with messages
1817              (in order to prevent tools from misinterpreting the  line  as  a
1818              mbox message separator).
1819
1820
1821
1822       entropy_file
1823              Type: path
1824              Default: “”
1825
1826              The  file  which includes random data that is used to initialize
1827              SSL library functions.
1828
1829
1830
1831       envelope_from_address
1832              Type: e-mail address
1833              Default: “”
1834
1835              Manually sets the envelope sender for outgoing  messages.   This
1836              value is ignored if $use_envelope_from is unset.
1837
1838
1839
1840       error_history
1841              Type: number
1842              Default: 30
1843
1844              This  variable  controls  the  size (in number of strings remem‐
1845              bered) of the error messages displayed by mutt.   These  can  be
1846              shown with the <error-history> function.  The history is cleared
1847              each time this variable is set.
1848
1849
1850
1851       escape
1852              Type: string
1853              Default: “~”
1854
1855              Escape character to use for functions in the built-in editor.
1856
1857
1858
1859       fast_reply
1860              Type: boolean
1861              Default: no
1862
1863              When set, the initial prompt  for  recipients  and  subject  are
1864              skipped  when  replying  to messages, and the initial prompt for
1865              subject is skipped when forwarding messages.
1866
1867              Note: this variable has no effect when the $autoedit variable is
1868              set.
1869
1870
1871
1872       fcc_attach
1873              Type: quadoption
1874              Default: yes
1875
1876              This  variable  controls  whether or not attachments on outgoing
1877              messages are saved along with the main body of your message.
1878
1879              Note: $fcc_before_send forces the default (set) behavior of this
1880              option.
1881
1882
1883
1884       fcc_before_send
1885              Type: boolean
1886              Default: no
1887
1888              When  this  variable  is set, FCCs will occur before sending the
1889              message.  Before sending, the message cannot be manipulated,  so
1890              it  will  be  stored  the  exact  same  as sent: $fcc_attach and
1891              $fcc_clear will be ignored (using their default values).
1892
1893              When unset, the default, FCCs will occur after  sending.   Vari‐
1894              ables  $fcc_attach and $fcc_clear will be respected, allowing it
1895              to be stored without attachments or  encryption/signing  if  de‐
1896              sired.
1897
1898
1899
1900       fcc_clear
1901              Type: boolean
1902              Default: no
1903
1904              When  this  variable is set, FCCs will be stored unencrypted and
1905              unsigned, even when  the  actual  message  is  encrypted  and/or
1906              signed.
1907
1908              Note:  $fcc_before_send  forces  the default (unset) behavior of
1909              this option.  (PGP only)
1910
1911              See also $pgp_self_encrypt, $smime_self_encrypt.
1912
1913
1914
1915       fcc_delimiter
1916              Type: string
1917              Default: “”
1918
1919              When specified, this allows the ability to Fcc to more than  one
1920              mailbox.  The fcc value will be split by this delimiter and Mutt
1921              will evaluate each part as a mailbox separately.
1922
1923              See $record, “fcc-hook”, and “fcc-save-hook”.
1924
1925
1926
1927       flag_safe
1928              Type: boolean
1929              Default: no
1930
1931              If set, flagged messages cannot be deleted.
1932
1933
1934
1935       folder
1936              Type: path
1937              Default: “~/Mail”
1938
1939              Specifies the default location of your mailboxes.  A “+” or  “=”
1940              at  the beginning of a pathname will be expanded to the value of
1941              this variable.  Note that if you change this variable (from  the
1942              default)  value you need to make sure that the assignment occurs
1943              before you use “+” or “=” for any other variables  since  expan‐
1944              sion takes place when handling the “mailboxes” command.
1945
1946
1947
1948       folder_format
1949              Type: string
1950              Default: “%2C %t %N %F %2l %-8.8u %-8.8g %8s %d %f”
1951
1952              This  variable  allows you to customize the file browser display
1953              to your personal taste.  This string is similar  to  $index_for‐
1954              mat, but has its own set of printf(3)-like sequences:
1955              %C     current file number
1956              %d     date/time folder was last modified
1957              %D     date/time folder was last modified using $date_format.
1958              %f     filename (“/” is appended to directory names, “@” to sym‐
1959                     bolic links and “*” to executable files)
1960              %F     file permissions
1961              %g     group name (or numeric gid, if missing)
1962              %l     number of hard links
1963              %m     number of messages in the mailbox *
1964              %n     number of unread messages in the mailbox *
1965              %N     N if mailbox has new mail, blank otherwise
1966              %s     size in bytes (see formatstrings-size)
1967              %t     “*” if the file is tagged, blank otherwise
1968              %u     owner name (or numeric uid, if missing)
1969              %>X    right justify the rest of the string and pad with charac‐
1970                     ter “X”
1971              %|X    pad to the end of the line with character “X”
1972              %*X    soft-fill with character “X” as pad
1973
1974              For  an  explanation of “soft-fill”, see the $index_format docu‐
1975              mentation.
1976
1977              * = can be optionally printed if nonzero
1978
1979              %m, %n, and %N only work for monitored mailboxes.   %m  requires
1980              $mail_check_stats  to  be set.  %n requires $mail_check_stats to
1981              be set (except for IMAP mailboxes).
1982
1983
1984
1985       followup_to
1986              Type: boolean
1987              Default: yes
1988
1989              Controls whether or not the “Mail-Followup-To:” header field  is
1990              generated  when sending mail.  When set, Mutt will generate this
1991              field when you are replying to a known mailing  list,  specified
1992              with the “subscribe” or “lists” commands.
1993
1994              This field has two purposes.  First, preventing you from receiv‐
1995              ing duplicate copies of replies to messages which  you  send  to
1996              mailing lists, and second, ensuring that you do get a reply sep‐
1997              arately for any messages sent to known lists to  which  you  are
1998              not subscribed.
1999
2000              The  header  will contain only the list's address for subscribed
2001              lists, and both the list address and your own email address  for
2002              unsubscribed  lists.  Without this header, a group reply to your
2003              message sent to a subscribed list will be sent to both the  list
2004              and  your address, resulting in two copies of the same email for
2005              you.
2006
2007
2008
2009       force_name
2010              Type: boolean
2011              Default: no
2012
2013              This variable is similar to $save_name, except  that  Mutt  will
2014              store a copy of your outgoing message by the username of the ad‐
2015              dress you are sending to even if that mailbox does not exist.
2016
2017              Also see the $record variable.
2018
2019
2020
2021       forward_attachments
2022              Type: quadoption
2023              Default: ask-yes
2024
2025              When forwarding inline (i.e.  $mime_forward  unset  or  answered
2026              with  “no” and $forward_decode set), attachments which cannot be
2027              decoded in a reasonable manner will be  attached  to  the  newly
2028              composed  message  if  this  quadoption  is set or answered with
2029              “yes”.
2030
2031
2032
2033       forward_attribution_intro
2034              Type: string (localized)
2035              Default: “----- Forwarded message from %f -----”
2036
2037              This is the string that will precede a message  which  has  been
2038              forwarded  in  the main body of a message (when $mime_forward is
2039              unset).  For a full listing of defined printf(3)-like  sequences
2040              see the section on $index_format.  See also $attribution_locale.
2041
2042
2043
2044       forward_attribution_trailer
2045              Type: string (localized)
2046              Default: “----- End forwarded message -----”
2047
2048              This  is  the  string  that will follow a message which has been
2049              forwarded in the main body of a message (when  $mime_forward  is
2050              unset).   For a full listing of defined printf(3)-like sequences
2051              see the section on $index_format.  See also $attribution_locale.
2052
2053
2054
2055       forward_decode
2056              Type: boolean
2057              Default: yes
2058
2059              Controls the decoding of complex MIME messages  into  text/plain
2060              when  forwarding  a message.  The message header is also RFC2047
2061              decoded.  This variable is only used, if $mime_forward is unset,
2062              otherwise $mime_forward_decode is used instead.
2063
2064
2065
2066       forward_decrypt
2067              Type: quadoption
2068              Default: yes
2069
2070              This quadoption controls the handling of encrypted messages when
2071              forwarding or attaching a message.   When  set  to  or  answered
2072              “yes”, the outer layer of encryption is stripped off.
2073
2074              This  variable  is  used  if $mime_forward is set and $mime_for‐
2075              ward_decode is unset.  It is also used when attaching a  message
2076              via <attach-message> in the compose menu.  (PGP only)
2077
2078
2079
2080       forward_edit
2081              Type: quadoption
2082              Default: yes
2083
2084              This  quadoption  controls  whether or not the user is automati‐
2085              cally placed in the editor when forwarding messages.  For  those
2086              who  always  want to forward with no modification, use a setting
2087              of “no”.
2088
2089
2090
2091       forward_format
2092              Type: string
2093              Default: “[%a: %s]”
2094
2095              This variable controls the default  subject  when  forwarding  a
2096              message.  It uses the same format sequences as the $index_format
2097              variable.
2098
2099
2100
2101       forward_quote
2102              Type: boolean
2103              Default: no
2104
2105              When set, forwarded messages included in the main  body  of  the
2106              message  (when $mime_forward is unset) will be quoted using $in‐
2107              dent_string.
2108
2109
2110
2111       from
2112              Type: e-mail address
2113              Default: “”
2114
2115              When set, this variable contains a default from address.  It can
2116              be  overridden using “my_hdr” (including from a “send-hook”) and
2117              $reverse_name.  This variable is ignored if $use_from is unset.
2118
2119              This setting defaults to the contents of the  environment  vari‐
2120              able $EMAIL.
2121
2122
2123
2124       gecos_mask
2125              Type: regular expression
2126              Default: “^[^,]*”
2127
2128              A  regular expression used by mutt to parse the GECOS field of a
2129              password entry when expanding the alias.  The default value will
2130              return the string up to the first “,” encountered.  If the GECOS
2131              field contains a string  like  “lastname,  firstname”  then  you
2132              should set it to “.*”.
2133
2134              This  can  be  useful if you see the following behavior: you ad‐
2135              dress an e-mail to user ID “stevef” whose full  name  is  “Steve
2136              Franklin”.     If   mutt   expands   “stevef”   to   “”Franklin”
2137              stevef@foo.bar” then you should set the $gecos_mask to a regular
2138              expression  that  will  match the whole name so mutt will expand
2139              “Franklin” to “Franklin, Steve”.
2140
2141
2142
2143       hdrs
2144              Type: boolean
2145              Default: yes
2146
2147              When unset, the header fields normally  added  by  the  “my_hdr”
2148              command  are  not  created.   This variable must be unset before
2149              composing a new message or replying in order to take effect.  If
2150              set,  the user defined header fields are added to every new mes‐
2151              sage.
2152
2153
2154
2155       header
2156              Type: boolean
2157              Default: no
2158
2159              When set, this variable causes Mutt to include the header of the
2160              message  you  are  replying  to into the edit buffer.  The $weed
2161              setting applies.
2162
2163
2164
2165       header_cache
2166              Type: path
2167              Default: “”
2168
2169              This variable points to the header cache database.  If  pointing
2170              to  a  directory  Mutt will contain a header cache database file
2171              per folder, if pointing to a file that file  will  be  a  single
2172              global header cache. By default it is unset so no header caching
2173              will be used.
2174
2175              Header caching can greatly improve speed when opening POP,  IMAP
2176              MH or Maildir folders, see “caching” for details.
2177
2178
2179
2180       header_cache_compress
2181              Type: boolean
2182              Default: yes
2183
2184              When  mutt  is compiled with qdbm, tokyocabinet, or kyotocabinet
2185              as header cache backend,  this  option  determines  whether  the
2186              database  will  be  compressed.  Compression results in database
2187              files roughly being one fifth of the usual  diskspace,  but  the
2188              decompression can result in a slower opening of cached folder(s)
2189              which in general is still much faster than  opening  non  header
2190              cached folders.
2191
2192
2193
2194       header_cache_pagesize
2195              Type: number (long)
2196              Default: 16384
2197
2198              When  mutt  is  compiled  with either gdbm or bdb4 as the header
2199              cache backend, this option changes the database page size.   Too
2200              large  or too small values can waste space, memory, or CPU time.
2201              The default should be more or less optimal for most use cases.
2202
2203
2204
2205       header_color_partial
2206              Type: boolean
2207              Default: no
2208
2209              When set, color header regexps behave like color  body  regexps:
2210              color  is applied to the exact text matched by the regexp.  When
2211              unset, color is applied to the entire header.
2212
2213              One use of this option might be  to  apply  color  to  just  the
2214              header labels.
2215
2216              See “color” for more details.
2217
2218
2219
2220       help
2221              Type: boolean
2222              Default: yes
2223
2224              When set, help lines describing the bindings for the major func‐
2225              tions provided by each menu are displayed on the first  line  of
2226              the screen.
2227
2228              Note:  The  binding will not be displayed correctly if the func‐
2229              tion is bound to a sequence  rather  than  a  single  keystroke.
2230              Also,  the  help line may not be updated if a binding is changed
2231              while Mutt is running.  Since this variable is  primarily  aimed
2232              at new users, neither of these should present a major problem.
2233
2234
2235
2236       hidden_host
2237              Type: boolean
2238              Default: no
2239
2240              When  set,  mutt will skip the host name part of $hostname vari‐
2241              able when adding the domain part to  addresses.   This  variable
2242              does  not  affect the generation of Message-IDs, and it will not
2243              lead to the cut-off of first-level domains.
2244
2245
2246
2247       hide_limited
2248              Type: boolean
2249              Default: no
2250
2251              When set, mutt will not show the presence of messages  that  are
2252              hidden by limiting, in the thread tree.
2253
2254
2255
2256       hide_missing
2257              Type: boolean
2258              Default: yes
2259
2260              When set, mutt will not show the presence of missing messages in
2261              the thread tree.
2262
2263
2264
2265       hide_thread_subject
2266              Type: boolean
2267              Default: yes
2268
2269              When set, mutt will not show the  subject  of  messages  in  the
2270              thread  tree that have the same subject as their parent or clos‐
2271              est previously displayed sibling.
2272
2273
2274
2275       hide_top_limited
2276              Type: boolean
2277              Default: no
2278
2279              When set, mutt will not show the presence of messages  that  are
2280              hidden  by  limiting,  at the top of threads in the thread tree.
2281              Note that when $hide_limited is set, this option  will  have  no
2282              effect.
2283
2284
2285
2286       hide_top_missing
2287              Type: boolean
2288              Default: yes
2289
2290              When set, mutt will not show the presence of missing messages at
2291              the  top  of  threads  in  the  thread  tree.   Note  that  when
2292              $hide_missing is set, this option will have no effect.
2293
2294
2295
2296       history
2297              Type: number
2298              Default: 10
2299
2300              This  variable  controls  the  size (in number of strings remem‐
2301              bered) of the string history buffer per category. The buffer  is
2302              cleared each time the variable is set.
2303
2304
2305
2306       history_file
2307              Type: path
2308              Default: “~/.mutthistory”
2309
2310              The file in which Mutt will save its history.
2311
2312              Also see $save_history.
2313
2314
2315
2316       history_remove_dups
2317              Type: boolean
2318              Default: no
2319
2320              When  set,  all of the string history will be scanned for dupli‐
2321              cates when a new entry is added.  Duplicate entries in the $his‐
2322              tory_file  will  also  be  removed  when it is periodically com‐
2323              pacted.
2324
2325
2326
2327       honor_disposition
2328              Type: boolean
2329              Default: no
2330
2331              When set, Mutt will not display attachments with  a  disposition
2332              of “attachment” inline even if it could render the part to plain
2333              text. These MIME parts can only be viewed  from  the  attachment
2334              menu.
2335
2336              If unset, Mutt will render all MIME parts it can properly trans‐
2337              form to plain text.
2338
2339
2340
2341       honor_followup_to
2342              Type: quadoption
2343              Default: yes
2344
2345              This variable controls whether or not a Mail-Followup-To  header
2346              is honored when group-replying to a message.
2347
2348
2349
2350       hostname
2351              Type: string
2352              Default: “”
2353
2354              Specifies  the  fully-qualified  hostname  of the system mutt is
2355              running on containing the host's name and the DNS domain it  be‐
2356              longs  to.  It  is used as the domain part (after “@”) for local
2357              email addresses as well as Message-Id headers.
2358
2359              Its value is determined at startup as follows: the node's  host‐
2360              name  is  first determined by the uname(3) function.  The domain
2361              is then looked up using the  gethostname(2)  and  getaddrinfo(3)
2362              functions.   If  those calls are unable to determine the domain,
2363              the full value returned by uname is used.  Optionally, Mutt  can
2364              be  compiled  with  a fixed domain name in which case a detected
2365              one is not used.
2366
2367              Starting in Mutt 2.0, the operations described in  the  previous
2368              paragraph  are  performed after the muttrc is processed, instead
2369              of beforehand.  This way, if the DNS operations are creating de‐
2370              lays  at  startup,  you  can avoid those by manually setting the
2371              value in your muttrc.
2372
2373              Also see $use_domain and $hidden_host.
2374
2375
2376
2377       idn_decode
2378              Type: boolean
2379              Default: yes
2380
2381              When set, Mutt will show you international domain names decoded.
2382              Note:  You  can  use  IDNs  for addresses even if this is unset.
2383              This variable only affects decoding. (IDN only)
2384
2385
2386
2387       idn_encode
2388              Type: boolean
2389              Default: yes
2390
2391              When set, Mutt will encode international domain names using IDN.
2392              Unset this if your SMTP server can handle newer (RFC 6531) UTF-8
2393              encoded domains. (IDN only)
2394
2395
2396
2397       ignore_linear_white_space
2398              Type: boolean
2399              Default: no
2400
2401              This option replaces linear-white-space between encoded-word and
2402              text  to  a  single space to prevent the display of MIME-encoded
2403              “Subject:” field from being divided into multiple lines.
2404
2405
2406
2407       ignore_list_reply_to
2408              Type: boolean
2409              Default: no
2410
2411              Affects the behavior of the <reply> function  when  replying  to
2412              messages  from  mailing  lists (as defined by the “subscribe” or
2413              “lists” commands).  When set, if the “Reply-To:” field is set to
2414              the  same  value  as the “To:” field, Mutt assumes that the “Re‐
2415              ply-To:” field was set by the mailing list to automate responses
2416              to  the  list, and will ignore this field.  To direct a response
2417              to the mailing list when this option is set, use  the  <list-re‐
2418              ply>  function;  <group-reply> will reply to both the sender and
2419              the list.
2420
2421
2422
2423       imap_authenticators
2424              Type: string
2425              Default: “”
2426
2427              This is a colon-delimited list of  authentication  methods  mutt
2428              may  attempt  to  use  to log in to an IMAP server, in the order
2429              mutt should try them.  Authentication methods are either “login”
2430              or  the right side of an IMAP “AUTH=xxx” capability string, e.g.
2431              “digest-md5”, “gssapi” or “cram-md5”. This option is case-insen‐
2432              sitive.  If it's unset (the default) mutt will try all available
2433              methods, in order from most-secure to least-secure.
2434
2435              Example:
2436
2437
2438              set imap_authenticators=”gssapi:cram-md5:login”
2439
2440
2441              Note: Mutt will only fall back to other  authentication  methods
2442              if  the  previous methods are unavailable. If a method is avail‐
2443              able but authentication fails, mutt will not connect to the IMAP
2444              server.
2445
2446
2447
2448       imap_check_subscribed
2449              Type: boolean
2450              Default: no
2451
2452              When  set,  mutt  will  fetch the set of subscribed folders from
2453              your server on connection, and add them to the set of  mailboxes
2454              it  polls  for  new  mail  just  as if you had issued individual
2455              “mailboxes” commands.
2456
2457
2458
2459       imap_condstore
2460              Type: boolean
2461              Default: no
2462
2463              When set, mutt will use the CONDSTORE extension  (RFC  7162)  if
2464              advertised  by the server.  Mutt's current implementation is ba‐
2465              sic, used only for initial message fetching and flag updates.
2466
2467              For some IMAP servers, enabling  this  will  slightly  speed  up
2468              downloading  initial  messages.  Unfortunately, Gmail is not one
2469              those,  and  displays  worse  performance  when  enabled.   Your
2470              mileage may vary.
2471
2472
2473
2474       imap_deflate
2475              Type: boolean
2476              Default: no
2477
2478              When  set,  mutt  will  use  the COMPRESS=DEFLATE extension (RFC
2479              4978) if advertised by the server.
2480
2481              In general a good compression efficiency can be achieved,  which
2482              speeds  up  reading  large mailboxes also on fairly good connec‐
2483              tions.
2484
2485
2486
2487       imap_delim_chars
2488              Type: string
2489              Default: “/.”
2490
2491              This contains the list of characters which  you  would  like  to
2492              treat as folder separators for displaying IMAP paths. In partic‐
2493              ular it helps in using the “=” shortcut for  your  folder  vari‐
2494              able.
2495
2496
2497
2498       imap_fetch_chunk_size
2499              Type: number (long)
2500              Default: 0
2501
2502              When  set  to  a value greater than 0, new headers will be down‐
2503              loaded in groups of this many headers per request.  If you  have
2504              a  very  large mailbox, this might prevent a timeout and discon‐
2505              nect when opening the mailbox, by sending a  FETCH  per  set  of
2506              this  many  headers, instead of a single FETCH for all new head‐
2507              ers.
2508
2509
2510
2511       imap_headers
2512              Type: string
2513              Default: “”
2514
2515              Mutt requests these header fields in  addition  to  the  default
2516              headers  (“Date:”, “From:”, “Sender:”, “Subject:”, “To:”, “Cc:”,
2517              “Message-Id:”, “References:”, “Content-Type:”, “Content-Descrip‐
2518              tion:”,  “In-Reply-To:”,  “Reply-To:”,  “Lines:”,  “List-Post:”,
2519              “X-Label:”) from IMAP servers before displaying the index  menu.
2520              You may want to add more headers for spam detection.
2521
2522              Note:  This is a space separated list, items should be uppercase
2523              and not contain the colon, e.g. “X-BOGOSITY  X-SPAM-STATUS”  for
2524              the “X-Bogosity:” and “X-Spam-Status:” header fields.
2525
2526
2527
2528       imap_idle
2529              Type: boolean
2530              Default: no
2531
2532              When  set,  mutt  will attempt to use the IMAP IDLE extension to
2533              check for new mail in the current mailbox. Some servers (dovecot
2534              was  the  inspiration for this option) react badly to mutt's im‐
2535              plementation. If your connection seems  to  freeze  up  periodi‐
2536              cally, try unsetting this.
2537
2538
2539
2540       imap_keepalive
2541              Type: number
2542              Default: 300
2543
2544              This  variable  specifies  the maximum amount of time in seconds
2545              that mutt will wait before polling  open  IMAP  connections,  to
2546              prevent  the  server  from closing them before mutt has finished
2547              with them. The default is well within the RFC-specified  minimum
2548              amount  of  time  (30  minutes) before a server is allowed to do
2549              this, but in practice the RFC does get violated  every  now  and
2550              then.  Reduce  this  number if you find yourself getting discon‐
2551              nected from your IMAP server due to inactivity.
2552
2553
2554
2555       imap_list_subscribed
2556              Type: boolean
2557              Default: no
2558
2559              This variable configures whether IMAP folder browsing will  look
2560              for only subscribed folders or all folders.  This can be toggled
2561              in the IMAP browser with the <toggle-subscribed> function.
2562
2563
2564
2565       imap_login
2566              Type: string
2567              Default: “”
2568
2569              Your login name on the IMAP server.
2570
2571              This variable defaults to the value of $imap_user.
2572
2573
2574
2575       imap_oauth_refresh_command
2576              Type: string
2577              Default: “”
2578
2579              The command to run to generate an OAUTH refresh token for autho‐
2580              rizing  your  connection to your IMAP server.  This command will
2581              be run on every connection attempt that uses the OAUTHBEARER au‐
2582              thentication mechanism.  See “oauth” for details.
2583
2584
2585
2586       imap_pass
2587              Type: string
2588              Default: “”
2589
2590              Specifies  the  password  for your IMAP account.  If unset, Mutt
2591              will  prompt  you  for  your  password  when  you   invoke   the
2592              <imap-fetch-mail> function or try to open an IMAP folder.
2593
2594              Warning:  you  should  only  use  this  option when you are on a
2595              fairly secure machine, because the superuser can read your  mut‐
2596              trc even if you are the only one who can read the file.
2597
2598
2599
2600       imap_passive
2601              Type: boolean
2602              Default: yes
2603
2604              When  set,  mutt will not open new IMAP connections to check for
2605              new mail.  Mutt will only check for new mail over existing  IMAP
2606              connections.   This  is  useful if you don't want to be prompted
2607              for user/password pairs on mutt invocation, or  if  opening  the
2608              connection is slow.
2609
2610
2611
2612       imap_peek
2613              Type: boolean
2614              Default: yes
2615
2616              When  set,  mutt will avoid implicitly marking your mail as read
2617              whenever you fetch a message from the server. This is  generally
2618              a  good  thing,  but  can  make  closing an IMAP folder somewhat
2619              slower. This option exists to appease speed freaks.
2620
2621
2622
2623       imap_pipeline_depth
2624              Type: number
2625              Default: 15
2626
2627              Controls the number of IMAP commands that may be queued  up  be‐
2628              fore  they are sent to the server. A deeper pipeline reduces the
2629              amount of time mutt must wait for the server, and can make  IMAP
2630              servers feel much more responsive. But not all servers correctly
2631              handle pipelined commands, so if you  have  problems  you  might
2632              want to try setting this variable to 0.
2633
2634              Note:  Changes  to  this variable have no effect on open connec‐
2635              tions.
2636
2637
2638
2639       imap_poll_timeout
2640              Type: number
2641              Default: 15
2642
2643              This variable specifies the maximum amount of  time  in  seconds
2644              that mutt will wait for a response when polling IMAP connections
2645              for new mail, before timing out and closing the connection.  Set
2646              to 0 to disable timing out.
2647
2648
2649
2650       imap_qresync
2651              Type: boolean
2652              Default: no
2653
2654              When  set, mutt will use the QRESYNC extension (RFC 7162) if ad‐
2655              vertised by the server.  Mutt's current implementation is basic,
2656              used only for initial message fetching and flag updates.
2657
2658              Note: this feature is currently experimental.  If you experience
2659              strange behavior, such as duplicate or missing  messages  please
2660              file a bug report to let us know.
2661
2662
2663
2664       imap_servernoise
2665              Type: boolean
2666              Default: yes
2667
2668              When  set,  mutt  will  display  warning  messages from the IMAP
2669              server as error messages. Since these messages are  often  harm‐
2670              less,  or  generated due to configuration problems on the server
2671              which are out of the users' hands, you may wish to suppress them
2672              at some point.
2673
2674
2675
2676       imap_user
2677              Type: string
2678              Default: “”
2679
2680              The name of the user whose mail you intend to access on the IMAP
2681              server.
2682
2683              This variable defaults to your user name on the local machine.
2684
2685
2686
2687       implicit_autoview
2688              Type: boolean
2689              Default: no
2690
2691              If set to “yes”, mutt will look for a  mailcap  entry  with  the
2692copiousoutput”  flag  set  for every MIME attachment it doesn't
2693              have an internal viewer defined for.  If such an entry is found,
2694              mutt  will  use  the viewer defined in that entry to convert the
2695              body part to text form.
2696
2697
2698
2699       include
2700              Type: quadoption
2701              Default: ask-yes
2702
2703              Controls whether or not a copy of the message(s) you are  reply‐
2704              ing to is included in your reply.
2705
2706
2707
2708       include_encrypted
2709              Type: boolean
2710              Default: no
2711
2712              Controls  whether  or not Mutt includes separately encrypted at‐
2713              tachment contents when replying.
2714
2715              This variable was added to prevent accidental  exposure  of  en‐
2716              crypted  contents when replying to an attacker.  If a previously
2717              encrypted message were attached  by  the  attacker,  they  could
2718              trick an unwary recipient into decrypting and including the mes‐
2719              sage in their reply.
2720
2721
2722
2723       include_onlyfirst
2724              Type: boolean
2725              Default: no
2726
2727              Controls whether or not Mutt includes only the first  attachment
2728              of the message you are replying.
2729
2730
2731
2732       indent_string
2733              Type: string
2734              Default: “> ”
2735
2736              Specifies the string to prepend to each line of text quoted in a
2737              message to which you are replying.  You are strongly  encouraged
2738              not to change this value, as it tends to agitate the more fanat‐
2739              ical netizens.
2740
2741              The value of this option is ignored if $text_flowed is set,  be‐
2742              cause  the  quoting  mechanism  is  strictly  defined  for  for‐
2743              mat=flowed.
2744
2745              This option is a format string, please see  the  description  of
2746              $index_format for supported printf(3)-style sequences.
2747
2748
2749
2750       index_format
2751              Type: string
2752              Default: “%4C %Z %{%b %d} %-15.15L (%?l?%4l&%4c?) %s”
2753
2754              This  variable allows you to customize the message index display
2755              to your personal taste.
2756
2757              “Format strings” are similar to the strings used in the C  func‐
2758              tion  printf(3)  to format output (see the man page for more de‐
2759              tails).  For an explanation of the %? construct, see  the  $sta‐
2760              tus_format  description.  The following sequences are defined in
2761              Mutt:
2762              %a     address of the author
2763              %A     reply-to address (if present; otherwise: address  of  au‐
2764                     thor)
2765              %b     filename of the original message folder (think mailbox)
2766              %B     the list to which the letter was sent, or else the folder
2767                     name (%b).
2768              %c     number of characters (bytes) in the message (see  format‐
2769                     strings-size)
2770              %C     current message number
2771              %d     date  and  time of the message in the format specified by
2772                     $date_format converted to sender's time zone
2773              %D     date and time of the message in the format  specified  by
2774                     $date_format converted to the local time zone
2775              %e     current message number in thread
2776              %E     number of messages in current thread
2777              %f     sender  (address  +  real  name),  either  From:  or  Re‐
2778                     turn-Path:
2779              %F     author name, or recipient name if the message is from you
2780              %H     spam attribute(s) of this message
2781              %i     message-id of the current message
2782              %l     number of lines in the unprocessed message (may not  work
2783                     with maildir, mh, and IMAP folders)
2784              %L     If  an address in the “To:” or “Cc:” header field matches
2785                     an address defined by the users “subscribe” command, this
2786                     displays ”To <list-name>”, otherwise the same as %F.
2787              %m     total number of message in the mailbox
2788              %M     number of hidden messages if the thread is collapsed.
2789              %N     message score
2790              %n     author's real name (or address if missing)
2791              %O     original  save  folder  where  mutt  would  formerly have
2792                     stashed the message: list name or recipient name  if  not
2793                     sent to a list
2794              %P     progress  indicator  for  the built-in pager (how much of
2795                     the file has been displayed)
2796              %r     comma separated list of “To:” recipients
2797              %R     comma separated list of “Cc:” recipients
2798              %s     subject of the message
2799              %S     single    character     status     of     the     message
2800                     (“N”/“O”/“D”/“d”/“!”/“r”/“*”)
2801              %t     “To:” field (recipients)
2802              %T     the appropriate character from the $to_chars string
2803              %u     user (login) name of the author
2804              %v     first name of the author, or the recipient if the message
2805                     is from you
2806              %X     number of attachments (please see the “attachments”  sec‐
2807                     tion for possible speed effects)
2808              %y     “X-Label:” field, if present
2809              %Y     “X-Label:”  field,  if  present, and (1) not at part of a
2810                     thread tree, (2) at the top of a thread,  or  (3)  “X-La‐
2811                     bel:” is different from preceding message's “X-Label:”.
2812              %Z     a three character set of message status flags.  the first
2813                     character        is        new/read/replied         flags
2814                     (“n”/“o”/“r”/“O”/“N”).   the second is deleted or encryp‐
2815                     tion flags (“D”/“d”/“S”/“P”/“s”/“K”).  the third  is  ei‐
2816                     ther  tagged/flagged  (“*”/“!”), or one of the characters
2817                     listed in $to_chars.
2818              %@name@
2819                     insert and evaluate format-string from the matching  “in‐
2820                     dex-format-hook” command
2821              %{fmt} the date and time of the message is converted to sender's
2822                     time zone, and “fmt” is expanded by the library  function
2823                     strftime(3); a leading bang disables locales
2824              %[fmt] the  date and time of the message is converted to the lo‐
2825                     cal time zone, and “fmt” is expanded by the library func‐
2826                     tion strftime(3); a leading bang disables locales
2827              %(fmt) the  local  date  and time when the message was received.
2828                     “fmt” is expanded by the library function strftime(3);  a
2829                     leading bang disables locales
2830              %<fmt> the  current local time. “fmt” is expanded by the library
2831                     function strftime(3); a leading bang disables locales.
2832              %>X    right justify the rest of the string and pad with charac‐
2833                     ter “X”
2834              %|X    pad to the end of the line with character “X”
2835              %*X    soft-fill with character “X” as pad
2836
2837              Note  that  for  mbox/mmdf, “%l” applies to the unprocessed mes‐
2838              sage, and for maildir/mh, the  value  comes  from  the  “Lines:”
2839              header  field  when  present (the meaning is normally the same).
2840              Thus the value depends on the encodings used  in  the  different
2841              parts of the message and has little meaning in practice.
2842
2843              “Soft-fill”  deserves  some explanation: Normal right-justifica‐
2844              tion will print everything to the left of the  “%>”,  displaying
2845              padding  and whatever lies to the right only if there's room. By
2846              contrast, soft-fill gives priority to the right-hand side, guar‐
2847              anteeing space to display it and showing padding only if there's
2848              still room. If necessary, soft-fill will eat text  leftwards  to
2849              make room for rightward text.
2850
2851              Note  that  these  expandos  are supported in “save-hook”, “fcc-
2852              hook”, “fcc-save-hook”, and “index-format-hook”.
2853
2854              They are also supported in the configuration variables $attribu‐
2855              tion,  $forward_attribution_intro, $forward_attribution_trailer,
2856              $forward_format, $indent_string, $message_format, $pager_format,
2857              and $post_indent_string.
2858
2859
2860
2861       ispell
2862              Type: path
2863              Default: “/usr/bin/hunspell”
2864
2865              How to invoke ispell (GNU's spell-checking software).
2866
2867
2868
2869       keep_flagged
2870              Type: boolean
2871              Default: no
2872
2873              If  set,  read messages marked as flagged will not be moved from
2874              your spool mailbox to your $mbox mailbox, or as a  result  of  a
2875              “mbox-hook” command.
2876
2877
2878
2879       local_date_header
2880              Type: boolean
2881              Default: yes
2882
2883              If  set, convert the date in the Date header of sent emails into
2884              local (sender's) timezone.
2885
2886
2887
2888       mail_check
2889              Type: number
2890              Default: 5
2891
2892              This variable configures how often (in seconds) mutt should look
2893              for new mail. Also see the $timeout variable.
2894
2895
2896
2897       mail_check_recent
2898              Type: boolean
2899              Default: yes
2900
2901              When set, Mutt will only notify you about new mail that has been
2902              received since the last time you opened the mailbox.   When  un‐
2903              set, Mutt will notify you if any new mail exists in the mailbox,
2904              regardless of whether you have visited it recently.
2905
2906              When $mark_old is set, Mutt does not  consider  the  mailbox  to
2907              contain new mail if only old messages exist.
2908
2909
2910
2911       mail_check_stats
2912              Type: boolean
2913              Default: no
2914
2915              When set, mutt will periodically calculate message statistics of
2916              a mailbox while polling for new mail.  It will check for unread,
2917              flagged,  and  total  message counts.  Because this operation is
2918              more performance intensive, it defaults to unset, and has a sep‐
2919              arate  option,  $mail_check_stats_interval, to control how often
2920              to update these counts.
2921
2922              Message statistics can also be explicitly calculated by invoking
2923              the <check-stats> function.
2924
2925
2926
2927       mail_check_stats_interval
2928              Type: number
2929              Default: 60
2930
2931              When  $mail_check_stats is set, this variable configures how of‐
2932              ten (in seconds) mutt will update message counts.
2933
2934
2935
2936       mailcap_path
2937              Type: string
2938              Default: “”
2939
2940              This variable specifies which files to consult  when  attempting
2941              to  display MIME bodies not directly supported by Mutt.  The de‐
2942              fault value is generated during startup: see the “mailcap”  sec‐
2943              tion of the manual.
2944
2945
2946
2947       mailcap_sanitize
2948              Type: boolean
2949              Default: yes
2950
2951              If  set, mutt will restrict possible characters in mailcap % ex‐
2952              pandos to a well-defined set of safe characters.   This  is  the
2953              safe setting, but we are not sure it doesn't break some more ad‐
2954              vanced MIME stuff.
2955
2956              DON'T CHANGE THIS SETTING UNLESS YOU ARE REALLY  SURE  WHAT  YOU
2957              ARE DOING!
2958
2959
2960
2961       maildir_header_cache_verify
2962              Type: boolean
2963              Default: yes
2964
2965              Check  for Maildir unaware programs other than mutt having modi‐
2966              fied maildir files when the header cache is in use.  This incurs
2967              one  stat(2)  per message every time the folder is opened (which
2968              can be very slow for NFS folders).
2969
2970
2971
2972       maildir_trash
2973              Type: boolean
2974              Default: no
2975
2976              If set, messages marked  as  deleted  will  be  saved  with  the
2977              maildir  trashed  flag instead of unlinked.  Note: this only ap‐
2978              plies to maildir-style mailboxes.  Setting it will have  no  ef‐
2979              fect on other mailbox types.
2980
2981
2982
2983       maildir_check_cur
2984              Type: boolean
2985              Default: no
2986
2987              If  set,  mutt  will  poll both the new and cur directories of a
2988              maildir folder for new messages.  This might be useful if  other
2989              programs  interacting  with the folder (e.g. dovecot) are moving
2990              new messages to the cur directory.  Note that setting  this  op‐
2991              tion  may  slow  down polling for new messages in large folders,
2992              since mutt has to scan all cur messages.
2993
2994
2995
2996       mark_macro_prefix
2997              Type: string
2998              Default: “'”
2999
3000              Prefix for macros created using mark-message.  A new macro auto‐
3001              matically  generated  with <mark-message>a will be composed from
3002              this prefix and the letter a.
3003
3004
3005
3006       mark_old
3007              Type: boolean
3008              Default: yes
3009
3010              Controls whether or not mutt marks new unread messages as old if
3011              you  exit a mailbox without reading them.  With this option set,
3012              the next time you start mutt, the messages will show up with  an
3013              “O”  next  to  them  in the index menu, indicating that they are
3014              old.
3015
3016
3017
3018       markers
3019              Type: boolean
3020              Default: yes
3021
3022              Controls the display of wrapped lines in the internal pager.  If
3023              set,  a  “+”  marker  is  displayed  at the beginning of wrapped
3024              lines.
3025
3026              Also see the $smart_wrap variable.
3027
3028
3029
3030       mask
3031              Type: regular expression
3032              Default: “!^\.[^.]”
3033
3034              A regular expression used in the file browser,  optionally  pre‐
3035              ceded  by  the  not  operator “!”.  Only files whose names match
3036              this mask will be shown. The match is always case-sensitive.
3037
3038
3039
3040       mbox
3041              Type: path
3042              Default: “~/mbox”
3043
3044              This  specifies  the  folder  into  which  read  mail  in   your
3045              $spoolfile folder will be appended.
3046
3047              Also see the $move variable.
3048
3049
3050
3051       mbox_type
3052              Type: folder magic
3053              Default: mbox
3054
3055              The  default mailbox type used when creating new folders. May be
3056              any of “mbox”, “MMDF”, “MH” and “Maildir”. This is overridden by
3057              the -m command-line option.
3058
3059
3060
3061       menu_context
3062              Type: number
3063              Default: 0
3064
3065              This  variable  controls the number of lines of context that are
3066              given when scrolling through menus. (Similar to $pager_context.)
3067
3068
3069
3070       menu_move_off
3071              Type: boolean
3072              Default: yes
3073
3074              When unset, the bottom entry of menus will never scroll up  past
3075              the  bottom  of  the  screen, unless there are less entries than
3076              lines.  When set, the bottom entry may move off the bottom.
3077
3078
3079
3080       menu_scroll
3081              Type: boolean
3082              Default: no
3083
3084              When set, menus will be scrolled up or down one  line  when  you
3085              attempt  to move across a screen boundary.  If unset, the screen
3086              is cleared and the next or previous page of  the  menu  is  dis‐
3087              played (useful for slow links to avoid many redraws).
3088
3089
3090
3091       message_cache_clean
3092              Type: boolean
3093              Default: no
3094
3095              If  set,  mutt  will clean out obsolete entries from the message
3096              cache when the mailbox is synchronized. You probably  only  want
3097              to  set  it every once in a while, since it can be a little slow
3098              (especially for large folders).
3099
3100
3101
3102       message_cachedir
3103              Type: path
3104              Default: “”
3105
3106              Set this to a directory and mutt will cache copies  of  messages
3107              from  your IMAP and POP servers here. You are free to remove en‐
3108              tries at any time.
3109
3110              When setting this variable to a directory, mutt needs  to  fetch
3111              every  remote  message only once and can perform regular expres‐
3112              sion searches as fast as for local folders.
3113
3114              Also see the $message_cache_clean variable.
3115
3116
3117
3118       message_format
3119              Type: string
3120              Default: “%s”
3121
3122              This is the string displayed in the “attachment”  menu  for  at‐
3123              tachments of type message/rfc822.  For a full listing of defined
3124              printf(3)-like sequences see the section on $index_format.
3125
3126
3127
3128       message_id_format
3129              Type: string
3130              Default: “<%z@%f>”
3131
3132              This variable describes the format of the  Message-ID  generated
3133              when  sending messages.  Mutt 2.0 introduced a more compact for‐
3134              mat, but this variable allows the ability  to  choose  your  own
3135              format.   The value may end in “|” to invoke an external filter.
3136              See formatstrings-filters.
3137
3138              Please note that the Message-ID value follows a  strict  syntax,
3139              and  you  are responsible for ensuring correctness if you change
3140              this from the default.  In particular, the value must follow the
3141              syntax  in  RFC 5322: “”<” id-left ”@” id-right ”>””.  No spaces
3142              are allowed, and id-left should follow the dot-atom-text  syntax
3143              in the RFC.  The id-right should generally be left at %f.
3144
3145              The  old  Message-ID  format  can  be  used  by setting this to:
3146<%Y%02m%02d%02H%02M%02S.G%c%p@%f>
3147
3148              The following printf(3)-style sequences are understood:
3149              %c     step counter looping from “A” to “Z”
3150              %d     current day of the month (GMT)
3151              %f     $hostname
3152              %H     current hour using a 24-hour clock (GMT)
3153              %m     current month number (GMT)
3154              %M     current minute of the hour (GMT)
3155              %p     pid of the running mutt process
3156              %r     3 bytes of pseudorandom data encoded in Base64
3157              %S     current second of the minute (GMT)
3158              %x     1 byte of pseudorandom data hex encoded (example: '1b')
3159              %Y     current year using 4 digits (GMT)
3160              %z     4 byte timestamp + 8 bytes of pseudorandom  data  encoded
3161                     in Base64
3162
3163
3164       meta_key
3165              Type: boolean
3166              Default: no
3167
3168              If  set,  forces  Mutt to interpret keystrokes with the high bit
3169              (bit 8) set as if the user had pressed the Esc key and  whatever
3170              key  remains after having the high bit removed.  For example, if
3171              the key pressed has an ASCII value of 0xf8, then this is treated
3172              as  if  the  user had pressed Esc then “x”.  This is because the
3173              result of removing the high bit from 0xf8 is 0x78, which is  the
3174              ASCII character “x”.
3175
3176
3177
3178       metoo
3179              Type: boolean
3180              Default: no
3181
3182              If  unset,  Mutt  will remove your address (see the “alternates”
3183              command) from the list of recipients when replying to a message.
3184
3185
3186
3187       mh_purge
3188              Type: boolean
3189              Default: no
3190
3191              When unset, mutt will mimic mh's  behavior  and  rename  deleted
3192              messages  to  ,<old  file  name> in mh folders instead of really
3193              deleting them. This leaves the message on disk  but  makes  pro‐
3194              grams  reading the folder ignore it. If the variable is set, the
3195              message files will simply be deleted.
3196
3197              This option is similar to $maildir_trash for Maildir folders.
3198
3199
3200
3201       mh_seq_flagged
3202              Type: string
3203              Default: “flagged”
3204
3205              The name of the MH sequence used for flagged messages.
3206
3207
3208
3209       mh_seq_replied
3210              Type: string
3211              Default: “replied”
3212
3213              The name of the MH sequence used to tag replied messages.
3214
3215
3216
3217       mh_seq_unseen
3218              Type: string
3219              Default: “unseen”
3220
3221              The name of the MH sequence used for unseen messages.
3222
3223
3224
3225       mime_forward
3226              Type: quadoption
3227              Default: no
3228
3229              When set, the message you are forwarding will be attached  as  a
3230              separate  message/rfc822  MIME  part  instead of included in the
3231              main body of the message.  This is useful  for  forwarding  MIME
3232              messages so the receiver can properly view the message as it was
3233              delivered to you. If you like to switch  between  MIME  and  not
3234              MIME  from  mail  to  mail,  set  this  variable  to “ask-no” or
3235              “ask-yes”.
3236
3237              Also see $forward_decode and $mime_forward_decode.
3238
3239
3240
3241       mime_forward_decode
3242              Type: boolean
3243              Default: no
3244
3245              Controls the decoding of complex MIME messages  into  text/plain
3246              when  forwarding a message while $mime_forward is set. Otherwise
3247              $forward_decode is used instead.
3248
3249
3250
3251       mime_forward_rest
3252              Type: quadoption
3253              Default: yes
3254
3255              When forwarding multiple attachments of a MIME message from  the
3256              attachment  menu,  attachments which cannot be decoded in a rea‐
3257              sonable manner will be attached to the newly composed message if
3258              this option is set.
3259
3260
3261
3262       mime_type_query_command
3263              Type: string
3264              Default: “”
3265
3266              This specifies a command to run, to determine the mime type of a
3267              new   attachment   when    composing    a    message.     Unless
3268              $mime_type_query_first  is set, this will only be run if the at‐
3269              tachment's extension is not found in the mime.types file.
3270
3271              The string may contain a “%s”, which will  be  substituted  with
3272              the attachment filename.  Mutt will add quotes around the string
3273              substituted for “%s” automatically according  to  shell  quoting
3274              rules, so you should avoid adding your own.  If no “%s” is found
3275              in the string, Mutt will append the attachment filename  to  the
3276              end of the string.
3277
3278              The  command  should output a single line containing the attach‐
3279              ment's mime type.
3280
3281              Suggested values are “xdg-mime query filetype” or “file -bi”.
3282
3283
3284
3285       mime_type_query_first
3286              Type: boolean
3287              Default: no
3288
3289              When set, the $mime_type_query_command will be  run  before  the
3290              mime.types lookup.
3291
3292
3293
3294       mix_entry_format
3295              Type: string
3296              Default: “%4n %c %-16s %a”
3297
3298              This  variable  describes  the  format of a remailer line on the
3299              mixmaster chain selection screen.  The following  printf(3)-like
3300              sequences are supported:
3301              %n     The running number on the menu.
3302              %c     Remailer capabilities.
3303              %s     The remailer's short name.
3304              %a     The remailer's e-mail address.
3305
3306
3307       mixmaster
3308              Type: path
3309              Default: “mixmaster”
3310
3311              This  variable contains the path to the Mixmaster binary on your
3312              system.  It is used with various sets of  parameters  to  gather
3313              the  list  of  known  remailers,  and  to finally send a message
3314              through the mixmaster chain.
3315
3316
3317
3318       move
3319              Type: quadoption
3320              Default: no
3321
3322              Controls whether or not Mutt will move read messages  from  your
3323              spool  mailbox to your $mbox mailbox, or as a result of a “mbox-
3324              hook” command.
3325
3326
3327
3328       muttlisp_inline_eval
3329              Type: boolean
3330              Default: no
3331
3332              If set, Mutt will evaluate bare parenthesis  arguments  to  com‐
3333              mands as MuttLisp expressions.
3334
3335
3336
3337       narrow_tree
3338              Type: boolean
3339              Default: no
3340
3341              This  variable, when set, makes the thread tree narrower, allow‐
3342              ing deeper threads to fit on the screen.
3343
3344
3345
3346       net_inc
3347              Type: number
3348              Default: 10
3349
3350              Operations that expect to transfer a large amount of  data  over
3351              the network will update their progress every $net_inc kilobytes.
3352              If set to 0, no progress messages will be displayed.
3353
3354              See also $read_inc, $write_inc and $net_inc.
3355
3356
3357
3358       new_mail_command
3359              Type: path
3360              Default: “”
3361
3362              If set, Mutt will call this command after a new message  is  re‐
3363              ceived.   See  the  $status_format  documentation for the values
3364              that can be formatted into this command.
3365
3366
3367
3368       pager
3369              Type: path
3370              Default: “builtin”
3371
3372              This variable specifies which pager you would  like  to  use  to
3373              view  messages.  The  value  “builtin” means to use the built-in
3374              pager, otherwise this variable should specify  the  pathname  of
3375              the external pager you would like to use.
3376
3377              Using  an external pager may have some disadvantages: Additional
3378              keystrokes are necessary because you can't call  mutt  functions
3379              directly  from  the pager, and screen resizes cause lines longer
3380              than the screen width to be badly formatted in the help menu.
3381
3382              When using an external pager, also see $prompt_after  which  de‐
3383              faults set.
3384
3385
3386
3387       pager_context
3388              Type: number
3389              Default: 0
3390
3391              This  variable  controls the number of lines of context that are
3392              given when displaying the next or previous page in the  internal
3393              pager.   By  default,  Mutt will display the line after the last
3394              one on the screen at the top of the next page (0 lines  of  con‐
3395              text).
3396
3397              This  variable  also  specifies  the amount of context given for
3398              search results. If positive, this many lines will be  given  be‐
3399              fore a match, if 0, the match will be top-aligned.
3400
3401
3402
3403       pager_format
3404              Type: string
3405              Default: “-%Z- %C/%m: %-20.20n   %s%*  -- (%P)”
3406
3407              This  variable controls the format of the one-line message “sta‐
3408              tus” displayed before each message in either the internal or  an
3409              external  pager.   The  valid  sequences  are listed in the $in‐
3410              dex_format section.
3411
3412
3413
3414       pager_index_lines
3415              Type: number
3416              Default: 0
3417
3418              Determines the number of lines of a mini-index  which  is  shown
3419              when  in the pager.  The current message, unless near the top or
3420              bottom of the folder, will be roughly one third of the way  down
3421              this mini-index, giving the reader the context of a few messages
3422              before and after the message.  This is useful, for  example,  to
3423              determine  how  many  messages  remain to be read in the current
3424              thread.  One of the lines is reserved for the  status  bar  from
3425              the  index,  so a setting of 6 will only show 5 lines of the ac‐
3426              tual index.  A value of 0 results in no index being  shown.   If
3427              the  number  of  messages  in  the  current  folder is less than
3428              $pager_index_lines, then the index will only use as  many  lines
3429              as it needs.
3430
3431
3432
3433       pager_stop
3434              Type: boolean
3435              Default: no
3436
3437              When  set,  the internal-pager will not move to the next message
3438              when you are at the end of a message and invoke the  <next-page>
3439              function.
3440
3441
3442
3443       pattern_format
3444              Type: string
3445              Default: “%2n %-15e  %d”
3446
3447              This  variable  describes the format of the “pattern completion”
3448              menu. The following printf(3)-style sequences are understood:
3449              %d     pattern description
3450              %e     pattern expression
3451              %n     index number
3452
3453       pgp_auto_decode
3454              Type: boolean
3455              Default: no
3456
3457              If set, mutt will automatically attempt to  decrypt  traditional
3458              PGP messages whenever the user performs an operation which ordi‐
3459              narily would result in the contents of the message  being  oper‐
3460              ated  on.   For  example, if the user displays a pgp-traditional
3461              message which has not been manually checked with the <check-tra‐
3462              ditional-pgp>  function,  mutt will automatically check the mes‐
3463              sage for traditional pgp.
3464
3465
3466
3467       pgp_autoinline
3468              Type: boolean
3469              Default: no
3470
3471              This option controls whether  Mutt  generates  old-style  inline
3472              (traditional)  PGP  encrypted  or  signed messages under certain
3473              circumstances.  This can be overridden by use of the  pgp  menu,
3474              when inline is not required.  The GPGME backend does not support
3475              this option.
3476
3477              Note that Mutt might automatically  use  PGP/MIME  for  messages
3478              which consist of more than a single MIME part.  Mutt can be con‐
3479              figured to ask before  sending  PGP/MIME  messages  when  inline
3480              (traditional) would not work.
3481
3482              Also see the $pgp_mime_auto variable.
3483
3484              Also  note  that  using  the  old-style  PGP  message  format is
3485              strongly deprecated.  (PGP only)
3486
3487
3488
3489       pgp_check_exit
3490              Type: boolean
3491              Default: yes
3492
3493              If set, mutt will check the exit code of the PGP subprocess when
3494              signing or encrypting.  A non-zero exit code means that the sub‐
3495              process failed.  (PGP only)
3496
3497
3498
3499       pgp_check_gpg_decrypt_status_fd
3500              Type: boolean
3501              Default: yes
3502
3503              If set, mutt will check the status  file  descriptor  output  of
3504              $pgp_decrypt_command  and  $pgp_decode_command  for GnuPG status
3505              codes indicating successful decryption.  This will check for the
3506              presence  of  DECRYPTION_OKAY, absence of DECRYPTION_FAILED, and
3507              that all  PLAINTEXT  occurs  between  the  BEGIN_DECRYPTION  and
3508              END_DECRYPTION status codes.
3509
3510              If  unset,  mutt will instead match the status fd output against
3511              $pgp_decryption_okay.  (PGP only)
3512
3513
3514
3515       pgp_clearsign_command
3516              Type: string
3517              Default: “”
3518
3519              This format is used to create  an  old-style  “clearsigned”  PGP
3520              message.   Note  that  the use of this format is strongly depre‐
3521              cated.
3522
3523              This is a format string, see the $pgp_decode_command command for
3524              possible printf(3)-like sequences.  (PGP only)
3525
3526
3527
3528       pgp_decode_command
3529              Type: string
3530              Default: “”
3531
3532              This  format strings specifies a command which is used to decode
3533              application/pgp attachments.
3534
3535              The PGP command formats have their own set of printf(3)-like se‐
3536              quences:
3537              %p     Expands  to  PGPPASSFD=0 when a pass phrase is needed, to
3538                     an empty string otherwise. Note: This may be used with  a
3539                     %? construct.
3540              %f     Expands to the name of a file containing a message.
3541              %s     Expands  to  the  name of a file containing the signature
3542                     part
3543                                of a multipart/signed attachment when  verify‐
3544                     ing it.
3545              %a     The  value of $pgp_sign_as if set, otherwise the value of
3546                     $pgp_default_key.
3547              %r     One or more key IDs (or fingerprints if available).
3548
3549              For examples on how to configure these formats for  the  various
3550              versions  of  PGP which are floating around, see the pgp and gpg
3551              sample configuration files in the  samples/  subdirectory  which
3552              has  been  installed on your system alongside the documentation.
3553              (PGP only)
3554
3555
3556
3557       pgp_decrypt_command
3558              Type: string
3559              Default: “”
3560
3561              This command is used to decrypt a PGP encrypted message.
3562
3563              This is a format string, see the $pgp_decode_command command for
3564              possible printf(3)-like sequences.  (PGP only)
3565
3566
3567
3568       pgp_decryption_okay
3569              Type: regular expression
3570              Default: “”
3571
3572              If  you assign text to this variable, then an encrypted PGP mes‐
3573              sage is only considered successfully  decrypted  if  the  output
3574              from  $pgp_decrypt_command  contains  the text.  This is used to
3575              protect against a spoofed encrypted message, with  multipart/en‐
3576              crypted  headers but containing a block that is not actually en‐
3577              crypted.  (e.g. simply signed and ascii armored text).
3578
3579              Note that if $pgp_check_gpg_decrypt_status_fd is set, this vari‐
3580              able is ignored.  (PGP only)
3581
3582
3583
3584       pgp_default_key
3585              Type: string
3586              Default: “”
3587
3588              This is the default key-pair to use for PGP operations.  It will
3589              be used for encryption (see $postpone_encrypt and  $pgp_self_en‐
3590              crypt).
3591
3592              It will also be used for signing unless $pgp_sign_as is set.
3593
3594              The  (now  deprecated)  pgp_self_encrypt_as is an alias for this
3595              variable, and should no longer be used.  (PGP only)
3596
3597
3598
3599       pgp_encrypt_only_command
3600              Type: string
3601              Default: “”
3602
3603              This command is used to encrypt a body part without signing it.
3604
3605              This is a format string, see the $pgp_decode_command command for
3606              possible printf(3)-like sequences.  (PGP only)
3607
3608
3609
3610       pgp_encrypt_sign_command
3611              Type: string
3612              Default: “”
3613
3614              This command is used to both sign and encrypt a body part.
3615
3616              This is a format string, see the $pgp_decode_command command for
3617              possible printf(3)-like sequences.  (PGP only)
3618
3619
3620
3621       pgp_entry_format
3622              Type: string
3623              Default: “%4n %t%f %4l/0x%k %-4a %2c %u”
3624
3625              This variable allows you to customize the PGP key selection menu
3626              to your personal taste. This string is similar to $index_format,
3627              but has its own set of printf(3)-like sequences:
3628              %n     number
3629              %k     key id
3630              %u     user id
3631              %a     algorithm
3632              %l     key length
3633              %f     flags
3634              %c     capabilities
3635              %t     trust/validity of the key-uid association
3636              %[<s>] date of the key where <s> is an strftime(3) expression
3637
3638              (PGP only)
3639
3640
3641
3642       pgp_export_command
3643              Type: string
3644              Default: “”
3645
3646              This command is used to export a public key from the user's  key
3647              ring.
3648
3649              This is a format string, see the $pgp_decode_command command for
3650              possible printf(3)-like sequences.  (PGP only)
3651
3652
3653
3654       pgp_getkeys_command
3655              Type: string
3656              Default: “”
3657
3658              This command is invoked whenever Mutt needs to fetch the  public
3659              key  associated  with  an  email address.  Of the sequences sup‐
3660              ported by $pgp_decode_command, %r is the only printf(3)-like se‐
3661              quence  used  with  this format.  Note that in this case, %r ex‐
3662              pands to the email address, not the public key ID (the key ID is
3663              unknown,  which  is  why  Mutt  is invoking this command).  (PGP
3664              only)
3665
3666
3667
3668       pgp_good_sign
3669              Type: regular expression
3670              Default: “”
3671
3672              If you assign a text to this variable, then a PGP  signature  is
3673              only  considered verified if the output from $pgp_verify_command
3674              contains the text. Use this variable if the exit code  from  the
3675              command is 0 even for bad signatures.  (PGP only)
3676
3677
3678
3679       pgp_ignore_subkeys
3680              Type: boolean
3681              Default: yes
3682
3683              Setting this variable will cause Mutt to ignore OpenPGP subkeys.
3684              Instead, the principal key will inherit the  subkeys'  capabili‐
3685              ties.   Unset this if you want to play interesting key selection
3686              games.  (PGP only)
3687
3688
3689
3690       pgp_import_command
3691              Type: string
3692              Default: “”
3693
3694              This command is used to import a key from  a  message  into  the
3695              user's public key ring.
3696
3697              This is a format string, see the $pgp_decode_command command for
3698              possible printf(3)-like sequences.  (PGP only)
3699
3700
3701
3702       pgp_list_pubring_command
3703              Type: string
3704              Default: “”
3705
3706              This command is used to list the  public  key  ring's  contents.
3707              The output format must be analogous to the one used by
3708
3709
3710              gpg --list-keys --with-colons --with-fingerprint
3711
3712
3713              This  format is also generated by the mutt_pgpring utility which
3714              comes with mutt.
3715
3716              Note: gpg's fixed-list-mode option should not be used.  It  pro‐
3717              duces  a  different date format which may result in mutt showing
3718              incorrect key generation dates.
3719
3720              This is a format string, see the $pgp_decode_command command for
3721              possible  printf(3)-like  sequences.  Note that in this case, %r
3722              expands to the search string, which is a list  of  one  or  more
3723              quoted values such as email address, name, or keyid.  (PGP only)
3724
3725
3726
3727       pgp_list_secring_command
3728              Type: string
3729              Default: “”
3730
3731              This  command  is  used  to list the secret key ring's contents.
3732              The output format must be analogous to the one used by:
3733
3734
3735              gpg --list-keys --with-colons --with-fingerprint
3736
3737
3738              This format is also generated by the mutt_pgpring utility  which
3739              comes with mutt.
3740
3741              Note:  gpg's fixed-list-mode option should not be used.  It pro‐
3742              duces a different date format which may result in  mutt  showing
3743              incorrect key generation dates.
3744
3745              This is a format string, see the $pgp_decode_command command for
3746              possible printf(3)-like sequences.  Note that in this  case,  %r
3747              expands  to  the  search  string, which is a list of one or more
3748              quoted values such as email address, name, or keyid.  (PGP only)
3749
3750
3751
3752       pgp_long_ids
3753              Type: boolean
3754              Default: yes
3755
3756              If set, use 64 bit PGP key IDs, if unset use the normal  32  bit
3757              key  IDs.  NOTE: Internally, Mutt has transitioned to using fin‐
3758              gerprints (or long key IDs as a fallback).  This option now only
3759              controls  the display of key IDs in the key selection menu and a
3760              few other places.  (PGP only)
3761
3762
3763
3764       pgp_mime_auto
3765              Type: quadoption
3766              Default: ask-yes
3767
3768              This option controls whether Mutt will prompt you for  automati‐
3769              cally  sending  a (signed/encrypted) message using PGP/MIME when
3770              inline (traditional) fails (for any reason).
3771
3772              Also note  that  using  the  old-style  PGP  message  format  is
3773              strongly deprecated.  (PGP only)
3774
3775
3776
3777       pgp_replyinline
3778              Type: boolean
3779              Default: no
3780
3781              Setting  this variable will cause Mutt to always attempt to cre‐
3782              ate an inline (traditional) message when replying to  a  message
3783              which is PGP encrypted/signed inline.  This can be overridden by
3784              use of the pgp menu, when inline is not required.   This  option
3785              does not automatically detect if the (replied-to) message is in‐
3786              line;  instead  it  relies  on  Mutt  internals  for  previously
3787              checked/flagged messages.
3788
3789              Note  that  Mutt  might  automatically use PGP/MIME for messages
3790              which consist of more than a single MIME part.  Mutt can be con‐
3791              figured  to  ask  before  sending  PGP/MIME messages when inline
3792              (traditional) would not work.
3793
3794              Also see the $pgp_mime_auto variable.
3795
3796              Also note  that  using  the  old-style  PGP  message  format  is
3797              strongly deprecated.  (PGP only)
3798
3799
3800
3801       pgp_retainable_sigs
3802              Type: boolean
3803              Default: no
3804
3805              If  set,  signed  and  encrypted messages will consist of nested
3806              multipart/signed and multipart/encrypted body parts.
3807
3808              This is useful for applications like encrypted and signed  mail‐
3809              ing  lists,  where  the outer layer (multipart/encrypted) can be
3810              easily removed, while the inner  multipart/signed  part  is  re‐
3811              tained.  (PGP only)
3812
3813
3814
3815       pgp_self_encrypt
3816              Type: boolean
3817              Default: yes
3818
3819              When  set,  PGP  encrypted messages will also be encrypted using
3820              the key in $pgp_default_key.  (PGP only)
3821
3822
3823
3824       pgp_show_unusable
3825              Type: boolean
3826              Default: yes
3827
3828              If set, mutt will display non-usable keys on the PGP key  selec‐
3829              tion menu.  This includes keys which have been revoked, have ex‐
3830              pired, or have been marked as  “disabled”  by  the  user.   (PGP
3831              only)
3832
3833
3834
3835       pgp_sign_as
3836              Type: string
3837              Default: “”
3838
3839              If  you have a different key pair to use for signing, you should
3840              set this to the signing key.  Most people will only need to  set
3841              $pgp_default_key.  It is recommended that you use the keyid form
3842              to specify your key (e.g. 0x00112233).  (PGP only)
3843
3844
3845
3846       pgp_sign_command
3847              Type: string
3848              Default: “”
3849
3850              This command is used to create the detached PGP signature for  a
3851              multipart/signed PGP/MIME body part.
3852
3853              This is a format string, see the $pgp_decode_command command for
3854              possible printf(3)-like sequences.  (PGP only)
3855
3856
3857
3858       pgp_sort_keys
3859              Type: sort order
3860              Default: address
3861
3862              Specifies how the entries in the pgp menu are sorted.  The  fol‐
3863              lowing are legal values:
3864              address
3865                     sort alphabetically by user id
3866              keyid  sort alphabetically by key id
3867              date   sort by key creation date
3868              trust  sort by the trust of the key
3869
3870              If  you prefer reverse order of the above values, prefix it with
3871              “reverse-”.  (PGP only)
3872
3873
3874
3875       pgp_strict_enc
3876              Type: boolean
3877              Default: yes
3878
3879              If set, Mutt will automatically encode PGP/MIME signed  messages
3880              as  quoted-printable.   Please note that unsetting this variable
3881              may lead to problems with non-verifyable PGP signatures, so only
3882              change this if you know what you are doing.  (PGP only)
3883
3884
3885
3886       pgp_timeout
3887              Type: number (long)
3888              Default: 300
3889
3890              The  number  of seconds after which a cached passphrase will ex‐
3891              pire if not used.  (PGP only)
3892
3893
3894
3895       pgp_use_gpg_agent
3896              Type: boolean
3897              Default: no
3898
3899              If set, mutt expects a gpg-agent(1) process will handle  private
3900              key  passphrase  prompts.   If  unset,  mutt will prompt for the
3901              passphrase and pass it via stdin to the pgp command.
3902
3903              Note that as of version 2.1, GnuPG automatically spawns an agent
3904              and requires the agent be used for passphrase management.  Since
3905              that version is increasingly prevalent, this  variable  now  de‐
3906              faults set.
3907
3908              Mutt  works with a GUI or curses pinentry program.  A TTY pinen‐
3909              try should not be used.
3910
3911              If you are using an older version of GnuPG without an agent run‐
3912              ning,  or  another encryption program without an agent, you will
3913              need to unset this variable.  (PGP only)
3914
3915
3916
3917       pgp_verify_command
3918              Type: string
3919              Default: “”
3920
3921              This command is used to verify PGP signatures.
3922
3923              This is a format string, see the $pgp_decode_command command for
3924              possible printf(3)-like sequences.  (PGP only)
3925
3926
3927
3928       pgp_verify_key_command
3929              Type: string
3930              Default: “”
3931
3932              This  command is used to verify key information from the key se‐
3933              lection menu.
3934
3935              This is a format string, see the $pgp_decode_command command for
3936              possible printf(3)-like sequences.  (PGP only)
3937
3938
3939
3940       pipe_decode
3941              Type: boolean
3942              Default: no
3943
3944              Used  in  connection with the <pipe-message> function.  When un‐
3945              set, Mutt will pipe the messages without any preprocessing. When
3946              set, Mutt will attempt to decode the messages first.
3947
3948              Also  see $pipe_decode_weed, which controls whether headers will
3949              be weeded when this is set.
3950
3951
3952
3953       pipe_decode_weed
3954              Type: boolean
3955              Default: yes
3956
3957              For <pipe-message>, when $pipe_decode is set, this further  con‐
3958              trols whether Mutt will weed headers.
3959
3960
3961
3962       pipe_sep
3963              Type: string
3964              Default: “\n”
3965
3966              The  separator  to  add  between  messages when piping a list of
3967              tagged messages to an external Unix command.
3968
3969
3970
3971       pipe_split
3972              Type: boolean
3973              Default: no
3974
3975              Used in connection with the  <pipe-message>  function  following
3976              <tag-prefix>.   If this variable is unset, when piping a list of
3977              tagged messages Mutt will concatenate the messages and will pipe
3978              them  all  concatenated.   When set, Mutt will pipe the messages
3979              one by one.  In both cases the messages are piped in the current
3980              sorted  order,  and  the $pipe_sep separator is added after each
3981              message.
3982
3983
3984
3985       pop_auth_try_all
3986              Type: boolean
3987              Default: yes
3988
3989              If set, Mutt will  try  all  available  authentication  methods.
3990              When  unset,  Mutt  will  only fall back to other authentication
3991              methods if the previous methods are unavailable. If a method  is
3992              available but authentication fails, Mutt will not connect to the
3993              POP server.
3994
3995
3996
3997       pop_authenticators
3998              Type: string
3999              Default: “”
4000
4001              This is a colon-delimited list of  authentication  methods  mutt
4002              may attempt to use to log in to an POP server, in the order mutt
4003              should try them.   Authentication  methods  are  either  “user”,
4004              “apop”  or  any  SASL  mechanism, e.g. “digest-md5”, “gssapi” or
4005              “cram-md5”.  This option is case-insensitive. If this option  is
4006              unset  (the default) mutt will try all available methods, in or‐
4007              der from most-secure to least-secure.
4008
4009              Example:
4010
4011
4012              set pop_authenticators=”digest-md5:apop:user”
4013
4014
4015
4016
4017       pop_checkinterval
4018              Type: number
4019              Default: 60
4020
4021              This variable configures how often (in seconds) mutt should look
4022              for  new  mail  in the currently selected mailbox if it is a POP
4023              mailbox.
4024
4025
4026
4027       pop_delete
4028              Type: quadoption
4029              Default: ask-no
4030
4031              If set, Mutt will delete successfully downloaded  messages  from
4032              the  POP  server when using the <fetch-mail> function.  When un‐
4033              set, Mutt will download messages but also leave them on the  POP
4034              server.
4035
4036
4037
4038       pop_host
4039              Type: string
4040              Default: “”
4041
4042              The  name of your POP server for the <fetch-mail> function.  You
4043              can also specify an alternative  port,  username  and  password,
4044              i.e.:
4045
4046
4047              [pop[s]://][username[:password]@]popserver[:port]
4048
4049
4050              where “[...]” denotes an optional part.
4051
4052
4053
4054       pop_last
4055              Type: boolean
4056              Default: no
4057
4058              If  this  variable  is  set, mutt will try to use the “LAST” POP
4059              command for retrieving only unread messages from the POP  server
4060              when using the <fetch-mail> function.
4061
4062
4063
4064       pop_oauth_refresh_command
4065              Type: string
4066              Default: “”
4067
4068              The command to run to generate an OAUTH refresh token for autho‐
4069              rizing your connection to your POP server.  This command will be
4070              run  on  every  connection attempt that uses the OAUTHBEARER au‐
4071              thentication mechanism.  See “oauth” for details.
4072
4073
4074
4075       pop_pass
4076              Type: string
4077              Default: “”
4078
4079              Specifies the password for your POP  account.   If  unset,  Mutt
4080              will prompt you for your password when you open a POP mailbox.
4081
4082              Warning:  you  should  only  use  this  option when you are on a
4083              fairly secure machine, because the superuser can read your  mut‐
4084              trc even if you are the only one who can read the file.
4085
4086
4087
4088       pop_reconnect
4089              Type: quadoption
4090              Default: ask-yes
4091
4092              Controls  whether  or  not Mutt will try to reconnect to the POP
4093              server if the connection is lost.
4094
4095
4096
4097       pop_user
4098              Type: string
4099              Default: “”
4100
4101              Your login name on the POP server.
4102
4103              This variable defaults to your user name on the local machine.
4104
4105
4106
4107       post_indent_string
4108              Type: string
4109              Default: “”
4110
4111              Similar to the $attribution  variable,  Mutt  will  append  this
4112              string  after  the inclusion of a message which is being replied
4113              to.  For a full listing of defined printf(3)-like sequences  see
4114              the section on $index_format.
4115
4116
4117
4118       postpone
4119              Type: quadoption
4120              Default: ask-yes
4121
4122              Controls  whether  or  not  messages are saved in the $postponed
4123              mailbox when you elect not to send immediately.
4124
4125              Also see the $recall variable.
4126
4127
4128
4129       postponed
4130              Type: path
4131              Default: “~/postponed”
4132
4133              Mutt allows you to indefinitely  “postpone  sending  a  message”
4134              which  you  are editing.  When you choose to postpone a message,
4135              Mutt saves it in the mailbox specified by this variable.
4136
4137              Also see the $postpone variable.
4138
4139
4140
4141       postpone_encrypt
4142              Type: boolean
4143              Default: no
4144
4145              When set, postponed messages that are marked for encryption will
4146              be  self-encrypted.   Mutt  will  first try to encrypt using the
4147              value specified in $pgp_default_key or  $smime_default_key.   If
4148              those  are  not  set,  it  will try the deprecated $postpone_en‐
4149              crypt_as.  (Crypto only)
4150
4151
4152
4153       postpone_encrypt_as
4154              Type: string
4155              Default: “”
4156
4157              This is a deprecated fall-back variable  for  $postpone_encrypt.
4158              Please  use  $pgp_default_key  or  $smime_default_key.   (Crypto
4159              only)
4160
4161
4162
4163       preconnect
4164              Type: string
4165              Default: “”
4166
4167              If set, a shell command to be executed if mutt fails  to  estab‐
4168              lish  a  connection to the server. This is useful for setting up
4169              secure connections, e.g. with ssh(1). If the command  returns  a
4170              nonzero status, mutt gives up opening the server. Example:
4171
4172
4173              set preconnect=”ssh -f -q -L 1234:mailhost.net:143 mailhost.net \
4174              sleep 20 < /dev/null > /dev/null”
4175
4176
4177              Mailbox  “foo”  on “mailhost.net” can now be reached as “{local‐
4178              host:1234}foo”.
4179
4180              Note: For this example to work, you must be able to  log  in  to
4181              the remote machine without having to enter a password.
4182
4183
4184
4185       print
4186              Type: quadoption
4187              Default: ask-no
4188
4189              Controls  whether  or  not Mutt really prints messages.  This is
4190              set to “ask-no” by default, because some people accidentally hit
4191              “p” often.
4192
4193
4194
4195       print_command
4196              Type: path
4197              Default: “lpr”
4198
4199              This  specifies  the  command  pipe that should be used to print
4200              messages.
4201
4202
4203
4204       print_decode
4205              Type: boolean
4206              Default: yes
4207
4208              Used in connection with the <print-message> function.   If  this
4209              option is set, the message is decoded before it is passed to the
4210              external command specified by $print_command.  If this option is
4211              unset,  no processing will be applied to the message when print‐
4212              ing it.  The latter setting may be useful if you are using  some
4213              advanced  printer filter which is able to properly format e-mail
4214              messages for printing.
4215
4216              Also see $print_decode_weed, which controls whether headers will
4217              be weeded when this is set.
4218
4219
4220
4221       print_decode_weed
4222              Type: boolean
4223              Default: yes
4224
4225              For  <print-message>,  when  $print_decode  is set, this further
4226              controls whether Mutt will weed headers.
4227
4228
4229
4230       print_split
4231              Type: boolean
4232              Default: no
4233
4234              Used in connection with the <print-message> function.   If  this
4235              option  is  set, the command specified by $print_command is exe‐
4236              cuted once for each message which is to be printed.  If this op‐
4237              tion  is  unset, the command specified by $print_command is exe‐
4238              cuted only once, and all the messages are concatenated,  with  a
4239              form feed as the message separator.
4240
4241              Those  who use the enscript(1) program's mail-printing mode will
4242              most likely want to set this option.
4243
4244
4245
4246       prompt_after
4247              Type: boolean
4248              Default: yes
4249
4250              If you use an external $pager, setting this variable will  cause
4251              Mutt  to  prompt  you  for a command when the pager exits rather
4252              than returning to the index menu.  If unset, Mutt will return to
4253              the index menu when the external pager exits.
4254
4255
4256
4257       query_command
4258              Type: path
4259              Default: “”
4260
4261              This  specifies  the  command Mutt will use to make external ad‐
4262              dress queries.  The string may contain a  “%s”,  which  will  be
4263              substituted with the query string the user types.  Mutt will add
4264              quotes around the string substituted for “%s” automatically  ac‐
4265              cording  to shell quoting rules, so you should avoid adding your
4266              own.  If no “%s” is found in the string, Mutt  will  append  the
4267              user's query to the end of the string.  See “query” for more in‐
4268              formation.
4269
4270
4271
4272       query_format
4273              Type: string
4274              Default: “%4c %t %-25.25a %-25.25n %?e?(%e)?”
4275
4276              This variable describes the format of the “query” menu. The fol‐
4277              lowing printf(3)-style sequences are understood:
4278              %a     destination address
4279              %c     current entry number
4280              %e     extra information *
4281              %n     destination name
4282              %t     “*” if current entry is tagged, a space otherwise
4283              %>X    right justify the rest of the string and pad with “X”
4284              %|X    pad to the end of the line with “X”
4285              %*X    soft-fill with character “X” as pad
4286
4287              For  an  explanation of “soft-fill”, see the $index_format docu‐
4288              mentation.
4289
4290              * = can be optionally printed if nonzero, see the $status_format
4291              documentation.
4292
4293
4294
4295       quit
4296              Type: quadoption
4297              Default: yes
4298
4299              This  variable  controls whether “quit” and “exit” actually quit
4300              from mutt.  If this option is set, they do quit, if it is unset,
4301              they  have no effect, and if it is set to ask-yes or ask-no, you
4302              are prompted for confirmation when you try to quit.
4303
4304
4305
4306       quote_regexp
4307              Type: regular expression
4308              Default: “^([ \t]*[|>:}#])+”
4309
4310              A regular expression used in the  internal  pager  to  determine
4311              quoted  sections  of  text in the body of a message. Quoted text
4312              may be filtered out using the <toggle-quoted> command,  or  col‐
4313              ored according to the “color quoted” family of directives.
4314
4315              Higher  levels  of  quoting  may  be colored differently (“color
4316              quoted1”, “color quoted2”, etc.). The quoting  level  is  deter‐
4317              mined  by  removing the last character from the matched text and
4318              recursively reapplying the regular expression until it fails  to
4319              produce a match.
4320
4321              Match  detection  may  be overridden by the $smileys regular ex‐
4322              pression.
4323
4324
4325
4326       read_inc
4327              Type: number
4328              Default: 10
4329
4330              If set to a value greater than 0, Mutt will display  which  mes‐
4331              sage  it is currently on when reading a mailbox or when perform‐
4332              ing search actions such as search  and  limit.  The  message  is
4333              printed  after  this  many  messages  have been read or searched
4334              (e.g., if set to 25, Mutt will print a message  when  it  is  at
4335              message  25,  and  then again when it gets to message 50).  This
4336              variable is meant to indicate progress when reading or searching
4337              large mailboxes which may take some time.  When set to 0, only a
4338              single message will appear before the reading the mailbox.
4339
4340              Also see the $write_inc, $net_inc and  $time_inc  variables  and
4341              the  “tuning”  section  of the manual for performance considera‐
4342              tions.
4343
4344
4345
4346       read_only
4347              Type: boolean
4348              Default: no
4349
4350              If set, all folders are opened in read-only mode.
4351
4352
4353
4354       realname
4355              Type: string
4356              Default: “”
4357
4358              This variable specifies what “real” or “personal” name should be
4359              used when sending messages.
4360
4361              By default, this is the GECOS field from /etc/passwd.  Note that
4362              this variable will not be used when the user has set a real name
4363              in the $from variable.
4364
4365
4366
4367       recall
4368              Type: quadoption
4369              Default: ask-yes
4370
4371              Controls  whether  or  not  Mutt recalls postponed messages when
4372              composing a new message.
4373
4374              Setting this variable to yes is not generally useful,  and  thus
4375              not recommended.  Note that the <recall-message> function can be
4376              used to manually recall postponed messages.
4377
4378              Also see $postponed variable.
4379
4380
4381
4382       record
4383              Type: path
4384              Default: “~/sent”
4385
4386              This specifies the file into which your outgoing messages should
4387              be  appended.  (This is meant as the primary method for saving a
4388              copy of your messages, but another way to do this is  using  the
4389              “my_hdr”  command  to  create a “Bcc:” field with your email ad‐
4390              dress in it.)
4391
4392              The value of  $record  is  overridden  by  the  $force_name  and
4393              $save_name  variables,  and  the  “fcc-hook”  command.  Also see
4394              $copy and $write_bcc.
4395
4396              Multiple mailboxes may be specified if $fcc_delimiter is set  to
4397              a string delimiter.
4398
4399
4400
4401       reflow_space_quotes
4402              Type: boolean
4403              Default: yes
4404
4405              This  option controls how quotes from format=flowed messages are
4406              displayed in the pager and when replying (with $text_flowed  un‐
4407              set).   When  set,  this  option adds spaces after each level of
4408              quote marks, turning ”>>>foo” into ”> > > foo”.
4409
4410              Note: If $reflow_text is  unset,  this  option  has  no  effect.
4411              Also,  this  option does not affect replies when $text_flowed is
4412              set.
4413
4414
4415
4416       reflow_text
4417              Type: boolean
4418              Default: yes
4419
4420              When set, Mutt will  reformat  paragraphs  in  text/plain  parts
4421              marked  format=flowed.   If  unset, Mutt will display paragraphs
4422              unaltered from how they appear in the message body.  See RFC3676
4423              for details on the format=flowed format.
4424
4425              Also see $reflow_wrap, and $wrap.
4426
4427
4428
4429       reflow_wrap
4430              Type: number
4431              Default: 78
4432
4433              This  variable  controls the maximum paragraph width when refor‐
4434              matting text/plain parts when $reflow_text  is  set.   When  the
4435              value  is  0, paragraphs will be wrapped at the terminal's right
4436              margin.  A positive value sets the paragraph width  relative  to
4437              the left margin.  A negative value set the paragraph width rela‐
4438              tive to the right margin.
4439
4440              Also see $wrap.
4441
4442
4443
4444       reply_regexp
4445              Type: regular expression
4446              Default: “^(re([\[0-9\]+])*|aw):[ \t]*”
4447
4448              A regular expression  used  to  recognize  reply  messages  when
4449              threading  and  replying.  The  default value corresponds to the
4450              English ”Re:” and the German ”Aw:”.
4451
4452
4453
4454       reply_self
4455              Type: boolean
4456              Default: no
4457
4458              If unset and you are replying to a message  sent  by  you,  Mutt
4459              will  assume  that  you  want to reply to the recipients of that
4460              message rather than to yourself.
4461
4462              Also see the “alternates” command.
4463
4464
4465
4466       reply_to
4467              Type: quadoption
4468              Default: ask-yes
4469
4470              If set, when replying to a message, Mutt will  use  the  address
4471              listed  in  the  Reply-to: header as the recipient of the reply.
4472              If unset, it will use the address in the From: header field  in‐
4473              stead.   This  option  is useful for reading a mailing list that
4474              sets the Reply-To: header field to the list address and you want
4475              to send a private message to the author of a message.
4476
4477
4478
4479       resolve
4480              Type: boolean
4481              Default: yes
4482
4483              When  set, the cursor will be automatically advanced to the next
4484              (possibly undeleted) message whenever a  command  that  modifies
4485              the current message is executed.
4486
4487
4488
4489       resume_draft_files
4490              Type: boolean
4491              Default: no
4492
4493              If  set,  draft  files (specified by -H on the command line) are
4494              processed similarly to when resuming a postponed  message.   Re‐
4495              cipients  are not prompted for; send-hooks are not evaluated; no
4496              alias expansion takes place; user-defined headers and signatures
4497              are not added to the message.
4498
4499
4500
4501       resume_edited_draft_files
4502              Type: boolean
4503              Default: yes
4504
4505              If  set, draft files previously edited (via -E -H on the command
4506              line) will have $resume_draft_files automatically set when  they
4507              are used as a draft file again.
4508
4509              The  first  time  a draft file is saved, mutt will add a header,
4510              X-Mutt-Resume-Draft to the saved file.  The next time the  draft
4511              file  is  read  in,  if  mutt  sees the header, it will set $re‐
4512              sume_draft_files.
4513
4514              This option is designed to prevent multiple signatures, user-de‐
4515              fined headers, and other processing effects from being made mul‐
4516              tiple times to the draft file.
4517
4518
4519
4520       reverse_alias
4521              Type: boolean
4522              Default: no
4523
4524              This variable controls whether or  not  Mutt  will  display  the
4525              “personal”  name from your aliases in the index menu if it finds
4526              an alias that matches the message's sender.  For example, if you
4527              have the following alias:
4528
4529
4530              alias juser abd30425@somewhere.net (Joe User)
4531
4532
4533              and then you receive mail which contains the following header:
4534
4535
4536              From: abd30425@somewhere.net
4537
4538
4539              It would be displayed in the index menu as “Joe User” instead of
4540              “abd30425@somewhere.net.”  This  is  useful  when  the  person's
4541              e-mail address is not human friendly.
4542
4543
4544
4545       reverse_name
4546              Type: boolean
4547              Default: no
4548
4549              It  may  sometimes arrive that you receive mail to a certain ma‐
4550              chine, move the messages to another machine, and reply  to  some
4551              the  messages  from there.  If this variable is set, the default
4552              From: line of the reply messages  is  built  using  the  address
4553              where  you received the messages you are replying to if that ad‐
4554              dress matches your “alternates”.  If the variable is  unset,  or
4555              the  address that would be used doesn't match your “alternates”,
4556              the From: line will use your address on the current machine.
4557
4558              Also see the “alternates” command and $reverse_realname.
4559
4560
4561
4562       reverse_realname
4563              Type: boolean
4564              Default: yes
4565
4566              This variable fine-tunes the behavior of the $reverse_name  fea‐
4567              ture.
4568
4569              When  it  is  unset,  Mutt  will  remove the real name part of a
4570              matching address.  This allows the  use  of  the  email  address
4571              without  having to also use what the sender put in the real name
4572              field.
4573
4574              When it is set, Mutt will use the matching address as-is.
4575
4576              In either case, a missing real name will be filled in afterwards
4577              using the value of $realname.
4578
4579
4580
4581       rfc2047_parameters
4582              Type: boolean
4583              Default: no
4584
4585              When this variable is set, Mutt will decode RFC2047-encoded MIME
4586              parameters. You want to set this variable when mutt suggests you
4587              to save attachments to files named like:
4588
4589
4590              =?iso-8859-1?Q?file=5F=E4=5F991116=2Ezip?=
4591
4592
4593              When this variable is set interactively, the change won't be ac‐
4594              tive until you change folders.
4595
4596              Note that this use of RFC2047's encoding is  explicitly  prohib‐
4597              ited by the standard, but nevertheless encountered in the wild.
4598
4599              Also  note  that setting this parameter will not have the effect
4600              that mutt generates this kind of encoding.  Instead,  mutt  will
4601              unconditionally use the encoding specified in RFC2231.
4602
4603
4604
4605       save_address
4606              Type: boolean
4607              Default: no
4608
4609              If set, mutt will take the sender's full address when choosing a
4610              default folder for saving a mail. If $save_name  or  $force_name
4611              is  set  too, the selection of the Fcc folder will be changed as
4612              well.
4613
4614
4615
4616       save_empty
4617              Type: boolean
4618              Default: yes
4619
4620              When unset, mailboxes which contain no saved  messages  will  be
4621              removed  when closed (the exception is $spoolfile which is never
4622              removed).  If set, mailboxes are never removed.
4623
4624              Note: This only applies to mbox and MMDF folders, Mutt does  not
4625              delete MH and Maildir directories.
4626
4627
4628
4629       save_history
4630              Type: number
4631              Default: 0
4632
4633              This  variable  controls  the size of the history (per category)
4634              saved in the $history_file file.
4635
4636
4637
4638       save_name
4639              Type: boolean
4640              Default: no
4641
4642              This variable controls  how  copies  of  outgoing  messages  are
4643              saved.   When set, a check is made to see if a mailbox specified
4644              by the recipient address exists (this is done by searching for a
4645              mailbox  in  the $folder directory with the username part of the
4646              recipient address).  If the mailbox exists, the outgoing message
4647              will be saved to that mailbox, otherwise the message is saved to
4648              the $record mailbox.
4649
4650              Also see the $force_name variable.
4651
4652
4653
4654       score
4655              Type: boolean
4656              Default: yes
4657
4658              When this variable is unset, scoring is turned off.  This can be
4659              useful  to  selectively disable scoring for certain folders when
4660              the $score_threshold_delete variable and related are used.
4661
4662
4663
4664       score_threshold_delete
4665              Type: number
4666              Default: -1
4667
4668              Messages which have been assigned a score equal to or lower than
4669              the value of this variable are automatically marked for deletion
4670              by mutt.  Since mutt scores are always greater than or equal  to
4671              zero,  the  default  setting  of this variable will never mark a
4672              message for deletion.
4673
4674
4675
4676       score_threshold_flag
4677              Type: number
4678              Default: 9999
4679
4680              Messages which have been assigned a score greater than or  equal
4681              to this variable's value are automatically marked ”flagged”.
4682
4683
4684
4685       score_threshold_read
4686              Type: number
4687              Default: -1
4688
4689              Messages which have been assigned a score equal to or lower than
4690              the value of this variable are automatically marked as  read  by
4691              mutt.   Since  mutt  scores  are always greater than or equal to
4692              zero, the default setting of this variable  will  never  mark  a
4693              message read.
4694
4695
4696
4697       search_context
4698              Type: number
4699              Default: 0
4700
4701              For the pager, this variable specifies the number of lines shown
4702              before search  results.  By  default,  search  results  will  be
4703              top-aligned.
4704
4705
4706
4707       send_charset
4708              Type: string
4709              Default: “us-ascii:iso-8859-1:utf-8”
4710
4711              A  colon-delimited list of character sets for outgoing messages.
4712              Mutt will use the first character set into which the text can be
4713              converted exactly.  If your $charset is not “iso-8859-1” and re‐
4714              cipients may not understand “UTF-8”, it is advisable to  include
4715              in  the  list  an appropriate widely used standard character set
4716              (such as “iso-8859-2”, “koi8-r” or “iso-2022-jp”) either instead
4717              of or after “iso-8859-1”.
4718
4719              In  case the text cannot be converted into one of these exactly,
4720              mutt uses $charset as a fallback.
4721
4722
4723
4724       send_multipart_alternative
4725              Type: quadoption
4726              Default: no
4727
4728              If set, Mutt will generate a multipart/alternative container and
4729              an  alternative  part  using  the  filter  script  specified  in
4730              $send_multipart_alternative_filter.  See the section “MIME  Mul‐
4731              tipart/Alternative” (alternative-order).
4732
4733              Note  that enabling multipart/alternative is not compatible with
4734              inline PGP encryption.  Mutt will prompt to use PGP/MIME in that
4735              case.
4736
4737
4738
4739       send_multipart_alternative_filter
4740              Type: path
4741              Default: “”
4742
4743              This  specifies  a  filter  script,  which will convert the main
4744              (composed) message of the email to an alternative  format.   The
4745              message  will be piped to the filter's stdin.  The expected out‐
4746              put of the filter is the generated mime  type,  e.g.  text/html,
4747              followed  by  a blank line, and then the converted content.  See
4748              the section “MIME Multipart/Alternative” (alternative-order).
4749
4750
4751
4752       sendmail
4753              Type: path
4754              Default: “/usr/sbin/sendmail -oem -oi”
4755
4756              Specifies the program and arguments used to deliver mail sent by
4757              Mutt.   Mutt expects that the specified program interprets addi‐
4758              tional arguments as recipient addresses.  Mutt appends  all  re‐
4759              cipients  after  adding a -- delimiter (if not already present).
4760              Additional flags, such as for $use_8bitmime, $use_envelope_from,
4761              $dsn_notify, or $dsn_return will be added before the delimiter.
4762
4763              See also: $write_bcc.
4764
4765
4766
4767       sendmail_wait
4768              Type: number
4769              Default: 0
4770
4771              Specifies  the  number  of  seconds  to  wait  for the $sendmail
4772              process to finish before giving up and putting delivery  in  the
4773              background.
4774
4775              Mutt interprets the value of this variable as follows:
4776              >0     number  of  seconds to wait for sendmail to finish before
4777                     continuing
4778              0      wait forever for sendmail to finish
4779              <0     always put sendmail in the background without waiting
4780
4781              Note that if you specify a value other than 0, the output of the
4782              child process will be put in a temporary file.  If there is some
4783              error, you will be informed as to where to find the output.
4784
4785
4786
4787       shell
4788              Type: path
4789              Default: “”
4790
4791              Command to use when spawning a subshell.  By default, the user's
4792              login shell from /etc/passwd is used.
4793
4794
4795
4796       sidebar_delim_chars
4797              Type: string
4798              Default: “/.”
4799
4800              This  contains  the  list  of characters which you would like to
4801              treat as folder separators for displaying paths in the sidebar.
4802
4803              Local mail is often arranged  in  directories:  `dir1/dir2/mail‐
4804              box'.
4805
4806
4807              set sidebar_delim_chars='/'
4808
4809
4810              IMAP mailboxes are often named: `folder1.folder2.mailbox'.
4811
4812
4813              set sidebar_delim_chars='.'
4814
4815
4816              See  also:  $sidebar_short_path,  $sidebar_folder_indent, $side‐
4817              bar_indent_string.
4818
4819
4820
4821       sidebar_divider_char
4822              Type: string
4823              Default: “|”
4824
4825              This specifies the characters to be drawn  between  the  sidebar
4826              (when  visible)  and  the  other  Mutt panels. ASCII and Unicode
4827              line-drawing characters are supported.
4828
4829
4830
4831       sidebar_folder_indent
4832              Type: boolean
4833              Default: no
4834
4835              Set this to indent mailboxes in the sidebar.
4836
4837              See also:  $sidebar_short_path,  $sidebar_indent_string,  $side‐
4838              bar_delim_chars.
4839
4840
4841
4842       sidebar_format
4843              Type: string
4844              Default: “%B%*  %n”
4845
4846              This  variable allows you to customize the sidebar display. This
4847              string is similar to $index_format,  but  has  its  own  set  of
4848              printf(3)-like sequences:
4849              %B     Name of the mailbox
4850              %S     * Size of mailbox (total number of messages)
4851              %N     * Number of unread messages in the mailbox
4852              %n     N if mailbox has new mail, blank otherwise
4853              %F     * Number of Flagged messages in the mailbox
4854              %!     “!”  :  one flagged message; “!!” : two flagged messages;
4855                     “n!” : n flagged messages (for n > 2).  Otherwise  prints
4856                     nothing.
4857              %d     * @ Number of deleted messages
4858              %L     * @ Number of messages after limiting
4859              %t     * @ Number of tagged messages
4860              %>X    right justify the rest of the string and pad with “X”
4861              %|X    pad to the end of the line with “X”
4862              %*X    soft-fill with character “X” as pad
4863
4864              *  = Can be optionally printed if nonzero @ = Only applicable to
4865              the current folder
4866
4867              In order to use %S, %N, %F, and %!,  $mail_check_stats  must  be
4868              set.   When  thus  set,  a  suggested  value  for this option is
4869              ”%B%?F? [%F]?%* %?N?%N/?%S”.
4870
4871
4872
4873       sidebar_indent_string
4874              Type: string
4875              Default: “  ”
4876
4877              This specifies the string that is used to  indent  mailboxes  in
4878              the sidebar.  It defaults to two spaces.
4879
4880              See  also:  $sidebar_short_path,  $sidebar_folder_indent, $side‐
4881              bar_delim_chars.
4882
4883
4884
4885       sidebar_new_mail_only
4886              Type: boolean
4887              Default: no
4888
4889              When set, the sidebar will  only  display  mailboxes  containing
4890              new, or flagged, mail.
4891
4892              See also: sidebar_whitelist.
4893
4894
4895
4896       sidebar_next_new_wrap
4897              Type: boolean
4898              Default: no
4899
4900              When  set,  the <sidebar-next-new> command will not stop and the
4901              end of the list of mailboxes, but wrap around to the  beginning.
4902              The  <sidebar-prev-new>  command is similarly affected, wrapping
4903              around to the end of the list.
4904
4905
4906
4907       sidebar_relative_shortpath_indent
4908              Type: boolean
4909              Default: no
4910
4911              When set, this option changes how $sidebar_short_path and $side‐
4912              bar_folder_indent  perform shortening and indentation: both will
4913              look at the previous sidebar entries and shorten/indent relative
4914              to the most recent parent.
4915
4916              An example of this option set/unset for mailboxes listed in this
4917              order, with $sidebar_short_path=yes, $sidebar_folder_indent=yes,
4918              and $sidebar_indent_string=”→”:
4919              mailbox
4920                     set unset
4921              =a.b   =a.b →b
4922              =a.b.c.d
4923                     →c.d →→→d
4924              =a.b.e →e →→e
4925
4926              The second line illustrates most clearly.  With this option set,
4927              =a.b.c.d is shortened relative to =a.b, becoming c.d; it is also
4928              indented  one  place  relative  to =a.b.  With this option unset
4929              =a.b.c.d is always shortened to the last part of the mailbox,  d
4930              and  is  indented  three places, with respect to $folder (repre‐
4931              sented by '=').
4932
4933              When set, the third line will also  be  indented  and  shortened
4934              relative to the first line.
4935
4936
4937
4938       sidebar_short_path
4939              Type: boolean
4940              Default: no
4941
4942              By default the sidebar will show the mailbox's path, relative to
4943              the $folder variable. Setting sidebar_shortpath=yes will shorten
4944              the names relative to the previous name. Here's an example:
4945              shortpath=no
4946                     shortpath=yes    shortpath=yes,   folderindent=yes,   in‐
4947                     dentstr=”..”
4948              fruit  fruit fruit
4949              fruit.apple
4950                     apple ..apple
4951              fruit.banana
4952                     banana ..banana
4953              fruit.cherry
4954                     cherry ..cherry
4955
4956              See also: $sidebar_delim_chars,  $sidebar_folder_indent,  $side‐
4957              bar_indent_string.
4958
4959
4960
4961       sidebar_sort_method
4962              Type: sort order
4963              Default: unsorted
4964
4965              Specifies  how  to  sort mailbox entries in the sidebar.  By de‐
4966              fault, the entries are sorted alphabetically.  Valid values:
4967              ‐ alpha (alphabetically)
4968              ‐ count (all message count)
4969              ‐ flagged (flagged message count)
4970              ‐ name (alphabetically)
4971              ‐ new (unread message count)
4972              ‐ path (alphabetically)
4973              ‐ unread (unread message count)
4974              ‐ unsorted
4975
4976              You may optionally use the “reverse-” prefix to specify  reverse
4977              sorting  order  (example:  “set  sidebar_sort_method=reverse-al‐
4978              pha”).
4979
4980
4981
4982       sidebar_use_mailbox_shortcuts
4983              Type: boolean
4984              Default: no
4985
4986              When set, sidebar  mailboxes  will  be  displayed  with  mailbox
4987              shortcut prefixes ”=” or ”~”.
4988
4989              When  unset, the sidebar will trim off a matching $folder prefix
4990              but otherwise not use mailbox shortcuts.
4991
4992
4993
4994       sidebar_visible
4995              Type: boolean
4996              Default: no
4997
4998              This specifies whether or not to show sidebar. The sidebar shows
4999              a list of all your mailboxes.
5000
5001              See also: $sidebar_format, $sidebar_width
5002
5003
5004
5005       sidebar_width
5006              Type: number
5007              Default: 30
5008
5009              This  controls  the  width  of  the  sidebar.  It is measured in
5010              screen columns.  For example: sidebar_width=20 could display  20
5011              ASCII characters, or 10 Chinese characters.
5012
5013
5014
5015       sig_dashes
5016              Type: boolean
5017              Default: yes
5018
5019              If  set,  a line containing “-- ” (note the trailing space) will
5020              be inserted before your $signature.  It is strongly  recommended
5021              that  you not unset this variable unless your signature contains
5022              just your name.  The reason for this is  because  many  software
5023              packages  use  “--  \n”  to detect your signature.  For example,
5024              Mutt has the ability to highlight the signature in  a  different
5025              color in the built-in pager.
5026
5027
5028
5029       sig_on_top
5030              Type: boolean
5031              Default: no
5032
5033              If set, the signature will be included before any quoted or for‐
5034              warded text.  It is strongly recommended that  you  do  not  set
5035              this variable unless you really know what you are doing, and are
5036              prepared to take some heat from netiquette guardians.
5037
5038
5039
5040       signature
5041              Type: path
5042              Default: “~/.signature”
5043
5044              Specifies the filename of your signature, which is  appended  to
5045              all outgoing messages.   If the filename ends with a pipe (“|”),
5046              it is assumed that filename is a shell command and input  should
5047              be read from its standard output.
5048
5049
5050
5051       simple_search
5052              Type: string
5053              Default: “~f %s | ~s %s”
5054
5055              Specifies  how  Mutt  should  expand a simple search into a real
5056              search pattern.  A simple search is one that  does  not  contain
5057              any  of  the “~” pattern modifiers.  See “patterns” for more in‐
5058              formation on search patterns.
5059
5060              For example, if you simply type  “joe”  at  a  search  or  limit
5061              prompt, Mutt will automatically expand it to the value specified
5062              by this variable by replacing “%s”  with  the  supplied  string.
5063              For  the default value, “joe” would be expanded to: “~f joe | ~s
5064              joe”.
5065
5066
5067
5068       size_show_bytes
5069              Type: boolean
5070              Default: no
5071
5072              If set, message sizes will display bytes for values less than  1
5073              kilobyte.  See formatstrings-size.
5074
5075
5076
5077       size_show_fractions
5078              Type: boolean
5079              Default: yes
5080
5081              If  set,  message  sizes will be displayed with a single decimal
5082              value for sizes from 0 to 10 kilobytes and 1  to  10  megabytes.
5083              See formatstrings-size.
5084
5085
5086
5087       size_show_mb
5088              Type: boolean
5089              Default: yes
5090
5091              If  set, message sizes will display megabytes for values greater
5092              than or equal to 1 megabyte.  See formatstrings-size.
5093
5094
5095
5096       size_units_on_left
5097              Type: boolean
5098              Default: no
5099
5100              If set, message sizes units will be displayed to the left of the
5101              number.  See formatstrings-size.
5102
5103
5104
5105       sleep_time
5106              Type: number
5107              Default: 1
5108
5109              Specifies  time,  in  seconds, to pause while displaying certain
5110              informational messages, while moving from folder to  folder  and
5111              after  expunging  messages from the current folder.  The default
5112              is to pause one second, so a value of zero for this option  sup‐
5113              presses the pause.
5114
5115
5116
5117       smart_wrap
5118              Type: boolean
5119              Default: yes
5120
5121              Controls  the  display  of lines longer than the screen width in
5122              the internal pager. If set, long lines are  wrapped  at  a  word
5123              boundary.   If  unset,  lines  are  simply wrapped at the screen
5124              edge. Also see the $markers variable.
5125
5126
5127
5128       smileys
5129              Type: regular expression
5130              Default: “(>From )|(:[-^]?[][)(><}{|/DP])”
5131
5132              The pager uses this variable to catch some  common  false  posi‐
5133              tives  of $quote_regexp, most notably smileys and not consider a
5134              line quoted text if it also matches $smileys. This  mostly  hap‐
5135              pens at the beginning of a line.
5136
5137
5138
5139       smime_ask_cert_label
5140              Type: boolean
5141              Default: yes
5142
5143              This flag controls whether you want to be asked to enter a label
5144              for a certificate about to be added to the database or  not.  It
5145              is set by default.  (S/MIME only)
5146
5147
5148
5149       smime_ca_location
5150              Type: path
5151              Default: “”
5152
5153              This variable contains the name of either a directory, or a file
5154              which  contains  trusted  certificates  for  use  with  OpenSSL.
5155              (S/MIME only)
5156
5157
5158
5159       smime_certificates
5160              Type: path
5161              Default: “”
5162
5163              Since  for  S/MIME there is no pubring/secring as with PGP, mutt
5164              has to handle storage and retrieval of keys by itself.  This  is
5165              very  basic  right  now, and keys and certificates are stored in
5166              two different directories, both  named  as  the  hash-value  re‐
5167              trieved  from  OpenSSL.  There  is  an index file which contains
5168              mailbox-address keyid pairs, and which can be  manually  edited.
5169              This option points to the location of the certificates.  (S/MIME
5170              only)
5171
5172
5173
5174       smime_decrypt_command
5175              Type: string
5176              Default: “”
5177
5178              This format string specifies a command which is used to  decrypt
5179              application/x-pkcs7-mime attachments.
5180
5181              The OpenSSL command formats have their own set of printf(3)-like
5182              sequences similar to PGP's:
5183              %f     Expands to the name of a file containing a message.
5184              %s     Expands to the name of a file  containing  the  signature
5185                     part
5186                                of  a multipart/signed attachment when verify‐
5187                     ing it.
5188              %k     The key-pair specified with $smime_default_key
5189              %c     One or more certificate IDs.
5190              %a     The algorithm used for encryption.
5191              %d     The   message    digest    algorithm    specified    with
5192                     $smime_sign_digest_alg.
5193              %C     CA location:  Depending on whether $smime_ca_location
5194                                points to a directory or file, this expands to
5195                                “-CApath   $smime_ca_location”   or   “-CAfile
5196                     $smime_ca_location”.
5197
5198              For examples on how to configure these formats, see the smime.rc
5199              in  the  samples/  subdirectory which has been installed on your
5200              system alongside the documentation.  (S/MIME only)
5201
5202
5203
5204       smime_decrypt_use_default_key
5205              Type: boolean
5206              Default: yes
5207
5208              If set (default) this tells mutt to use the default key for  de‐
5209              cryption. Otherwise, if managing multiple certificate-key-pairs,
5210              mutt will try to use the mailbox-address to determine the key to
5211              use.  It  will  ask  you  to supply a key, if it can't find one.
5212              (S/MIME only)
5213
5214
5215
5216       smime_default_key
5217              Type: string
5218              Default: “”
5219
5220              This is the default key-pair to use for S/MIME  operations,  and
5221              must be set to the keyid (the hash-value that OpenSSL generates)
5222              to work properly.
5223
5224              It will  be  used  for  encryption  (see  $postpone_encrypt  and
5225              $smime_self_encrypt).  If  GPGME  is enabled, this is the key id
5226              displayed by gpgsm.
5227
5228              It will be used  for  decryption  unless  $smime_decrypt_use_de‐
5229              fault_key is unset.
5230
5231              It will also be used for signing unless $smime_sign_as is set.
5232
5233              The  (now deprecated) smime_self_encrypt_as is an alias for this
5234              variable, and should no longer be used.  (S/MIME only)
5235
5236
5237
5238       smime_encrypt_command
5239              Type: string
5240              Default: “”
5241
5242              This command is used to create encrypted S/MIME messages.
5243
5244              This is a format string, see the $smime_decrypt_command  command
5245              for possible printf(3)-like sequences.  (S/MIME only)
5246
5247
5248
5249       smime_encrypt_with
5250              Type: string
5251              Default: “aes256”
5252
5253              This  sets  the  algorithm  that  should be used for encryption.
5254              Valid choices are “aes128”, “aes192”, “aes256”,  “des”,  “des3”,
5255              “rc2-40”, “rc2-64”, “rc2-128”.  (S/MIME only)
5256
5257
5258
5259       smime_get_cert_command
5260              Type: string
5261              Default: “”
5262
5263              This  command  is used to extract X509 certificates from a PKCS7
5264              structure.
5265
5266              This is a format string, see the $smime_decrypt_command  command
5267              for possible printf(3)-like sequences.  (S/MIME only)
5268
5269
5270
5271       smime_get_cert_email_command
5272              Type: string
5273              Default: “”
5274
5275              This  command  is  used to extract the mail address(es) used for
5276              storing X509 certificates, and  for  verification  purposes  (to
5277              check  whether the certificate was issued for the sender's mail‐
5278              box).
5279
5280              This is a format string, see the $smime_decrypt_command  command
5281              for possible printf(3)-like sequences.  (S/MIME only)
5282
5283
5284
5285       smime_get_signer_cert_command
5286              Type: string
5287              Default: “”
5288
5289              This  command  is used to extract only the signers X509 certifi‐
5290              cate from a S/MIME signature, so that  the  certificate's  owner
5291              may get compared to the email's “From:” field.
5292
5293              This  is a format string, see the $smime_decrypt_command command
5294              for possible printf(3)-like sequences.  (S/MIME only)
5295
5296
5297
5298       smime_import_cert_command
5299              Type: string
5300              Default: “”
5301
5302              This command is used to import a certificate via smime_keys.
5303
5304              This is a format string, see the $smime_decrypt_command  command
5305              for possible printf(3)-like sequences.  (S/MIME only)
5306
5307
5308
5309       smime_is_default
5310              Type: boolean
5311              Default: no
5312
5313              The  default behavior of mutt is to use PGP on all auto-sign/en‐
5314              cryption operations. To override and to use OpenSSL instead this
5315              must  be set.  However, this has no effect while replying, since
5316              mutt will automatically select the  same  application  that  was
5317              used  to  sign/encrypt  the  original  message.  (Note that this
5318              variable  can  be  overridden  by  unsetting  $crypt_autosmime.)
5319              (S/MIME only)
5320
5321
5322
5323       smime_keys
5324              Type: path
5325              Default: “”
5326
5327              Since  for  S/MIME there is no pubring/secring as with PGP, mutt
5328              has to handle storage and retrieval  of  keys/certs  by  itself.
5329              This  is  very basic right now, and stores keys and certificates
5330              in two different directories, both named as the  hash-value  re‐
5331              trieved  from  OpenSSL.  There  is  an index file which contains
5332              mailbox-address keyid pair, and which can  be  manually  edited.
5333              This option points to the location of the private keys.  (S/MIME
5334              only)
5335
5336
5337
5338       smime_pk7out_command
5339              Type: string
5340              Default: “”
5341
5342              This command is used to extract PKCS7 structures of S/MIME  sig‐
5343              natures, in order to extract the public X509 certificate(s).
5344
5345              This  is a format string, see the $smime_decrypt_command command
5346              for possible printf(3)-like sequences.  (S/MIME only)
5347
5348
5349
5350       smime_self_encrypt
5351              Type: boolean
5352              Default: yes
5353
5354              When set, S/MIME encrypted messages will also be encrypted using
5355              the certificate in $smime_default_key.  (S/MIME only)
5356
5357
5358
5359       smime_sign_as
5360              Type: string
5361              Default: “”
5362
5363              If  you  have  a separate key to use for signing, you should set
5364              this to the signing key. Most  people  will  only  need  to  set
5365              $smime_default_key.  (S/MIME only)
5366
5367
5368
5369       smime_sign_command
5370              Type: string
5371              Default: “”
5372
5373              This command is used to created S/MIME signatures of type multi‐
5374              part/signed, which can be read by all mail clients.
5375
5376              This is a format string, see the $smime_decrypt_command  command
5377              for possible printf(3)-like sequences.  NOTE: %c and %k will de‐
5378              fault to $smime_sign_as if  set,  otherwise  $smime_default_key.
5379              (S/MIME only)
5380
5381
5382
5383       smime_sign_digest_alg
5384              Type: string
5385              Default: “sha256”
5386
5387              This  sets  the  algorithm that should be used for the signature
5388              message digest.  Valid  choices  are  “md5”,  “sha1”,  “sha224”,
5389              “sha256”, “sha384”, “sha512”.  (S/MIME only)
5390
5391
5392
5393       smime_sign_opaque_command
5394              Type: string
5395              Default: “”
5396
5397              This command is used to created S/MIME signatures of type appli‐
5398              cation/x-pkcs7-signature, which can  only  be  handled  by  mail
5399              clients supporting the S/MIME extension.
5400
5401              This  is a format string, see the $smime_decrypt_command command
5402              for possible printf(3)-like sequences.  (S/MIME only)
5403
5404
5405
5406       smime_timeout
5407              Type: number (long)
5408              Default: 300
5409
5410              The number of seconds after which a cached passphrase  will  ex‐
5411              pire if not used.  (S/MIME only)
5412
5413
5414
5415       smime_verify_command
5416              Type: string
5417              Default: “”
5418
5419              This  command is used to verify S/MIME signatures of type multi‐
5420              part/signed.
5421
5422              This is a format string, see the $smime_decrypt_command  command
5423              for possible printf(3)-like sequences.  (S/MIME only)
5424
5425
5426
5427       smime_verify_opaque_command
5428              Type: string
5429              Default: “”
5430
5431              This  command is used to verify S/MIME signatures of type appli‐
5432              cation/x-pkcs7-mime.
5433
5434              This is a format string, see the $smime_decrypt_command  command
5435              for possible printf(3)-like sequences.  (S/MIME only)
5436
5437
5438
5439       smtp_authenticators
5440              Type: string
5441              Default: “”
5442
5443              This  is  a  colon-delimited list of authentication methods mutt
5444              may attempt to use to log in to an SMTP  server,  in  the  order
5445              mutt should try them.  Authentication methods are any SASL mech‐
5446              anism, e.g.  “digest-md5”, “gssapi” or “cram-md5”.  This  option
5447              is  case-insensitive.  If  it is “unset” (the default) mutt will
5448              try  all  available  methods,  in  order  from  most-secure   to
5449              least-secure.
5450
5451              Example:
5452
5453
5454              set smtp_authenticators=”digest-md5:cram-md5”
5455
5456
5457
5458
5459       smtp_oauth_refresh_command
5460              Type: string
5461              Default: “”
5462
5463              The command to run to generate an OAUTH refresh token for autho‐
5464              rizing your connection to your SMTP server.  This  command  will
5465              be run on every connection attempt that uses the OAUTHBEARER au‐
5466              thentication mechanism.  See “oauth” for details.
5467
5468
5469
5470       smtp_pass
5471              Type: string
5472              Default: “”
5473
5474              Specifies the password for your SMTP account.   If  unset,  Mutt
5475              will  prompt  you for your password when you first send mail via
5476              SMTP.  See $smtp_url to configure mutt to send mail via SMTP.
5477
5478              Warning: you should only use this  option  when  you  are  on  a
5479              fairly  secure machine, because the superuser can read your mut‐
5480              trc even if you are the only one who can read the file.
5481
5482
5483
5484       smtp_url
5485              Type: string
5486              Default: “”
5487
5488              Defines the SMTP smarthost where sent  messages  should  relayed
5489              for delivery. This should take the form of an SMTP URL, e.g.:
5490
5491
5492              smtp[s]://[user[:pass]@]host[:port]
5493
5494
5495              where  “[...]”  denotes an optional part.  Setting this variable
5496              overrides the value of the $sendmail variable.
5497
5498              Also see $write_bcc.
5499
5500
5501
5502       sort
5503              Type: sort order
5504              Default: date
5505
5506              Specifies how to sort messages in the “index” menu.  Valid  val‐
5507              ues are:
5508              ‐ date or date-sent
5509              ‐ date-received
5510              ‐ from
5511              ‐ mailbox-order (unsorted)
5512              ‐ score
5513              ‐ size
5514              ‐ spam
5515              ‐ subject
5516              ‐ threads
5517              ‐ to
5518
5519              You  may optionally use the “reverse-” prefix to specify reverse
5520              sorting order (example: “set sort=reverse-date-sent”).
5521
5522
5523
5524       sort_alias
5525              Type: sort order
5526              Default: alias
5527
5528              Specifies how the entries in the “alias” menu are  sorted.   The
5529              following are legal values:
5530              ‐ address (sort alphabetically by email address)
5531              ‐ alias (sort alphabetically by alias name)
5532              ‐ unsorted (leave in order specified in .muttrc)
5533
5534
5535       sort_aux
5536              Type: sort order
5537              Default: date
5538
5539              This provides a secondary sort for messages in the “index” menu,
5540              used when the $sort value is equal for two messages.
5541
5542              When sorting by threads, this variable controls how threads  are
5543              sorted in relation to other threads, and how the branches of the
5544              thread trees are sorted.  This can be  set  to  any  value  that
5545              $sort  can,  except  “threads” (in that case, mutt will just use
5546              “date-sent”).  You can also specify the “last-” prefix in  addi‐
5547              tion  to the “reverse-” prefix, but “last-” must come after “re‐
5548              verse-”.  The  “last-”  prefix  causes  messages  to  be  sorted
5549              against its siblings by which has the last descendant, using the
5550              rest of $sort_aux as an ordering.  For instance,
5551
5552
5553              set sort_aux=last-date-received
5554
5555
5556              would mean that if a new message is received in a  thread,  that
5557              thread becomes the last one displayed (or the first, if you have
5558set sort=reverse-threads”.)
5559
5560              Note: For reversed-threads $sort order,  $sort_aux  is  reversed
5561              again (which is not the right thing to do, but kept to not break
5562              any existing configuration setting).
5563
5564
5565
5566       sort_browser
5567              Type: sort order
5568              Default: alpha
5569
5570              Specifies how to sort entries in the file browser.  By  default,
5571              the entries are sorted alphabetically.  Valid values:
5572              ‐ alpha (alphabetically)
5573              ‐ count
5574              ‐ date
5575              ‐ size
5576              ‐ unread
5577              ‐ unsorted
5578
5579              You  may optionally use the “reverse-” prefix to specify reverse
5580              sorting order (example: “set sort_browser=reverse-date”).
5581
5582
5583
5584       sort_browser_mailboxes
5585              Type: sort order
5586              Default: unsorted
5587
5588              Specifies how to sort entries in the mailbox  browser.   By  de‐
5589              fault,  the entries are unsorted, displayed in the same order as
5590              listed in the “mailboxes” command.  Valid values:
5591              ‐ alpha (alphabetically)
5592              ‐ count
5593              ‐ date
5594              ‐ size
5595              ‐ unread
5596              ‐ unsorted
5597
5598              You may optionally use the “reverse-” prefix to specify  reverse
5599              sorting  order (example: “set sort_browser_mailboxes=reverse-al‐
5600              pha”).
5601
5602
5603
5604       sort_re
5605              Type: boolean
5606              Default: yes
5607
5608              This variable is  only  useful  when  sorting  by  threads  with
5609              $strict_threads  unset.   In that case, it changes the heuristic
5610              mutt uses to thread messages by  subject.   With  $sort_re  set,
5611              mutt  will only attach a message as the child of another message
5612              by subject if the subject of the child  message  starts  with  a
5613              substring  matching the setting of $reply_regexp.  With $sort_re
5614              unset, mutt will attach the message whether or not this  is  the
5615              case,  as  long  as the non-$reply_regexp parts of both messages
5616              are identical.
5617
5618
5619
5620       spam_separator
5621              Type: string
5622              Default: “,”
5623
5624              This variable controls what happens when multiple  spam  headers
5625              are matched: if unset, each successive header will overwrite any
5626              previous matches value for the spam label. If set, each  succes‐
5627              sive  match  will  append to the previous, using this variable's
5628              value as a separator.
5629
5630
5631
5632       spoolfile
5633              Type: path
5634              Default: “”
5635
5636              If your spool mailbox is in a non-default place where Mutt  can‐
5637              not  find  it,  you can specify its location with this variable.
5638              Mutt will initially set this variable to the value of the  envi‐
5639              ronment variable $MAIL or $MAILDIR if either is defined.
5640
5641
5642
5643       ssl_ca_certificates_file
5644              Type: path
5645              Default: “/etc/ssl/certs/ca-bundle.crt”
5646
5647              This  variable  specifies  a file containing trusted CA certifi‐
5648              cates.  Any server certificate that is signed with one of  these
5649              CA certificates is also automatically accepted. (GnuTLS only)
5650
5651              Example:
5652
5653
5654              set ssl_ca_certificates_file=/etc/ssl/certs/ca-certificates.crt
5655
5656
5657
5658
5659       ssl_client_cert
5660              Type: path
5661              Default: “”
5662
5663              The file containing a client certificate and its associated pri‐
5664              vate key.
5665
5666
5667
5668       ssl_force_tls
5669              Type: boolean
5670              Default: yes
5671
5672              If this variable is set, Mutt will require that all  connections
5673              to  remote  servers be encrypted. Furthermore it will attempt to
5674              negotiate TLS even if the server does not advertise the capabil‐
5675              ity,  since it would otherwise have to abort the connection any‐
5676              way. This option supersedes $ssl_starttls.
5677
5678
5679
5680       ssl_min_dh_prime_bits
5681              Type: number
5682              Default: 0
5683
5684              This variable specifies the minimum acceptable  prime  size  (in
5685              bits)  for  use in any Diffie-Hellman key exchange. A value of 0
5686              will use the default from the GNUTLS library. (GnuTLS only)
5687
5688
5689
5690       ssl_starttls
5691              Type: quadoption
5692              Default: yes
5693
5694              If set (the default), mutt  will  attempt  to  use  STARTTLS  on
5695              servers  advertising  the  capability. When unset, mutt will not
5696              attempt to use STARTTLS regardless of the server's capabilities.
5697
5698              Note that STARTTLS is subject to many kinds of attacks,  includ‐
5699              ing  the  ability of a machine-in-the-middle to suppress the ad‐
5700              vertising of support.  Setting $ssl_force_tls is recommended  if
5701              you rely on STARTTLS.
5702
5703
5704
5705       ssl_use_sslv2
5706              Type: boolean
5707              Default: no
5708
5709              If  set  ,  Mutt  will use SSLv2 when communicating with servers
5710              that request it. N.B. As of 2011, SSLv2 is considered  insecure,
5711              and          using          is          inadvisable.         See
5712              https://tools.ietf.org/html/rfc6176 .  (OpenSSL only)
5713
5714
5715
5716       ssl_use_sslv3
5717              Type: boolean
5718              Default: no
5719
5720              If set , Mutt will use SSLv3  when  communicating  with  servers
5721              that  request it. N.B. As of 2015, SSLv3 is considered insecure,
5722              and       using       it       is        inadvisable.        See
5723              https://tools.ietf.org/html/rfc7525 .
5724
5725
5726
5727       ssl_use_tlsv1
5728              Type: boolean
5729              Default: no
5730
5731              If  set  , Mutt will use TLSv1.0 when communicating with servers
5732              that request it. N.B. As of 2015, TLSv1.0  is  considered  inse‐
5733              cure,      and      using     it     is     inadvisable.     See
5734              https://tools.ietf.org/html/rfc7525 .
5735
5736
5737
5738       ssl_use_tlsv1_1
5739              Type: boolean
5740              Default: no
5741
5742              If set , Mutt will use TLSv1.1 when communicating  with  servers
5743              that  request  it.  N.B. As of 2015, TLSv1.1 is considered inse‐
5744              cure,     and     using     it     is      inadvisable.      See
5745              https://tools.ietf.org/html/rfc7525 .
5746
5747
5748
5749       ssl_use_tlsv1_2
5750              Type: boolean
5751              Default: yes
5752
5753              If  set  , Mutt will use TLSv1.2 when communicating with servers
5754              that request it.
5755
5756
5757
5758       ssl_use_tlsv1_3
5759              Type: boolean
5760              Default: yes
5761
5762              If set , Mutt will use TLSv1.3 when communicating  with  servers
5763              that request it.
5764
5765
5766
5767       ssl_usesystemcerts
5768              Type: boolean
5769              Default: yes
5770
5771              If  set to yes, mutt will use CA certificates in the system-wide
5772              certificate store when  checking  if  a  server  certificate  is
5773              signed by a trusted CA. (OpenSSL only)
5774
5775
5776
5777       ssl_verify_dates
5778              Type: boolean
5779              Default: yes
5780
5781              If  set  (the  default),  mutt  will  not automatically accept a
5782              server certificate that is either not yet valid or  already  ex‐
5783              pired.  You  should  only unset this for particular known hosts,
5784              using the <account-hook> function.
5785
5786
5787
5788       ssl_verify_host
5789              Type: boolean
5790              Default: yes
5791
5792              If set (the default),  mutt  will  not  automatically  accept  a
5793              server  certificate whose host name does not match the host used
5794              in your folder URL. You should only unset  this  for  particular
5795              known hosts, using the <account-hook> function.
5796
5797
5798
5799       ssl_verify_host_override
5800              Type: string
5801              Default: “”
5802
5803              Defines  an alternate host name to verify the server certificate
5804              against.  This should not be set unless you are  sure  what  you
5805              are  doing,  but  it  might be useful for connection to a .onion
5806              host without a properly configured host name in the certificate.
5807              See $ssl_verify_host.
5808
5809
5810
5811       ssl_verify_partial_chains
5812              Type: boolean
5813              Default: no
5814
5815              This  option  should  not be changed from the default unless you
5816              understand what you are doing.
5817
5818              Setting this variable to yes will permit verifying partial  cer‐
5819              tification chains, i. e. a certificate chain where not the root,
5820              but an intermediate certificate CA, or the host certificate, are
5821              marked  trusted (in $certificate_file), without marking the root
5822              signing CA as trusted.
5823
5824              (OpenSSL 1.0.2b and newer only).
5825
5826
5827
5828       ssl_ciphers
5829              Type: string
5830              Default: “@SYSTEM”
5831
5832              Contains a colon-separated list of ciphers  to  use  when  using
5833              SSL.  For OpenSSL, see ciphers(1) for the syntax of the string.
5834
5835              For GnuTLS, this option will be used in place of ”NORMAL” at the
5836              start of the priority string.  See  gnutls_priority_init(3)  for
5837              the  syntax  and  more  details.  (Note: GnuTLS version 2.1.7 or
5838              higher is required.)
5839
5840
5841
5842       status_chars
5843              Type: string
5844              Default: “-*%A”
5845
5846              Controls the characters used by  the  “%r”  indicator  in  $sta‐
5847              tus_format.  The first character is used when the mailbox is un‐
5848              changed. The second is used when the mailbox has  been  changed,
5849              and  it  needs  to  be  resynchronized. The third is used if the
5850              mailbox is in read-only mode, or if  the  mailbox  will  not  be
5851              written  when  exiting  that  mailbox (You can toggle whether to
5852              write changes to a mailbox with  the  <toggle-write>  operation,
5853              bound  by  default  to “%”). The fourth is used to indicate that
5854              the current folder has been opened in attach- message mode (Cer‐
5855              tain operations like composing a new mail, replying, forwarding,
5856              etc. are not permitted in this mode).
5857
5858
5859
5860       status_format
5861              Type: string (localized)
5862              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?%?B? Back:%B?%?l? %l?]---(%s/%S)-%>-(%P)---”
5863
5864              Controls the format of the status line displayed in the  “index”
5865              menu.   This string is similar to $index_format, but has its own
5866              set of printf(3)-like sequences:
5867              %b     number of mailboxes with new mail *
5868              %B     number of backgrounded editing sessions *
5869              %d     number of deleted messages *
5870              %f     the full pathname of the current mailbox
5871              %F     number of flagged messages *
5872              %h     local hostname
5873              %l     size (in bytes)  of  the  current  mailbox  (see  format‐
5874                     strings-size) *
5875              %L     size  (in bytes) of the messages shown (i.e., which match
5876                     the current limit) (see formatstrings-size) *
5877              %m     the number of messages in the mailbox *
5878              %M     the number of messages shown (i.e., which match the  cur‐
5879                     rent limit) *
5880              %n     number of new messages in the mailbox *
5881              %o     number of old unread messages *
5882              %p     number of postponed messages *
5883              %P     percentage of the way through the index
5884              %r     modified/read-only/won't-write/attach-message  indicator,
5885                     according to $status_chars
5886              %R     number of read messages *
5887              %s     current sorting mode ($sort)
5888              %S     current aux sorting method ($sort_aux)
5889              %t     number of tagged messages *
5890              %u     number of unread messages *
5891              %v     Mutt version string
5892              %V     currently active limit pattern, if any *
5893              %>X    right justify the rest of the string and pad with “X”
5894              %|X    pad to the end of the line with “X”
5895              %*X    soft-fill with character “X” as pad
5896
5897              For an explanation of “soft-fill”, see the  $index_format  docu‐
5898              mentation.
5899
5900              * = can be optionally printed if nonzero
5901
5902              Some  of  the  above sequences can be used to optionally print a
5903              string if their value is nonzero.  For  example,  you  may  only
5904              want  to see the number of flagged messages if such messages ex‐
5905              ist, since zero is not particularly meaningful.   To  optionally
5906              print  a  string based upon one of the above sequences, the fol‐
5907              lowing construct is used:
5908
5909              %?<sequence_char>?<optional_string>?
5910
5911              where sequence_char is a character from the table above, and op‐
5912              tional_string  is  the  string  you  would  like  printed if se‐
5913              quence_char is nonzero.  optional_string may contain  other  se‐
5914              quences  as  well  as normal text, but you may not nest optional
5915              strings.
5916
5917              Here is an example illustrating how to optionally print the num‐
5918              ber of new messages in a mailbox:
5919
5920              %?n?%n new messages.?
5921
5922              You can also switch between two strings using the following con‐
5923              struct:
5924
5925              %?<sequence_char>?<if_string>&<else_string>?
5926
5927              If the value of sequence_char is non-zero, if_string will be ex‐
5928              panded, otherwise else_string will be expanded.
5929
5930              You  can  force  the result of any printf(3)-like sequence to be
5931              lowercase by prefixing the sequence character with an underscore
5932              (“_”) sign.  For example, if you want to display the local host‐
5933              name in lowercase, you would use: “%_h”.
5934
5935              If you prefix the sequence character with a colon (“:”)  charac‐
5936              ter, mutt will replace any dots in the expansion by underscores.
5937              This might be helpful with IMAP folders that don't like dots  in
5938              folder names.
5939
5940
5941
5942       status_on_top
5943              Type: boolean
5944              Default: no
5945
5946              Setting this variable causes the “status bar” to be displayed on
5947              the first line of the screen rather than  near  the  bottom.  If
5948              $help is set, too it'll be placed at the bottom.
5949
5950
5951
5952       strict_threads
5953              Type: boolean
5954              Default: no
5955
5956              If  set,  threading  will only make use of the “In-Reply-To” and
5957              “References:” fields when you $sort by message threads.  By  de‐
5958              fault,  messages  with  the same subject are grouped together in
5959              “pseudo threads.”. This may not always be desirable, such as  in
5960              a  personal  mailbox where you might have several unrelated mes‐
5961              sages with the subjects like “hi” which  will  get  grouped  to‐
5962              gether.  See also $sort_re for a less drastic way of controlling
5963              this behavior.
5964
5965
5966
5967       suspend
5968              Type: boolean
5969              Default: yes
5970
5971              When unset, mutt won't stop when the user presses the terminal's
5972              susp key, usually “^Z”. This is useful if you run mutt inside an
5973              xterm using a command like “xterm -e mutt”.
5974
5975
5976
5977       text_flowed
5978              Type: boolean
5979              Default: no
5980
5981              When set, mutt will generate “format=flowed” bodies with a  con‐
5982              tent type of “text/plain; format=flowed”.  This format is easier
5983              to handle for some mailing software, and  generally  just  looks
5984              like  ordinary text.  To actually make use of this format's fea‐
5985              tures, you'll need support in your editor.
5986
5987              The option only controls  newly  composed  messages.   Postponed
5988              messages,  resent  messages,  and  draft messages (via -H on the
5989              command line) will use the content-type of the source message.
5990
5991              Note that $indent_string is ignored when this option is set.
5992
5993
5994
5995       thorough_search
5996              Type: boolean
5997              Default: yes
5998
5999              Affects the ~b, ~B, and ~h search operations described  in  sec‐
6000              tion  “patterns”.   If  set, the headers and body/attachments of
6001              messages to be searched are decoded before searching. If  unset,
6002              messages are searched as they appear in the folder.
6003
6004              Users  searching  attachments or for non-ASCII characters should
6005              set this value because decoding also includes  MIME  parsing/de‐
6006              coding  and  possible  character set conversions. Otherwise mutt
6007              will attempt to match against the raw message received (for  ex‐
6008              ample  quoted-printable  encoded  or with encoded headers) which
6009              may lead to incorrect search results.
6010
6011
6012
6013       thread_received
6014              Type: boolean
6015              Default: no
6016
6017              When set, mutt uses the date received rather than the date  sent
6018              to thread messages by subject.
6019
6020
6021
6022       tilde
6023              Type: boolean
6024              Default: no
6025
6026              When  set, the internal-pager will pad blank lines to the bottom
6027              of the screen with a tilde (“~”).
6028
6029
6030
6031       time_inc
6032              Type: number
6033              Default: 0
6034
6035              Along with $read_inc, $write_inc, and  $net_inc,  this  variable
6036              controls  the  frequency  with  which  progress updates are dis‐
6037              played. It suppresses updates less than  $time_inc  milliseconds
6038              apart.  This  can improve throughput on systems with slow termi‐
6039              nals, or when running mutt on a remote system.
6040
6041              Also see the “tuning” section of the manual for performance con‐
6042              siderations.
6043
6044
6045
6046       timeout
6047              Type: number
6048              Default: 600
6049
6050              When Mutt is waiting for user input either idling in menus or in
6051              an interactive prompt, Mutt would block until input is  present.
6052              Depending  on the context, this would prevent certain operations
6053              from working, like checking for new mail or keeping an IMAP con‐
6054              nection alive.
6055
6056              This  variable  controls how many seconds Mutt will at most wait
6057              until it aborts waiting for input, performs these operations and
6058              continues to wait for input.
6059
6060              A value of zero or less will cause Mutt to never time out.
6061
6062
6063
6064       tmpdir
6065              Type: path
6066              Default: “”
6067
6068              This  variable  allows  you to specify where Mutt will place its
6069              temporary files needed for displaying  and  composing  messages.
6070              If this variable is not set, the environment variable $TMPDIR is
6071              used.  If $TMPDIR is not set then “/tmp” is used.
6072
6073
6074
6075       to_chars
6076              Type: string
6077              Default: “ +TCFL”
6078
6079              Controls the character used to indicate mail addressed  to  you.
6080              The  first  character  is  the one used when the mail is not ad‐
6081              dressed to your address.  The second is used when  you  are  the
6082              only  recipient  of the message.  The third is when your address
6083              appears in the “To:” header field, but you are not the only  re‐
6084              cipient  of the message.  The fourth character is used when your
6085              address is specified in the “Cc:” header field, but you are  not
6086              the  only  recipient.   The  fifth character is used to indicate
6087              mail that was sent by you.  The sixth character is used to indi‐
6088              cate when a mail was sent to a mailing-list you subscribe to.
6089
6090
6091
6092       trash
6093              Type: path
6094              Default: “”
6095
6096              If  set,  this  variable  specifies the path of the trash folder
6097              where the mails marked for deletion will be  moved,  instead  of
6098              being irremediably purged.
6099
6100              NOTE:  When  you delete a message in the trash folder, it is re‐
6101              ally deleted, so that you have a way to clean the trash.
6102
6103
6104
6105       ts_icon_format
6106              Type: string (localized)
6107              Default: “M%?n?AIL&ail?”
6108
6109              Controls the format of the icon title, as long as  “$ts_enabled”
6110              is  set.  This string is identical in formatting to the one used
6111              by “$status_format”.
6112
6113
6114
6115       ts_enabled
6116              Type: boolean
6117              Default: no
6118
6119              Controls whether mutt tries to set the terminal status line  and
6120              icon  name.   Most terminal emulators emulate the status line in
6121              the window title.
6122
6123
6124
6125       ts_status_format
6126              Type: string (localized)
6127              Default: “Mutt with %?m?%m messages&no messages?%?n? [%n NEW]?”
6128
6129              Controls the format of the terminal status line (or  window  ti‐
6130              tle),  provided  that “$ts_enabled” has been set. This string is
6131              identical in formatting to the one used by “$status_format”.
6132
6133
6134
6135       tunnel
6136              Type: string
6137              Default: “”
6138
6139              Setting this variable will cause mutt to open a pipe to  a  com‐
6140              mand instead of a raw socket. You may be able to use this to set
6141              up preauthenticated connections to your  IMAP/POP3/SMTP  server.
6142              Example:
6143
6144
6145              set tunnel=”ssh -q mailhost.net /usr/local/libexec/imapd”
6146
6147
6148              Note: For this example to work you must be able to log in to the
6149              remote machine without having to enter a password.
6150
6151              When set, Mutt uses  the  tunnel  for  all  remote  connections.
6152              Please see “account-hook” in the manual for how to use different
6153              tunnel commands per connection.
6154
6155
6156
6157       tunnel_is_secure
6158              Type: boolean
6159              Default: yes
6160
6161              When set, Mutt will assume the $tunnel connection does not  need
6162              STARTTLS  to be enabled.  It will also allow IMAP PREAUTH server
6163              responses inside a tunnel to proceed.  This  is  appropriate  if
6164              $tunnel uses ssh or directly invokes the server locally.
6165
6166              When  unset,  Mutt  will  negotiate  STARTTLS  according  to the
6167              ssl_starttls and ssl_force_tls variables.  If  ssl_force_tls  is
6168              set,  Mutt will abort connecting if an IMAP server responds with
6169              PREAUTH.  This setting is appropriate if $tunnel does  not  pro‐
6170              vide security and could be tampered with by attackers.
6171
6172
6173
6174       uncollapse_jump
6175              Type: boolean
6176              Default: no
6177
6178              When  set,  Mutt  will  jump to the next unread message, if any,
6179              when the current thread is uncollapsed.
6180
6181
6182
6183       uncollapse_new
6184              Type: boolean
6185              Default: yes
6186
6187              When set,  Mutt  will  automatically  uncollapse  any  collapsed
6188              thread  that  receives  a  new  message.  When  unset, collapsed
6189              threads will remain collapsed. the presence of the  new  message
6190              will still affect index sorting, though.
6191
6192
6193
6194       use_8bitmime
6195              Type: boolean
6196              Default: no
6197
6198              Warning: do not set this variable unless you are using a version
6199              of sendmail which supports the -B8BITMIME flag (such as sendmail
6200              8.8.x) or you may not be able to send mail.
6201
6202              When  set,  Mutt  will invoke $sendmail with the -B8BITMIME flag
6203              when sending 8-bit messages to enable ESMTP negotiation.
6204
6205
6206
6207       use_domain
6208              Type: boolean
6209              Default: yes
6210
6211              When set, Mutt will qualify all local  addresses  (ones  without
6212              the  “@host” portion) with the value of $hostname.  If unset, no
6213              addresses will be qualified.
6214
6215
6216
6217       use_envelope_from
6218              Type: boolean
6219              Default: no
6220
6221              When set, mutt will set the envelope sender of the message.   If
6222              $envelope_from_address is set, it will be used as the sender ad‐
6223              dress. If unset, mutt will attempt to derive the sender from the
6224              “From:” header.
6225
6226              Note  that  this information is passed to sendmail command using
6227              the -f command line switch. Therefore setting this option is not
6228              useful  if  the $sendmail variable already contains -f or if the
6229              executable pointed  to  by  $sendmail  doesn't  support  the  -f
6230              switch.
6231
6232
6233
6234       use_from
6235              Type: boolean
6236              Default: yes
6237
6238              When set, Mutt will generate the “From:” header field when send‐
6239              ing messages.  If unset, no “From:” header field will be  gener‐
6240              ated unless the user explicitly sets one using the “my_hdr” com‐
6241              mand.
6242
6243
6244
6245       use_ipv6
6246              Type: boolean
6247              Default: yes
6248
6249              When set, Mutt will look for IPv6 addresses of hosts it tries to
6250              contact.   If this option is unset, Mutt will restrict itself to
6251              IPv4 addresses.  Normally, the default should work.
6252
6253
6254
6255       user_agent
6256              Type: boolean
6257              Default: no
6258
6259              When set, mutt will add a “User-Agent:” header to outgoing  mes‐
6260              sages,  indicating  which version of mutt was used for composing
6261              them.
6262
6263
6264
6265       visual
6266              Type: path
6267              Default: “”
6268
6269              Specifies the visual editor to invoke when the “~v”  command  is
6270              given in the built-in editor.
6271
6272
6273
6274       wait_key
6275              Type: boolean
6276              Default: yes
6277
6278              Controls  whether  Mutt will ask you to press a key after an ex‐
6279              ternal command has been invoked by these  functions:  <shell-es‐
6280              cape>,   <pipe-message>,   <pipe-entry>,   <print-message>,  and
6281              <print-entry> commands.
6282
6283              It is also used when viewing attachments with “auto_view”,  pro‐
6284              vided  that  the corresponding mailcap entry has a needsterminal
6285              flag, and the external program is interactive.
6286
6287              When set, Mutt will always ask for a key. When unset, Mutt  will
6288              wait  for a key only if the external command returned a non-zero
6289              status.
6290
6291
6292
6293       weed
6294              Type: boolean
6295              Default: yes
6296
6297              When set, mutt will weed headers when displaying, forwarding, or
6298              replying to messages.
6299
6300              Also   see   $copy_decode_weed,   $pipe_decode_weed,  $print_de‐
6301              code_weed.
6302
6303
6304
6305       wrap
6306              Type: number
6307              Default: 0
6308
6309              When set to a positive value, mutt will wrap text at $wrap char‐
6310              acters.   When  set  to a negative value, mutt will wrap text so
6311              that there are $wrap characters of empty space on the right side
6312              of  the terminal. Setting it to zero makes mutt wrap at the ter‐
6313              minal width.
6314
6315              Also see $reflow_wrap.
6316
6317
6318
6319       wrap_headers
6320              Type: number
6321              Default: 78
6322
6323              This option specifies the number of characters to use for  wrap‐
6324              ping  an  outgoing message's headers. Allowed values are between
6325              78 and 998 inclusive.
6326
6327              Note: This option usually shouldn't be changed.  RFC5233  recom‐
6328              mends  a  line length of 78 (the default), so please only change
6329              this setting when you know what you're doing.
6330
6331
6332
6333       wrap_search
6334              Type: boolean
6335              Default: yes
6336
6337              Controls whether searches wrap around the end.
6338
6339              When set, searches will wrap around the first  (or  last)  item.
6340              When unset, incremental searches will not wrap.
6341
6342
6343
6344       wrapmargin
6345              Type: number
6346              Default: 0
6347
6348              (DEPRECATED) Equivalent to setting $wrap with a negative value.
6349
6350
6351
6352       write_bcc
6353              Type: boolean
6354              Default: no
6355
6356              Controls  whether mutt writes out the “Bcc:” header when prepar‐
6357              ing messages to be sent.  Some MTAs, such as Exim  and  Courier,
6358              do not strip the “Bcc:” header; so it is advisable to leave this
6359              unset unless you have a particular need for the header to be  in
6360              the sent message.
6361
6362              If  mutt  is  set  to deliver directly via SMTP (see $smtp_url),
6363              this option does nothing: mutt will never write out  the  “Bcc:”
6364              header in this case.
6365
6366              Note  this  option only affects the sending of messages.  Fcc'ed
6367              copies of a message will always contain the “Bcc:” header if one
6368              exists.
6369
6370
6371
6372       write_inc
6373              Type: number
6374              Default: 10
6375
6376              When  writing  a  mailbox,  a  message  will  be  printed  every
6377              $write_inc messages to indicate progress.  If set to 0,  only  a
6378              single message will be displayed before writing a mailbox.
6379
6380              Also see the $read_inc, $net_inc and $time_inc variables and the
6381              “tuning” section of the manual for performance considerations.
6382
6383
6384

SEE ALSO

6386       iconv(1),   iconv(3),   mailcap(5),   maildir(5),   mbox(5),   mutt(1),
6387       printf(3), regex(7), strftime(3)
6388
6389       The Mutt Manual
6390
6391       The Mutt home page: http://www.mutt.org/
6392

AUTHOR

6394       Michael Elkins, and others.  Use <mutt-dev@mutt.org> to contact the de‐
6395       velopers.
6396
6397
6398
6399Unix                             January 2019                        muttrc(5)
Impressum