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.
1 # Auto-generated using mkconf from manual.txt
2 # on 2019-01-18 23:28:41
4 # Invoked as: ./mkconf confvars
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.
15 set abort_noattach=ask-yes
18 # 3.2. abort_noattach_regexp
20 # Type: regular expression
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
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
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)'
36 # 3.3. abort_nosubject
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.
47 # 3.4. abort_unmodified
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.
61 # Default: “~/.muttrc”
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.
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.
71 # The default for this option is the currently used muttrc file, or “~/.muttrc”
72 # if no user muttrc was found.
74 set alias_file="$my_confdir/aliases"
80 # Default: “%4n %2f %t %-10a %r”
82 # Specifies the format of the data displayed for the “alias” menu. The following
83 # printf(3)-style sequences are available:
85 # ┌──┬──────────────────────────────────────────────────────────────┐
87 # ├──┼──────────────────────────────────────────────────────────────┤
88 # │%f│flags - currently, a “d” for an alias marked for deletion │
89 # ├──┼──────────────────────────────────────────────────────────────┤
91 # ├──┼──────────────────────────────────────────────────────────────┤
92 # │%r│address which alias expands to │
93 # ├──┼──────────────────────────────────────────────────────────────┤
94 # │%t│character which indicates if the alias is tagged for inclusion│
95 # └──┴──────────────────────────────────────────────────────────────┘
104 # Controls whether 8-bit data is converted to 7-bit using either Quoted-
105 # Printable or Base64 encoding when sending mail.
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
120 # [-- PGP output follows ...
122 # and give it the same color as your attachment color (see also $crypt_timestamp
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.
144 # If set, Mutt will use plain ASCII characters when displaying thread and
145 # attachment trees, instead of the default ACS characters.
154 # If set, Mutt will prompt you for blind-carbon-copy (Bcc) recipients before
155 # editing an outgoing message.
164 # If set, Mutt will prompt you for carbon-copy (Cc) recipients before editing the
165 # body of an outgoing message.
169 # 3.13. assumed_charset
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”.
180 # For example, Japanese users might prefer this:
182 # set assumed_charset="iso-2022-jp:euc-jp:shift_jis:utf-8"
184 # However, only the first content is valid for the message body.
188 # 3.14. attach_charset
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
198 # If unset, the value of $charset will be used instead. For example, the
199 # following configuration would work for Japanese text handling:
201 # set attach_charset="iso-2022-jp:euc-jp:shift_jis:utf-8"
203 # Note: for Japanese users, “iso-2022-*” must be put at the head of the value as
204 # shown above if included.
208 # 3.15. attach_format
211 # Default: “%u%D%I %t%4n %T%.40d%> [%.7m/%.10M, %.6e%?C?, %C?, %s] ”
213 # This variable describes the format of the “attachment” menu. The following
214 # printf(3)-style sequences are understood:
216 # ┌───┬─────────────────────────────────────────────────────────────────────────┐
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 # ├───┼─────────────────────────────────────────────────────────────────────────┤
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 # ├───┼─────────────────────────────────────────────────────────────────────────┤
242 # ├───┼─────────────────────────────────────────────────────────────────────────┤
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 # └───┴─────────────────────────────────────────────────────────────────────────┘
259 # For an explanation of “soft-fill”, see the $index_format documentation.
268 # The separator to add between attachments when operating (saving, printing,
269 # piping, etc) on a list of tagged attachments.
278 # If this variable is unset, when operating (saving, printing, piping, etc) on a
279 # list of tagged attachments, Mutt will concatenate the attachments and will
280 # operate on them as a single attachment. The $attach_sep separator is added
281 # after each attachment. When set, Mutt will operate on the attachments one by
289 # Default: “On %d, %n wrote:”
291 # This is the string that will precede a message which has been included in a
292 # reply. For a full listing of defined printf(3)-like sequences see the section
295 set attribution="$my_attribution_en"
298 # 3.19. attribution_locale
303 # The locale used by strftime(3) to format dates in the attribution string. Legal
304 # values are the strings your system accepts for the locale environment variable
307 # This variable is to allow the attribution date format to be customized by
308 # recipient or folder using hooks. By default, Mutt will use your locale
309 # environment, so there is no need to set this except to override that default.
318 # When set, functions in the index menu which affect a message will be applied to
319 # all tagged messages (if there are any). When unset, you must first use the
320 # <tag-prefix> function (bound to “;” by default) to make the next function apply
321 # to all tagged messages.
330 # When set along with $edit_headers, Mutt will skip the initial send-menu
331 # (prompting for subject and recipients) and allow you to immediately begin
332 # editing the body of your message. The send-menu may still be accessed once you
333 # have finished editing the body of your message.
335 # Note: when this option is set, you cannot use send-hooks that depend on the
336 # recipients when composing a new (non-reply) message, as the initial list of
337 # recipients is empty.
339 # Also see $fast_reply.
349 # When this variable is set, mutt will beep when an error occurs.
359 # When this variable is set, mutt will beep whenever it prints a message
360 # notifying you of new mail. This is independent of the setting of the $beep
370 # Controls whether you will be asked to confirm bouncing messages. If set to yes
371 # you don't get asked if you want to bounce a message. Setting this variable to
372 # no is not generally useful, and thus not recommended, because you are unable to
377 # 3.25. bounce_delivered
382 # When this variable is set, mutt will include Delivered-To headers when bouncing
383 # messages. Postfix users may wish to unset this variable.
385 set bounce_delivered=no
388 # 3.26. braille_friendly
393 # When this variable is set, mutt will place the cursor at the beginning of the
394 # current line in menus, even when the $arrow_cursor variable is unset, making it
395 # easier for blind persons using Braille displays to follow these menus. The
396 # option is unset by default because many visual terminals don't permit making
397 # the cursor invisible.
401 # 3.27. browser_abbreviate_mailboxes
406 # When this variable is set, mutt will abbreviate mailbox names in the browser
407 # mailbox list, using '~' and '=' shortcuts.
409 # The default "alpha" setting of $sort_browser uses locale-based sorting (using
410 # strcoll(3)), which ignores some punctuation. This can lead to some situations
411 # where the order doesn't make intuitive sense. In those cases, it may be
412 # desirable to unset this variable.
416 # 3.28. certificate_file
419 # Default: “~/.mutt_certificates”
421 # This variable specifies the file where the certificates you trust are saved.
422 # When an unknown certificate is encountered, you are asked if you accept it or
423 # not. If you accept it, the certificate can also be saved in this file and
424 # further connections are automatically accepted.
426 # You can also manually add CA certificates in this file. Any server certificate
427 # that is signed with one of these CA certificates is also automatically
432 # set certificate_file=~/.mutt/certificates
436 # 3.29. change_folder_next
441 # When this variable is set, the <change-folder> function mailbox suggestion will
442 # start at the next folder in your “mailboxes” list, instead of starting at the
443 # first folder in the list.
452 # Character set your terminal uses to display and enter textual data. It is also
453 # the fallback for $send_charset.
455 # Upon startup Mutt tries to derive this value from environment variables such as
456 # $LC_CTYPE or $LANG.
458 # Note: It should only be set in case Mutt isn't able to determine the character
459 # set used correctly.
463 # 3.31. check_mbox_size
468 # When this variable is set, mutt will use file size attribute instead of access
469 # time when checking for new mail in mbox and mmdf folders.
471 # This variable is unset by default and should only be enabled when new mail
472 # detection for these folder types is unreliable or doesn't work.
474 # Note that enabling this variable should happen before any “mailboxes”
475 # directives occur in configuration files regarding mbox or mmdf folders because
476 # mutt needs to determine the initial new mail status of such a mailbox by
477 # performing a fast mailbox scan when it is defined. Afterwards the new mail
478 # status is tracked by file size changes.
487 # Note: this option only affects maildir and MH style mailboxes.
489 # When set, Mutt will check for new mail delivered while the mailbox is open.
490 # Especially with MH mailboxes, this operation can take quite some time since it
491 # involves scanning the directory and checking each file to see if it has already
492 # been looked at. If this variable is unset, no check for new mail is performed
493 # while the mailbox is open.
497 # 3.33. collapse_unread
502 # When unset, Mutt will not collapse a thread if it contains any unread messages.
506 # 3.34. compose_format
509 # Default: “-- Mutt: Compose [Approx. msg size: %l Atts: %a]%>-”
511 # Controls the format of the status line displayed in the “compose” menu. This
512 # string is similar to $status_format, but has its own set of printf(3)-like
515 # ┌──┬──────────────────────────────────────────────────┐
516 # │%a│total number of attachments │
517 # ├──┼──────────────────────────────────────────────────┤
518 # │%h│local hostname │
519 # ├──┼──────────────────────────────────────────────────┤
520 # │%l│approximate size (in bytes) of the current message│
521 # ├──┼──────────────────────────────────────────────────┤
522 # │%v│Mutt version string │
523 # └──┴──────────────────────────────────────────────────┘
525 # See the text describing the $status_format option for more information on how
526 # to set $compose_format.
530 # 3.35. config_charset
535 # When defined, Mutt will recode commands in rc files from this encoding to the
536 # current character set as specified by $charset and aliases written to
537 # $alias_file from the current character set.
539 # Please note that if setting $charset it must be done before setting
542 # Recoding should be avoided as it may render unconvertable characters as
543 # question marks which can lead to undesired side effects (for example in regular
548 # 3.36. confirmappend
553 # When set, Mutt will prompt for confirmation when appending messages to an
559 # 3.37. confirmcreate
564 # When set, Mutt will prompt for confirmation when saving messages to a mailbox
565 # which does not yet exist before creating it.
569 # 3.38. connect_timeout
574 # Causes Mutt to timeout a network connection (for IMAP, POP or SMTP) after this
575 # many seconds if the connection is not able to be established. A negative value
576 # causes Mutt to wait indefinitely for the connection attempt to succeed.
583 # Default: “text/plain”
585 # Sets the default Content-Type for the body of newly composed messages.
594 # This variable controls whether or not copies of your outgoing messages will be
595 # saved for later references. Also see $record, $save_name, $force_name and “
601 # 3.41. crypt_autoencrypt
606 # Setting this variable will cause Mutt to always attempt to PGP encrypt outgoing
607 # messages. This is probably only useful in connection to the “send-hook”
608 # command. It can be overridden by use of the pgp menu, when encryption is not
609 # required or signing is requested as well. If $smime_is_default is set, then
610 # OpenSSL is used instead to create S/MIME messages and settings can be
611 # overridden by use of the smime menu instead. (Crypto only)
615 # 3.42. crypt_autopgp
620 # This variable controls whether or not mutt may automatically enable PGP
621 # encryption/signing for messages. See also $crypt_autoencrypt,
622 # $crypt_replyencrypt, $crypt_autosign, $crypt_replysign and $smime_is_default.
626 # 3.43. crypt_autosign
631 # Setting this variable will cause Mutt to always attempt to cryptographically
632 # sign outgoing messages. This can be overridden by use of the pgp menu, when
633 # signing is not required or encryption is requested as well. If
634 # $smime_is_default is set, then OpenSSL is used instead to create S/MIME
635 # messages and settings can be overridden by use of the smime menu instead of the
636 # pgp menu. (Crypto only)
638 set crypt_autosign=yes
641 # 3.44. crypt_autosmime
646 # This variable controls whether or not mutt may automatically enable S/MIME
647 # encryption/signing for messages. See also $crypt_autoencrypt,
648 # $crypt_replyencrypt, $crypt_autosign, $crypt_replysign and $smime_is_default.
652 # 3.45. crypt_confirmhook
657 # If set, then you will be prompted for confirmation of keys when using the
658 # crypt-hook command. If unset, no such confirmation prompt will be presented.
659 # This is generally considered unsafe, especially where typos are concerned.
663 # 3.46. crypt_opportunistic_encrypt
668 # Setting this variable will cause Mutt to automatically enable and disable
669 # encryption, based on whether all message recipient keys can be located by Mutt.
671 # When this option is enabled, Mutt will enable/disable encryption each time the
672 # TO, CC, and BCC lists are edited. If $edit_headers is set, Mutt will also do so
673 # each time the message is edited.
675 # While this is set, encryption can't be manually enabled/disabled. The pgp or
676 # smime menus provide a selection to temporarily disable this option for the
679 # If $crypt_autoencrypt or $crypt_replyencrypt enable encryption for a message,
680 # this option will be disabled for that message. It can be manually re-enabled in
681 # the pgp or smime menus. (Crypto only)
685 # 3.47. crypt_replyencrypt
690 # If set, automatically PGP or OpenSSL encrypt replies to messages which are
691 # encrypted. (Crypto only)
695 # 3.48. crypt_replysign
700 # If set, automatically PGP or OpenSSL sign replies to messages which are signed.
702 # Note: this does not work on messages that are encrypted and signed! (Crypto
705 set crypt_replysign=yes
708 # 3.49. crypt_replysignencrypted
713 # If set, automatically PGP or OpenSSL sign replies to messages which are
714 # encrypted. This makes sense in combination with $crypt_replyencrypt, because it
715 # allows you to sign all messages which are automatically encrypted. This works
716 # around the problem noted in $crypt_replysign, that mutt is not able to find out
717 # whether an encrypted message is also signed. (Crypto only)
719 set crypt_replysignencrypted=yes
722 # 3.50. crypt_timestamp
727 # If set, mutt will include a time stamp in the lines surrounding PGP or S/MIME
728 # output, so spoofing such lines is more difficult. If you are using colors to
729 # mark these lines, and rely on these, you may unset this setting. (Crypto only)
733 # 3.51. crypt_use_gpgme
738 # This variable controls the use of the GPGME-enabled crypto backends. If it is
739 # set and Mutt was built with gpgme support, the gpgme code for S/MIME and PGP
740 # will be used instead of the classic code. Note that you need to set this option
741 # in .muttrc; it won't have any effect when used interactively.
743 # Note that the GPGME backend does not support creating old-style inline
744 # (traditional) PGP encrypted or signed messages (see $pgp_autoinline).
748 # 3.52. crypt_use_pka
753 # Controls whether mutt uses PKA (see http://www.g10code.de/docs/
754 # pka-intro.de.pdf) during signature verification (only supported by the GPGME
759 # 3.53. crypt_verify_sig
764 # If “yes”, always attempt to verify PGP or S/MIME signatures. If “ask-*”, ask
765 # whether or not to verify the signature. If “no”, never attempt to verify
766 # cryptographic signatures. (Crypto only)
773 # Default: “!%a, %b %d, %Y at %I:%M:%S%p %Z”
775 # This variable controls the format of the date printed by the “%d” sequence in
776 # $index_format. This is passed to the strftime(3) function to process the date,
777 # see the man page for the proper syntax.
779 # Unless the first character in the string is a bang (“!”), the month and week
780 # day names are expanded according to the locale. If the first character in the
781 # string is a bang, the bang is discarded, and the month and week day names in
782 # the rest of the string are expanded in the C locale (that is in US English).
784 set date_format="%d %b %Y %T%Z"
790 # Default: “~f %s !~P | (~P ~C %s)”
792 # This variable controls how “message-hook”, “reply-hook”, “send-hook”, “
793 # send2-hook”, “save-hook”, and “fcc-hook” will be interpreted if they are
794 # specified with only a simple regexp, instead of a matching pattern. The hooks
795 # are expanded when they are declared, so a hook will be interpreted according to
796 # the value of this variable at the time the hook is declared.
798 # The default value matches if the message is either from a user matching the
799 # regular expression given, or if it is from you (if the from address matches “
800 # alternates”) and is to or cc'ed to a user matching the given regular
810 # Controls whether or not messages are really deleted when closing or
811 # synchronizing a mailbox. If set to yes, messages marked for deleting will
812 # automatically be purged without prompting. If set to no, messages marked for
813 # deletion will be kept in the mailbox.
823 # If this option is set, mutt will untag messages when marking them for deletion.
824 # This applies when you either explicitly delete a message, or when you save it
829 # 3.58. digest_collapse
834 # If this option is set, mutt's received-attachments menu will not show the
835 # subparts of individual messages in a multipart/digest. To see these subparts,
836 # press “v” on that menu.
840 # 3.59. display_filter
845 # When set, specifies a command used to filter messages. When a message is viewed
846 # it is passed as standard input to $display_filter, and the filtered message is
847 # read from the standard output.
851 # 3.60. dotlock_program
854 # Default: “/usr/bin/mutt_dotlock”
856 # Contains the path of the mutt_dotlock(8) binary to be used by mutt.
865 # This variable sets the request for when notification is returned. The string
866 # consists of a comma separated list (no spaces!) of one or more of the
867 # following: never, to never request notification, failure, to request
868 # notification on transmission failure, delay, to be notified of message delays,
869 # success, to be notified of successful transmission.
873 # set dsn_notify="failure,delay"
875 # Note: when using $sendmail for delivery, you should not enable this unless you
876 # are either using Sendmail 8.8.x or greater or a MTA providing a sendmail(1)
877 # -compatible interface supporting the -N option for DSN. For SMTP delivery, DSN
878 # support is auto-detected so that it depends on the server whether DSN will be
888 # This variable controls how much of your message is returned in DSN messages. It
889 # may be set to either hdrs to return just the message header, or full to return
894 # set dsn_return=hdrs
896 # Note: when using $sendmail for delivery, you should not enable this unless you
897 # are either using Sendmail 8.8.x or greater or a MTA providing a sendmail(1)
898 # -compatible interface supporting the -R option for DSN. For SMTP delivery, DSN
899 # support is auto-detected so that it depends on the server whether DSN will be
904 # 3.63. duplicate_threads
909 # This variable controls whether mutt, when $sort is set to threads, threads
910 # messages with the same Message-Id together. If it is set, it will indicate that
911 # it thinks they are duplicates of each other with an equals sign in the thread
921 # This option allows you to edit the header of your outgoing messages along with
922 # the body of your message.
924 # Although the compose menu may have localized header labels, the labels passed
925 # to your editor will be standard RFC 2822 headers, (e.g. To:, Cc:, Subject:).
926 # Headers added in your editor must also be RFC 2822 headers, or one of the
927 # pseudo headers listed in “edit-header”. Mutt will not understand localized
928 # header labels, just as it would not when parsing an actual email.
930 # Note that changes made to the References: and Date: headers are ignored for
931 # interoperability reasons.
941 # This variable specifies which editor is used by mutt. It defaults to the value
942 # of the $VISUAL, or $EDITOR, environment variable, or to the string “vi” if
943 # neither of those are set.
945 # The $editor string may contain a %s escape, which will be replaced by the name
946 # of the file to be edited. If the %s escape does not appear in $editor, a space
947 # and the name to be edited are appended.
949 # The resulting string is then executed by running
953 # where string is the expansion of $editor described above.
955 set editor="mailplate --edit --auto --keep-unknown"
963 # When set, mutt will quoted-printable encode messages when they contain the
964 # string “From ” (note the trailing space) in the beginning of a line. This is
965 # useful to avoid the tampering certain mail delivery and transport agents tend
966 # to do with messages (in order to prevent tools from misinterpreting the line as
967 # a mbox message separator).
976 # The file which includes random data that is used to initialize SSL library
981 # 3.68. envelope_from_address
983 # Type: e-mail address
986 # Manually sets the envelope sender for outgoing messages. This value is ignored
987 # if $use_envelope_from is unset.
991 # 3.69. error_history
996 # This variable controls the size (in number of strings remembered) of the error
997 # messages displayed by mutt. These can be shown with the <error-history>
998 # function. The history is cleared each time this variable is set.
1007 # Escape character to use for functions in the built-in editor.
1016 # When set, the initial prompt for recipients and subject are skipped when
1017 # replying to messages, and the initial prompt for subject is skipped when
1018 # forwarding messages.
1020 # Note: this variable has no effect when the $autoedit variable is set.
1029 # This variable controls whether or not attachments on outgoing messages are
1030 # saved along with the main body of your message.
1040 # When this variable is set, FCCs will be stored unencrypted and unsigned, even
1041 # when the actual message is encrypted and/or signed. (PGP only)
1050 # If set, flagged messages cannot be deleted.
1059 # Specifies the default location of your mailboxes. A “+” or “=” at the beginning
1060 # of a pathname will be expanded to the value of this variable. Note that if you
1061 # change this variable (from the default) value you need to make sure that the
1062 # assignment occurs before you use “+” or “=” for any other variables since
1063 # expansion takes place when handling the “mailboxes” command.
1068 # 3.76. folder_format
1071 # Default: “%2C %t %N %F %2l %-8.8u %-8.8g %8s %d %f”
1073 # This variable allows you to customize the file browser display to your personal
1074 # taste. This string is similar to $index_format, but has its own set of printf
1075 # (3)-like sequences:
1077 # ┌───┬─────────────────────────────────────────────────────────────────────────┐
1078 # │%C │current file number │
1079 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1080 # │%d │date/time folder was last modified │
1081 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1082 # │%D │date/time folder was last modified using $date_format. │
1083 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1084 # │%f │filename (“/” is appended to directory names, “@” to symbolic links and “│
1085 # │ │*” to executable files) │
1086 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1087 # │%F │file permissions │
1088 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1089 # │%g │group name (or numeric gid, if missing) │
1090 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1091 # │%l │number of hard links │
1092 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1093 # │%m │number of messages in the mailbox * │
1094 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1095 # │%n │number of unread messages in the mailbox * │
1096 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1097 # │%N │N if mailbox has new mail, blank otherwise │
1098 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1099 # │%s │size in bytes │
1100 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1101 # │%t │“*” if the file is tagged, blank otherwise │
1102 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1103 # │%u │owner name (or numeric uid, if missing) │
1104 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1105 # │%>X│right justify the rest of the string and pad with character “X” │
1106 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1107 # │%|X│pad to the end of the line with character “X” │
1108 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1109 # │%*X│soft-fill with character “X” as pad │
1110 # └───┴─────────────────────────────────────────────────────────────────────────┘
1112 # For an explanation of “soft-fill”, see the $index_format documentation.
1114 # * = can be optionally printed if nonzero
1116 # %m, %n, and %N only work for monitored mailboxes. %m requires $mail_check_stats
1117 # to be set. %n requires $mail_check_stats to be set (except for IMAP mailboxes).
1126 # Controls whether or not the “Mail-Followup-To:” header field is generated when
1127 # sending mail. When set, Mutt will generate this field when you are replying to
1128 # a known mailing list, specified with the “subscribe” or “lists” commands.
1130 # This field has two purposes. First, preventing you from receiving duplicate
1131 # copies of replies to messages which you send to mailing lists, and second,
1132 # ensuring that you do get a reply separately for any messages sent to known
1133 # lists to which you are not subscribed.
1135 # The header will contain only the list's address for subscribed lists, and both
1136 # the list address and your own email address for unsubscribed lists. Without
1137 # this header, a group reply to your message sent to a subscribed list will be
1138 # sent to both the list and your address, resulting in two copies of the same
1148 # This variable is similar to $save_name, except that Mutt will store a copy of
1149 # your outgoing message by the username of the address you are sending to even if
1150 # that mailbox does not exist.
1152 # Also see the $record variable.
1156 # 3.79. forward_attribution_intro
1159 # Default: “----- Forwarded message from %f -----”
1161 # This is the string that will precede a message which has been forwarded in the
1162 # main body of a message (when $mime_forward is unset). For a full listing of
1163 # defined printf(3)-like sequences see the section on $index_format. See also
1164 # $attribution_locale.
1168 # 3.80. forward_attribution_trailer
1171 # Default: “----- End forwarded message -----”
1173 # This is the string that will follow a message which has been forwarded in the
1174 # main body of a message (when $mime_forward is unset). For a full listing of
1175 # defined printf(3)-like sequences see the section on $index_format. See also
1176 # $attribution_locale.
1180 # 3.81. forward_decode
1185 # Controls the decoding of complex MIME messages into text/plain when forwarding
1186 # a message. The message header is also RFC2047 decoded. This variable is only
1187 # used, if $mime_forward is unset, otherwise $mime_forward_decode is used
1192 # 3.82. forward_decrypt
1197 # Controls the handling of encrypted messages when forwarding a message. When set
1198 # , the outer layer of encryption is stripped off. This variable is only used if
1199 # $mime_forward is set and $mime_forward_decode is unset. (PGP only)
1203 # 3.83. forward_edit
1208 # This quadoption controls whether or not the user is automatically placed in the
1209 # editor when forwarding messages. For those who always want to forward with no
1210 # modification, use a setting of “no”.
1214 # 3.84. forward_format
1217 # Default: “[%a: %s]”
1219 # This variable controls the default subject when forwarding a message. It uses
1220 # the same format sequences as the $index_format variable.
1222 set forward_format="(fwd) %s"
1225 # 3.85. forward_quote
1230 # When set, forwarded messages included in the main body of the message (when
1231 # $mime_forward is unset) will be quoted using $indent_string.
1237 # Type: e-mail address
1240 # When set, this variable contains a default from address. It can be overridden
1241 # using “my_hdr” (including from a “send-hook”) and $reverse_name. This variable
1242 # is ignored if $use_from is unset.
1244 # This setting defaults to the contents of the environment variable $EMAIL.
1246 set from='martin f krafft <madduck@madduck.net>'
1251 # Type: regular expression
1254 # A regular expression used by mutt to parse the GECOS field of a password entry
1255 # when expanding the alias. The default value will return the string up to the
1256 # first “,” encountered. If the GECOS field contains a string like “lastname,
1257 # firstname” then you should set it to “.*”.
1259 # This can be useful if you see the following behavior: you address an e-mail to
1260 # user ID “stevef” whose full name is “Steve Franklin”. If mutt expands “stevef”
1261 # to “"Franklin" stevef@foo.bar” then you should set the $gecos_mask to a regular
1262 # expression that will match the whole name so mutt will expand “Franklin” to “
1272 # When unset, the header fields normally added by the “my_hdr” command are not
1273 # created. This variable must be unset before composing a new message or replying
1274 # in order to take effect. If set, the user defined header fields are added to
1275 # every new message.
1284 # When set, this variable causes Mutt to include the header of the message you
1285 # are replying to into the edit buffer. The $weed setting applies.
1289 # 3.90. header_cache
1294 # This variable points to the header cache database. If pointing to a directory
1295 # Mutt will contain a header cache database file per folder, if pointing to a
1296 # file that file will be a single global header cache. By default it is unset so
1297 # no header caching will be used.
1299 # Header caching can greatly improve speed when opening POP, IMAP MH or Maildir
1300 # folders, see “caching” for details.
1302 set header_cache="~/.var/mutt/header_cache"
1305 # 3.91. header_cache_compress
1310 # When mutt is compiled with qdbm, tokyocabinet, or kyotocabinet as header cache
1311 # backend, this option determines whether the database will be compressed.
1312 # Compression results in database files roughly being one fifth of the usual
1313 # diskspace, but the decompression can result in a slower opening of cached
1314 # folder(s) which in general is still much faster than opening non header cached
1317 set header_cache_compress=no
1320 # 3.92. header_cache_pagesize
1325 # When mutt is compiled with either gdbm or bdb4 as the header cache backend,
1326 # this option changes the database page size. Too large or too small values can
1327 # waste space, memory, or CPU time. The default should be more or less optimal
1328 # for most use cases.
1332 # 3.93. header_color_partial
1337 # When set, color header regexps behave like color body regexps: color is applied
1338 # to the exact text matched by the regexp. When unset, color is applied to the
1341 # One use of this option might be to apply color to just the header labels.
1343 # See “color” for more details.
1352 # When set, help lines describing the bindings for the major functions provided
1353 # by each menu are displayed on the first line of the screen.
1355 # Note: The binding will not be displayed correctly if the function is bound to a
1356 # sequence rather than a single keystroke. Also, the help line may not be updated
1357 # if a binding is changed while Mutt is running. Since this variable is primarily
1358 # aimed at new users, neither of these should present a major problem.
1367 # When set, mutt will skip the host name part of $hostname variable when adding
1368 # the domain part to addresses. This variable does not affect the generation of
1369 # Message-IDs, and it will not lead to the cut-off of first-level domains.
1373 # 3.96. hide_limited
1378 # When set, mutt will not show the presence of messages that are hidden by
1379 # limiting, in the thread tree.
1383 # 3.97. hide_missing
1388 # When set, mutt will not show the presence of missing messages in the thread
1393 # 3.98. hide_thread_subject
1398 # When set, mutt will not show the subject of messages in the thread tree that
1399 # have the same subject as their parent or closest previously displayed sibling.
1403 # 3.99. hide_top_limited
1408 # When set, mutt will not show the presence of messages that are hidden by
1409 # limiting, at the top of threads in the thread tree. Note that when
1410 # $hide_limited is set, this option will have no effect.
1414 # 3.100. hide_top_missing
1419 # When set, mutt will not show the presence of missing messages at the top of
1420 # threads in the thread tree. Note that when $hide_missing is set, this option
1421 # will have no effect.
1430 # This variable controls the size (in number of strings remembered) of the string
1431 # history buffer per category. The buffer is cleared each time the variable is
1436 # 3.102. history_file
1439 # Default: “~/.mutthistory”
1441 # The file in which Mutt will save its history.
1443 # Also see $save_history.
1445 set history_file="~/.var/mutt/history"
1448 # 3.103. history_remove_dups
1453 # When set, all of the string history will be scanned for duplicates when a new
1454 # entry is added. Duplicate entries in the $history_file will also be removed
1455 # when it is periodically compacted.
1459 # 3.104. honor_disposition
1464 # When set, Mutt will not display attachments with a disposition of “attachment”
1465 # inline even if it could render the part to plain text. These MIME parts can
1466 # only be viewed from the attachment menu.
1468 # If unset, Mutt will render all MIME parts it can properly transform to plain
1473 # 3.105. honor_followup_to
1478 # This variable controls whether or not a Mail-Followup-To header is honored when
1479 # group-replying to a message.
1488 # Specifies the fully-qualified hostname of the system mutt is running on
1489 # containing the host's name and the DNS domain it belongs to. It is used as the
1490 # domain part (after “@”) for local email addresses as well as Message-Id
1493 # Its value is determined at startup as follows: the node's hostname is first
1494 # determined by the uname(3) function. The domain is then looked up using the
1495 # gethostname(2) and getaddrinfo(3) functions. If those calls are unable to
1496 # determine the domain, the full value returned by uname is used. Optionally,
1497 # Mutt can be compiled with a fixed domain name in which case a detected one is
1500 # Also see $use_domain and $hidden_host.
1509 # When set, Mutt will show you international domain names decoded. Note: You can
1510 # use IDNs for addresses even if this is unset. This variable only affects
1511 # decoding. (IDN only)
1520 # When set, Mutt will encode international domain names using IDN. Unset this if
1521 # your SMTP server can handle newer (RFC 6531) UTF-8 encoded domains. (IDN only)
1525 # 3.109. ignore_linear_white_space
1530 # This option replaces linear-white-space between encoded-word and text to a
1531 # single space to prevent the display of MIME-encoded “Subject:” field from being
1532 # divided into multiple lines.
1536 # 3.110. ignore_list_reply_to
1541 # Affects the behavior of the <reply> function when replying to messages from
1542 # mailing lists (as defined by the “subscribe” or “lists” commands). When set, if
1543 # the “Reply-To:” field is set to the same value as the “To:” field, Mutt assumes
1544 # that the “Reply-To:” field was set by the mailing list to automate responses to
1545 # the list, and will ignore this field. To direct a response to the mailing list
1546 # when this option is set, use the <list-reply> function; <group-reply> will
1547 # reply to both the sender and the list.
1549 set ignore_list_reply_to=yes
1552 # 3.111. imap_authenticators
1557 # This is a colon-delimited list of authentication methods mutt may attempt to
1558 # use to log in to an IMAP server, in the order mutt should try them.
1559 # Authentication methods are either “login” or the right side of an IMAP “AUTH=
1560 # xxx” capability string, e.g. “digest-md5”, “gssapi” or “cram-md5”. This option
1561 # is case-insensitive. If it's unset (the default) mutt will try all available
1562 # methods, in order from most-secure to least-secure.
1566 # set imap_authenticators="gssapi:cram-md5:login"
1568 # Note: Mutt will only fall back to other authentication methods if the previous
1569 # methods are unavailable. If a method is available but authentication fails,
1570 # mutt will not connect to the IMAP server.
1574 # 3.112. imap_check_subscribed
1579 # When set, mutt will fetch the set of subscribed folders from your server on
1580 # connection, and add them to the set of mailboxes it polls for new mail just as
1581 # if you had issued individual “mailboxes” commands.
1585 # 3.113. imap_delim_chars
1590 # This contains the list of characters which you would like to treat as folder
1591 # separators for displaying IMAP paths. In particular it helps in using the “=”
1592 # shortcut for your folder variable.
1596 # 3.114. imap_headers
1601 # Mutt requests these header fields in addition to the default headers (“Date:”,
1602 # “From:”, “Subject:”, “To:”, “Cc:”, “Message-Id:”, “References:”, “Content-Type:
1603 # ”, “Content-Description:”, “In-Reply-To:”, “Reply-To:”, “Lines:”, “List-Post:”,
1604 # “X-Label:”) from IMAP servers before displaying the index menu. You may want to
1605 # add more headers for spam detection.
1607 # Note: This is a space separated list, items should be uppercase and not contain
1608 # the colon, e.g. “X-BOGOSITY X-SPAM-STATUS” for the “X-Bogosity:” and “
1609 # X-Spam-Status:” header fields.
1618 # When set, mutt will attempt to use the IMAP IDLE extension to check for new
1619 # mail in the current mailbox. Some servers (dovecot was the inspiration for this
1620 # option) react badly to mutt's implementation. If your connection seems to
1621 # freeze up periodically, try unsetting this.
1625 # 3.116. imap_keepalive
1630 # This variable specifies the maximum amount of time in seconds that mutt will
1631 # wait before polling open IMAP connections, to prevent the server from closing
1632 # them before mutt has finished with them. The default is well within the
1633 # RFC-specified minimum amount of time (30 minutes) before a server is allowed to
1634 # do this, but in practice the RFC does get violated every now and then. Reduce
1635 # this number if you find yourself getting disconnected from your IMAP server due
1640 # 3.117. imap_list_subscribed
1645 # This variable configures whether IMAP folder browsing will look for only
1646 # subscribed folders or all folders. This can be toggled in the IMAP browser with
1647 # the <toggle-subscribed> function.
1656 # Your login name on the IMAP server.
1658 # This variable defaults to the value of $imap_user.
1662 # 3.119. imap_oauth_refresh_command
1667 # The command to run to generate an OAUTH refresh token for authorizing your
1668 # connection to your IMAP server. This command will be run on every connection
1669 # attempt that uses the OAUTHBEARER authentication mechanism.
1678 # Specifies the password for your IMAP account. If unset, Mutt will prompt you
1679 # for your password when you invoke the <imap-fetch-mail> function or try to open
1682 # Warning: you should only use this option when you are on a fairly secure
1683 # machine, because the superuser can read your muttrc even if you are the only
1684 # one who can read the file.
1688 # 3.121. imap_passive
1693 # When set, mutt will not open new IMAP connections to check for new mail. Mutt
1694 # will only check for new mail over existing IMAP connections. This is useful if
1695 # you don't want to be prompted to user/password pairs on mutt invocation, or if
1696 # opening the connection is slow.
1705 # When set, mutt will avoid implicitly marking your mail as read whenever you
1706 # fetch a message from the server. This is generally a good thing, but can make
1707 # closing an IMAP folder somewhat slower. This option exists to appease speed
1712 # 3.123. imap_pipeline_depth
1717 # Controls the number of IMAP commands that may be queued up before they are sent
1718 # to the server. A deeper pipeline reduces the amount of time mutt must wait for
1719 # the server, and can make IMAP servers feel much more responsive. But not all
1720 # servers correctly handle pipelined commands, so if you have problems you might
1721 # want to try setting this variable to 0.
1723 # Note: Changes to this variable have no effect on open connections.
1727 # 3.124. imap_poll_timeout
1732 # This variable specifies the maximum amount of time in seconds that mutt will
1733 # wait for a response when polling IMAP connections for new mail, before timing
1734 # out and closing the connection. Set to 0 to disable timing out.
1738 # 3.125. imap_servernoise
1743 # When set, mutt will display warning messages from the IMAP server as error
1744 # messages. Since these messages are often harmless, or generated due to
1745 # configuration problems on the server which are out of the users' hands, you may
1746 # wish to suppress them at some point.
1755 # The name of the user whose mail you intend to access on the IMAP server.
1757 # This variable defaults to your user name on the local machine.
1761 # 3.127. implicit_autoview
1766 # If set to “yes”, mutt will look for a mailcap entry with the “copiousoutput”
1767 # flag set for every MIME attachment it doesn't have an internal viewer defined
1768 # for. If such an entry is found, mutt will use the viewer defined in that entry
1769 # to convert the body part to text form.
1771 set implicit_autoview=no
1779 # Controls whether or not a copy of the message(s) you are replying to is
1780 # included in your reply.
1785 # 3.129. include_onlyfirst
1790 # Controls whether or not Mutt includes only the first attachment of the message
1795 # 3.130. indent_string
1800 # Specifies the string to prepend to each line of text quoted in a message to
1801 # which you are replying. You are strongly encouraged not to change this value,
1802 # as it tends to agitate the more fanatical netizens.
1804 # The value of this option is ignored if $text_flowed is set, because the quoting
1805 # mechanism is strictly defined for format=flowed.
1807 # This option is a format string, please see the description of $index_format for
1808 # supported printf(3)-style sequences.
1812 # 3.131. index_format
1815 # Default: “%4C %Z %{%b %d} %-15.15L (%?l?%4l&%4c?) %s”
1817 # This variable allows you to customize the message index display to your
1820 # “Format strings” are similar to the strings used in the C function printf(3) to
1821 # format output (see the man page for more details). For an explanation of the %?
1822 # construct, see the $status_format description. The following sequences are
1825 # ┌─────┬───────────────────────────────────────────────────────────────────────┐
1826 # │%a │address of the author │
1827 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1828 # │%A │reply-to address (if present; otherwise: address of author) │
1829 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1830 # │%b │filename of the original message folder (think mailbox) │
1831 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1832 # │%B │the list to which the letter was sent, or else the folder name (%b). │
1833 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1834 # │%c │number of characters (bytes) in the message │
1835 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1836 # │%C │current message number │
1837 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1838 # │%d │date and time of the message in the format specified by $date_format │
1839 # │ │converted to sender's time zone │
1840 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1841 # │%D │date and time of the message in the format specified by $date_format │
1842 # │ │converted to the local time zone │
1843 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1844 # │%e │current message number in thread │
1845 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1846 # │%E │number of messages in current thread │
1847 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1848 # │%f │sender (address + real name), either From: or Return-Path: │
1849 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1850 # │%F │author name, or recipient name if the message is from you │
1851 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1852 # │%H │spam attribute(s) of this message │
1853 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1854 # │%i │message-id of the current message │
1855 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1856 # │%l │number of lines in the message (does not work with maildir, mh, and │
1857 # │ │possibly IMAP folders) │
1858 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1859 # │ │If an address in the “To:” or “Cc:” header field matches an address │
1860 # │%L │defined by the users “subscribe” command, this displays "To <list-name>│
1861 # │ │", otherwise the same as %F. │
1862 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1863 # │%m │total number of message in the mailbox │
1864 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1865 # │%M │number of hidden messages if the thread is collapsed. │
1866 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1867 # │%N │message score │
1868 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1869 # │%n │author's real name (or address if missing) │
1870 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1871 # │%O │original save folder where mutt would formerly have stashed the │
1872 # │ │message: list name or recipient name if not sent to a list │
1873 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1874 # │%P │progress indicator for the built-in pager (how much of the file has │
1875 # │ │been displayed) │
1876 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1877 # │%r │comma separated list of “To:” recipients │
1878 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1879 # │%R │comma separated list of “Cc:” recipients │
1880 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1881 # │%s │subject of the message │
1882 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1883 # │%S │single character status of the message (“N”/“O”/“D”/“d”/“!”/“r”/“*”) │
1884 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1885 # │%t │“To:” field (recipients) │
1886 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1887 # │%T │the appropriate character from the $to_chars string │
1888 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1889 # │%u │user (login) name of the author │
1890 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1891 # │%v │first name of the author, or the recipient if the message is from you │
1892 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1893 # │%X │number of attachments (please see the “attachments” section for │
1894 # │ │possible speed effects) │
1895 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1896 # │%y │“X-Label:” field, if present │
1897 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1898 # │ │“X-Label:” field, if present, and (1) not at part of a thread tree, (2)│
1899 # │%Y │at the top of a thread, or (3) “X-Label:” is different from preceding │
1900 # │ │message's “X-Label:”. │
1901 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1902 # │ │a three character set of message status flags. the first character is │
1903 # │%Z │new/read/replied flags (“n”/“o”/“r”/“O”/“N”). the second is deleted or │
1904 # │ │encryption flags (“D”/“d”/“S”/“P”/“s”/“K”). the third is either tagged/│
1905 # │ │flagged (“*”/“!”), or one of the characters listed in $to_chars. │
1906 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1907 # │% │the date and time of the message is converted to sender's time zone, │
1908 # │{fmt}│and “fmt” is expanded by the library function strftime(3); a leading │
1909 # │ │bang disables locales │
1910 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1911 # │% │the date and time of the message is converted to the local time zone, │
1912 # │[fmt]│and “fmt” is expanded by the library function strftime(3); a leading │
1913 # │ │bang disables locales │
1914 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1915 # │% │the local date and time when the message was received. “fmt” is │
1916 # │(fmt)│expanded by the library function strftime(3); a leading bang disables │
1918 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1919 # │% │the current local time. “fmt” is expanded by the library function │
1920 # │<fmt>│strftime(3); a leading bang disables locales. │
1921 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1922 # │%>X │right justify the rest of the string and pad with character “X” │
1923 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1924 # │%|X │pad to the end of the line with character “X” │
1925 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1926 # │%*X │soft-fill with character “X” as pad │
1927 # └─────┴───────────────────────────────────────────────────────────────────────┘
1929 # “Soft-fill” deserves some explanation: Normal right-justification will print
1930 # everything to the left of the “%>”, displaying padding and whatever lies to the
1931 # right only if there's room. By contrast, soft-fill gives priority to the
1932 # right-hand side, guaranteeing space to display it and showing padding only if
1933 # there's still room. If necessary, soft-fill will eat text leftwards to make
1934 # room for rightward text.
1936 # Note that these expandos are supported in “save-hook”, “fcc-hook” and “
1937 # fcc-save-hook”, too.
1946 # How to invoke ispell (GNU's spell-checking software).
1950 # 3.133. keep_flagged
1955 # If set, read messages marked as flagged will not be moved from your spool
1956 # mailbox to your $mbox mailbox, or as a result of a “mbox-hook” command.
1965 # This variable configures how often (in seconds) mutt should look for new mail.
1966 # Also see the $timeout variable.
1970 # 3.135. mail_check_recent
1975 # When set, Mutt will only notify you about new mail that has been received since
1976 # the last time you opened the mailbox. When unset, Mutt will notify you if any
1977 # new mail exists in the mailbox, regardless of whether you have visited it
1980 # When $mark_old is set, Mutt does not consider the mailbox to contain new mail
1981 # if only old messages exist.
1985 # 3.136. mail_check_stats
1990 # When set, mutt will periodically calculate message statistics of a mailbox
1991 # while polling for new mail. It will check for unread, flagged, and total
1992 # message counts. Because this operation is more performance intensive, it
1993 # defaults to unset, and has a separate option, $mail_check_stats_interval, to
1994 # control how often to update these counts.
1996 set mail_check_stats=yes
1999 # 3.137. mail_check_stats_interval
2004 # When $mail_check_stats is set, this variable configures how often (in seconds)
2005 # mutt will update message counts.
2009 # 3.138. mailcap_path
2014 # This variable specifies which files to consult when attempting to display MIME
2015 # bodies not directly supported by Mutt.
2017 set mailcap_path="$my_confdir/mailcap.icalendar:$my_confdir/mailcap.backgrounding:$my_confdir/mailcap.htmldump"
2020 # 3.139. mailcap_sanitize
2025 # If set, mutt will restrict possible characters in mailcap % expandos to a
2026 # well-defined set of safe characters. This is the safe setting, but we are not
2027 # sure it doesn't break some more advanced MIME stuff.
2029 # DON'T CHANGE THIS SETTING UNLESS YOU ARE REALLY SURE WHAT YOU ARE DOING!
2033 # 3.140. maildir_header_cache_verify
2038 # Check for Maildir unaware programs other than mutt having modified maildir
2039 # files when the header cache is in use. This incurs one stat(2) per message
2040 # every time the folder is opened (which can be very slow for NFS folders).
2042 set maildir_header_cache_verify=no
2045 # 3.141. maildir_trash
2050 # If set, messages marked as deleted will be saved with the maildir trashed flag
2051 # instead of unlinked. Note: this only applies to maildir-style mailboxes.
2052 # Setting it will have no effect on other mailbox types.
2056 # 3.142. maildir_check_cur
2061 # If set, mutt will poll both the new and cur directories of a maildir folder for
2062 # new messages. This might be useful if other programs interacting with the
2063 # folder (e.g. dovecot) are moving new messages to the cur directory. Note that
2064 # setting this option may slow down polling for new messages in large folders,
2065 # since mutt has to scan all cur messages.
2069 # 3.143. mark_macro_prefix
2074 # Prefix for macros created using mark-message. A new macro automatically
2075 # generated with <mark-message>a will be composed from this prefix and the letter
2085 # Controls whether or not mutt marks new unread messages as old if you exit a
2086 # mailbox without reading them. With this option set, the next time you start
2087 # mutt, the messages will show up with an “O” next to them in the index menu,
2088 # indicating that they are old.
2098 # Controls the display of wrapped lines in the internal pager. If set, a “+”
2099 # marker is displayed at the beginning of wrapped lines.
2101 # Also see the $smart_wrap variable.
2108 # Type: regular expression
2109 # Default: “!^.[^.]”
2111 # A regular expression used in the file browser, optionally preceded by the not
2112 # operator “!”. Only files whose names match this mask will be shown. The match
2113 # is always case-sensitive.
2122 # This specifies the folder into which read mail in your $spoolfile folder will
2125 # Also see the $move variable.
2131 # Type: folder magic
2134 # The default mailbox type used when creating new folders. May be any of “mbox”,
2135 # “MMDF”, “MH” and “Maildir”. This is overridden by the -m command-line option.
2137 set mbox_type=Maildir
2140 # 3.149. menu_context
2145 # This variable controls the number of lines of context that are given when
2146 # scrolling through menus. (Similar to $pager_context.)
2151 # 3.150. menu_move_off
2156 # When unset, the bottom entry of menus will never scroll up past the bottom of
2157 # the screen, unless there are less entries than lines. When set, the bottom
2158 # entry may move off the bottom.
2162 # 3.151. menu_scroll
2167 # When set, menus will be scrolled up or down one line when you attempt to move
2168 # across a screen boundary. If unset, the screen is cleared and the next or
2169 # previous page of the menu is displayed (useful for slow links to avoid many
2175 # 3.152. message_cache_clean
2180 # If set, mutt will clean out obsolete entries from the message cache when the
2181 # mailbox is synchronized. You probably only want to set it every once in a
2182 # while, since it can be a little slow (especially for large folders).
2186 # 3.153. message_cachedir
2191 # Set this to a directory and mutt will cache copies of messages from your IMAP
2192 # and POP servers here. You are free to remove entries at any time.
2194 # When setting this variable to a directory, mutt needs to fetch every remote
2195 # message only once and can perform regular expression searches as fast as for
2198 # Also see the $message_cache_clean variable.
2202 # 3.154. message_format
2207 # This is the string displayed in the “attachment” menu for attachments of type
2208 # message/rfc822. For a full listing of defined printf(3)-like sequences see the
2209 # section on $index_format.
2218 # If set, forces Mutt to interpret keystrokes with the high bit (bit 8) set as if
2219 # the user had pressed the Esc key and whatever key remains after having the high
2220 # bit removed. For example, if the key pressed has an ASCII value of 0xf8, then
2221 # this is treated as if the user had pressed Esc then “x”. This is because the
2222 # result of removing the high bit from 0xf8 is 0x78, which is the ASCII character
2232 # If unset, Mutt will remove your address (see the “alternates” command) from the
2233 # list of recipients when replying to a message.
2242 # When unset, mutt will mimic mh's behavior and rename deleted messages to ,<old
2243 # file name> in mh folders instead of really deleting them. This leaves the
2244 # message on disk but makes programs reading the folder ignore it. If the
2245 # variable is set, the message files will simply be deleted.
2247 # This option is similar to $maildir_trash for Maildir folders.
2251 # 3.158. mh_seq_flagged
2254 # Default: “flagged”
2256 # The name of the MH sequence used for flagged messages.
2260 # 3.159. mh_seq_replied
2263 # Default: “replied”
2265 # The name of the MH sequence used to tag replied messages.
2269 # 3.160. mh_seq_unseen
2274 # The name of the MH sequence used for unseen messages.
2278 # 3.161. mime_forward
2283 # When set, the message you are forwarding will be attached as a separate message
2284 # /rfc822 MIME part instead of included in the main body of the message. This is
2285 # useful for forwarding MIME messages so the receiver can properly view the
2286 # message as it was delivered to you. If you like to switch between MIME and not
2287 # MIME from mail to mail, set this variable to “ask-no” or “ask-yes”.
2289 # Also see $forward_decode and $mime_forward_decode.
2291 set mime_forward=ask-yes
2294 # 3.162. mime_forward_decode
2299 # Controls the decoding of complex MIME messages into text/plain when forwarding
2300 # a message while $mime_forward is set. Otherwise $forward_decode is used
2305 # 3.163. mime_forward_rest
2310 # When forwarding multiple attachments of a MIME message from the attachment
2311 # menu, attachments which cannot be decoded in a reasonable manner will be
2312 # attached to the newly composed message if this option is set.
2316 # 3.164. mime_type_query_command
2321 # This specifies a command to run, to determine the mime type of a new attachment
2322 # when composing a message. Unless $mime_type_query_first is set, this will only
2323 # be run if the attachment's extension is not found in the mime.types file.
2325 # The string may contain a “%s”, which will be substituted with the attachment
2326 # filename. Mutt will add quotes around the string substituted for “%s”
2327 # automatically according to shell quoting rules, so you should avoid adding your
2328 # own. If no “%s” is found in the string, Mutt will append the attachment
2329 # filename to the end of the string.
2331 # The command should output a single line containing the attachment's mime type.
2333 # Suggested values are “xdg-mime query filetype” or “file -bi”.
2337 # 3.165. mime_type_query_first
2342 # When set, the $mime_type_query_command will be run before the mime.types
2347 # 3.166. mix_entry_format
2350 # Default: “%4n %c %-16s %a”
2352 # This variable describes the format of a remailer line on the mixmaster chain
2353 # selection screen. The following printf(3)-like sequences are supported:
2355 # ┌──┬───────────────────────────────┐
2356 # │%n│The running number on the menu.│
2357 # ├──┼───────────────────────────────┤
2358 # │%c│Remailer capabilities. │
2359 # ├──┼───────────────────────────────┤
2360 # │%s│The remailer's short name. │
2361 # ├──┼───────────────────────────────┤
2362 # │%a│The remailer's e-mail address. │
2363 # └──┴───────────────────────────────┘
2370 # Default: “mixmaster”
2372 # This variable contains the path to the Mixmaster binary on your system. It is
2373 # used with various sets of parameters to gather the list of known remailers, and
2374 # to finally send a message through the mixmaster chain.
2376 set mixmaster="mixmaster-filter"
2384 # Controls whether or not Mutt will move read messages from your spool mailbox to
2385 # your $mbox mailbox, or as a result of a “mbox-hook” command.
2390 # 3.169. narrow_tree
2395 # This variable, when set, makes the thread tree narrower, allowing deeper
2396 # threads to fit on the screen.
2406 # Operations that expect to transfer a large amount of data over the network will
2407 # update their progress every $net_inc kilobytes. If set to 0, no progress
2408 # messages will be displayed.
2410 # See also $read_inc, $write_inc and $net_inc.
2414 # 3.171. new_mail_command
2419 # If set, Mutt will call this command after a new message is received. See the
2420 # $status_format documentation for the values that can be formatted into this
2428 # Default: “builtin”
2430 # This variable specifies which pager you would like to use to view messages. The
2431 # value “builtin” means to use the built-in pager, otherwise this variable should
2432 # specify the pathname of the external pager you would like to use.
2434 # Using an external pager may have some disadvantages: Additional keystrokes are
2435 # necessary because you can't call mutt functions directly from the pager, and
2436 # screen resizes cause lines longer than the screen width to be badly formatted
2441 # 3.173. pager_context
2446 # This variable controls the number of lines of context that are given when
2447 # displaying the next or previous page in the internal pager. By default, Mutt
2448 # will display the line after the last one on the screen at the top of the next
2449 # page (0 lines of context).
2451 # This variable also specifies the amount of context given for search results. If
2452 # positive, this many lines will be given before a match, if 0, the match will be
2458 # 3.174. pager_format
2461 # Default: “-%Z- %C/%m: %-20.20n %s%* -- (%P)”
2463 # This variable controls the format of the one-line message “status” displayed
2464 # before each message in either the internal or an external pager. The valid
2465 # sequences are listed in the $index_format section.
2467 set pager_format="<%a> %* %i (%P)"
2470 # 3.175. pager_index_lines
2475 # Determines the number of lines of a mini-index which is shown when in the
2476 # pager. The current message, unless near the top or bottom of the folder, will
2477 # be roughly one third of the way down this mini-index, giving the reader the
2478 # context of a few messages before and after the message. This is useful, for
2479 # example, to determine how many messages remain to be read in the current
2480 # thread. One of the lines is reserved for the status bar from the index, so a
2481 # setting of 6 will only show 5 lines of the actual index. A value of 0 results
2482 # in no index being shown. If the number of messages in the current folder is
2483 # less than $pager_index_lines, then the index will only use as many lines as it
2486 set pager_index_lines=5
2494 # When set, the internal-pager will not move to the next message when you are at
2495 # the end of a message and invoke the <next-page> function.
2500 # 3.177. pgp_auto_decode
2505 # If set, mutt will automatically attempt to decrypt traditional PGP messages
2506 # whenever the user performs an operation which ordinarily would result in the
2507 # contents of the message being operated on. For example, if the user displays a
2508 # pgp-traditional message which has not been manually checked with the
2509 # <check-traditional-pgp> function, mutt will automatically check the message for
2512 set pgp_auto_decode=yes
2515 # 3.178. pgp_autoinline
2520 # This option controls whether Mutt generates old-style inline (traditional) PGP
2521 # encrypted or signed messages under certain circumstances. This can be
2522 # overridden by use of the pgp menu, when inline is not required. The GPGME
2523 # backend does not support this option.
2525 # Note that Mutt might automatically use PGP/MIME for messages which consist of
2526 # more than a single MIME part. Mutt can be configured to ask before sending PGP/
2527 # MIME messages when inline (traditional) would not work.
2529 # Also see the $pgp_mime_auto variable.
2531 # Also note that using the old-style PGP message format is strongly deprecated.
2536 # 3.179. pgp_check_exit
2541 # If set, mutt will check the exit code of the PGP subprocess when signing or
2542 # encrypting. A non-zero exit code means that the subprocess failed. (PGP only)
2546 # 3.180. pgp_check_gpg_decrypt_status_fd
2551 # If set, mutt will check the status file descriptor output of
2552 # $pgp_decrypt_command and $pgp_decode_command for GnuPG status codes indicating
2553 # successful decryption. This will check for the presence of DECRYPTION_OKAY,
2554 # absence of DECRYPTION_FAILED, and that all PLAINTEXT occurs between the
2555 # BEGIN_DECRYPTION and END_DECRYPTION status codes.
2557 # If unset, mutt will instead match the status fd output against
2558 # $pgp_decryption_okay. (PGP only)
2562 # 3.181. pgp_clearsign_command
2567 # This format is used to create an old-style “clearsigned” PGP message. Note that
2568 # the use of this format is strongly deprecated.
2570 # This is a format string, see the $pgp_decode_command command for possible
2571 # printf(3)-like sequences. (PGP only)
2575 # 3.182. pgp_decode_command
2580 # This format strings specifies a command which is used to decode application/pgp
2583 # The PGP command formats have their own set of printf(3)-like sequences:
2585 # ┌──┬──────────────────────────────────────────────────────────────────────────┐
2586 # │%p│Expands to PGPPASSFD=0 when a pass phrase is needed, to an empty string │
2587 # │ │otherwise. Note: This may be used with a %? construct. │
2588 # ├──┼──────────────────────────────────────────────────────────────────────────┤
2589 # │%f│Expands to the name of a file containing a message. │
2590 # ├──┼──────────────────────────────────────────────────────────────────────────┤
2591 # │%s│Expands to the name of a file containing the signature part of a multipart│
2592 # │ │/signed attachment when verifying it. │
2593 # ├──┼──────────────────────────────────────────────────────────────────────────┤
2594 # │%a│The value of $pgp_sign_as if set, otherwise the value of $pgp_default_key.│
2595 # ├──┼──────────────────────────────────────────────────────────────────────────┤
2596 # │%r│One or more key IDs (or fingerprints if available). │
2597 # └──┴──────────────────────────────────────────────────────────────────────────┘
2599 # For examples on how to configure these formats for the various versions of PGP
2600 # which are floating around, see the pgp and gpg sample configuration files in
2601 # the samples/ subdirectory which has been installed on your system alongside the
2602 # documentation. (PGP only)
2606 # 3.183. pgp_decrypt_command
2611 # This command is used to decrypt a PGP encrypted message.
2613 # This is a format string, see the $pgp_decode_command command for possible
2614 # printf(3)-like sequences. (PGP only)
2618 # 3.184. pgp_decryption_okay
2620 # Type: regular expression
2623 # If you assign text to this variable, then an encrypted PGP message is only
2624 # considered successfully decrypted if the output from $pgp_decrypt_command
2625 # contains the text. This is used to protect against a spoofed encrypted message,
2626 # with multipart/encrypted headers but containing a block that is not actually
2627 # encrypted. (e.g. simply signed and ascii armored text).
2629 # Note that if $pgp_check_gpg_decrypt_status_fd is set, this variable is ignored.
2634 # 3.185. pgp_default_key
2639 # This is the default key-pair to use for PGP operations. It will be used for
2640 # encryption (see $postpone_encrypt and $pgp_self_encrypt).
2642 # It will also be used for signing unless $pgp_sign_as is set.
2644 # The (now deprecated) pgp_self_encrypt_as is an alias for this variable, and
2645 # should no longer be used. (PGP only)
2649 # 3.186. pgp_encrypt_only_command
2654 # This command is used to encrypt a body part without signing it.
2656 # This is a format string, see the $pgp_decode_command command for possible
2657 # printf(3)-like sequences. (PGP only)
2661 # 3.187. pgp_encrypt_sign_command
2666 # This command is used to both sign and encrypt a body part.
2668 # This is a format string, see the $pgp_decode_command command for possible
2669 # printf(3)-like sequences. (PGP only)
2673 # 3.188. pgp_entry_format
2676 # Default: “%4n %t%f %4l/0x%k %-4a %2c %u”
2678 # This variable allows you to customize the PGP key selection menu to your
2679 # personal taste. This string is similar to $index_format, but has its own set of
2680 # printf(3)-like sequences:
2682 # ┌──────┬──────────────────────────────────────────────────────┐
2684 # ├──────┼──────────────────────────────────────────────────────┤
2686 # ├──────┼──────────────────────────────────────────────────────┤
2688 # ├──────┼──────────────────────────────────────────────────────┤
2690 # ├──────┼──────────────────────────────────────────────────────┤
2692 # ├──────┼──────────────────────────────────────────────────────┤
2694 # ├──────┼──────────────────────────────────────────────────────┤
2695 # │%c │capabilities │
2696 # ├──────┼──────────────────────────────────────────────────────┤
2697 # │%t │trust/validity of the key-uid association │
2698 # ├──────┼──────────────────────────────────────────────────────┤
2699 # │%[<s>]│date of the key where <s> is an strftime(3) expression│
2700 # └──────┴──────────────────────────────────────────────────────┘
2706 # 3.189. pgp_export_command
2711 # This command is used to export a public key from the user's key ring.
2713 # This is a format string, see the $pgp_decode_command command for possible
2714 # printf(3)-like sequences. (PGP only)
2718 # 3.190. pgp_getkeys_command
2723 # This command is invoked whenever Mutt needs to fetch the public key associated
2724 # with an email address. Of the sequences supported by $pgp_decode_command, %r is
2725 # the only printf(3)-like sequence used with this format. Note that in this case,
2726 # %r expands to the email address, not the public key ID (the key ID is unknown,
2727 # which is why Mutt is invoking this command). (PGP only)
2731 # 3.191. pgp_good_sign
2733 # Type: regular expression
2736 # If you assign a text to this variable, then a PGP signature is only considered
2737 # verified if the output from $pgp_verify_command contains the text. Use this
2738 # variable if the exit code from the command is 0 even for bad signatures. (PGP
2743 # 3.192. pgp_ignore_subkeys
2748 # Setting this variable will cause Mutt to ignore OpenPGP subkeys. Instead, the
2749 # principal key will inherit the subkeys' capabilities. Unset this if you want to
2750 # play interesting key selection games. (PGP only)
2754 # 3.193. pgp_import_command
2759 # This command is used to import a key from a message into the user's public key
2762 # This is a format string, see the $pgp_decode_command command for possible
2763 # printf(3)-like sequences. (PGP only)
2767 # 3.194. pgp_list_pubring_command
2772 # This command is used to list the public key ring's contents. The output format
2773 # must be analogous to the one used by
2775 # gpg --list-keys --with-colons --with-fingerprint
2777 # This format is also generated by the pgpring utility which comes with mutt.
2779 # Note: gpg's fixed-list-mode option should not be used. It produces a different
2780 # date format which may result in mutt showing incorrect key generation dates.
2782 # This is a format string, see the $pgp_decode_command command for possible
2783 # printf(3)-like sequences. (PGP only)
2787 # 3.195. pgp_list_secring_command
2792 # This command is used to list the secret key ring's contents. The output format
2793 # must be analogous to the one used by:
2795 # gpg --list-keys --with-colons --with-fingerprint
2797 # This format is also generated by the pgpring utility which comes with mutt.
2799 # Note: gpg's fixed-list-mode option should not be used. It produces a different
2800 # date format which may result in mutt showing incorrect key generation dates.
2802 # This is a format string, see the $pgp_decode_command command for possible
2803 # printf(3)-like sequences. (PGP only)
2807 # 3.196. pgp_long_ids
2812 # If set, use 64 bit PGP key IDs, if unset use the normal 32 bit key IDs. NOTE:
2813 # Internally, Mutt has transitioned to using fingerprints (or long key IDs as a
2814 # fallback). This option now only controls the display of key IDs in the key
2815 # selection menu and a few other places. (PGP only)
2819 # 3.197. pgp_mime_auto
2824 # This option controls whether Mutt will prompt you for automatically sending a
2825 # (signed/encrypted) message using PGP/MIME when inline (traditional) fails (for
2828 # Also note that using the old-style PGP message format is strongly deprecated.
2833 # 3.198. pgp_replyinline
2838 # Setting this variable will cause Mutt to always attempt to create an inline
2839 # (traditional) message when replying to a message which is PGP encrypted/signed
2840 # inline. This can be overridden by use of the pgp menu, when inline is not
2841 # required. This option does not automatically detect if the (replied-to) message
2842 # is inline; instead it relies on Mutt internals for previously checked/flagged
2845 # Note that Mutt might automatically use PGP/MIME for messages which consist of
2846 # more than a single MIME part. Mutt can be configured to ask before sending PGP/
2847 # MIME messages when inline (traditional) would not work.
2849 # Also see the $pgp_mime_auto variable.
2851 # Also note that using the old-style PGP message format is strongly deprecated.
2856 # 3.199. pgp_retainable_sigs
2861 # If set, signed and encrypted messages will consist of nested multipart/signed
2862 # and multipart/encrypted body parts.
2864 # This is useful for applications like encrypted and signed mailing lists, where
2865 # the outer layer (multipart/encrypted) can be easily removed, while the inner
2866 # multipart/signed part is retained. (PGP only)
2868 set pgp_retainable_sigs=yes
2871 # 3.200. pgp_self_encrypt
2876 # When set, PGP encrypted messages will also be encrypted using the key in
2877 # $pgp_default_key. (PGP only)
2881 # 3.201. pgp_show_unusable
2886 # If set, mutt will display non-usable keys on the PGP key selection menu. This
2887 # includes keys which have been revoked, have expired, or have been marked as “
2888 # disabled” by the user. (PGP only)
2890 set pgp_show_unusable=no
2893 # 3.202. pgp_sign_as
2898 # If you have a different key pair to use for signing, you should set this to the
2899 # signing key. Most people will only need to set $pgp_default_key. It is
2900 # recommended that you use the keyid form to specify your key (e.g. 0x00112233).
2903 set pgp_sign_as="0x9C9D6979AE941637"
2906 # 3.203. pgp_sign_command
2911 # This command is used to create the detached PGP signature for a multipart/
2912 # signed PGP/MIME body part.
2914 # This is a format string, see the $pgp_decode_command command for possible
2915 # printf(3)-like sequences. (PGP only)
2919 # 3.204. pgp_sort_keys
2924 # Specifies how the entries in the pgp menu are sorted. The following are legal
2927 # ┌───────┬──────────────────────────────┐
2928 # │address│sort alphabetically by user id│
2929 # ├───────┼──────────────────────────────┤
2930 # │keyid │sort alphabetically by key id │
2931 # ├───────┼──────────────────────────────┤
2932 # │date │sort by key creation date │
2933 # ├───────┼──────────────────────────────┤
2934 # │trust │sort by the trust of the key │
2935 # └───────┴──────────────────────────────┘
2937 # If you prefer reverse order of the above values, prefix it with “reverse-”.
2942 # 3.205. pgp_strict_enc
2947 # If set, Mutt will automatically encode PGP/MIME signed messages as
2948 # quoted-printable. Please note that unsetting this variable may lead to problems
2949 # with non-verifyable PGP signatures, so only change this if you know what you
2950 # are doing. (PGP only)
2954 # 3.206. pgp_timeout
2959 # The number of seconds after which a cached passphrase will expire if not used.
2964 # 3.207. pgp_use_gpg_agent
2969 # If set, mutt will use a possibly-running gpg-agent(1) process. Note that as of
2970 # version 2.1, GnuPG no longer exports GPG_AGENT_INFO, so mutt no longer verifies
2971 # if the agent is running. (PGP only)
2973 set pgp_use_gpg_agent=yes
2976 # 3.208. pgp_verify_command
2981 # This command is used to verify PGP signatures.
2983 # This is a format string, see the $pgp_decode_command command for possible
2984 # printf(3)-like sequences. (PGP only)
2988 # 3.209. pgp_verify_key_command
2993 # This command is used to verify key information from the key selection menu.
2995 # This is a format string, see the $pgp_decode_command command for possible
2996 # printf(3)-like sequences. (PGP only)
3000 # 3.210. pipe_decode
3005 # Used in connection with the <pipe-message> command. When unset, Mutt will pipe
3006 # the messages without any preprocessing. When set, Mutt will weed headers and
3007 # will attempt to decode the messages first.
3016 # The separator to add between messages when piping a list of tagged messages to
3017 # an external Unix command.
3026 # Used in connection with the <pipe-message> function following <tag-prefix>. If
3027 # this variable is unset, when piping a list of tagged messages Mutt will
3028 # concatenate the messages and will pipe them all concatenated. When set, Mutt
3029 # will pipe the messages one by one. In both cases the messages are piped in the
3030 # current sorted order, and the $pipe_sep separator is added after each message.
3034 # 3.213. pop_auth_try_all
3039 # If set, Mutt will try all available authentication methods. When unset, Mutt
3040 # will only fall back to other authentication methods if the previous methods are
3041 # unavailable. If a method is available but authentication fails, Mutt will not
3042 # connect to the POP server.
3046 # 3.214. pop_authenticators
3051 # This is a colon-delimited list of authentication methods mutt may attempt to
3052 # use to log in to an POP server, in the order mutt should try them.
3053 # Authentication methods are either “user”, “apop” or any SASL mechanism, e.g. “
3054 # digest-md5”, “gssapi” or “cram-md5”. This option is case-insensitive. If this
3055 # option is unset (the default) mutt will try all available methods, in order
3056 # from most-secure to least-secure.
3060 # set pop_authenticators="digest-md5:apop:user"
3064 # 3.215. pop_checkinterval
3069 # This variable configures how often (in seconds) mutt should look for new mail
3070 # in the currently selected mailbox if it is a POP mailbox.
3079 # If set, Mutt will delete successfully downloaded messages from the POP server
3080 # when using the <fetch-mail> function. When unset, Mutt will download messages
3081 # but also leave them on the POP server.
3090 # The name of your POP server for the <fetch-mail> function. You can also specify
3091 # an alternative port, username and password, i.e.:
3093 # [pop[s]://][username[:password]@]popserver[:port]
3095 # where “[...]” denotes an optional part.
3104 # If this variable is set, mutt will try to use the “LAST” POP command for
3105 # retrieving only unread messages from the POP server when using the <fetch-mail>
3110 # 3.219. pop_oauth_refresh_command
3115 # The command to run to generate an OAUTH refresh token for authorizing your
3116 # connection to your POP server. This command will be run on every connection
3117 # attempt that uses the OAUTHBEARER authentication mechanism.
3126 # Specifies the password for your POP account. If unset, Mutt will prompt you for
3127 # your password when you open a POP mailbox.
3129 # Warning: you should only use this option when you are on a fairly secure
3130 # machine, because the superuser can read your muttrc even if you are the only
3131 # one who can read the file.
3135 # 3.221. pop_reconnect
3140 # Controls whether or not Mutt will try to reconnect to the POP server if the
3141 # connection is lost.
3150 # Your login name on the POP server.
3152 # This variable defaults to your user name on the local machine.
3156 # 3.223. post_indent_string
3161 # Similar to the $attribution variable, Mutt will append this string after the
3162 # inclusion of a message which is being replied to.
3171 # Controls whether or not messages are saved in the $postponed mailbox when you
3172 # elect not to send immediately.
3174 # Also see the $recall variable.
3181 # Default: “~/postponed”
3183 # Mutt allows you to indefinitely “postpone sending a message” which you are
3184 # editing. When you choose to postpone a message, Mutt saves it in the mailbox
3185 # specified by this variable.
3187 # Also see the $postpone variable.
3189 set postponed="=drafts"
3192 # 3.226. postpone_encrypt
3197 # When set, postponed messages that are marked for encryption will be
3198 # self-encrypted. Mutt will first try to encrypt using the value specified in
3199 # $pgp_default_key or $smime_default_key. If those are not set, it will try the
3200 # deprecated $postpone_encrypt_as. (Crypto only)
3204 # 3.227. postpone_encrypt_as
3209 # This is a deprecated fall-back variable for $postpone_encrypt. Please use
3210 # $pgp_default_key or $smime_default_key. (Crypto only)
3219 # If set, a shell command to be executed if mutt fails to establish a connection
3220 # to the server. This is useful for setting up secure connections, e.g. with ssh
3221 # (1). If the command returns a nonzero status, mutt gives up opening the server.
3224 # set preconnect="ssh -f -q -L 1234:mailhost.net:143 mailhost.net sleep 20 < /dev/null > /dev/null"
3226 # Mailbox “foo” on “mailhost.net” can now be reached as “{localhost:1234}foo”.
3228 # Note: For this example to work, you must be able to log in to the remote
3229 # machine without having to enter a password.
3238 # Controls whether or not Mutt really prints messages. This is set to “ask-no” by
3239 # default, because some people accidentally hit “p” often.
3243 # 3.230. print_command
3248 # This specifies the command pipe that should be used to print messages.
3250 set print_command="muttprint"
3253 # 3.231. print_decode
3258 # Used in connection with the <print-message> command. If this option is set, the
3259 # message is decoded before it is passed to the external command specified by
3260 # $print_command. If this option is unset, no processing will be applied to the
3261 # message when printing it. The latter setting may be useful if you are using
3262 # some advanced printer filter which is able to properly format e-mail messages
3267 # 3.232. print_split
3272 # Used in connection with the <print-message> command. If this option is set, the
3273 # command specified by $print_command is executed once for each message which is
3274 # to be printed. If this option is unset, the command specified by $print_command
3275 # is executed only once, and all the messages are concatenated, with a form feed
3276 # as the message separator.
3278 # Those who use the enscript(1) program's mail-printing mode will most likely
3279 # want to set this option.
3284 # 3.233. prompt_after
3289 # If you use an external $pager, setting this variable will cause Mutt to prompt
3290 # you for a command when the pager exits rather than returning to the index menu.
3291 # If unset, Mutt will return to the index menu when the external pager exits.
3295 # 3.234. query_command
3300 # This specifies the command Mutt will use to make external address queries. The
3301 # string may contain a “%s”, which will be substituted with the query string the
3302 # user types. Mutt will add quotes around the string substituted for “%s”
3303 # automatically according to shell quoting rules, so you should avoid adding your
3304 # own. If no “%s” is found in the string, Mutt will append the user's query to
3305 # the end of the string. See “query” for more information.
3307 set query_command="lbdbq"
3310 # 3.235. query_format
3313 # Default: “%4c %t %-25.25a %-25.25n %?e?(%e)?”
3315 # This variable describes the format of the “query” menu. The following printf(3)
3316 # -style sequences are understood:
3318 # ┌───┬─────────────────────────────────────────────────────┐
3319 # │%a │destination address │
3320 # ├───┼─────────────────────────────────────────────────────┤
3321 # │%c │current entry number │
3322 # ├───┼─────────────────────────────────────────────────────┤
3323 # │%e │extra information * │
3324 # ├───┼─────────────────────────────────────────────────────┤
3325 # │%n │destination name │
3326 # ├───┼─────────────────────────────────────────────────────┤
3327 # │%t │“*” if current entry is tagged, a space otherwise │
3328 # ├───┼─────────────────────────────────────────────────────┤
3329 # │%>X│right justify the rest of the string and pad with “X”│
3330 # ├───┼─────────────────────────────────────────────────────┤
3331 # │%|X│pad to the end of the line with “X” │
3332 # ├───┼─────────────────────────────────────────────────────┤
3333 # │%*X│soft-fill with character “X” as pad │
3334 # └───┴─────────────────────────────────────────────────────┘
3336 # For an explanation of “soft-fill”, see the $index_format documentation.
3338 # * = can be optionally printed if nonzero, see the $status_format documentation.
3347 # This variable controls whether “quit” and “exit” actually quit from mutt. If
3348 # this option is set, they do quit, if it is unset, they have no effect, and if
3349 # it is set to ask-yes or ask-no, you are prompted for confirmation when you try
3354 # 3.237. quote_regexp
3356 # Type: regular expression
3357 # Default: “^([ t]*[|>:}#])+”
3359 # A regular expression used in the internal pager to determine quoted sections of
3360 # text in the body of a message. Quoted text may be filtered out using the
3361 # <toggle-quoted> command, or colored according to the “color quoted” family of
3364 # Higher levels of quoting may be colored differently (“color quoted1”, “color
3365 # quoted2”, etc.). The quoting level is determined by removing the last character
3366 # from the matched text and recursively reapplying the regular expression until
3367 # it fails to produce a match.
3369 # Match detection may be overridden by the $smileys regular expression.
3378 # If set to a value greater than 0, Mutt will display which message it is
3379 # currently on when reading a mailbox or when performing search actions such as
3380 # search and limit. The message is printed after this many messages have been
3381 # read or searched (e.g., if set to 25, Mutt will print a message when it is at
3382 # message 25, and then again when it gets to message 50). This variable is meant
3383 # to indicate progress when reading or searching large mailboxes which may take
3384 # some time. When set to 0, only a single message will appear before the reading
3387 # Also see the $write_inc, $net_inc and $time_inc variables and the “tuning”
3388 # section of the manual for performance considerations.
3397 # If set, all folders are opened in read-only mode.
3406 # This variable specifies what “real” or “personal” name should be used when
3409 # By default, this is the GECOS field from /etc/passwd. Note that this variable
3410 # will not be used when the user has set a real name in the $from variable.
3419 # Controls whether or not Mutt recalls postponed messages when composing a new
3422 # Setting this variable to yes is not generally useful, and thus not recommended.
3423 # Note that the <recall-message> function can be used to manually recall
3424 # postponed messages.
3426 # Also see $postponed variable.
3436 # This specifies the file into which your outgoing messages should be appended.
3437 # (This is meant as the primary method for saving a copy of your messages, but
3438 # another way to do this is using the “my_hdr” command to create a “Bcc:” field
3439 # with your email address in it.)
3441 # The value of $record is overridden by the $force_name and $save_name variables,
3442 # and the “fcc-hook” command.
3447 # 3.243. reflow_space_quotes
3452 # This option controls how quotes from format=flowed messages are displayed in
3453 # the pager and when replying (with $text_flowed unset). When set, this option
3454 # adds spaces after each level of quote marks, turning ">>>foo" into "> > > foo".
3456 # Note: If $reflow_text is unset, this option has no effect. Also, this option
3457 # does not affect replies when $text_flowed is set.
3461 # 3.244. reflow_text
3466 # When set, Mutt will reformat paragraphs in text/plain parts marked format=
3467 # flowed. If unset, Mutt will display paragraphs unaltered from how they appear
3468 # in the message body. See RFC3676 for details on the format=flowed format.
3470 # Also see $reflow_wrap, and $wrap.
3474 # 3.245. reflow_wrap
3479 # This variable controls the maximum paragraph width when reformatting text/plain
3480 # parts when $reflow_text is set. When the value is 0, paragraphs will be wrapped
3481 # at the terminal's right margin. A positive value sets the paragraph width
3482 # relative to the left margin. A negative value set the paragraph width relative
3483 # to the right margin.
3490 # 3.246. reply_regexp
3492 # Type: regular expression
3493 # Default: “^(re([[0-9]+])*|aw):[ t]*”
3495 # A regular expression used to recognize reply messages when threading and
3496 # replying. The default value corresponds to the English "Re:" and the German
3499 set reply_regexp="^((re([-[(]?[[:digit:]]+[)]]?)?|a(nt)?w(ort)?|wg|s(gkb|v)):[[:space:]]*)+"
3507 # If unset and you are replying to a message sent by you, Mutt will assume that
3508 # you want to reply to the recipients of that message rather than to yourself.
3510 # Also see the “alternates” command.
3519 # If set, when replying to a message, Mutt will use the address listed in the
3520 # Reply-to: header as the recipient of the reply. If unset, it will use the
3521 # address in the From: header field instead. This option is useful for reading a
3522 # mailing list that sets the Reply-To: header field to the list address and you
3523 # want to send a private message to the author of a message.
3532 # When set, the cursor will be automatically advanced to the next (possibly
3533 # undeleted) message whenever a command that modifies the current message is
3538 # 3.250. resume_draft_files
3543 # If set, draft files (specified by -H on the command line) are processed
3544 # similarly to when resuming a postponed message. Recipients are not prompted
3545 # for; send-hooks are not evaluated; no alias expansion takes place; user-defined
3546 # headers and signatures are not added to the message.
3550 # 3.251. resume_edited_draft_files
3555 # If set, draft files previously edited (via -E -H on the command line) will have
3556 # $resume_draft_files automatically set when they are used as a draft file again.
3558 # The first time a draft file is saved, mutt will add a header,
3559 # X-Mutt-Resume-Draft to the saved file. The next time the draft file is read in,
3560 # if mutt sees the header, it will set $resume_draft_files.
3562 # This option is designed to prevent multiple signatures, user-defined headers,
3563 # and other processing effects from being made multiple times to the draft file.
3567 # 3.252. reverse_alias
3572 # This variable controls whether or not Mutt will display the “personal” name
3573 # from your aliases in the index menu if it finds an alias that matches the
3574 # message's sender. For example, if you have the following alias:
3576 # alias juser abd30425@somewhere.net (Joe User)
3578 # and then you receive mail which contains the following header:
3580 # From: abd30425@somewhere.net
3582 # It would be displayed in the index menu as “Joe User” instead of “
3583 # abd30425@somewhere.net.” This is useful when the person's e-mail address is not
3588 # 3.253. reverse_name
3593 # It may sometimes arrive that you receive mail to a certain machine, move the
3594 # messages to another machine, and reply to some the messages from there. If this
3595 # variable is set, the default From: line of the reply messages is built using
3596 # the address where you received the messages you are replying to if that address
3597 # matches your “alternates”. If the variable is unset, or the address that would
3598 # be used doesn't match your “alternates”, the From: line will use your address
3599 # on the current machine.
3601 # Also see the “alternates” command.
3603 set reverse_name=yes
3606 # 3.254. reverse_realname
3611 # This variable fine-tunes the behavior of the $reverse_name feature. When it is
3612 # set, mutt will use the address from incoming messages as-is, possibly including
3613 # eventual real names. When it is unset, mutt will override any such real names
3614 # with the setting of the $realname variable.
3618 # 3.255. rfc2047_parameters
3623 # When this variable is set, Mutt will decode RFC2047-encoded MIME parameters.
3624 # You want to set this variable when mutt suggests you to save attachments to
3627 # =?iso-8859-1?Q?file=5F=E4=5F991116=2Ezip?=
3629 # When this variable is set interactively, the change won't be active until you
3632 # Note that this use of RFC2047's encoding is explicitly prohibited by the
3633 # standard, but nevertheless encountered in the wild.
3635 # Also note that setting this parameter will not have the effect that mutt
3636 # generates this kind of encoding. Instead, mutt will unconditionally use the
3637 # encoding specified in RFC2231.
3639 set rfc2047_parameters=yes
3642 # 3.256. save_address
3647 # If set, mutt will take the sender's full address when choosing a default folder
3648 # for saving a mail. If $save_name or $force_name is set too, the selection of
3649 # the Fcc folder will be changed as well.
3658 # When unset, mailboxes which contain no saved messages will be removed when
3659 # closed (the exception is $spoolfile which is never removed). If set, mailboxes
3660 # are never removed.
3662 # Note: This only applies to mbox and MMDF folders, Mutt does not delete MH and
3663 # Maildir directories.
3667 # 3.258. save_history
3672 # This variable controls the size of the history (per category) saved in the
3673 # $history_file file.
3675 set save_history=100
3683 # This variable controls how copies of outgoing messages are saved. When set, a
3684 # check is made to see if a mailbox specified by the recipient address exists
3685 # (this is done by searching for a mailbox in the $folder directory with the
3686 # username part of the recipient address). If the mailbox exists, the outgoing
3687 # message will be saved to that mailbox, otherwise the message is saved to the
3690 # Also see the $force_name variable.
3699 # When this variable is unset, scoring is turned off. This can be useful to
3700 # selectively disable scoring for certain folders when the
3701 # $score_threshold_delete variable and related are used.
3705 # 3.261. score_threshold_delete
3710 # Messages which have been assigned a score equal to or lower than the value of
3711 # this variable are automatically marked for deletion by mutt. Since mutt scores
3712 # are always greater than or equal to zero, the default setting of this variable
3713 # will never mark a message for deletion.
3717 # 3.262. score_threshold_flag
3722 # Messages which have been assigned a score greater than or equal to this
3723 # variable's value are automatically marked "flagged".
3727 # 3.263. score_threshold_read
3732 # Messages which have been assigned a score equal to or lower than the value of
3733 # this variable are automatically marked as read by mutt. Since mutt scores are
3734 # always greater than or equal to zero, the default setting of this variable will
3735 # never mark a message read.
3739 # 3.264. search_context
3744 # For the pager, this variable specifies the number of lines shown before search
3745 # results. By default, search results will be top-aligned.
3747 set search_context=5
3750 # 3.265. send_charset
3753 # Default: “us-ascii:iso-8859-1:utf-8”
3755 # A colon-delimited list of character sets for outgoing messages. Mutt will use
3756 # the first character set into which the text can be converted exactly. If your
3757 # $charset is not “iso-8859-1” and recipients may not understand “UTF-8”, it is
3758 # advisable to include in the list an appropriate widely used standard character
3759 # set (such as “iso-8859-2”, “koi8-r” or “iso-2022-jp”) either instead of or
3760 # after “iso-8859-1”.
3762 # In case the text cannot be converted into one of these exactly, mutt uses
3763 # $charset as a fallback.
3765 set send_charset="utf-8"
3771 # Default: “/usr/sbin/sendmail -oem -oi”
3773 # Specifies the program and arguments used to deliver mail sent by Mutt. Mutt
3774 # expects that the specified program interprets additional arguments as recipient
3775 # addresses. Mutt appends all recipients after adding a -- delimiter (if not
3776 # already present). Additional flags, such as for $use_8bitmime,
3777 # $use_envelope_from, $dsn_notify, or $dsn_return will be added before the
3780 set sendmail="$my_confdir/sendmail"
3783 # 3.267. sendmail_wait
3788 # Specifies the number of seconds to wait for the $sendmail process to finish
3789 # before giving up and putting delivery in the background.
3791 # Mutt interprets the value of this variable as follows:
3793 # ┌──┬──────────────────────────────────────────────────────────────────┐
3794 # │>0│number of seconds to wait for sendmail to finish before continuing│
3795 # ├──┼──────────────────────────────────────────────────────────────────┤
3796 # │0 │wait forever for sendmail to finish │
3797 # ├──┼──────────────────────────────────────────────────────────────────┤
3798 # │<0│always put sendmail in the background without waiting │
3799 # └──┴──────────────────────────────────────────────────────────────────┘
3801 # Note that if you specify a value other than 0, the output of the child process
3802 # will be put in a temporary file. If there is some error, you will be informed
3803 # as to where to find the output.
3812 # Command to use when spawning a subshell. By default, the user's login shell
3813 # from /etc/passwd is used.
3817 # 3.269. sidebar_delim_chars
3822 # This contains the list of characters which you would like to treat as folder
3823 # separators for displaying paths in the sidebar.
3825 # Local mail is often arranged in directories: `dir1/dir2/mailbox'.
3827 # set sidebar_delim_chars='/'
3829 # IMAP mailboxes are often named: `folder1.folder2.mailbox'.
3831 # set sidebar_delim_chars='.'
3833 # See also: $sidebar_short_path, $sidebar_folder_indent, $sidebar_indent_string.
3837 # 3.270. sidebar_divider_char
3842 # This specifies the characters to be drawn between the sidebar (when visible)
3843 # and the other Mutt panels. ASCII and Unicode line-drawing characters are
3846 set sidebar_divider_char=" "
3849 # 3.271. sidebar_folder_indent
3854 # Set this to indent mailboxes in the sidebar.
3856 # See also: $sidebar_short_path, $sidebar_indent_string, $sidebar_delim_chars.
3858 set sidebar_folder_indent=yes
3861 # 3.272. sidebar_format
3864 # Default: “%B%* %n”
3866 # This variable allows you to customize the sidebar display. This string is
3867 # similar to $index_format, but has its own set of printf(3)-like sequences:
3869 # ┌───┬─────────────────────────────────────────────────────────────────────────┐
3870 # │%B │Name of the mailbox │
3871 # ├───┼─────────────────────────────────────────────────────────────────────────┤
3872 # │%S │* Size of mailbox (total number of messages) │
3873 # ├───┼─────────────────────────────────────────────────────────────────────────┤
3874 # │%N │* Number of unread messages in the mailbox │
3875 # ├───┼─────────────────────────────────────────────────────────────────────────┤
3876 # │%n │N if mailbox has new mail, blank otherwise │
3877 # ├───┼─────────────────────────────────────────────────────────────────────────┤
3878 # │%F │* Number of Flagged messages in the mailbox │
3879 # ├───┼─────────────────────────────────────────────────────────────────────────┤
3880 # │%! │“!” : one flagged message; “!!” : two flagged messages; “n!” : n flagged │
3881 # │ │messages (for n > 2). Otherwise prints nothing. │
3882 # ├───┼─────────────────────────────────────────────────────────────────────────┤
3883 # │%d │* @ Number of deleted messages │
3884 # ├───┼─────────────────────────────────────────────────────────────────────────┤
3885 # │%L │* @ Number of messages after limiting │
3886 # ├───┼─────────────────────────────────────────────────────────────────────────┤
3887 # │%t │* @ Number of tagged messages │
3888 # ├───┼─────────────────────────────────────────────────────────────────────────┤
3889 # │%>X│right justify the rest of the string and pad with “X” │
3890 # ├───┼─────────────────────────────────────────────────────────────────────────┤
3891 # │%|X│pad to the end of the line with “X” │
3892 # ├───┼─────────────────────────────────────────────────────────────────────────┤
3893 # │%*X│soft-fill with character “X” as pad │
3894 # └───┴─────────────────────────────────────────────────────────────────────────┘
3896 # * = Can be optionally printed if nonzero @ = Only applicable to the current
3899 # In order to use %S, %N, %F, and %!, $mail_check_stats must be set. When thus
3900 # set, a suggested value for this option is "%B%?F? [%F]?%* %?N?%N/?%S".
3902 set sidebar_format="%B%?F? [%F]?%* %?N?%N/?%S"
3905 # 3.273. sidebar_indent_string
3910 # This specifies the string that is used to indent mailboxes in the sidebar. It
3911 # defaults to two spaces.
3913 # See also: $sidebar_short_path, $sidebar_folder_indent, $sidebar_delim_chars.
3915 set sidebar_indent_string=" "
3918 # 3.274. sidebar_new_mail_only
3923 # When set, the sidebar will only display mailboxes containing new, or flagged,
3926 # See also: sidebar_whitelist.
3930 # 3.275. sidebar_next_new_wrap
3935 # When set, the <sidebar-next-new> command will not stop and the end of the list
3936 # of mailboxes, but wrap around to the beginning. The <sidebar-prev-new> command
3937 # is similarly affected, wrapping around to the end of the list.
3939 set sidebar_next_new_wrap=yes
3942 # 3.276. sidebar_short_path
3947 # By default the sidebar will show the mailbox's path, relative to the $folder
3948 # variable. Setting sidebar_shortpath=yes will shorten the names relative to the
3949 # previous name. Here's an example:
3951 # ┌────────────┬─────────────┬───────────────────────────────────────────────┐
3952 # │shortpath=no│shortpath=yes│shortpath=yes, folderindent=yes, indentstr=".."│
3953 # ├────────────┼─────────────┼───────────────────────────────────────────────┤
3954 # │fruit │fruit │fruit │
3955 # ├────────────┼─────────────┼───────────────────────────────────────────────┤
3956 # │fruit.apple │apple │..apple │
3957 # ├────────────┼─────────────┼───────────────────────────────────────────────┤
3958 # │fruit.banana│banana │..banana │
3959 # ├────────────┼─────────────┼───────────────────────────────────────────────┤
3960 # │fruit.cherry│cherry │..cherry │
3961 # └────────────┴─────────────┴───────────────────────────────────────────────┘
3963 # See also: $sidebar_delim_chars, $sidebar_folder_indent, $sidebar_indent_string.
3965 set sidebar_short_path=yes
3968 # 3.277. sidebar_sort_method
3973 # Specifies how to sort entries in the file browser. By default, the entries are
3974 # sorted alphabetically. Valid values:
3976 # • alpha (alphabetically)
3978 # • count (all message count)
3980 # • flagged (flagged message count)
3982 # • name (alphabetically)
3984 # • new (unread message count)
3986 # • path (alphabetically)
3988 # • unread (unread message count)
3992 # You may optionally use the “reverse-” prefix to specify reverse sorting order
3993 # (example: “set sort_browser=reverse-date”).
3995 set sidebar_sort_method=path
3998 # 3.278. sidebar_visible
4003 # This specifies whether or not to show sidebar. The sidebar shows a list of all
4006 # See also: $sidebar_format, $sidebar_width
4008 set sidebar_visible=yes
4011 # 3.279. sidebar_width
4016 # This controls the width of the sidebar. It is measured in screen columns. For
4017 # example: sidebar_width=20 could display 20 ASCII characters, or 10 Chinese
4020 set sidebar_width=20
4028 # If set, a line containing “-- ” (note the trailing space) will be inserted
4029 # before your $signature. It is strongly recommended that you not unset this
4030 # variable unless your signature contains just your name. The reason for this is
4031 # because many software packages use “-- n” to detect your signature. For
4032 # example, Mutt has the ability to highlight the signature in a different color
4033 # in the built-in pager.
4043 # If set, the signature will be included before any quoted or forwarded text. It
4044 # is strongly recommended that you do not set this variable unless you really
4045 # know what you are doing, and are prepared to take some heat from netiquette
4053 # Default: “~/.signature”
4055 # Specifies the filename of your signature, which is appended to all outgoing
4056 # messages. If the filename ends with a pipe (“|”), it is assumed that filename
4057 # is a shell command and input should be read from its standard output.
4061 # 3.283. simple_search
4064 # Default: “~f %s | ~s %s”
4066 # Specifies how Mutt should expand a simple search into a real search pattern. A
4067 # simple search is one that does not contain any of the “~” pattern operators.
4068 # See “patterns” for more information on search patterns.
4070 # For example, if you simply type “joe” at a search or limit prompt, Mutt will
4071 # automatically expand it to the value specified by this variable by replacing “
4072 # %s” with the supplied string. For the default value, “joe” would be expanded
4073 # to: “~f joe | ~s joe”.
4075 set simple_search="~L %s | ~s %s"
4083 # Specifies time, in seconds, to pause while displaying certain informational
4084 # messages, while moving from folder to folder and after expunging messages from
4085 # the current folder. The default is to pause one second, so a value of zero for
4086 # this option suppresses the pause.
4095 # Controls the display of lines longer than the screen width in the internal
4096 # pager. If set, long lines are wrapped at a word boundary. If unset, lines are
4097 # simply wrapped at the screen edge. Also see the $markers variable.
4103 # Type: regular expression
4104 # Default: “(>From )|(:[-^]?[][)(><}{|/DP])”
4106 # The pager uses this variable to catch some common false positives of
4107 # $quote_regexp, most notably smileys and not consider a line quoted text if it
4108 # also matches $smileys. This mostly happens at the beginning of a line.
4112 # 3.287. smime_ask_cert_label
4117 # This flag controls whether you want to be asked to enter a label for a
4118 # certificate about to be added to the database or not. It is set by default. (S/
4123 # 3.288. smime_ca_location
4128 # This variable contains the name of either a directory, or a file which contains
4129 # trusted certificates for use with OpenSSL. (S/MIME only)
4133 # 3.289. smime_certificates
4138 # Since for S/MIME there is no pubring/secring as with PGP, mutt has to handle
4139 # storage and retrieval of keys by itself. This is very basic right now, and keys
4140 # and certificates are stored in two different directories, both named as the
4141 # hash-value retrieved from OpenSSL. There is an index file which contains
4142 # mailbox-address keyid pairs, and which can be manually edited. This option
4143 # points to the location of the certificates. (S/MIME only)
4145 set smime_certificates="~/.smime/certificates"
4148 # 3.290. smime_decrypt_command
4153 # This format string specifies a command which is used to decrypt application/
4154 # x-pkcs7-mime attachments.
4156 # The OpenSSL command formats have their own set of printf(3)-like sequences
4159 # ┌──┬──────────────────────────────────────────────────────────────────────────┐
4160 # │%f│Expands to the name of a file containing a message. │
4161 # ├──┼──────────────────────────────────────────────────────────────────────────┤
4162 # │%s│Expands to the name of a file containing the signature part of a multipart│
4163 # │ │/signed attachment when verifying it. │
4164 # ├──┼──────────────────────────────────────────────────────────────────────────┤
4165 # │%k│The key-pair specified with $smime_default_key │
4166 # ├──┼──────────────────────────────────────────────────────────────────────────┤
4167 # │%c│One or more certificate IDs. │
4168 # ├──┼──────────────────────────────────────────────────────────────────────────┤
4169 # │%a│The algorithm used for encryption. │
4170 # ├──┼──────────────────────────────────────────────────────────────────────────┤
4171 # │%d│The message digest algorithm specified with $smime_sign_digest_alg. │
4172 # ├──┼──────────────────────────────────────────────────────────────────────────┤
4173 # │ │CA location: Depending on whether $smime_ca_location points to a directory│
4174 # │%C│or file, this expands to “-CApath $smime_ca_location” or “-CAfile │
4175 # │ │$smime_ca_location”. │
4176 # └──┴──────────────────────────────────────────────────────────────────────────┘
4178 # For examples on how to configure these formats, see the smime.rc in the samples
4179 # / subdirectory which has been installed on your system alongside the
4180 # documentation. (S/MIME only)
4184 # 3.291. smime_decrypt_use_default_key
4189 # If set (default) this tells mutt to use the default key for decryption.
4190 # Otherwise, if managing multiple certificate-key-pairs, mutt will try to use the
4191 # mailbox-address to determine the key to use. It will ask you to supply a key,
4192 # if it can't find one. (S/MIME only)
4196 # 3.292. smime_default_key
4201 # This is the default key-pair to use for S/MIME operations, and must be set to
4202 # the keyid (the hash-value that OpenSSL generates) to work properly.
4204 # It will be used for encryption (see $postpone_encrypt and $smime_self_encrypt).
4206 # It will be used for decryption unless $smime_decrypt_use_default_key is unset.
4208 # It will also be used for signing unless $smime_sign_as is set.
4210 # The (now deprecated) smime_self_encrypt_as is an alias for this variable, and
4211 # should no longer be used. (S/MIME only)
4215 # 3.293. smime_encrypt_command
4220 # This command is used to create encrypted S/MIME messages.
4222 # This is a format string, see the $smime_decrypt_command command for possible
4223 # printf(3)-like sequences. (S/MIME only)
4227 # 3.294. smime_encrypt_with
4232 # This sets the algorithm that should be used for encryption. Valid choices are “
4233 # aes128”, “aes192”, “aes256”, “des”, “des3”, “rc2-40”, “rc2-64”, “rc2-128”. (S/
4238 # 3.295. smime_get_cert_command
4243 # This command is used to extract X509 certificates from a PKCS7 structure.
4245 # This is a format string, see the $smime_decrypt_command command for possible
4246 # printf(3)-like sequences. (S/MIME only)
4250 # 3.296. smime_get_cert_email_command
4255 # This command is used to extract the mail address(es) used for storing X509
4256 # certificates, and for verification purposes (to check whether the certificate
4257 # was issued for the sender's mailbox).
4259 # This is a format string, see the $smime_decrypt_command command for possible
4260 # printf(3)-like sequences. (S/MIME only)
4264 # 3.297. smime_get_signer_cert_command
4269 # This command is used to extract only the signers X509 certificate from a S/MIME
4270 # signature, so that the certificate's owner may get compared to the email's “
4273 # This is a format string, see the $smime_decrypt_command command for possible
4274 # printf(3)-like sequences. (S/MIME only)
4278 # 3.298. smime_import_cert_command
4283 # This command is used to import a certificate via smime_keys.
4285 # This is a format string, see the $smime_decrypt_command command for possible
4286 # printf(3)-like sequences. (S/MIME only)
4290 # 3.299. smime_is_default
4295 # The default behavior of mutt is to use PGP on all auto-sign/encryption
4296 # operations. To override and to use OpenSSL instead this must be set. However,
4297 # this has no effect while replying, since mutt will automatically select the
4298 # same application that was used to sign/encrypt the original message. (Note that
4299 # this variable can be overridden by unsetting $crypt_autosmime.) (S/MIME only)
4308 # Since for S/MIME there is no pubring/secring as with PGP, mutt has to handle
4309 # storage and retrieval of keys/certs by itself. This is very basic right now,
4310 # and stores keys and certificates in two different directories, both named as
4311 # the hash-value retrieved from OpenSSL. There is an index file which contains
4312 # mailbox-address keyid pair, and which can be manually edited. This option
4313 # points to the location of the private keys. (S/MIME only)
4315 set smime_keys="~/.smime/keys"
4318 # 3.301. smime_pk7out_command
4323 # This command is used to extract PKCS7 structures of S/MIME signatures, in order
4324 # to extract the public X509 certificate(s).
4326 # This is a format string, see the $smime_decrypt_command command for possible
4327 # printf(3)-like sequences. (S/MIME only)
4331 # 3.302. smime_self_encrypt
4336 # When set, S/MIME encrypted messages will also be encrypted using the
4337 # certificate in $smime_default_key. (S/MIME only)
4341 # 3.303. smime_sign_as
4346 # If you have a separate key to use for signing, you should set this to the
4347 # signing key. Most people will only need to set $smime_default_key. (S/MIME
4352 # 3.304. smime_sign_command
4357 # This command is used to created S/MIME signatures of type multipart/signed,
4358 # which can be read by all mail clients.
4360 # This is a format string, see the $smime_decrypt_command command for possible
4361 # printf(3)-like sequences. NOTE: %c and %k will default to $smime_sign_as if
4362 # set, otherwise $smime_default_key. (S/MIME only)
4366 # 3.305. smime_sign_digest_alg
4371 # This sets the algorithm that should be used for the signature message digest.
4372 # Valid choices are “md5”, “sha1”, “sha224”, “sha256”, “sha384”, “sha512”. (S/
4377 # 3.306. smime_sign_opaque_command
4382 # This command is used to created S/MIME signatures of type application/
4383 # x-pkcs7-signature, which can only be handled by mail clients supporting the S/
4386 # This is a format string, see the $smime_decrypt_command command for possible
4387 # printf(3)-like sequences. (S/MIME only)
4391 # 3.307. smime_timeout
4396 # The number of seconds after which a cached passphrase will expire if not used.
4401 # 3.308. smime_verify_command
4406 # This command is used to verify S/MIME signatures of type multipart/signed.
4408 # This is a format string, see the $smime_decrypt_command command for possible
4409 # printf(3)-like sequences. (S/MIME only)
4413 # 3.309. smime_verify_opaque_command
4418 # This command is used to verify S/MIME signatures of type application/
4421 # This is a format string, see the $smime_decrypt_command command for possible
4422 # printf(3)-like sequences. (S/MIME only)
4426 # 3.310. smtp_authenticators
4431 # This is a colon-delimited list of authentication methods mutt may attempt to
4432 # use to log in to an SMTP server, in the order mutt should try them.
4433 # Authentication methods are any SASL mechanism, e.g. “digest-md5”, “gssapi” or “
4434 # cram-md5”. This option is case-insensitive. If it is “unset” (the default) mutt
4435 # will try all available methods, in order from most-secure to least-secure.
4439 # set smtp_authenticators="digest-md5:cram-md5"
4443 # 3.311. smtp_oauth_refresh_command
4448 # The command to run to generate an OAUTH refresh token for authorizing your
4449 # connection to your SMTP server. This command will be run on every connection
4450 # attempt that uses the OAUTHBEARER authentication mechanism.
4459 # Specifies the password for your SMTP account. If unset, Mutt will prompt you
4460 # for your password when you first send mail via SMTP. See $smtp_url to configure
4461 # mutt to send mail via SMTP.
4463 # Warning: you should only use this option when you are on a fairly secure
4464 # machine, because the superuser can read your muttrc even if you are the only
4465 # one who can read the file.
4474 # Defines the SMTP smarthost where sent messages should relayed for delivery.
4475 # This should take the form of an SMTP URL, e.g.:
4477 # smtp[s]://[user[:pass]@]host[:port]
4479 # where “[...]” denotes an optional part. Setting this variable overrides the
4480 # value of the $sendmail variable.
4489 # Specifies how to sort messages in the “index” menu. Valid values are:
4491 # • date or date-sent
4497 # • mailbox-order (unsorted)
4511 # You may optionally use the “reverse-” prefix to specify reverse sorting order
4512 # (example: “set sort=reverse-date-sent”).
4522 # Specifies how the entries in the “alias” menu are sorted. The following are
4525 # • address (sort alphabetically by email address)
4527 # • alias (sort alphabetically by alias name)
4529 # • unsorted (leave in order specified in .muttrc)
4538 # When sorting by threads, this variable controls how threads are sorted in
4539 # relation to other threads, and how the branches of the thread trees are sorted.
4540 # This can be set to any value that $sort can, except “threads” (in that case,
4541 # mutt will just use “date-sent”). You can also specify the “last-” prefix in
4542 # addition to the “reverse-” prefix, but “last-” must come after “reverse-”. The
4543 # “last-” prefix causes messages to be sorted against its siblings by which has
4544 # the last descendant, using the rest of $sort_aux as an ordering. For instance,
4546 # set sort_aux=last-date-received
4548 # would mean that if a new message is received in a thread, that thread becomes
4549 # the last one displayed (or the first, if you have “set sort=reverse-threads”.)
4551 # Note: For reversed $sort order $sort_aux is reversed again (which is not the
4552 # right thing to do, but kept to not break any existing configuration setting).
4554 set sort_aux=last-date-received
4557 # 3.317. sort_browser
4562 # Specifies how to sort entries in the file browser. By default, the entries are
4563 # sorted alphabetically. Valid values:
4565 # • alpha (alphabetically)
4577 # You may optionally use the “reverse-” prefix to specify reverse sorting order
4578 # (example: “set sort_browser=reverse-date”).
4587 # This variable is only useful when sorting by threads with $strict_threads unset
4588 # . In that case, it changes the heuristic mutt uses to thread messages by
4589 # subject. With $sort_re set, mutt will only attach a message as the child of
4590 # another message by subject if the subject of the child message starts with a
4591 # substring matching the setting of $reply_regexp. With $sort_re unset, mutt will
4592 # attach the message whether or not this is the case, as long as the non-
4593 # $reply_regexp parts of both messages are identical.
4597 # 3.319. spam_separator
4602 # This variable controls what happens when multiple spam headers are matched: if
4603 # unset, each successive header will overwrite any previous matches value for the
4604 # spam label. If set, each successive match will append to the previous, using
4605 # this variable's value as a separator.
4614 # If your spool mailbox is in a non-default place where Mutt cannot find it, you
4615 # can specify its location with this variable. Mutt will initially set this
4616 # variable to the value of the environment variable $MAIL or $MAILDIR if either
4619 set spoolfile="=inbox"
4622 # 3.321. ssl_ca_certificates_file
4627 # This variable specifies a file containing trusted CA certificates. Any server
4628 # certificate that is signed with one of these CA certificates is also
4629 # automatically accepted. (GnuTLS only)
4633 # set ssl_ca_certificates_file=/etc/ssl/certs/ca-certificates.crt
4635 set ssl_ca_certificates_file="/etc/ssl/certs/ca-certificates.crt"
4638 # 3.322. ssl_client_cert
4643 # The file containing a client certificate and its associated private key.
4647 # 3.323. ssl_force_tls
4652 # If this variable is set, Mutt will require that all connections to remote
4653 # servers be encrypted. Furthermore it will attempt to negotiate TLS even if the
4654 # server does not advertise the capability, since it would otherwise have to
4655 # abort the connection anyway. This option supersedes $ssl_starttls.
4659 # 3.324. ssl_min_dh_prime_bits
4664 # This variable specifies the minimum acceptable prime size (in bits) for use in
4665 # any Diffie-Hellman key exchange. A value of 0 will use the default from the
4666 # GNUTLS library. (GnuTLS only)
4670 # 3.325. ssl_starttls
4675 # If set (the default), mutt will attempt to use STARTTLS on servers advertising
4676 # the capability. When unset, mutt will not attempt to use STARTTLS regardless of
4677 # the server's capabilities.
4681 # 3.326. ssl_use_sslv2
4686 # This variable specifies whether to attempt to use SSLv2 in the SSL
4687 # authentication process. Note that SSLv2 and SSLv3 are now considered
4688 # fundamentally insecure and are no longer recommended. (OpenSSL only)
4692 # 3.327. ssl_use_sslv3
4697 # This variable specifies whether to attempt to use SSLv3 in the SSL
4698 # authentication process. Note that SSLv2 and SSLv3 are now considered
4699 # fundamentally insecure and are no longer recommended.
4703 # 3.328. ssl_use_tlsv1
4708 # This variable specifies whether to attempt to use TLSv1.0 in the SSL
4709 # authentication process.
4713 # 3.329. ssl_use_tlsv1_1
4718 # This variable specifies whether to attempt to use TLSv1.1 in the SSL
4719 # authentication process.
4723 # 3.330. ssl_use_tlsv1_2
4728 # This variable specifies whether to attempt to use TLSv1.2 in the SSL
4729 # authentication process.
4733 # 3.331. ssl_usesystemcerts
4738 # If set to yes, mutt will use CA certificates in the system-wide certificate
4739 # store when checking if a server certificate is signed by a trusted CA. (OpenSSL
4744 # 3.332. ssl_verify_dates
4749 # If set (the default), mutt will not automatically accept a server certificate
4750 # that is either not yet valid or already expired. You should only unset this for
4751 # particular known hosts, using the <account-hook> function.
4755 # 3.333. ssl_verify_host
4760 # If set (the default), mutt will not automatically accept a server certificate
4761 # whose host name does not match the host used in your folder URL. You should
4762 # only unset this for particular known hosts, using the <account-hook> function.
4766 # 3.334. ssl_verify_partial_chains
4771 # This option should not be changed from the default unless you understand what
4774 # Setting this variable to yes will permit verifying partial certification
4775 # chains, i. e. a certificate chain where not the root, but an intermediate
4776 # certificate CA, or the host certificate, are marked trusted (in
4777 # $certificate_file), without marking the root signing CA as trusted.
4779 # (OpenSSL 1.0.2b and newer only).
4783 # 3.335. ssl_ciphers
4788 # Contains a colon-seperated list of ciphers to use when using SSL. For OpenSSL,
4789 # see ciphers(1) for the syntax of the string.
4791 # For GnuTLS, this option will be used in place of "NORMAL" at the start of the
4792 # priority string. See gnutls_priority_init(3) for the syntax and more details.
4793 # (Note: GnuTLS version 2.1.7 or higher is required.)
4797 # 3.336. status_chars
4802 # Controls the characters used by the “%r” indicator in $status_format. The first
4803 # character is used when the mailbox is unchanged. The second is used when the
4804 # mailbox has been changed, and it needs to be resynchronized. The third is used
4805 # if the mailbox is in read-only mode, or if the mailbox will not be written when
4806 # exiting that mailbox (You can toggle whether to write changes to a mailbox with
4807 # the <toggle-write> operation, bound by default to “%”). The fourth is used to
4808 # indicate that the current folder has been opened in attach- message mode
4809 # (Certain operations like composing a new mail, replying, forwarding, etc. are
4810 # not permitted in this mode).
4814 # 3.337. status_format
4817 # Default: “-%r-Mutt: %f [Msgs:%?M?%M/?%m%?n? New:%n?%?o? Old:%o?%?d? Del:%d?%?F?
4818 # Flag:%F?%?t? Tag:%t?%?p? Post:%p?%?b? Inc:%b?%?l? %l?]---(%s/%S)-%>-(%P)---”
4820 # Controls the format of the status line displayed in the “index” menu. This
4821 # string is similar to $index_format, but has its own set of printf(3)-like
4824 # ┌───┬─────────────────────────────────────────────────────────────────────────┐
4825 # │%b │number of mailboxes with new mail * │
4826 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4827 # │%d │number of deleted messages * │
4828 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4829 # │%f │the full pathname of the current mailbox │
4830 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4831 # │%F │number of flagged messages * │
4832 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4833 # │%h │local hostname │
4834 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4835 # │%l │size (in bytes) of the current mailbox * │
4836 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4837 # │%L │size (in bytes) of the messages shown (i.e., which match the current │
4839 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4840 # │%m │the number of messages in the mailbox * │
4841 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4842 # │%M │the number of messages shown (i.e., which match the current limit) * │
4843 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4844 # │%n │number of new messages in the mailbox * │
4845 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4846 # │%o │number of old unread messages * │
4847 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4848 # │%p │number of postponed messages * │
4849 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4850 # │%P │percentage of the way through the index │
4851 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4852 # │%r │modified/read-only/won't-write/attach-message indicator, according to │
4853 # │ │$status_chars │
4854 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4855 # │%R │number of read messages * │
4856 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4857 # │%s │current sorting mode ($sort) │
4858 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4859 # │%S │current aux sorting method ($sort_aux) │
4860 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4861 # │%t │number of tagged messages * │
4862 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4863 # │%u │number of unread messages * │
4864 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4865 # │%v │Mutt version string │
4866 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4867 # │%V │currently active limit pattern, if any * │
4868 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4869 # │%>X│right justify the rest of the string and pad with “X” │
4870 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4871 # │%|X│pad to the end of the line with “X” │
4872 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4873 # │%*X│soft-fill with character “X” as pad │
4874 # └───┴─────────────────────────────────────────────────────────────────────────┘
4876 # For an explanation of “soft-fill”, see the $index_format documentation.
4878 # * = can be optionally printed if nonzero
4880 # Some of the above sequences can be used to optionally print a string if their
4881 # value is nonzero. For example, you may only want to see the number of flagged
4882 # messages if such messages exist, since zero is not particularly meaningful. To
4883 # optionally print a string based upon one of the above sequences, the following
4884 # construct is used:
4886 # %?<sequence_char>?<optional_string>?
4888 # where sequence_char is a character from the table above, and optional_string is
4889 # the string you would like printed if sequence_char is nonzero. optional_string
4890 # may contain other sequences as well as normal text, but you may not nest
4893 # Here is an example illustrating how to optionally print the number of new
4894 # messages in a mailbox:
4896 # %?n?%n new messages.?
4898 # You can also switch between two strings using the following construct:
4900 # %?<sequence_char>?<if_string>&<else_string>?
4902 # If the value of sequence_char is non-zero, if_string will be expanded,
4903 # otherwise else_string will be expanded.
4905 # You can force the result of any printf(3)-like sequence to be lowercase by
4906 # prefixing the sequence character with an underscore (“_”) sign. For example, if
4907 # you want to display the local hostname in lowercase, you would use: “%_h”.
4909 # If you prefix the sequence character with a colon (“:”) character, mutt will
4910 # replace any dots in the expansion by underscores. This might be helpful with
4911 # IMAP folders that don't like dots in folder names.
4913 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) "
4916 # 3.338. status_on_top
4921 # Setting this variable causes the “status bar” to be displayed on the first line
4922 # of the screen rather than near the bottom. If $help is set, too it'll be placed
4927 # 3.339. strict_threads
4932 # If set, threading will only make use of the “In-Reply-To” and “References:”
4933 # fields when you $sort by message threads. By default, messages with the same
4934 # subject are grouped together in “pseudo threads.”. This may not always be
4935 # desirable, such as in a personal mailbox where you might have several unrelated
4936 # messages with the subjects like “hi” which will get grouped together. See also
4937 # $sort_re for a less drastic way of controlling this behavior.
4939 set strict_threads=yes
4947 # When unset, mutt won't stop when the user presses the terminal's susp key,
4948 # usually “^Z”. This is useful if you run mutt inside an xterm using a command
4949 # like “xterm -e mutt”.
4953 # 3.341. text_flowed
4958 # When set, mutt will generate “format=flowed” bodies with a content type of “
4959 # text/plain; format=flowed”. This format is easier to handle for some mailing
4960 # software, and generally just looks like ordinary text. To actually make use of
4961 # this format's features, you'll need support in your editor.
4963 # Note that $indent_string is ignored when this option is set.
4968 # 3.342. thorough_search
4973 # Affects the ~b and ~h search operations described in section “patterns”. If set
4974 # , the headers and body/attachments of messages to be searched are decoded
4975 # before searching. If unset, messages are searched as they appear in the folder.
4977 # Users searching attachments or for non-ASCII characters should set this value
4978 # because decoding also includes MIME parsing/decoding and possible character set
4979 # conversions. Otherwise mutt will attempt to match against the raw message
4980 # received (for example quoted-printable encoded or with encoded headers) which
4981 # may lead to incorrect search results.
4983 set thorough_search=yes
4986 # 3.343. thread_received
4991 # When set, mutt uses the date received rather than the date sent to thread
4992 # messages by subject.
4994 set thread_received=yes
5002 # When set, the internal-pager will pad blank lines to the bottom of the screen
5003 # with a tilde (“~”).
5013 # Along with $read_inc, $write_inc, and $net_inc, this variable controls the
5014 # frequency with which progress updates are displayed. It suppresses updates less
5015 # than $time_inc milliseconds apart. This can improve throughput on systems with
5016 # slow terminals, or when running mutt on a remote system.
5018 # Also see the “tuning” section of the manual for performance considerations.
5028 # When Mutt is waiting for user input either idling in menus or in an interactive
5029 # prompt, Mutt would block until input is present. Depending on the context, this
5030 # would prevent certain operations from working, like checking for new mail or
5031 # keeping an IMAP connection alive.
5033 # This variable controls how many seconds Mutt will at most wait until it aborts
5034 # waiting for input, performs these operations and continues to wait for input.
5036 # A value of zero or less will cause Mutt to never time out.
5045 # This variable allows you to specify where Mutt will place its temporary files
5046 # needed for displaying and composing messages. If this variable is not set, the
5047 # environment variable $TMPDIR is used. If $TMPDIR is not set then “/tmp” is
5057 # Controls the character used to indicate mail addressed to you. The first
5058 # character is the one used when the mail is not addressed to your address. The
5059 # second is used when you are the only recipient of the message. The third is
5060 # when your address appears in the “To:” header field, but you are not the only
5061 # recipient of the message. The fourth character is used when your address is
5062 # specified in the “Cc:” header field, but you are not the only recipient. The
5063 # fifth character is used to indicate mail that was sent by you. The sixth
5064 # character is used to indicate when a mail was sent to a mailing-list you
5074 # If set, this variable specifies the path of the trash folder where the mails
5075 # marked for deletion will be moved, instead of being irremediably purged.
5077 # NOTE: When you delete a message in the trash folder, it is really deleted, so
5078 # that you have a way to clean the trash.
5082 # 3.350. ts_icon_format
5085 # Default: “M%?n?AIL&ail?”
5087 # Controls the format of the icon title, as long as “$ts_enabled” is set. This
5088 # string is identical in formatting to the one used by “$status_format”.
5097 # Controls whether mutt tries to set the terminal status line and icon name. Most
5098 # terminal emulators emulate the status line in the window title.
5103 # 3.352. ts_status_format
5106 # Default: “Mutt with %?m?%m messages&no messages?%?n? [%n NEW]?”
5108 # Controls the format of the terminal status line (or window title), provided
5109 # that “$ts_enabled” has been set. This string is identical in formatting to the
5110 # one used by “$status_format”.
5112 set ts_status_format="mutt: %f%?V?[%V]&?"
5120 # Setting this variable will cause mutt to open a pipe to a command instead of a
5121 # raw socket. You may be able to use this to set up preauthenticated connections
5122 # to your IMAP/POP3/SMTP server. Example:
5124 # set tunnel="ssh -q mailhost.net /usr/local/libexec/imapd"
5126 # Note: For this example to work you must be able to log in to the remote machine
5127 # without having to enter a password.
5129 # When set, Mutt uses the tunnel for all remote connections. Please see “
5130 # account-hook” in the manual for how to use different tunnel commands per
5135 # 3.354. uncollapse_jump
5140 # When set, Mutt will jump to the next unread message, if any, when the current
5141 # thread is uncollapsed.
5145 # 3.355. uncollapse_new
5150 # When set, Mutt will automatically uncollapse any collapsed thread that receives
5151 # a new message. When unset, collapsed threads will remain collapsed. the
5152 # presence of the new message will still affect index sorting, though.
5156 # 3.356. use_8bitmime
5161 # Warning: do not set this variable unless you are using a version of sendmail
5162 # which supports the -B8BITMIME flag (such as sendmail 8.8.x) or you may not be
5163 # able to send mail.
5165 # When set, Mutt will invoke $sendmail with the -B8BITMIME flag when sending
5166 # 8-bit messages to enable ESMTP negotiation.
5175 # When set, Mutt will qualify all local addresses (ones without the “@host”
5176 # portion) with the value of $hostname. If unset, no addresses will be qualified.
5180 # 3.358. use_envelope_from
5185 # When set, mutt will set the envelope sender of the message. If
5186 # $envelope_from_address is set, it will be used as the sender address. If unset,
5187 # mutt will attempt to derive the sender from the “From:” header.
5189 # Note that this information is passed to sendmail command using the -f command
5190 # line switch. Therefore setting this option is not useful if the $sendmail
5191 # variable already contains -f or if the executable pointed to by $sendmail
5192 # doesn't support the -f switch.
5194 set use_envelope_from=yes
5202 # When set, Mutt will generate the “From:” header field when sending messages. If
5203 # unset, no “From:” header field will be generated unless the user explicitly
5204 # sets one using the “my_hdr” command.
5213 # When set, Mutt will look for IPv6 addresses of hosts it tries to contact. If
5214 # this option is unset, Mutt will restrict itself to IPv4 addresses. Normally,
5215 # the default should work.
5224 # When set, mutt will add a “User-Agent:” header to outgoing messages, indicating
5225 # which version of mutt was used for composing them.
5234 # Specifies the visual editor to invoke when the “~v” command is given in the
5244 # Controls whether Mutt will ask you to press a key after an external command has
5245 # been invoked by these functions: <shell-escape>, <pipe-message>, <pipe-entry>,
5246 # <print-message>, and <print-entry> commands.
5248 # It is also used when viewing attachments with “auto_view”, provided that the
5249 # corresponding mailcap entry has a needsterminal flag, and the external program
5252 # When set, Mutt will always ask for a key. When unset, Mutt will wait for a key
5253 # only if the external command returned a non-zero status.
5263 # When set, mutt will weed headers when displaying, forwarding, printing, or
5264 # replying to messages.
5273 # When set to a positive value, mutt will wrap text at $wrap characters. When set
5274 # to a negative value, mutt will wrap text so that there are $wrap characters of
5275 # empty space on the right side of the terminal. Setting it to zero makes mutt
5276 # wrap at the terminal width.
5278 # Also see $reflow_wrap.
5280 set wrap=$reflow_wrap
5283 # 3.366. wrap_headers
5288 # This option specifies the number of characters to use for wrapping an outgoing
5289 # message's headers. Allowed values are between 78 and 998 inclusive.
5291 # Note: This option usually shouldn't be changed. RFC5233 recommends a line
5292 # length of 78 (the default), so please only change this setting when you know
5293 # what you're doing.
5297 # 3.367. wrap_search
5302 # Controls whether searches wrap around the end.
5304 # When set, searches will wrap around the first (or last) item. When unset,
5305 # incremental searches will not wrap.
5314 # (DEPRECATED) Equivalent to setting $wrap with a negative value.
5323 # Controls whether mutt writes out the “Bcc:” header when preparing messages to
5324 # be sent. Exim users may wish to unset this. If mutt is set to deliver directly
5325 # via SMTP (see $smtp_url), this option does nothing: mutt will never write out
5326 # the “Bcc:” header in this case.
5335 # When writing a mailbox, a message will be printed every $write_inc messages to
5336 # indicate progress. If set to 0, only a single message will be displayed before
5337 # writing a mailbox.
5339 # Also see the $read_inc, $net_inc and $time_inc variables and the “tuning”
5340 # section of the manual for performance considerations.
5343 # vim:sw=12:noet:sts=12:ts=12:ft=muttrc