]> 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:

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