]> git.madduck.net Git - etc/mutt.git/blob - .config/mutt/confvars

madduck's git repository

Every one of the projects in this repository is available at the canonical URL git://git.madduck.net/madduck/pub/<projectpath> — see each project's metadata for the exact URL.

All patches and comments are welcome. Please squash your changes to logical commits before using git-format-patch and git-send-email to patches@git.madduck.net. If you'd read over the Git project's submission guidelines and adhered to them, I'd be especially grateful.

SSH access, as well as push access can be individually arranged.

If you use my repositories frequently, consider adding the following snippet to ~/.gitconfig and using the third clone URL listed for each project:

[url "git://git.madduck.net/madduck/"]
  insteadOf = madduck:

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