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.
587 set content_type="text/plain; markup=markdown"
595 # This variable controls whether or not copies of your outgoing messages will be
596 # saved for later references. Also see $record, $save_name, $force_name and “
602 # 3.41. crypt_autoencrypt
607 # Setting this variable will cause Mutt to always attempt to PGP encrypt outgoing
608 # messages. This is probably only useful in connection to the “send-hook”
609 # command. It can be overridden by use of the pgp menu, when encryption is not
610 # required or signing is requested as well. If $smime_is_default is set, then
611 # OpenSSL is used instead to create S/MIME messages and settings can be
612 # overridden by use of the smime menu instead. (Crypto only)
616 # 3.42. crypt_autopgp
621 # This variable controls whether or not mutt may automatically enable PGP
622 # encryption/signing for messages. See also $crypt_autoencrypt,
623 # $crypt_replyencrypt, $crypt_autosign, $crypt_replysign and $smime_is_default.
627 # 3.43. crypt_autosign
632 # Setting this variable will cause Mutt to always attempt to cryptographically
633 # sign outgoing messages. This can be overridden by use of the pgp menu, when
634 # signing is not required or encryption is requested as well. If
635 # $smime_is_default is set, then OpenSSL is used instead to create S/MIME
636 # messages and settings can be overridden by use of the smime menu instead of the
637 # pgp menu. (Crypto only)
639 set crypt_autosign=yes
642 # 3.44. crypt_autosmime
647 # This variable controls whether or not mutt may automatically enable S/MIME
648 # encryption/signing for messages. See also $crypt_autoencrypt,
649 # $crypt_replyencrypt, $crypt_autosign, $crypt_replysign and $smime_is_default.
653 # 3.45. crypt_confirmhook
658 # If set, then you will be prompted for confirmation of keys when using the
659 # crypt-hook command. If unset, no such confirmation prompt will be presented.
660 # This is generally considered unsafe, especially where typos are concerned.
664 # 3.46. crypt_opportunistic_encrypt
669 # Setting this variable will cause Mutt to automatically enable and disable
670 # encryption, based on whether all message recipient keys can be located by Mutt.
672 # When this option is enabled, Mutt will enable/disable encryption each time the
673 # TO, CC, and BCC lists are edited. If $edit_headers is set, Mutt will also do so
674 # each time the message is edited.
676 # While this is set, encryption can't be manually enabled/disabled. The pgp or
677 # smime menus provide a selection to temporarily disable this option for the
680 # If $crypt_autoencrypt or $crypt_replyencrypt enable encryption for a message,
681 # this option will be disabled for that message. It can be manually re-enabled in
682 # the pgp or smime menus. (Crypto only)
686 # 3.47. crypt_replyencrypt
691 # If set, automatically PGP or OpenSSL encrypt replies to messages which are
692 # encrypted. (Crypto only)
696 # 3.48. crypt_replysign
701 # If set, automatically PGP or OpenSSL sign replies to messages which are signed.
703 # Note: this does not work on messages that are encrypted and signed! (Crypto
706 set crypt_replysign=yes
709 # 3.49. crypt_replysignencrypted
714 # If set, automatically PGP or OpenSSL sign replies to messages which are
715 # encrypted. This makes sense in combination with $crypt_replyencrypt, because it
716 # allows you to sign all messages which are automatically encrypted. This works
717 # around the problem noted in $crypt_replysign, that mutt is not able to find out
718 # whether an encrypted message is also signed. (Crypto only)
720 set crypt_replysignencrypted=yes
723 # 3.50. crypt_timestamp
728 # If set, mutt will include a time stamp in the lines surrounding PGP or S/MIME
729 # output, so spoofing such lines is more difficult. If you are using colors to
730 # mark these lines, and rely on these, you may unset this setting. (Crypto only)
734 # 3.51. crypt_use_gpgme
739 # This variable controls the use of the GPGME-enabled crypto backends. If it is
740 # set and Mutt was built with gpgme support, the gpgme code for S/MIME and PGP
741 # will be used instead of the classic code. Note that you need to set this option
742 # in .muttrc; it won't have any effect when used interactively.
744 # Note that the GPGME backend does not support creating old-style inline
745 # (traditional) PGP encrypted or signed messages (see $pgp_autoinline).
749 # 3.52. crypt_use_pka
754 # Controls whether mutt uses PKA (see http://www.g10code.de/docs/
755 # pka-intro.de.pdf) during signature verification (only supported by the GPGME
758 set crypt_use_pka=yes
761 # 3.53. crypt_verify_sig
766 # If “yes”, always attempt to verify PGP or S/MIME signatures. If “ask-*”, ask
767 # whether or not to verify the signature. If “no”, never attempt to verify
768 # cryptographic signatures. (Crypto only)
775 # Default: “!%a, %b %d, %Y at %I:%M:%S%p %Z”
777 # This variable controls the format of the date printed by the “%d” sequence in
778 # $index_format. This is passed to the strftime(3) function to process the date,
779 # see the man page for the proper syntax.
781 # Unless the first character in the string is a bang (“!”), the month and week
782 # day names are expanded according to the locale. If the first character in the
783 # string is a bang, the bang is discarded, and the month and week day names in
784 # the rest of the string are expanded in the C locale (that is in US English).
786 set date_format="%F %T%Z"
792 # Default: “~f %s !~P | (~P ~C %s)”
794 # This variable controls how “message-hook”, “reply-hook”, “send-hook”, “
795 # send2-hook”, “save-hook”, and “fcc-hook” will be interpreted if they are
796 # specified with only a simple regexp, instead of a matching pattern. The hooks
797 # are expanded when they are declared, so a hook will be interpreted according to
798 # the value of this variable at the time the hook is declared.
800 # The default value matches if the message is either from a user matching the
801 # regular expression given, or if it is from you (if the from address matches “
802 # alternates”) and is to or cc'ed to a user matching the given regular
812 # Controls whether or not messages are really deleted when closing or
813 # synchronizing a mailbox. If set to yes, messages marked for deleting will
814 # automatically be purged without prompting. If set to no, messages marked for
815 # deletion will be kept in the mailbox.
825 # If this option is set, mutt will untag messages when marking them for deletion.
826 # This applies when you either explicitly delete a message, or when you save it
831 # 3.58. digest_collapse
836 # If this option is set, mutt's received-attachments menu will not show the
837 # subparts of individual messages in a multipart/digest. To see these subparts,
838 # press “v” on that menu.
842 # 3.59. display_filter
847 # When set, specifies a command used to filter messages. When a message is viewed
848 # it is passed as standard input to $display_filter, and the filtered message is
849 # read from the standard output.
853 # 3.60. dotlock_program
856 # Default: “/usr/bin/mutt_dotlock”
858 # Contains the path of the mutt_dotlock(8) binary to be used by mutt.
867 # This variable sets the request for when notification is returned. The string
868 # consists of a comma separated list (no spaces!) of one or more of the
869 # following: never, to never request notification, failure, to request
870 # notification on transmission failure, delay, to be notified of message delays,
871 # success, to be notified of successful transmission.
875 # set dsn_notify="failure,delay"
877 # Note: when using $sendmail for delivery, you should not enable this unless you
878 # are either using Sendmail 8.8.x or greater or a MTA providing a sendmail(1)
879 # -compatible interface supporting the -N option for DSN. For SMTP delivery, DSN
880 # support is auto-detected so that it depends on the server whether DSN will be
890 # This variable controls how much of your message is returned in DSN messages. It
891 # may be set to either hdrs to return just the message header, or full to return
896 # set dsn_return=hdrs
898 # Note: when using $sendmail for delivery, you should not enable this unless you
899 # are either using Sendmail 8.8.x or greater or a MTA providing a sendmail(1)
900 # -compatible interface supporting the -R option for DSN. For SMTP delivery, DSN
901 # support is auto-detected so that it depends on the server whether DSN will be
906 # 3.63. duplicate_threads
911 # This variable controls whether mutt, when $sort is set to threads, threads
912 # messages with the same Message-Id together. If it is set, it will indicate that
913 # it thinks they are duplicates of each other with an equals sign in the thread
923 # This option allows you to edit the header of your outgoing messages along with
924 # the body of your message.
926 # Although the compose menu may have localized header labels, the labels passed
927 # to your editor will be standard RFC 2822 headers, (e.g. To:, Cc:, Subject:).
928 # Headers added in your editor must also be RFC 2822 headers, or one of the
929 # pseudo headers listed in “edit-header”. Mutt will not understand localized
930 # header labels, just as it would not when parsing an actual email.
932 # Note that changes made to the References: and Date: headers are ignored for
933 # interoperability reasons.
943 # This variable specifies which editor is used by mutt. It defaults to the value
944 # of the $VISUAL, or $EDITOR, environment variable, or to the string “vi” if
945 # neither of those are set.
947 # The $editor string may contain a %s escape, which will be replaced by the name
948 # of the file to be edited. If the %s escape does not appear in $editor, a space
949 # and the name to be edited are appended.
951 # The resulting string is then executed by running
955 # where string is the expansion of $editor described above.
957 set editor="mailplate --edit --auto --keep-unknown"
965 # When set, mutt will quoted-printable encode messages when they contain the
966 # string “From ” (note the trailing space) in the beginning of a line. This is
967 # useful to avoid the tampering certain mail delivery and transport agents tend
968 # to do with messages (in order to prevent tools from misinterpreting the line as
969 # a mbox message separator).
978 # The file which includes random data that is used to initialize SSL library
983 # 3.68. envelope_from_address
985 # Type: e-mail address
988 # Manually sets the envelope sender for outgoing messages. This value is ignored
989 # if $use_envelope_from is unset.
993 # 3.69. error_history
998 # This variable controls the size (in number of strings remembered) of the error
999 # messages displayed by mutt. These can be shown with the <error-history>
1000 # function. The history is cleared each time this variable is set.
1009 # Escape character to use for functions in the built-in editor.
1018 # When set, the initial prompt for recipients and subject are skipped when
1019 # replying to messages, and the initial prompt for subject is skipped when
1020 # forwarding messages.
1022 # Note: this variable has no effect when the $autoedit variable is set.
1031 # This variable controls whether or not attachments on outgoing messages are
1032 # saved along with the main body of your message.
1042 # When this variable is set, FCCs will be stored unencrypted and unsigned, even
1043 # when the actual message is encrypted and/or signed. (PGP only)
1052 # If set, flagged messages cannot be deleted.
1061 # Specifies the default location of your mailboxes. A “+” or “=” at the beginning
1062 # of a pathname will be expanded to the value of this variable. Note that if you
1063 # change this variable (from the default) value you need to make sure that the
1064 # assignment occurs before you use “+” or “=” for any other variables since
1065 # expansion takes place when handling the “mailboxes” command.
1070 # 3.76. folder_format
1073 # Default: “%2C %t %N %F %2l %-8.8u %-8.8g %8s %d %f”
1075 # This variable allows you to customize the file browser display to your personal
1076 # taste. This string is similar to $index_format, but has its own set of printf
1077 # (3)-like sequences:
1079 # ┌───┬─────────────────────────────────────────────────────────────────────────┐
1080 # │%C │current file number │
1081 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1082 # │%d │date/time folder was last modified │
1083 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1084 # │%D │date/time folder was last modified using $date_format. │
1085 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1086 # │%f │filename (“/” is appended to directory names, “@” to symbolic links and “│
1087 # │ │*” to executable files) │
1088 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1089 # │%F │file permissions │
1090 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1091 # │%g │group name (or numeric gid, if missing) │
1092 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1093 # │%l │number of hard links │
1094 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1095 # │%m │number of messages in the mailbox * │
1096 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1097 # │%n │number of unread messages in the mailbox * │
1098 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1099 # │%N │N if mailbox has new mail, blank otherwise │
1100 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1101 # │%s │size in bytes │
1102 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1103 # │%t │“*” if the file is tagged, blank otherwise │
1104 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1105 # │%u │owner name (or numeric uid, if missing) │
1106 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1107 # │%>X│right justify the rest of the string and pad with character “X” │
1108 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1109 # │%|X│pad to the end of the line with character “X” │
1110 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1111 # │%*X│soft-fill with character “X” as pad │
1112 # └───┴─────────────────────────────────────────────────────────────────────────┘
1114 # For an explanation of “soft-fill”, see the $index_format documentation.
1116 # * = can be optionally printed if nonzero
1118 # %m, %n, and %N only work for monitored mailboxes. %m requires $mail_check_stats
1119 # to be set. %n requires $mail_check_stats to be set (except for IMAP mailboxes).
1128 # Controls whether or not the “Mail-Followup-To:” header field is generated when
1129 # sending mail. When set, Mutt will generate this field when you are replying to
1130 # a known mailing list, specified with the “subscribe” or “lists” commands.
1132 # This field has two purposes. First, preventing you from receiving duplicate
1133 # copies of replies to messages which you send to mailing lists, and second,
1134 # ensuring that you do get a reply separately for any messages sent to known
1135 # lists to which you are not subscribed.
1137 # The header will contain only the list's address for subscribed lists, and both
1138 # the list address and your own email address for unsubscribed lists. Without
1139 # this header, a group reply to your message sent to a subscribed list will be
1140 # sent to both the list and your address, resulting in two copies of the same
1150 # This variable is similar to $save_name, except that Mutt will store a copy of
1151 # your outgoing message by the username of the address you are sending to even if
1152 # that mailbox does not exist.
1154 # Also see the $record variable.
1158 # 3.79. forward_attribution_intro
1161 # Default: “----- Forwarded message from %f -----”
1163 # This is the string that will precede a message which has been forwarded in the
1164 # main body of a message (when $mime_forward is unset). For a full listing of
1165 # defined printf(3)-like sequences see the section on $index_format. See also
1166 # $attribution_locale.
1170 # 3.80. forward_attribution_trailer
1173 # Default: “----- End forwarded message -----”
1175 # This is the string that will follow a message which has been forwarded in the
1176 # main body of a message (when $mime_forward is unset). For a full listing of
1177 # defined printf(3)-like sequences see the section on $index_format. See also
1178 # $attribution_locale.
1182 # 3.81. forward_decode
1187 # Controls the decoding of complex MIME messages into text/plain when forwarding
1188 # a message. The message header is also RFC2047 decoded. This variable is only
1189 # used, if $mime_forward is unset, otherwise $mime_forward_decode is used
1194 # 3.82. forward_decrypt
1199 # Controls the handling of encrypted messages when forwarding a message. When set
1200 # , the outer layer of encryption is stripped off. This variable is only used if
1201 # $mime_forward is set and $mime_forward_decode is unset. (PGP only)
1205 # 3.83. forward_edit
1210 # This quadoption controls whether or not the user is automatically placed in the
1211 # editor when forwarding messages. For those who always want to forward with no
1212 # modification, use a setting of “no”.
1216 # 3.84. forward_format
1219 # Default: “[%a: %s]”
1221 # This variable controls the default subject when forwarding a message. It uses
1222 # the same format sequences as the $index_format variable.
1224 set forward_format="(fwd) %s"
1227 # 3.85. forward_quote
1232 # When set, forwarded messages included in the main body of the message (when
1233 # $mime_forward is unset) will be quoted using $indent_string.
1239 # Type: e-mail address
1242 # When set, this variable contains a default from address. It can be overridden
1243 # using “my_hdr” (including from a “send-hook”) and $reverse_name. This variable
1244 # is ignored if $use_from is unset.
1246 # This setting defaults to the contents of the environment variable $EMAIL.
1248 set from='martin f krafft <madduck@madduck.net>'
1253 # Type: regular expression
1256 # A regular expression used by mutt to parse the GECOS field of a password entry
1257 # when expanding the alias. The default value will return the string up to the
1258 # first “,” encountered. If the GECOS field contains a string like “lastname,
1259 # firstname” then you should set it to “.*”.
1261 # This can be useful if you see the following behavior: you address an e-mail to
1262 # user ID “stevef” whose full name is “Steve Franklin”. If mutt expands “stevef”
1263 # to “"Franklin" stevef@foo.bar” then you should set the $gecos_mask to a regular
1264 # expression that will match the whole name so mutt will expand “Franklin” to “
1274 # When unset, the header fields normally added by the “my_hdr” command are not
1275 # created. This variable must be unset before composing a new message or replying
1276 # in order to take effect. If set, the user defined header fields are added to
1277 # every new message.
1286 # When set, this variable causes Mutt to include the header of the message you
1287 # are replying to into the edit buffer. The $weed setting applies.
1291 # 3.90. header_cache
1296 # This variable points to the header cache database. If pointing to a directory
1297 # Mutt will contain a header cache database file per folder, if pointing to a
1298 # file that file will be a single global header cache. By default it is unset so
1299 # no header caching will be used.
1301 # Header caching can greatly improve speed when opening POP, IMAP MH or Maildir
1302 # folders, see “caching” for details.
1304 set header_cache="~/.var/mutt/header_cache"
1307 # 3.91. header_cache_compress
1312 # When mutt is compiled with qdbm, tokyocabinet, or kyotocabinet as header cache
1313 # backend, this option determines whether the database will be compressed.
1314 # Compression results in database files roughly being one fifth of the usual
1315 # diskspace, but the decompression can result in a slower opening of cached
1316 # folder(s) which in general is still much faster than opening non header cached
1319 set header_cache_compress=no
1322 # 3.92. header_cache_pagesize
1327 # When mutt is compiled with either gdbm or bdb4 as the header cache backend,
1328 # this option changes the database page size. Too large or too small values can
1329 # waste space, memory, or CPU time. The default should be more or less optimal
1330 # for most use cases.
1334 # 3.93. header_color_partial
1339 # When set, color header regexps behave like color body regexps: color is applied
1340 # to the exact text matched by the regexp. When unset, color is applied to the
1343 # One use of this option might be to apply color to just the header labels.
1345 # See “color” for more details.
1354 # When set, help lines describing the bindings for the major functions provided
1355 # by each menu are displayed on the first line of the screen.
1357 # Note: The binding will not be displayed correctly if the function is bound to a
1358 # sequence rather than a single keystroke. Also, the help line may not be updated
1359 # if a binding is changed while Mutt is running. Since this variable is primarily
1360 # aimed at new users, neither of these should present a major problem.
1369 # When set, mutt will skip the host name part of $hostname variable when adding
1370 # the domain part to addresses. This variable does not affect the generation of
1371 # Message-IDs, and it will not lead to the cut-off of first-level domains.
1375 # 3.96. hide_limited
1380 # When set, mutt will not show the presence of messages that are hidden by
1381 # limiting, in the thread tree.
1385 # 3.97. hide_missing
1390 # When set, mutt will not show the presence of missing messages in the thread
1395 # 3.98. hide_thread_subject
1400 # When set, mutt will not show the subject of messages in the thread tree that
1401 # have the same subject as their parent or closest previously displayed sibling.
1405 # 3.99. hide_top_limited
1410 # When set, mutt will not show the presence of messages that are hidden by
1411 # limiting, at the top of threads in the thread tree. Note that when
1412 # $hide_limited is set, this option will have no effect.
1416 # 3.100. hide_top_missing
1421 # When set, mutt will not show the presence of missing messages at the top of
1422 # threads in the thread tree. Note that when $hide_missing is set, this option
1423 # will have no effect.
1432 # This variable controls the size (in number of strings remembered) of the string
1433 # history buffer per category. The buffer is cleared each time the variable is
1438 # 3.102. history_file
1441 # Default: “~/.mutthistory”
1443 # The file in which Mutt will save its history.
1445 # Also see $save_history.
1447 set history_file="~/.var/mutt/history"
1450 # 3.103. history_remove_dups
1455 # When set, all of the string history will be scanned for duplicates when a new
1456 # entry is added. Duplicate entries in the $history_file will also be removed
1457 # when it is periodically compacted.
1461 # 3.104. honor_disposition
1466 # When set, Mutt will not display attachments with a disposition of “attachment”
1467 # inline even if it could render the part to plain text. These MIME parts can
1468 # only be viewed from the attachment menu.
1470 # If unset, Mutt will render all MIME parts it can properly transform to plain
1475 # 3.105. honor_followup_to
1480 # This variable controls whether or not a Mail-Followup-To header is honored when
1481 # group-replying to a message.
1490 # Specifies the fully-qualified hostname of the system mutt is running on
1491 # containing the host's name and the DNS domain it belongs to. It is used as the
1492 # domain part (after “@”) for local email addresses as well as Message-Id
1495 # Its value is determined at startup as follows: the node's hostname is first
1496 # determined by the uname(3) function. The domain is then looked up using the
1497 # gethostname(2) and getaddrinfo(3) functions. If those calls are unable to
1498 # determine the domain, the full value returned by uname is used. Optionally,
1499 # Mutt can be compiled with a fixed domain name in which case a detected one is
1502 # Also see $use_domain and $hidden_host.
1511 # When set, Mutt will show you international domain names decoded. Note: You can
1512 # use IDNs for addresses even if this is unset. This variable only affects
1513 # decoding. (IDN only)
1522 # When set, Mutt will encode international domain names using IDN. Unset this if
1523 # your SMTP server can handle newer (RFC 6531) UTF-8 encoded domains. (IDN only)
1527 # 3.109. ignore_linear_white_space
1532 # This option replaces linear-white-space between encoded-word and text to a
1533 # single space to prevent the display of MIME-encoded “Subject:” field from being
1534 # divided into multiple lines.
1538 # 3.110. ignore_list_reply_to
1543 # Affects the behavior of the <reply> function when replying to messages from
1544 # mailing lists (as defined by the “subscribe” or “lists” commands). When set, if
1545 # the “Reply-To:” field is set to the same value as the “To:” field, Mutt assumes
1546 # that the “Reply-To:” field was set by the mailing list to automate responses to
1547 # the list, and will ignore this field. To direct a response to the mailing list
1548 # when this option is set, use the <list-reply> function; <group-reply> will
1549 # reply to both the sender and the list.
1551 set ignore_list_reply_to=yes
1554 # 3.111. imap_authenticators
1559 # This is a colon-delimited list of authentication methods mutt may attempt to
1560 # use to log in to an IMAP server, in the order mutt should try them.
1561 # Authentication methods are either “login” or the right side of an IMAP “AUTH=
1562 # xxx” capability string, e.g. “digest-md5”, “gssapi” or “cram-md5”. This option
1563 # is case-insensitive. If it's unset (the default) mutt will try all available
1564 # methods, in order from most-secure to least-secure.
1568 # set imap_authenticators="gssapi:cram-md5:login"
1570 # Note: Mutt will only fall back to other authentication methods if the previous
1571 # methods are unavailable. If a method is available but authentication fails,
1572 # mutt will not connect to the IMAP server.
1576 # 3.112. imap_check_subscribed
1581 # When set, mutt will fetch the set of subscribed folders from your server on
1582 # connection, and add them to the set of mailboxes it polls for new mail just as
1583 # if you had issued individual “mailboxes” commands.
1587 # 3.113. imap_delim_chars
1592 # This contains the list of characters which you would like to treat as folder
1593 # separators for displaying IMAP paths. In particular it helps in using the “=”
1594 # shortcut for your folder variable.
1598 # 3.114. imap_headers
1603 # Mutt requests these header fields in addition to the default headers (“Date:”,
1604 # “From:”, “Subject:”, “To:”, “Cc:”, “Message-Id:”, “References:”, “Content-Type:
1605 # ”, “Content-Description:”, “In-Reply-To:”, “Reply-To:”, “Lines:”, “List-Post:”,
1606 # “X-Label:”) from IMAP servers before displaying the index menu. You may want to
1607 # add more headers for spam detection.
1609 # Note: This is a space separated list, items should be uppercase and not contain
1610 # the colon, e.g. “X-BOGOSITY X-SPAM-STATUS” for the “X-Bogosity:” and “
1611 # X-Spam-Status:” header fields.
1620 # When set, mutt will attempt to use the IMAP IDLE extension to check for new
1621 # mail in the current mailbox. Some servers (dovecot was the inspiration for this
1622 # option) react badly to mutt's implementation. If your connection seems to
1623 # freeze up periodically, try unsetting this.
1627 # 3.116. imap_keepalive
1632 # This variable specifies the maximum amount of time in seconds that mutt will
1633 # wait before polling open IMAP connections, to prevent the server from closing
1634 # them before mutt has finished with them. The default is well within the
1635 # RFC-specified minimum amount of time (30 minutes) before a server is allowed to
1636 # do this, but in practice the RFC does get violated every now and then. Reduce
1637 # this number if you find yourself getting disconnected from your IMAP server due
1642 # 3.117. imap_list_subscribed
1647 # This variable configures whether IMAP folder browsing will look for only
1648 # subscribed folders or all folders. This can be toggled in the IMAP browser with
1649 # the <toggle-subscribed> function.
1658 # Your login name on the IMAP server.
1660 # This variable defaults to the value of $imap_user.
1664 # 3.119. imap_oauth_refresh_command
1669 # The command to run to generate an OAUTH refresh token for authorizing your
1670 # connection to your IMAP server. This command will be run on every connection
1671 # attempt that uses the OAUTHBEARER authentication mechanism.
1680 # Specifies the password for your IMAP account. If unset, Mutt will prompt you
1681 # for your password when you invoke the <imap-fetch-mail> function or try to open
1684 # Warning: you should only use this option when you are on a fairly secure
1685 # machine, because the superuser can read your muttrc even if you are the only
1686 # one who can read the file.
1690 # 3.121. imap_passive
1695 # When set, mutt will not open new IMAP connections to check for new mail. Mutt
1696 # will only check for new mail over existing IMAP connections. This is useful if
1697 # you don't want to be prompted to user/password pairs on mutt invocation, or if
1698 # opening the connection is slow.
1707 # When set, mutt will avoid implicitly marking your mail as read whenever you
1708 # fetch a message from the server. This is generally a good thing, but can make
1709 # closing an IMAP folder somewhat slower. This option exists to appease speed
1714 # 3.123. imap_pipeline_depth
1719 # Controls the number of IMAP commands that may be queued up before they are sent
1720 # to the server. A deeper pipeline reduces the amount of time mutt must wait for
1721 # the server, and can make IMAP servers feel much more responsive. But not all
1722 # servers correctly handle pipelined commands, so if you have problems you might
1723 # want to try setting this variable to 0.
1725 # Note: Changes to this variable have no effect on open connections.
1729 # 3.124. imap_poll_timeout
1734 # This variable specifies the maximum amount of time in seconds that mutt will
1735 # wait for a response when polling IMAP connections for new mail, before timing
1736 # out and closing the connection. Set to 0 to disable timing out.
1740 # 3.125. imap_servernoise
1745 # When set, mutt will display warning messages from the IMAP server as error
1746 # messages. Since these messages are often harmless, or generated due to
1747 # configuration problems on the server which are out of the users' hands, you may
1748 # wish to suppress them at some point.
1757 # The name of the user whose mail you intend to access on the IMAP server.
1759 # This variable defaults to your user name on the local machine.
1763 # 3.127. implicit_autoview
1768 # If set to “yes”, mutt will look for a mailcap entry with the “copiousoutput”
1769 # flag set for every MIME attachment it doesn't have an internal viewer defined
1770 # for. If such an entry is found, mutt will use the viewer defined in that entry
1771 # to convert the body part to text form.
1773 set implicit_autoview=no
1781 # Controls whether or not a copy of the message(s) you are replying to is
1782 # included in your reply.
1787 # 3.129. include_onlyfirst
1792 # Controls whether or not Mutt includes only the first attachment of the message
1797 # 3.130. indent_string
1802 # Specifies the string to prepend to each line of text quoted in a message to
1803 # which you are replying. You are strongly encouraged not to change this value,
1804 # as it tends to agitate the more fanatical netizens.
1806 # The value of this option is ignored if $text_flowed is set, because the quoting
1807 # mechanism is strictly defined for format=flowed.
1809 # This option is a format string, please see the description of $index_format for
1810 # supported printf(3)-style sequences.
1814 # 3.131. index_format
1817 # Default: “%4C %Z %{%b %d} %-15.15L (%?l?%4l&%4c?) %s”
1819 # This variable allows you to customize the message index display to your
1822 # “Format strings” are similar to the strings used in the C function printf(3) to
1823 # format output (see the man page for more details). For an explanation of the %?
1824 # construct, see the $status_format description. The following sequences are
1827 # ┌─────┬───────────────────────────────────────────────────────────────────────┐
1828 # │%a │address of the author │
1829 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1830 # │%A │reply-to address (if present; otherwise: address of author) │
1831 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1832 # │%b │filename of the original message folder (think mailbox) │
1833 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1834 # │%B │the list to which the letter was sent, or else the folder name (%b). │
1835 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1836 # │%c │number of characters (bytes) in the message │
1837 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1838 # │%C │current message number │
1839 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1840 # │%d │date and time of the message in the format specified by $date_format │
1841 # │ │converted to sender's time zone │
1842 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1843 # │%D │date and time of the message in the format specified by $date_format │
1844 # │ │converted to the local time zone │
1845 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1846 # │%e │current message number in thread │
1847 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1848 # │%E │number of messages in current thread │
1849 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1850 # │%f │sender (address + real name), either From: or Return-Path: │
1851 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1852 # │%F │author name, or recipient name if the message is from you │
1853 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1854 # │%H │spam attribute(s) of this message │
1855 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1856 # │%i │message-id of the current message │
1857 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1858 # │%l │number of lines in the message (does not work with maildir, mh, and │
1859 # │ │possibly IMAP folders) │
1860 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1861 # │ │If an address in the “To:” or “Cc:” header field matches an address │
1862 # │%L │defined by the users “subscribe” command, this displays "To <list-name>│
1863 # │ │", otherwise the same as %F. │
1864 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1865 # │%m │total number of message in the mailbox │
1866 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1867 # │%M │number of hidden messages if the thread is collapsed. │
1868 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1869 # │%N │message score │
1870 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1871 # │%n │author's real name (or address if missing) │
1872 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1873 # │%O │original save folder where mutt would formerly have stashed the │
1874 # │ │message: list name or recipient name if not sent to a list │
1875 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1876 # │%P │progress indicator for the built-in pager (how much of the file has │
1877 # │ │been displayed) │
1878 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1879 # │%r │comma separated list of “To:” recipients │
1880 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1881 # │%R │comma separated list of “Cc:” recipients │
1882 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1883 # │%s │subject of the message │
1884 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1885 # │%S │single character status of the message (“N”/“O”/“D”/“d”/“!”/“r”/“*”) │
1886 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1887 # │%t │“To:” field (recipients) │
1888 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1889 # │%T │the appropriate character from the $to_chars string │
1890 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1891 # │%u │user (login) name of the author │
1892 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1893 # │%v │first name of the author, or the recipient if the message is from you │
1894 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1895 # │%X │number of attachments (please see the “attachments” section for │
1896 # │ │possible speed effects) │
1897 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1898 # │%y │“X-Label:” field, if present │
1899 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1900 # │ │“X-Label:” field, if present, and (1) not at part of a thread tree, (2)│
1901 # │%Y │at the top of a thread, or (3) “X-Label:” is different from preceding │
1902 # │ │message's “X-Label:”. │
1903 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1904 # │ │a three character set of message status flags. the first character is │
1905 # │%Z │new/read/replied flags (“n”/“o”/“r”/“O”/“N”). the second is deleted or │
1906 # │ │encryption flags (“D”/“d”/“S”/“P”/“s”/“K”). the third is either tagged/│
1907 # │ │flagged (“*”/“!”), or one of the characters listed in $to_chars. │
1908 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1909 # │% │the date and time of the message is converted to sender's time zone, │
1910 # │{fmt}│and “fmt” is expanded by the library function strftime(3); a leading │
1911 # │ │bang disables locales │
1912 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1913 # │% │the date and time of the message is converted to the local time zone, │
1914 # │[fmt]│and “fmt” is expanded by the library function strftime(3); a leading │
1915 # │ │bang disables locales │
1916 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1917 # │% │the local date and time when the message was received. “fmt” is │
1918 # │(fmt)│expanded by the library function strftime(3); a leading bang disables │
1920 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1921 # │% │the current local time. “fmt” is expanded by the library function │
1922 # │<fmt>│strftime(3); a leading bang disables locales. │
1923 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1924 # │%>X │right justify the rest of the string and pad with character “X” │
1925 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1926 # │%|X │pad to the end of the line with character “X” │
1927 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1928 # │%*X │soft-fill with character “X” as pad │
1929 # └─────┴───────────────────────────────────────────────────────────────────────┘
1931 # “Soft-fill” deserves some explanation: Normal right-justification will print
1932 # everything to the left of the “%>”, displaying padding and whatever lies to the
1933 # right only if there's room. By contrast, soft-fill gives priority to the
1934 # right-hand side, guaranteeing space to display it and showing padding only if
1935 # there's still room. If necessary, soft-fill will eat text leftwards to make
1936 # room for rightward text.
1938 # Note that these expandos are supported in “save-hook”, “fcc-hook” and “
1939 # fcc-save-hook”, too.
1948 # How to invoke ispell (GNU's spell-checking software).
1952 # 3.133. keep_flagged
1957 # If set, read messages marked as flagged will not be moved from your spool
1958 # mailbox to your $mbox mailbox, or as a result of a “mbox-hook” command.
1967 # This variable configures how often (in seconds) mutt should look for new mail.
1968 # Also see the $timeout variable.
1972 # 3.135. mail_check_recent
1977 # When set, Mutt will only notify you about new mail that has been received since
1978 # the last time you opened the mailbox. When unset, Mutt will notify you if any
1979 # new mail exists in the mailbox, regardless of whether you have visited it
1982 # When $mark_old is set, Mutt does not consider the mailbox to contain new mail
1983 # if only old messages exist.
1987 # 3.136. mail_check_stats
1992 # When set, mutt will periodically calculate message statistics of a mailbox
1993 # while polling for new mail. It will check for unread, flagged, and total
1994 # message counts. Because this operation is more performance intensive, it
1995 # defaults to unset, and has a separate option, $mail_check_stats_interval, to
1996 # control how often to update these counts.
1998 set mail_check_stats=yes
2001 # 3.137. mail_check_stats_interval
2006 # When $mail_check_stats is set, this variable configures how often (in seconds)
2007 # mutt will update message counts.
2011 # 3.138. mailcap_path
2016 # This variable specifies which files to consult when attempting to display MIME
2017 # bodies not directly supported by Mutt.
2019 set mailcap_path="$my_confdir/mailcap.icalendar:$my_confdir/mailcap.backgrounding:$my_confdir/mailcap.htmldump"
2022 # 3.139. mailcap_sanitize
2027 # If set, mutt will restrict possible characters in mailcap % expandos to a
2028 # well-defined set of safe characters. This is the safe setting, but we are not
2029 # sure it doesn't break some more advanced MIME stuff.
2031 # DON'T CHANGE THIS SETTING UNLESS YOU ARE REALLY SURE WHAT YOU ARE DOING!
2035 # 3.140. maildir_header_cache_verify
2040 # Check for Maildir unaware programs other than mutt having modified maildir
2041 # files when the header cache is in use. This incurs one stat(2) per message
2042 # every time the folder is opened (which can be very slow for NFS folders).
2044 set maildir_header_cache_verify=no
2047 # 3.141. maildir_trash
2052 # If set, messages marked as deleted will be saved with the maildir trashed flag
2053 # instead of unlinked. Note: this only applies to maildir-style mailboxes.
2054 # Setting it will have no effect on other mailbox types.
2058 # 3.142. maildir_check_cur
2063 # If set, mutt will poll both the new and cur directories of a maildir folder for
2064 # new messages. This might be useful if other programs interacting with the
2065 # folder (e.g. dovecot) are moving new messages to the cur directory. Note that
2066 # setting this option may slow down polling for new messages in large folders,
2067 # since mutt has to scan all cur messages.
2071 # 3.143. mark_macro_prefix
2076 # Prefix for macros created using mark-message. A new macro automatically
2077 # generated with <mark-message>a will be composed from this prefix and the letter
2087 # Controls whether or not mutt marks new unread messages as old if you exit a
2088 # mailbox without reading them. With this option set, the next time you start
2089 # mutt, the messages will show up with an “O” next to them in the index menu,
2090 # indicating that they are old.
2100 # Controls the display of wrapped lines in the internal pager. If set, a “+”
2101 # marker is displayed at the beginning of wrapped lines.
2103 # Also see the $smart_wrap variable.
2110 # Type: regular expression
2111 # Default: “!^.[^.]”
2113 # A regular expression used in the file browser, optionally preceded by the not
2114 # operator “!”. Only files whose names match this mask will be shown. The match
2115 # is always case-sensitive.
2124 # This specifies the folder into which read mail in your $spoolfile folder will
2127 # Also see the $move variable.
2133 # Type: folder magic
2136 # The default mailbox type used when creating new folders. May be any of “mbox”,
2137 # “MMDF”, “MH” and “Maildir”. This is overridden by the -m command-line option.
2139 set mbox_type=Maildir
2142 # 3.149. menu_context
2147 # This variable controls the number of lines of context that are given when
2148 # scrolling through menus. (Similar to $pager_context.)
2153 # 3.150. menu_move_off
2158 # When unset, the bottom entry of menus will never scroll up past the bottom of
2159 # the screen, unless there are less entries than lines. When set, the bottom
2160 # entry may move off the bottom.
2164 # 3.151. menu_scroll
2169 # When set, menus will be scrolled up or down one line when you attempt to move
2170 # across a screen boundary. If unset, the screen is cleared and the next or
2171 # previous page of the menu is displayed (useful for slow links to avoid many
2177 # 3.152. message_cache_clean
2182 # If set, mutt will clean out obsolete entries from the message cache when the
2183 # mailbox is synchronized. You probably only want to set it every once in a
2184 # while, since it can be a little slow (especially for large folders).
2188 # 3.153. message_cachedir
2193 # Set this to a directory and mutt will cache copies of messages from your IMAP
2194 # and POP servers here. You are free to remove entries at any time.
2196 # When setting this variable to a directory, mutt needs to fetch every remote
2197 # message only once and can perform regular expression searches as fast as for
2200 # Also see the $message_cache_clean variable.
2204 # 3.154. message_format
2209 # This is the string displayed in the “attachment” menu for attachments of type
2210 # message/rfc822. For a full listing of defined printf(3)-like sequences see the
2211 # section on $index_format.
2220 # If set, forces Mutt to interpret keystrokes with the high bit (bit 8) set as if
2221 # the user had pressed the Esc key and whatever key remains after having the high
2222 # bit removed. For example, if the key pressed has an ASCII value of 0xf8, then
2223 # this is treated as if the user had pressed Esc then “x”. This is because the
2224 # result of removing the high bit from 0xf8 is 0x78, which is the ASCII character
2234 # If unset, Mutt will remove your address (see the “alternates” command) from the
2235 # list of recipients when replying to a message.
2244 # When unset, mutt will mimic mh's behavior and rename deleted messages to ,<old
2245 # file name> in mh folders instead of really deleting them. This leaves the
2246 # message on disk but makes programs reading the folder ignore it. If the
2247 # variable is set, the message files will simply be deleted.
2249 # This option is similar to $maildir_trash for Maildir folders.
2253 # 3.158. mh_seq_flagged
2256 # Default: “flagged”
2258 # The name of the MH sequence used for flagged messages.
2262 # 3.159. mh_seq_replied
2265 # Default: “replied”
2267 # The name of the MH sequence used to tag replied messages.
2271 # 3.160. mh_seq_unseen
2276 # The name of the MH sequence used for unseen messages.
2280 # 3.161. mime_forward
2285 # When set, the message you are forwarding will be attached as a separate message
2286 # /rfc822 MIME part instead of included in the main body of the message. This is
2287 # useful for forwarding MIME messages so the receiver can properly view the
2288 # message as it was delivered to you. If you like to switch between MIME and not
2289 # MIME from mail to mail, set this variable to “ask-no” or “ask-yes”.
2291 # Also see $forward_decode and $mime_forward_decode.
2293 set mime_forward=ask-yes
2296 # 3.162. mime_forward_decode
2301 # Controls the decoding of complex MIME messages into text/plain when forwarding
2302 # a message while $mime_forward is set. Otherwise $forward_decode is used
2307 # 3.163. mime_forward_rest
2312 # When forwarding multiple attachments of a MIME message from the attachment
2313 # menu, attachments which cannot be decoded in a reasonable manner will be
2314 # attached to the newly composed message if this option is set.
2318 # 3.164. mime_type_query_command
2323 # This specifies a command to run, to determine the mime type of a new attachment
2324 # when composing a message. Unless $mime_type_query_first is set, this will only
2325 # be run if the attachment's extension is not found in the mime.types file.
2327 # The string may contain a “%s”, which will be substituted with the attachment
2328 # filename. Mutt will add quotes around the string substituted for “%s”
2329 # automatically according to shell quoting rules, so you should avoid adding your
2330 # own. If no “%s” is found in the string, Mutt will append the attachment
2331 # filename to the end of the string.
2333 # The command should output a single line containing the attachment's mime type.
2335 # Suggested values are “xdg-mime query filetype” or “file -bi”.
2339 # 3.165. mime_type_query_first
2344 # When set, the $mime_type_query_command will be run before the mime.types
2349 # 3.166. mix_entry_format
2352 # Default: “%4n %c %-16s %a”
2354 # This variable describes the format of a remailer line on the mixmaster chain
2355 # selection screen. The following printf(3)-like sequences are supported:
2357 # ┌──┬───────────────────────────────┐
2358 # │%n│The running number on the menu.│
2359 # ├──┼───────────────────────────────┤
2360 # │%c│Remailer capabilities. │
2361 # ├──┼───────────────────────────────┤
2362 # │%s│The remailer's short name. │
2363 # ├──┼───────────────────────────────┤
2364 # │%a│The remailer's e-mail address. │
2365 # └──┴───────────────────────────────┘
2372 # Default: “mixmaster”
2374 # This variable contains the path to the Mixmaster binary on your system. It is
2375 # used with various sets of parameters to gather the list of known remailers, and
2376 # to finally send a message through the mixmaster chain.
2378 set mixmaster="mixmaster-filter"
2386 # Controls whether or not Mutt will move read messages from your spool mailbox to
2387 # your $mbox mailbox, or as a result of a “mbox-hook” command.
2392 # 3.169. narrow_tree
2397 # This variable, when set, makes the thread tree narrower, allowing deeper
2398 # threads to fit on the screen.
2408 # Operations that expect to transfer a large amount of data over the network will
2409 # update their progress every $net_inc kilobytes. If set to 0, no progress
2410 # messages will be displayed.
2412 # See also $read_inc, $write_inc and $net_inc.
2416 # 3.171. new_mail_command
2421 # If set, Mutt will call this command after a new message is received. See the
2422 # $status_format documentation for the values that can be formatted into this
2430 # Default: “builtin”
2432 # This variable specifies which pager you would like to use to view messages. The
2433 # value “builtin” means to use the built-in pager, otherwise this variable should
2434 # specify the pathname of the external pager you would like to use.
2436 # Using an external pager may have some disadvantages: Additional keystrokes are
2437 # necessary because you can't call mutt functions directly from the pager, and
2438 # screen resizes cause lines longer than the screen width to be badly formatted
2443 # 3.173. pager_context
2448 # This variable controls the number of lines of context that are given when
2449 # displaying the next or previous page in the internal pager. By default, Mutt
2450 # will display the line after the last one on the screen at the top of the next
2451 # page (0 lines of context).
2453 # This variable also specifies the amount of context given for search results. If
2454 # positive, this many lines will be given before a match, if 0, the match will be
2460 # 3.174. pager_format
2463 # Default: “-%Z- %C/%m: %-20.20n %s%* -- (%P)”
2465 # This variable controls the format of the one-line message “status” displayed
2466 # before each message in either the internal or an external pager. The valid
2467 # sequences are listed in the $index_format section.
2469 set pager_format="<%a> %* %i (%P)"
2472 # 3.175. pager_index_lines
2477 # Determines the number of lines of a mini-index which is shown when in the
2478 # pager. The current message, unless near the top or bottom of the folder, will
2479 # be roughly one third of the way down this mini-index, giving the reader the
2480 # context of a few messages before and after the message. This is useful, for
2481 # example, to determine how many messages remain to be read in the current
2482 # thread. One of the lines is reserved for the status bar from the index, so a
2483 # setting of 6 will only show 5 lines of the actual index. A value of 0 results
2484 # in no index being shown. If the number of messages in the current folder is
2485 # less than $pager_index_lines, then the index will only use as many lines as it
2488 set pager_index_lines=5
2496 # When set, the internal-pager will not move to the next message when you are at
2497 # the end of a message and invoke the <next-page> function.
2502 # 3.177. pgp_auto_decode
2507 # If set, mutt will automatically attempt to decrypt traditional PGP messages
2508 # whenever the user performs an operation which ordinarily would result in the
2509 # contents of the message being operated on. For example, if the user displays a
2510 # pgp-traditional message which has not been manually checked with the
2511 # <check-traditional-pgp> function, mutt will automatically check the message for
2514 set pgp_auto_decode=yes
2517 # 3.178. pgp_autoinline
2522 # This option controls whether Mutt generates old-style inline (traditional) PGP
2523 # encrypted or signed messages under certain circumstances. This can be
2524 # overridden by use of the pgp menu, when inline is not required. The GPGME
2525 # backend does not support this option.
2527 # Note that Mutt might automatically use PGP/MIME for messages which consist of
2528 # more than a single MIME part. Mutt can be configured to ask before sending PGP/
2529 # MIME messages when inline (traditional) would not work.
2531 # Also see the $pgp_mime_auto variable.
2533 # Also note that using the old-style PGP message format is strongly deprecated.
2538 # 3.179. pgp_check_exit
2543 # If set, mutt will check the exit code of the PGP subprocess when signing or
2544 # encrypting. A non-zero exit code means that the subprocess failed. (PGP only)
2548 # 3.180. pgp_check_gpg_decrypt_status_fd
2553 # If set, mutt will check the status file descriptor output of
2554 # $pgp_decrypt_command and $pgp_decode_command for GnuPG status codes indicating
2555 # successful decryption. This will check for the presence of DECRYPTION_OKAY,
2556 # absence of DECRYPTION_FAILED, and that all PLAINTEXT occurs between the
2557 # BEGIN_DECRYPTION and END_DECRYPTION status codes.
2559 # If unset, mutt will instead match the status fd output against
2560 # $pgp_decryption_okay. (PGP only)
2564 # 3.181. pgp_clearsign_command
2569 # This format is used to create an old-style “clearsigned” PGP message. Note that
2570 # the use of this format is strongly deprecated.
2572 # This is a format string, see the $pgp_decode_command command for possible
2573 # printf(3)-like sequences. (PGP only)
2577 # 3.182. pgp_decode_command
2582 # This format strings specifies a command which is used to decode application/pgp
2585 # The PGP command formats have their own set of printf(3)-like sequences:
2587 # ┌──┬──────────────────────────────────────────────────────────────────────────┐
2588 # │%p│Expands to PGPPASSFD=0 when a pass phrase is needed, to an empty string │
2589 # │ │otherwise. Note: This may be used with a %? construct. │
2590 # ├──┼──────────────────────────────────────────────────────────────────────────┤
2591 # │%f│Expands to the name of a file containing a message. │
2592 # ├──┼──────────────────────────────────────────────────────────────────────────┤
2593 # │%s│Expands to the name of a file containing the signature part of a multipart│
2594 # │ │/signed attachment when verifying it. │
2595 # ├──┼──────────────────────────────────────────────────────────────────────────┤
2596 # │%a│The value of $pgp_sign_as if set, otherwise the value of $pgp_default_key.│
2597 # ├──┼──────────────────────────────────────────────────────────────────────────┤
2598 # │%r│One or more key IDs (or fingerprints if available). │
2599 # └──┴──────────────────────────────────────────────────────────────────────────┘
2601 # For examples on how to configure these formats for the various versions of PGP
2602 # which are floating around, see the pgp and gpg sample configuration files in
2603 # the samples/ subdirectory which has been installed on your system alongside the
2604 # documentation. (PGP only)
2608 # 3.183. pgp_decrypt_command
2613 # This command is used to decrypt a PGP encrypted message.
2615 # This is a format string, see the $pgp_decode_command command for possible
2616 # printf(3)-like sequences. (PGP only)
2620 # 3.184. pgp_decryption_okay
2622 # Type: regular expression
2625 # If you assign text to this variable, then an encrypted PGP message is only
2626 # considered successfully decrypted if the output from $pgp_decrypt_command
2627 # contains the text. This is used to protect against a spoofed encrypted message,
2628 # with multipart/encrypted headers but containing a block that is not actually
2629 # encrypted. (e.g. simply signed and ascii armored text).
2631 # Note that if $pgp_check_gpg_decrypt_status_fd is set, this variable is ignored.
2636 # 3.185. pgp_default_key
2641 # This is the default key-pair to use for PGP operations. It will be used for
2642 # encryption (see $postpone_encrypt and $pgp_self_encrypt).
2644 # It will also be used for signing unless $pgp_sign_as is set.
2646 # The (now deprecated) pgp_self_encrypt_as is an alias for this variable, and
2647 # should no longer be used. (PGP only)
2651 # 3.186. pgp_encrypt_only_command
2656 # This command is used to encrypt a body part without signing it.
2658 # This is a format string, see the $pgp_decode_command command for possible
2659 # printf(3)-like sequences. (PGP only)
2663 # 3.187. pgp_encrypt_sign_command
2668 # This command is used to both sign and encrypt a body part.
2670 # This is a format string, see the $pgp_decode_command command for possible
2671 # printf(3)-like sequences. (PGP only)
2675 # 3.188. pgp_entry_format
2678 # Default: “%4n %t%f %4l/0x%k %-4a %2c %u”
2680 # This variable allows you to customize the PGP key selection menu to your
2681 # personal taste. This string is similar to $index_format, but has its own set of
2682 # printf(3)-like sequences:
2684 # ┌──────┬──────────────────────────────────────────────────────┐
2686 # ├──────┼──────────────────────────────────────────────────────┤
2688 # ├──────┼──────────────────────────────────────────────────────┤
2690 # ├──────┼──────────────────────────────────────────────────────┤
2692 # ├──────┼──────────────────────────────────────────────────────┤
2694 # ├──────┼──────────────────────────────────────────────────────┤
2696 # ├──────┼──────────────────────────────────────────────────────┤
2697 # │%c │capabilities │
2698 # ├──────┼──────────────────────────────────────────────────────┤
2699 # │%t │trust/validity of the key-uid association │
2700 # ├──────┼──────────────────────────────────────────────────────┤
2701 # │%[<s>]│date of the key where <s> is an strftime(3) expression│
2702 # └──────┴──────────────────────────────────────────────────────┘
2708 # 3.189. pgp_export_command
2713 # This command is used to export a public key from the user's key ring.
2715 # This is a format string, see the $pgp_decode_command command for possible
2716 # printf(3)-like sequences. (PGP only)
2720 # 3.190. pgp_getkeys_command
2725 # This command is invoked whenever Mutt needs to fetch the public key associated
2726 # with an email address. Of the sequences supported by $pgp_decode_command, %r is
2727 # the only printf(3)-like sequence used with this format. Note that in this case,
2728 # %r expands to the email address, not the public key ID (the key ID is unknown,
2729 # which is why Mutt is invoking this command). (PGP only)
2733 # 3.191. pgp_good_sign
2735 # Type: regular expression
2738 # If you assign a text to this variable, then a PGP signature is only considered
2739 # verified if the output from $pgp_verify_command contains the text. Use this
2740 # variable if the exit code from the command is 0 even for bad signatures. (PGP
2745 # 3.192. pgp_ignore_subkeys
2750 # Setting this variable will cause Mutt to ignore OpenPGP subkeys. Instead, the
2751 # principal key will inherit the subkeys' capabilities. Unset this if you want to
2752 # play interesting key selection games. (PGP only)
2756 # 3.193. pgp_import_command
2761 # This command is used to import a key from a message into the user's public key
2764 # This is a format string, see the $pgp_decode_command command for possible
2765 # printf(3)-like sequences. (PGP only)
2769 # 3.194. pgp_list_pubring_command
2774 # This command is used to list the public key ring's contents. The output format
2775 # must be analogous to the one used by
2777 # gpg --list-keys --with-colons --with-fingerprint
2779 # This format is also generated by the pgpring utility which comes with mutt.
2781 # Note: gpg's fixed-list-mode option should not be used. It produces a different
2782 # date format which may result in mutt showing incorrect key generation dates.
2784 # This is a format string, see the $pgp_decode_command command for possible
2785 # printf(3)-like sequences. (PGP only)
2789 # 3.195. pgp_list_secring_command
2794 # This command is used to list the secret key ring's contents. The output format
2795 # must be analogous to the one used by:
2797 # gpg --list-keys --with-colons --with-fingerprint
2799 # This format is also generated by the pgpring utility which comes with mutt.
2801 # Note: gpg's fixed-list-mode option should not be used. It produces a different
2802 # date format which may result in mutt showing incorrect key generation dates.
2804 # This is a format string, see the $pgp_decode_command command for possible
2805 # printf(3)-like sequences. (PGP only)
2809 # 3.196. pgp_long_ids
2814 # If set, use 64 bit PGP key IDs, if unset use the normal 32 bit key IDs. NOTE:
2815 # Internally, Mutt has transitioned to using fingerprints (or long key IDs as a
2816 # fallback). This option now only controls the display of key IDs in the key
2817 # selection menu and a few other places. (PGP only)
2821 # 3.197. pgp_mime_auto
2826 # This option controls whether Mutt will prompt you for automatically sending a
2827 # (signed/encrypted) message using PGP/MIME when inline (traditional) fails (for
2830 # Also note that using the old-style PGP message format is strongly deprecated.
2835 # 3.198. pgp_replyinline
2840 # Setting this variable will cause Mutt to always attempt to create an inline
2841 # (traditional) message when replying to a message which is PGP encrypted/signed
2842 # inline. This can be overridden by use of the pgp menu, when inline is not
2843 # required. This option does not automatically detect if the (replied-to) message
2844 # is inline; instead it relies on Mutt internals for previously checked/flagged
2847 # Note that Mutt might automatically use PGP/MIME for messages which consist of
2848 # more than a single MIME part. Mutt can be configured to ask before sending PGP/
2849 # MIME messages when inline (traditional) would not work.
2851 # Also see the $pgp_mime_auto variable.
2853 # Also note that using the old-style PGP message format is strongly deprecated.
2858 # 3.199. pgp_retainable_sigs
2863 # If set, signed and encrypted messages will consist of nested multipart/signed
2864 # and multipart/encrypted body parts.
2866 # This is useful for applications like encrypted and signed mailing lists, where
2867 # the outer layer (multipart/encrypted) can be easily removed, while the inner
2868 # multipart/signed part is retained. (PGP only)
2870 set pgp_retainable_sigs=yes
2873 # 3.200. pgp_self_encrypt
2878 # When set, PGP encrypted messages will also be encrypted using the key in
2879 # $pgp_default_key. (PGP only)
2883 # 3.201. pgp_show_unusable
2888 # If set, mutt will display non-usable keys on the PGP key selection menu. This
2889 # includes keys which have been revoked, have expired, or have been marked as “
2890 # disabled” by the user. (PGP only)
2892 set pgp_show_unusable=no
2895 # 3.202. pgp_sign_as
2900 # If you have a different key pair to use for signing, you should set this to the
2901 # signing key. Most people will only need to set $pgp_default_key. It is
2902 # recommended that you use the keyid form to specify your key (e.g. 0x00112233).
2905 set pgp_sign_as="0x9C9D6979AE941637"
2908 # 3.203. pgp_sign_command
2913 # This command is used to create the detached PGP signature for a multipart/
2914 # signed PGP/MIME body part.
2916 # This is a format string, see the $pgp_decode_command command for possible
2917 # printf(3)-like sequences. (PGP only)
2921 # 3.204. pgp_sort_keys
2926 # Specifies how the entries in the pgp menu are sorted. The following are legal
2929 # ┌───────┬──────────────────────────────┐
2930 # │address│sort alphabetically by user id│
2931 # ├───────┼──────────────────────────────┤
2932 # │keyid │sort alphabetically by key id │
2933 # ├───────┼──────────────────────────────┤
2934 # │date │sort by key creation date │
2935 # ├───────┼──────────────────────────────┤
2936 # │trust │sort by the trust of the key │
2937 # └───────┴──────────────────────────────┘
2939 # If you prefer reverse order of the above values, prefix it with “reverse-”.
2944 # 3.205. pgp_strict_enc
2949 # If set, Mutt will automatically encode PGP/MIME signed messages as
2950 # quoted-printable. Please note that unsetting this variable may lead to problems
2951 # with non-verifyable PGP signatures, so only change this if you know what you
2952 # are doing. (PGP only)
2956 # 3.206. pgp_timeout
2961 # The number of seconds after which a cached passphrase will expire if not used.
2966 # 3.207. pgp_use_gpg_agent
2971 # If set, mutt will use a possibly-running gpg-agent(1) process. Note that as of
2972 # version 2.1, GnuPG no longer exports GPG_AGENT_INFO, so mutt no longer verifies
2973 # if the agent is running. (PGP only)
2975 set pgp_use_gpg_agent=yes
2978 # 3.208. pgp_verify_command
2983 # This command is used to verify PGP signatures.
2985 # This is a format string, see the $pgp_decode_command command for possible
2986 # printf(3)-like sequences. (PGP only)
2990 # 3.209. pgp_verify_key_command
2995 # This command is used to verify key information from the key selection menu.
2997 # This is a format string, see the $pgp_decode_command command for possible
2998 # printf(3)-like sequences. (PGP only)
3002 # 3.210. pipe_decode
3007 # Used in connection with the <pipe-message> command. When unset, Mutt will pipe
3008 # the messages without any preprocessing. When set, Mutt will weed headers and
3009 # will attempt to decode the messages first.
3018 # The separator to add between messages when piping a list of tagged messages to
3019 # an external Unix command.
3028 # Used in connection with the <pipe-message> function following <tag-prefix>. If
3029 # this variable is unset, when piping a list of tagged messages Mutt will
3030 # concatenate the messages and will pipe them all concatenated. When set, Mutt
3031 # will pipe the messages one by one. In both cases the messages are piped in the
3032 # current sorted order, and the $pipe_sep separator is added after each message.
3036 # 3.213. pop_auth_try_all
3041 # If set, Mutt will try all available authentication methods. When unset, Mutt
3042 # will only fall back to other authentication methods if the previous methods are
3043 # unavailable. If a method is available but authentication fails, Mutt will not
3044 # connect to the POP server.
3048 # 3.214. pop_authenticators
3053 # This is a colon-delimited list of authentication methods mutt may attempt to
3054 # use to log in to an POP server, in the order mutt should try them.
3055 # Authentication methods are either “user”, “apop” or any SASL mechanism, e.g. “
3056 # digest-md5”, “gssapi” or “cram-md5”. This option is case-insensitive. If this
3057 # option is unset (the default) mutt will try all available methods, in order
3058 # from most-secure to least-secure.
3062 # set pop_authenticators="digest-md5:apop:user"
3066 # 3.215. pop_checkinterval
3071 # This variable configures how often (in seconds) mutt should look for new mail
3072 # in the currently selected mailbox if it is a POP mailbox.
3081 # If set, Mutt will delete successfully downloaded messages from the POP server
3082 # when using the <fetch-mail> function. When unset, Mutt will download messages
3083 # but also leave them on the POP server.
3092 # The name of your POP server for the <fetch-mail> function. You can also specify
3093 # an alternative port, username and password, i.e.:
3095 # [pop[s]://][username[:password]@]popserver[:port]
3097 # where “[...]” denotes an optional part.
3106 # If this variable is set, mutt will try to use the “LAST” POP command for
3107 # retrieving only unread messages from the POP server when using the <fetch-mail>
3112 # 3.219. pop_oauth_refresh_command
3117 # The command to run to generate an OAUTH refresh token for authorizing your
3118 # connection to your POP server. This command will be run on every connection
3119 # attempt that uses the OAUTHBEARER authentication mechanism.
3128 # Specifies the password for your POP account. If unset, Mutt will prompt you for
3129 # your password when you open a POP mailbox.
3131 # Warning: you should only use this option when you are on a fairly secure
3132 # machine, because the superuser can read your muttrc even if you are the only
3133 # one who can read the file.
3137 # 3.221. pop_reconnect
3142 # Controls whether or not Mutt will try to reconnect to the POP server if the
3143 # connection is lost.
3152 # Your login name on the POP server.
3154 # This variable defaults to your user name on the local machine.
3158 # 3.223. post_indent_string
3163 # Similar to the $attribution variable, Mutt will append this string after the
3164 # inclusion of a message which is being replied to.
3173 # Controls whether or not messages are saved in the $postponed mailbox when you
3174 # elect not to send immediately.
3176 # Also see the $recall variable.
3183 # Default: “~/postponed”
3185 # Mutt allows you to indefinitely “postpone sending a message” which you are
3186 # editing. When you choose to postpone a message, Mutt saves it in the mailbox
3187 # specified by this variable.
3189 # Also see the $postpone variable.
3191 set postponed="=drafts"
3194 # 3.226. postpone_encrypt
3199 # When set, postponed messages that are marked for encryption will be
3200 # self-encrypted. Mutt will first try to encrypt using the value specified in
3201 # $pgp_default_key or $smime_default_key. If those are not set, it will try the
3202 # deprecated $postpone_encrypt_as. (Crypto only)
3206 # 3.227. postpone_encrypt_as
3211 # This is a deprecated fall-back variable for $postpone_encrypt. Please use
3212 # $pgp_default_key or $smime_default_key. (Crypto only)
3221 # If set, a shell command to be executed if mutt fails to establish a connection
3222 # to the server. This is useful for setting up secure connections, e.g. with ssh
3223 # (1). If the command returns a nonzero status, mutt gives up opening the server.
3226 # set preconnect="ssh -f -q -L 1234:mailhost.net:143 mailhost.net sleep 20 < /dev/null > /dev/null"
3228 # Mailbox “foo” on “mailhost.net” can now be reached as “{localhost:1234}foo”.
3230 # Note: For this example to work, you must be able to log in to the remote
3231 # machine without having to enter a password.
3240 # Controls whether or not Mutt really prints messages. This is set to “ask-no” by
3241 # default, because some people accidentally hit “p” often.
3245 # 3.230. print_command
3250 # This specifies the command pipe that should be used to print messages.
3252 set print_command="muttprint"
3255 # 3.231. print_decode
3260 # Used in connection with the <print-message> command. If this option is set, the
3261 # message is decoded before it is passed to the external command specified by
3262 # $print_command. If this option is unset, no processing will be applied to the
3263 # message when printing it. The latter setting may be useful if you are using
3264 # some advanced printer filter which is able to properly format e-mail messages
3269 # 3.232. print_split
3274 # Used in connection with the <print-message> command. If this option is set, the
3275 # command specified by $print_command is executed once for each message which is
3276 # to be printed. If this option is unset, the command specified by $print_command
3277 # is executed only once, and all the messages are concatenated, with a form feed
3278 # as the message separator.
3280 # Those who use the enscript(1) program's mail-printing mode will most likely
3281 # want to set this option.
3286 # 3.233. prompt_after
3291 # If you use an external $pager, setting this variable will cause Mutt to prompt
3292 # you for a command when the pager exits rather than returning to the index menu.
3293 # If unset, Mutt will return to the index menu when the external pager exits.
3297 # 3.234. query_command
3302 # This specifies the command Mutt will use to make external address queries. The
3303 # string may contain a “%s”, which will be substituted with the query string the
3304 # user types. Mutt will add quotes around the string substituted for “%s”
3305 # automatically according to shell quoting rules, so you should avoid adding your
3306 # own. If no “%s” is found in the string, Mutt will append the user's query to
3307 # the end of the string. See “query” for more information.
3309 set query_command="lbdbq"
3312 # 3.235. query_format
3315 # Default: “%4c %t %-25.25a %-25.25n %?e?(%e)?”
3317 # This variable describes the format of the “query” menu. The following printf(3)
3318 # -style sequences are understood:
3320 # ┌───┬─────────────────────────────────────────────────────┐
3321 # │%a │destination address │
3322 # ├───┼─────────────────────────────────────────────────────┤
3323 # │%c │current entry number │
3324 # ├───┼─────────────────────────────────────────────────────┤
3325 # │%e │extra information * │
3326 # ├───┼─────────────────────────────────────────────────────┤
3327 # │%n │destination name │
3328 # ├───┼─────────────────────────────────────────────────────┤
3329 # │%t │“*” if current entry is tagged, a space otherwise │
3330 # ├───┼─────────────────────────────────────────────────────┤
3331 # │%>X│right justify the rest of the string and pad with “X”│
3332 # ├───┼─────────────────────────────────────────────────────┤
3333 # │%|X│pad to the end of the line with “X” │
3334 # ├───┼─────────────────────────────────────────────────────┤
3335 # │%*X│soft-fill with character “X” as pad │
3336 # └───┴─────────────────────────────────────────────────────┘
3338 # For an explanation of “soft-fill”, see the $index_format documentation.
3340 # * = can be optionally printed if nonzero, see the $status_format documentation.
3349 # This variable controls whether “quit” and “exit” actually quit from mutt. If
3350 # this option is set, they do quit, if it is unset, they have no effect, and if
3351 # it is set to ask-yes or ask-no, you are prompted for confirmation when you try
3356 # 3.237. quote_regexp
3358 # Type: regular expression
3359 # Default: “^([ t]*[|>:}#])+”
3361 # A regular expression used in the internal pager to determine quoted sections of
3362 # text in the body of a message. Quoted text may be filtered out using the
3363 # <toggle-quoted> command, or colored according to the “color quoted” family of
3366 # Higher levels of quoting may be colored differently (“color quoted1”, “color
3367 # quoted2”, etc.). The quoting level is determined by removing the last character
3368 # from the matched text and recursively reapplying the regular expression until
3369 # it fails to produce a match.
3371 # Match detection may be overridden by the $smileys regular expression.
3380 # If set to a value greater than 0, Mutt will display which message it is
3381 # currently on when reading a mailbox or when performing search actions such as
3382 # search and limit. The message is printed after this many messages have been
3383 # read or searched (e.g., if set to 25, Mutt will print a message when it is at
3384 # message 25, and then again when it gets to message 50). This variable is meant
3385 # to indicate progress when reading or searching large mailboxes which may take
3386 # some time. When set to 0, only a single message will appear before the reading
3389 # Also see the $write_inc, $net_inc and $time_inc variables and the “tuning”
3390 # section of the manual for performance considerations.
3399 # If set, all folders are opened in read-only mode.
3408 # This variable specifies what “real” or “personal” name should be used when
3411 # By default, this is the GECOS field from /etc/passwd. Note that this variable
3412 # will not be used when the user has set a real name in the $from variable.
3421 # Controls whether or not Mutt recalls postponed messages when composing a new
3424 # Setting this variable to yes is not generally useful, and thus not recommended.
3425 # Note that the <recall-message> function can be used to manually recall
3426 # postponed messages.
3428 # Also see $postponed variable.
3438 # This specifies the file into which your outgoing messages should be appended.
3439 # (This is meant as the primary method for saving a copy of your messages, but
3440 # another way to do this is using the “my_hdr” command to create a “Bcc:” field
3441 # with your email address in it.)
3443 # The value of $record is overridden by the $force_name and $save_name variables,
3444 # and the “fcc-hook” command.
3449 # 3.243. reflow_space_quotes
3454 # This option controls how quotes from format=flowed messages are displayed in
3455 # the pager and when replying (with $text_flowed unset). When set, this option
3456 # adds spaces after each level of quote marks, turning ">>>foo" into "> > > foo".
3458 # Note: If $reflow_text is unset, this option has no effect. Also, this option
3459 # does not affect replies when $text_flowed is set.
3463 # 3.244. reflow_text
3468 # When set, Mutt will reformat paragraphs in text/plain parts marked format=
3469 # flowed. If unset, Mutt will display paragraphs unaltered from how they appear
3470 # in the message body. See RFC3676 for details on the format=flowed format.
3472 # Also see $reflow_wrap, and $wrap.
3476 # 3.245. reflow_wrap
3481 # This variable controls the maximum paragraph width when reformatting text/plain
3482 # parts when $reflow_text is set. When the value is 0, paragraphs will be wrapped
3483 # at the terminal's right margin. A positive value sets the paragraph width
3484 # relative to the left margin. A negative value set the paragraph width relative
3485 # to the right margin.
3492 # 3.246. reply_regexp
3494 # Type: regular expression
3495 # Default: “^(re([[0-9]+])*|aw):[ t]*”
3497 # A regular expression used to recognize reply messages when threading and
3498 # replying. The default value corresponds to the English "Re:" and the German
3501 set reply_regexp="^((re([-[(]?[[:digit:]]+[)]]?)?|a(nt)?w(ort)?|wg|s(gkb|v)):[[:space:]]*)+"
3509 # If unset and you are replying to a message sent by you, Mutt will assume that
3510 # you want to reply to the recipients of that message rather than to yourself.
3512 # Also see the “alternates” command.
3521 # If set, when replying to a message, Mutt will use the address listed in the
3522 # Reply-to: header as the recipient of the reply. If unset, it will use the
3523 # address in the From: header field instead. This option is useful for reading a
3524 # mailing list that sets the Reply-To: header field to the list address and you
3525 # want to send a private message to the author of a message.
3534 # When set, the cursor will be automatically advanced to the next (possibly
3535 # undeleted) message whenever a command that modifies the current message is
3540 # 3.250. resume_draft_files
3545 # If set, draft files (specified by -H on the command line) are processed
3546 # similarly to when resuming a postponed message. Recipients are not prompted
3547 # for; send-hooks are not evaluated; no alias expansion takes place; user-defined
3548 # headers and signatures are not added to the message.
3552 # 3.251. resume_edited_draft_files
3557 # If set, draft files previously edited (via -E -H on the command line) will have
3558 # $resume_draft_files automatically set when they are used as a draft file again.
3560 # The first time a draft file is saved, mutt will add a header,
3561 # X-Mutt-Resume-Draft to the saved file. The next time the draft file is read in,
3562 # if mutt sees the header, it will set $resume_draft_files.
3564 # This option is designed to prevent multiple signatures, user-defined headers,
3565 # and other processing effects from being made multiple times to the draft file.
3569 # 3.252. reverse_alias
3574 # This variable controls whether or not Mutt will display the “personal” name
3575 # from your aliases in the index menu if it finds an alias that matches the
3576 # message's sender. For example, if you have the following alias:
3578 # alias juser abd30425@somewhere.net (Joe User)
3580 # and then you receive mail which contains the following header:
3582 # From: abd30425@somewhere.net
3584 # It would be displayed in the index menu as “Joe User” instead of “
3585 # abd30425@somewhere.net.” This is useful when the person's e-mail address is not
3590 # 3.253. reverse_name
3595 # It may sometimes arrive that you receive mail to a certain machine, move the
3596 # messages to another machine, and reply to some the messages from there. If this
3597 # variable is set, the default From: line of the reply messages is built using
3598 # the address where you received the messages you are replying to if that address
3599 # matches your “alternates”. If the variable is unset, or the address that would
3600 # be used doesn't match your “alternates”, the From: line will use your address
3601 # on the current machine.
3603 # Also see the “alternates” command.
3605 set reverse_name=yes
3608 # 3.254. reverse_realname
3613 # This variable fine-tunes the behavior of the $reverse_name feature. When it is
3614 # set, mutt will use the address from incoming messages as-is, possibly including
3615 # eventual real names. When it is unset, mutt will override any such real names
3616 # with the setting of the $realname variable.
3620 # 3.255. rfc2047_parameters
3625 # When this variable is set, Mutt will decode RFC2047-encoded MIME parameters.
3626 # You want to set this variable when mutt suggests you to save attachments to
3629 # =?iso-8859-1?Q?file=5F=E4=5F991116=2Ezip?=
3631 # When this variable is set interactively, the change won't be active until you
3634 # Note that this use of RFC2047's encoding is explicitly prohibited by the
3635 # standard, but nevertheless encountered in the wild.
3637 # Also note that setting this parameter will not have the effect that mutt
3638 # generates this kind of encoding. Instead, mutt will unconditionally use the
3639 # encoding specified in RFC2231.
3641 set rfc2047_parameters=yes
3644 # 3.256. save_address
3649 # If set, mutt will take the sender's full address when choosing a default folder
3650 # for saving a mail. If $save_name or $force_name is set too, the selection of
3651 # the Fcc folder will be changed as well.
3660 # When unset, mailboxes which contain no saved messages will be removed when
3661 # closed (the exception is $spoolfile which is never removed). If set, mailboxes
3662 # are never removed.
3664 # Note: This only applies to mbox and MMDF folders, Mutt does not delete MH and
3665 # Maildir directories.
3669 # 3.258. save_history
3674 # This variable controls the size of the history (per category) saved in the
3675 # $history_file file.
3677 set save_history=100
3685 # This variable controls how copies of outgoing messages are saved. When set, a
3686 # check is made to see if a mailbox specified by the recipient address exists
3687 # (this is done by searching for a mailbox in the $folder directory with the
3688 # username part of the recipient address). If the mailbox exists, the outgoing
3689 # message will be saved to that mailbox, otherwise the message is saved to the
3692 # Also see the $force_name variable.
3701 # When this variable is unset, scoring is turned off. This can be useful to
3702 # selectively disable scoring for certain folders when the
3703 # $score_threshold_delete variable and related are used.
3707 # 3.261. score_threshold_delete
3712 # Messages which have been assigned a score equal to or lower than the value of
3713 # this variable are automatically marked for deletion by mutt. Since mutt scores
3714 # are always greater than or equal to zero, the default setting of this variable
3715 # will never mark a message for deletion.
3719 # 3.262. score_threshold_flag
3724 # Messages which have been assigned a score greater than or equal to this
3725 # variable's value are automatically marked "flagged".
3729 # 3.263. score_threshold_read
3734 # Messages which have been assigned a score equal to or lower than the value of
3735 # this variable are automatically marked as read by mutt. Since mutt scores are
3736 # always greater than or equal to zero, the default setting of this variable will
3737 # never mark a message read.
3741 # 3.264. search_context
3746 # For the pager, this variable specifies the number of lines shown before search
3747 # results. By default, search results will be top-aligned.
3749 set search_context=5
3752 # 3.265. send_charset
3755 # Default: “us-ascii:iso-8859-1:utf-8”
3757 # A colon-delimited list of character sets for outgoing messages. Mutt will use
3758 # the first character set into which the text can be converted exactly. If your
3759 # $charset is not “iso-8859-1” and recipients may not understand “UTF-8”, it is
3760 # advisable to include in the list an appropriate widely used standard character
3761 # set (such as “iso-8859-2”, “koi8-r” or “iso-2022-jp”) either instead of or
3762 # after “iso-8859-1”.
3764 # In case the text cannot be converted into one of these exactly, mutt uses
3765 # $charset as a fallback.
3767 set send_charset="utf-8"
3773 # Default: “/usr/sbin/sendmail -oem -oi”
3775 # Specifies the program and arguments used to deliver mail sent by Mutt. Mutt
3776 # expects that the specified program interprets additional arguments as recipient
3777 # addresses. Mutt appends all recipients after adding a -- delimiter (if not
3778 # already present). Additional flags, such as for $use_8bitmime,
3779 # $use_envelope_from, $dsn_notify, or $dsn_return will be added before the
3782 set sendmail="$my_confdir/sendmail"
3785 # 3.267. sendmail_wait
3790 # Specifies the number of seconds to wait for the $sendmail process to finish
3791 # before giving up and putting delivery in the background.
3793 # Mutt interprets the value of this variable as follows:
3795 # ┌──┬──────────────────────────────────────────────────────────────────┐
3796 # │>0│number of seconds to wait for sendmail to finish before continuing│
3797 # ├──┼──────────────────────────────────────────────────────────────────┤
3798 # │0 │wait forever for sendmail to finish │
3799 # ├──┼──────────────────────────────────────────────────────────────────┤
3800 # │<0│always put sendmail in the background without waiting │
3801 # └──┴──────────────────────────────────────────────────────────────────┘
3803 # Note that if you specify a value other than 0, the output of the child process
3804 # will be put in a temporary file. If there is some error, you will be informed
3805 # as to where to find the output.
3814 # Command to use when spawning a subshell. By default, the user's login shell
3815 # from /etc/passwd is used.
3819 # 3.269. sidebar_delim_chars
3824 # This contains the list of characters which you would like to treat as folder
3825 # separators for displaying paths in the sidebar.
3827 # Local mail is often arranged in directories: `dir1/dir2/mailbox'.
3829 # set sidebar_delim_chars='/'
3831 # IMAP mailboxes are often named: `folder1.folder2.mailbox'.
3833 # set sidebar_delim_chars='.'
3835 # See also: $sidebar_short_path, $sidebar_folder_indent, $sidebar_indent_string.
3839 # 3.270. sidebar_divider_char
3844 # This specifies the characters to be drawn between the sidebar (when visible)
3845 # and the other Mutt panels. ASCII and Unicode line-drawing characters are
3848 set sidebar_divider_char=" "
3851 # 3.271. sidebar_folder_indent
3856 # Set this to indent mailboxes in the sidebar.
3858 # See also: $sidebar_short_path, $sidebar_indent_string, $sidebar_delim_chars.
3860 set sidebar_folder_indent=yes
3863 # 3.272. sidebar_format
3866 # Default: “%B%* %n”
3868 # This variable allows you to customize the sidebar display. This string is
3869 # similar to $index_format, but has its own set of printf(3)-like sequences:
3871 # ┌───┬─────────────────────────────────────────────────────────────────────────┐
3872 # │%B │Name of the mailbox │
3873 # ├───┼─────────────────────────────────────────────────────────────────────────┤
3874 # │%S │* Size of mailbox (total number of messages) │
3875 # ├───┼─────────────────────────────────────────────────────────────────────────┤
3876 # │%N │* Number of unread messages in the mailbox │
3877 # ├───┼─────────────────────────────────────────────────────────────────────────┤
3878 # │%n │N if mailbox has new mail, blank otherwise │
3879 # ├───┼─────────────────────────────────────────────────────────────────────────┤
3880 # │%F │* Number of Flagged messages in the mailbox │
3881 # ├───┼─────────────────────────────────────────────────────────────────────────┤
3882 # │%! │“!” : one flagged message; “!!” : two flagged messages; “n!” : n flagged │
3883 # │ │messages (for n > 2). Otherwise prints nothing. │
3884 # ├───┼─────────────────────────────────────────────────────────────────────────┤
3885 # │%d │* @ Number of deleted messages │
3886 # ├───┼─────────────────────────────────────────────────────────────────────────┤
3887 # │%L │* @ Number of messages after limiting │
3888 # ├───┼─────────────────────────────────────────────────────────────────────────┤
3889 # │%t │* @ Number of tagged messages │
3890 # ├───┼─────────────────────────────────────────────────────────────────────────┤
3891 # │%>X│right justify the rest of the string and pad with “X” │
3892 # ├───┼─────────────────────────────────────────────────────────────────────────┤
3893 # │%|X│pad to the end of the line with “X” │
3894 # ├───┼─────────────────────────────────────────────────────────────────────────┤
3895 # │%*X│soft-fill with character “X” as pad │
3896 # └───┴─────────────────────────────────────────────────────────────────────────┘
3898 # * = Can be optionally printed if nonzero @ = Only applicable to the current
3901 # In order to use %S, %N, %F, and %!, $mail_check_stats must be set. When thus
3902 # set, a suggested value for this option is "%B%?F? [%F]?%* %?N?%N/?%S".
3904 set sidebar_format="%B%?F? [%F]?%* %?N?%N/?%S"
3907 # 3.273. sidebar_indent_string
3912 # This specifies the string that is used to indent mailboxes in the sidebar. It
3913 # defaults to two spaces.
3915 # See also: $sidebar_short_path, $sidebar_folder_indent, $sidebar_delim_chars.
3917 set sidebar_indent_string=" "
3920 # 3.274. sidebar_new_mail_only
3925 # When set, the sidebar will only display mailboxes containing new, or flagged,
3928 # See also: sidebar_whitelist.
3932 # 3.275. sidebar_next_new_wrap
3937 # When set, the <sidebar-next-new> command will not stop and the end of the list
3938 # of mailboxes, but wrap around to the beginning. The <sidebar-prev-new> command
3939 # is similarly affected, wrapping around to the end of the list.
3941 set sidebar_next_new_wrap=yes
3944 # 3.276. sidebar_short_path
3949 # By default the sidebar will show the mailbox's path, relative to the $folder
3950 # variable. Setting sidebar_shortpath=yes will shorten the names relative to the
3951 # previous name. Here's an example:
3953 # ┌────────────┬─────────────┬───────────────────────────────────────────────┐
3954 # │shortpath=no│shortpath=yes│shortpath=yes, folderindent=yes, indentstr=".."│
3955 # ├────────────┼─────────────┼───────────────────────────────────────────────┤
3956 # │fruit │fruit │fruit │
3957 # ├────────────┼─────────────┼───────────────────────────────────────────────┤
3958 # │fruit.apple │apple │..apple │
3959 # ├────────────┼─────────────┼───────────────────────────────────────────────┤
3960 # │fruit.banana│banana │..banana │
3961 # ├────────────┼─────────────┼───────────────────────────────────────────────┤
3962 # │fruit.cherry│cherry │..cherry │
3963 # └────────────┴─────────────┴───────────────────────────────────────────────┘
3965 # See also: $sidebar_delim_chars, $sidebar_folder_indent, $sidebar_indent_string.
3967 set sidebar_short_path=yes
3970 # 3.277. sidebar_sort_method
3975 # Specifies how to sort entries in the file browser. By default, the entries are
3976 # sorted alphabetically. Valid values:
3978 # • alpha (alphabetically)
3980 # • count (all message count)
3982 # • flagged (flagged message count)
3984 # • name (alphabetically)
3986 # • new (unread message count)
3988 # • path (alphabetically)
3990 # • unread (unread message count)
3994 # You may optionally use the “reverse-” prefix to specify reverse sorting order
3995 # (example: “set sort_browser=reverse-date”).
3997 set sidebar_sort_method=path
4000 # 3.278. sidebar_visible
4005 # This specifies whether or not to show sidebar. The sidebar shows a list of all
4008 # See also: $sidebar_format, $sidebar_width
4010 set sidebar_visible=yes
4013 # 3.279. sidebar_width
4018 # This controls the width of the sidebar. It is measured in screen columns. For
4019 # example: sidebar_width=20 could display 20 ASCII characters, or 10 Chinese
4022 set sidebar_width=20
4030 # If set, a line containing “-- ” (note the trailing space) will be inserted
4031 # before your $signature. It is strongly recommended that you not unset this
4032 # variable unless your signature contains just your name. The reason for this is
4033 # because many software packages use “-- n” to detect your signature. For
4034 # example, Mutt has the ability to highlight the signature in a different color
4035 # in the built-in pager.
4045 # If set, the signature will be included before any quoted or forwarded text. It
4046 # is strongly recommended that you do not set this variable unless you really
4047 # know what you are doing, and are prepared to take some heat from netiquette
4055 # Default: “~/.signature”
4057 # Specifies the filename of your signature, which is appended to all outgoing
4058 # messages. If the filename ends with a pipe (“|”), it is assumed that filename
4059 # is a shell command and input should be read from its standard output.
4063 # 3.283. simple_search
4066 # Default: “~f %s | ~s %s”
4068 # Specifies how Mutt should expand a simple search into a real search pattern. A
4069 # simple search is one that does not contain any of the “~” pattern operators.
4070 # See “patterns” for more information on search patterns.
4072 # For example, if you simply type “joe” at a search or limit prompt, Mutt will
4073 # automatically expand it to the value specified by this variable by replacing “
4074 # %s” with the supplied string. For the default value, “joe” would be expanded
4075 # to: “~f joe | ~s joe”.
4077 set simple_search="~L %s | ~s %s"
4085 # Specifies time, in seconds, to pause while displaying certain informational
4086 # messages, while moving from folder to folder and after expunging messages from
4087 # the current folder. The default is to pause one second, so a value of zero for
4088 # this option suppresses the pause.
4097 # Controls the display of lines longer than the screen width in the internal
4098 # pager. If set, long lines are wrapped at a word boundary. If unset, lines are
4099 # simply wrapped at the screen edge. Also see the $markers variable.
4105 # Type: regular expression
4106 # Default: “(>From )|(:[-^]?[][)(><}{|/DP])”
4108 # The pager uses this variable to catch some common false positives of
4109 # $quote_regexp, most notably smileys and not consider a line quoted text if it
4110 # also matches $smileys. This mostly happens at the beginning of a line.
4114 # 3.287. smime_ask_cert_label
4119 # This flag controls whether you want to be asked to enter a label for a
4120 # certificate about to be added to the database or not. It is set by default. (S/
4125 # 3.288. smime_ca_location
4130 # This variable contains the name of either a directory, or a file which contains
4131 # trusted certificates for use with OpenSSL. (S/MIME only)
4135 # 3.289. smime_certificates
4140 # Since for S/MIME there is no pubring/secring as with PGP, mutt has to handle
4141 # storage and retrieval of keys by itself. This is very basic right now, and keys
4142 # and certificates are stored in two different directories, both named as the
4143 # hash-value retrieved from OpenSSL. There is an index file which contains
4144 # mailbox-address keyid pairs, and which can be manually edited. This option
4145 # points to the location of the certificates. (S/MIME only)
4147 set smime_certificates="~/.smime/certificates"
4150 # 3.290. smime_decrypt_command
4155 # This format string specifies a command which is used to decrypt application/
4156 # x-pkcs7-mime attachments.
4158 # The OpenSSL command formats have their own set of printf(3)-like sequences
4161 # ┌──┬──────────────────────────────────────────────────────────────────────────┐
4162 # │%f│Expands to the name of a file containing a message. │
4163 # ├──┼──────────────────────────────────────────────────────────────────────────┤
4164 # │%s│Expands to the name of a file containing the signature part of a multipart│
4165 # │ │/signed attachment when verifying it. │
4166 # ├──┼──────────────────────────────────────────────────────────────────────────┤
4167 # │%k│The key-pair specified with $smime_default_key │
4168 # ├──┼──────────────────────────────────────────────────────────────────────────┤
4169 # │%c│One or more certificate IDs. │
4170 # ├──┼──────────────────────────────────────────────────────────────────────────┤
4171 # │%a│The algorithm used for encryption. │
4172 # ├──┼──────────────────────────────────────────────────────────────────────────┤
4173 # │%d│The message digest algorithm specified with $smime_sign_digest_alg. │
4174 # ├──┼──────────────────────────────────────────────────────────────────────────┤
4175 # │ │CA location: Depending on whether $smime_ca_location points to a directory│
4176 # │%C│or file, this expands to “-CApath $smime_ca_location” or “-CAfile │
4177 # │ │$smime_ca_location”. │
4178 # └──┴──────────────────────────────────────────────────────────────────────────┘
4180 # For examples on how to configure these formats, see the smime.rc in the samples
4181 # / subdirectory which has been installed on your system alongside the
4182 # documentation. (S/MIME only)
4186 # 3.291. smime_decrypt_use_default_key
4191 # If set (default) this tells mutt to use the default key for decryption.
4192 # Otherwise, if managing multiple certificate-key-pairs, mutt will try to use the
4193 # mailbox-address to determine the key to use. It will ask you to supply a key,
4194 # if it can't find one. (S/MIME only)
4198 # 3.292. smime_default_key
4203 # This is the default key-pair to use for S/MIME operations, and must be set to
4204 # the keyid (the hash-value that OpenSSL generates) to work properly.
4206 # It will be used for encryption (see $postpone_encrypt and $smime_self_encrypt).
4208 # It will be used for decryption unless $smime_decrypt_use_default_key is unset.
4210 # It will also be used for signing unless $smime_sign_as is set.
4212 # The (now deprecated) smime_self_encrypt_as is an alias for this variable, and
4213 # should no longer be used. (S/MIME only)
4217 # 3.293. smime_encrypt_command
4222 # This command is used to create encrypted S/MIME messages.
4224 # This is a format string, see the $smime_decrypt_command command for possible
4225 # printf(3)-like sequences. (S/MIME only)
4229 # 3.294. smime_encrypt_with
4234 # This sets the algorithm that should be used for encryption. Valid choices are “
4235 # aes128”, “aes192”, “aes256”, “des”, “des3”, “rc2-40”, “rc2-64”, “rc2-128”. (S/
4240 # 3.295. smime_get_cert_command
4245 # This command is used to extract X509 certificates from a PKCS7 structure.
4247 # This is a format string, see the $smime_decrypt_command command for possible
4248 # printf(3)-like sequences. (S/MIME only)
4252 # 3.296. smime_get_cert_email_command
4257 # This command is used to extract the mail address(es) used for storing X509
4258 # certificates, and for verification purposes (to check whether the certificate
4259 # was issued for the sender's mailbox).
4261 # This is a format string, see the $smime_decrypt_command command for possible
4262 # printf(3)-like sequences. (S/MIME only)
4266 # 3.297. smime_get_signer_cert_command
4271 # This command is used to extract only the signers X509 certificate from a S/MIME
4272 # signature, so that the certificate's owner may get compared to the email's “
4275 # This is a format string, see the $smime_decrypt_command command for possible
4276 # printf(3)-like sequences. (S/MIME only)
4280 # 3.298. smime_import_cert_command
4285 # This command is used to import a certificate via smime_keys.
4287 # This is a format string, see the $smime_decrypt_command command for possible
4288 # printf(3)-like sequences. (S/MIME only)
4292 # 3.299. smime_is_default
4297 # The default behavior of mutt is to use PGP on all auto-sign/encryption
4298 # operations. To override and to use OpenSSL instead this must be set. However,
4299 # this has no effect while replying, since mutt will automatically select the
4300 # same application that was used to sign/encrypt the original message. (Note that
4301 # this variable can be overridden by unsetting $crypt_autosmime.) (S/MIME only)
4310 # Since for S/MIME there is no pubring/secring as with PGP, mutt has to handle
4311 # storage and retrieval of keys/certs by itself. This is very basic right now,
4312 # and stores keys and certificates in two different directories, both named as
4313 # the hash-value retrieved from OpenSSL. There is an index file which contains
4314 # mailbox-address keyid pair, and which can be manually edited. This option
4315 # points to the location of the private keys. (S/MIME only)
4317 set smime_keys="~/.smime/keys"
4320 # 3.301. smime_pk7out_command
4325 # This command is used to extract PKCS7 structures of S/MIME signatures, in order
4326 # to extract the public X509 certificate(s).
4328 # This is a format string, see the $smime_decrypt_command command for possible
4329 # printf(3)-like sequences. (S/MIME only)
4333 # 3.302. smime_self_encrypt
4338 # When set, S/MIME encrypted messages will also be encrypted using the
4339 # certificate in $smime_default_key. (S/MIME only)
4343 # 3.303. smime_sign_as
4348 # If you have a separate key to use for signing, you should set this to the
4349 # signing key. Most people will only need to set $smime_default_key. (S/MIME
4354 # 3.304. smime_sign_command
4359 # This command is used to created S/MIME signatures of type multipart/signed,
4360 # which can be read by all mail clients.
4362 # This is a format string, see the $smime_decrypt_command command for possible
4363 # printf(3)-like sequences. NOTE: %c and %k will default to $smime_sign_as if
4364 # set, otherwise $smime_default_key. (S/MIME only)
4368 # 3.305. smime_sign_digest_alg
4373 # This sets the algorithm that should be used for the signature message digest.
4374 # Valid choices are “md5”, “sha1”, “sha224”, “sha256”, “sha384”, “sha512”. (S/
4379 # 3.306. smime_sign_opaque_command
4384 # This command is used to created S/MIME signatures of type application/
4385 # x-pkcs7-signature, which can only be handled by mail clients supporting the S/
4388 # This is a format string, see the $smime_decrypt_command command for possible
4389 # printf(3)-like sequences. (S/MIME only)
4393 # 3.307. smime_timeout
4398 # The number of seconds after which a cached passphrase will expire if not used.
4403 # 3.308. smime_verify_command
4408 # This command is used to verify S/MIME signatures of type multipart/signed.
4410 # This is a format string, see the $smime_decrypt_command command for possible
4411 # printf(3)-like sequences. (S/MIME only)
4415 # 3.309. smime_verify_opaque_command
4420 # This command is used to verify S/MIME signatures of type application/
4423 # This is a format string, see the $smime_decrypt_command command for possible
4424 # printf(3)-like sequences. (S/MIME only)
4428 # 3.310. smtp_authenticators
4433 # This is a colon-delimited list of authentication methods mutt may attempt to
4434 # use to log in to an SMTP server, in the order mutt should try them.
4435 # Authentication methods are any SASL mechanism, e.g. “digest-md5”, “gssapi” or “
4436 # cram-md5”. This option is case-insensitive. If it is “unset” (the default) mutt
4437 # will try all available methods, in order from most-secure to least-secure.
4441 # set smtp_authenticators="digest-md5:cram-md5"
4445 # 3.311. smtp_oauth_refresh_command
4450 # The command to run to generate an OAUTH refresh token for authorizing your
4451 # connection to your SMTP server. This command will be run on every connection
4452 # attempt that uses the OAUTHBEARER authentication mechanism.
4461 # Specifies the password for your SMTP account. If unset, Mutt will prompt you
4462 # for your password when you first send mail via SMTP. See $smtp_url to configure
4463 # mutt to send mail via SMTP.
4465 # Warning: you should only use this option when you are on a fairly secure
4466 # machine, because the superuser can read your muttrc even if you are the only
4467 # one who can read the file.
4476 # Defines the SMTP smarthost where sent messages should relayed for delivery.
4477 # This should take the form of an SMTP URL, e.g.:
4479 # smtp[s]://[user[:pass]@]host[:port]
4481 # where “[...]” denotes an optional part. Setting this variable overrides the
4482 # value of the $sendmail variable.
4491 # Specifies how to sort messages in the “index” menu. Valid values are:
4493 # • date or date-sent
4499 # • mailbox-order (unsorted)
4513 # You may optionally use the “reverse-” prefix to specify reverse sorting order
4514 # (example: “set sort=reverse-date-sent”).
4524 # Specifies how the entries in the “alias” menu are sorted. The following are
4527 # • address (sort alphabetically by email address)
4529 # • alias (sort alphabetically by alias name)
4531 # • unsorted (leave in order specified in .muttrc)
4540 # When sorting by threads, this variable controls how threads are sorted in
4541 # relation to other threads, and how the branches of the thread trees are sorted.
4542 # This can be set to any value that $sort can, except “threads” (in that case,
4543 # mutt will just use “date-sent”). You can also specify the “last-” prefix in
4544 # addition to the “reverse-” prefix, but “last-” must come after “reverse-”. The
4545 # “last-” prefix causes messages to be sorted against its siblings by which has
4546 # the last descendant, using the rest of $sort_aux as an ordering. For instance,
4548 # set sort_aux=last-date-received
4550 # would mean that if a new message is received in a thread, that thread becomes
4551 # the last one displayed (or the first, if you have “set sort=reverse-threads”.)
4553 # Note: For reversed $sort order $sort_aux is reversed again (which is not the
4554 # right thing to do, but kept to not break any existing configuration setting).
4556 set sort_aux=last-date-received
4559 # 3.317. sort_browser
4564 # Specifies how to sort entries in the file browser. By default, the entries are
4565 # sorted alphabetically. Valid values:
4567 # • alpha (alphabetically)
4579 # You may optionally use the “reverse-” prefix to specify reverse sorting order
4580 # (example: “set sort_browser=reverse-date”).
4589 # This variable is only useful when sorting by threads with $strict_threads unset
4590 # . In that case, it changes the heuristic mutt uses to thread messages by
4591 # subject. With $sort_re set, mutt will only attach a message as the child of
4592 # another message by subject if the subject of the child message starts with a
4593 # substring matching the setting of $reply_regexp. With $sort_re unset, mutt will
4594 # attach the message whether or not this is the case, as long as the non-
4595 # $reply_regexp parts of both messages are identical.
4599 # 3.319. spam_separator
4604 # This variable controls what happens when multiple spam headers are matched: if
4605 # unset, each successive header will overwrite any previous matches value for the
4606 # spam label. If set, each successive match will append to the previous, using
4607 # this variable's value as a separator.
4616 # If your spool mailbox is in a non-default place where Mutt cannot find it, you
4617 # can specify its location with this variable. Mutt will initially set this
4618 # variable to the value of the environment variable $MAIL or $MAILDIR if either
4621 set spoolfile="=inbox"
4624 # 3.321. ssl_ca_certificates_file
4629 # This variable specifies a file containing trusted CA certificates. Any server
4630 # certificate that is signed with one of these CA certificates is also
4631 # automatically accepted. (GnuTLS only)
4635 # set ssl_ca_certificates_file=/etc/ssl/certs/ca-certificates.crt
4637 set ssl_ca_certificates_file="/etc/ssl/certs/ca-certificates.crt"
4640 # 3.322. ssl_client_cert
4645 # The file containing a client certificate and its associated private key.
4649 # 3.323. ssl_force_tls
4654 # If this variable is set, Mutt will require that all connections to remote
4655 # servers be encrypted. Furthermore it will attempt to negotiate TLS even if the
4656 # server does not advertise the capability, since it would otherwise have to
4657 # abort the connection anyway. This option supersedes $ssl_starttls.
4661 # 3.324. ssl_min_dh_prime_bits
4666 # This variable specifies the minimum acceptable prime size (in bits) for use in
4667 # any Diffie-Hellman key exchange. A value of 0 will use the default from the
4668 # GNUTLS library. (GnuTLS only)
4672 # 3.325. ssl_starttls
4677 # If set (the default), mutt will attempt to use STARTTLS on servers advertising
4678 # the capability. When unset, mutt will not attempt to use STARTTLS regardless of
4679 # the server's capabilities.
4683 # 3.326. ssl_use_sslv2
4688 # This variable specifies whether to attempt to use SSLv2 in the SSL
4689 # authentication process. Note that SSLv2 and SSLv3 are now considered
4690 # fundamentally insecure and are no longer recommended. (OpenSSL only)
4694 # 3.327. ssl_use_sslv3
4699 # This variable specifies whether to attempt to use SSLv3 in the SSL
4700 # authentication process. Note that SSLv2 and SSLv3 are now considered
4701 # fundamentally insecure and are no longer recommended.
4705 # 3.328. ssl_use_tlsv1
4710 # This variable specifies whether to attempt to use TLSv1.0 in the SSL
4711 # authentication process.
4715 # 3.329. ssl_use_tlsv1_1
4720 # This variable specifies whether to attempt to use TLSv1.1 in the SSL
4721 # authentication process.
4725 # 3.330. ssl_use_tlsv1_2
4730 # This variable specifies whether to attempt to use TLSv1.2 in the SSL
4731 # authentication process.
4735 # 3.331. ssl_usesystemcerts
4740 # If set to yes, mutt will use CA certificates in the system-wide certificate
4741 # store when checking if a server certificate is signed by a trusted CA. (OpenSSL
4746 # 3.332. ssl_verify_dates
4751 # If set (the default), mutt will not automatically accept a server certificate
4752 # that is either not yet valid or already expired. You should only unset this for
4753 # particular known hosts, using the <account-hook> function.
4757 # 3.333. ssl_verify_host
4762 # If set (the default), mutt will not automatically accept a server certificate
4763 # whose host name does not match the host used in your folder URL. You should
4764 # only unset this for particular known hosts, using the <account-hook> function.
4768 # 3.334. ssl_verify_partial_chains
4773 # This option should not be changed from the default unless you understand what
4776 # Setting this variable to yes will permit verifying partial certification
4777 # chains, i. e. a certificate chain where not the root, but an intermediate
4778 # certificate CA, or the host certificate, are marked trusted (in
4779 # $certificate_file), without marking the root signing CA as trusted.
4781 # (OpenSSL 1.0.2b and newer only).
4785 # 3.335. ssl_ciphers
4790 # Contains a colon-seperated list of ciphers to use when using SSL. For OpenSSL,
4791 # see ciphers(1) for the syntax of the string.
4793 # For GnuTLS, this option will be used in place of "NORMAL" at the start of the
4794 # priority string. See gnutls_priority_init(3) for the syntax and more details.
4795 # (Note: GnuTLS version 2.1.7 or higher is required.)
4799 # 3.336. status_chars
4804 # Controls the characters used by the “%r” indicator in $status_format. The first
4805 # character is used when the mailbox is unchanged. The second is used when the
4806 # mailbox has been changed, and it needs to be resynchronized. The third is used
4807 # if the mailbox is in read-only mode, or if the mailbox will not be written when
4808 # exiting that mailbox (You can toggle whether to write changes to a mailbox with
4809 # the <toggle-write> operation, bound by default to “%”). The fourth is used to
4810 # indicate that the current folder has been opened in attach- message mode
4811 # (Certain operations like composing a new mail, replying, forwarding, etc. are
4812 # not permitted in this mode).
4816 # 3.337. status_format
4819 # Default: “-%r-Mutt: %f [Msgs:%?M?%M/?%m%?n? New:%n?%?o? Old:%o?%?d? Del:%d?%?F?
4820 # Flag:%F?%?t? Tag:%t?%?p? Post:%p?%?b? Inc:%b?%?l? %l?]---(%s/%S)-%>-(%P)---”
4822 # Controls the format of the status line displayed in the “index” menu. This
4823 # string is similar to $index_format, but has its own set of printf(3)-like
4826 # ┌───┬─────────────────────────────────────────────────────────────────────────┐
4827 # │%b │number of mailboxes with new mail * │
4828 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4829 # │%d │number of deleted messages * │
4830 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4831 # │%f │the full pathname of the current mailbox │
4832 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4833 # │%F │number of flagged messages * │
4834 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4835 # │%h │local hostname │
4836 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4837 # │%l │size (in bytes) of the current mailbox * │
4838 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4839 # │%L │size (in bytes) of the messages shown (i.e., which match the current │
4841 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4842 # │%m │the number of messages in the mailbox * │
4843 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4844 # │%M │the number of messages shown (i.e., which match the current limit) * │
4845 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4846 # │%n │number of new messages in the mailbox * │
4847 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4848 # │%o │number of old unread messages * │
4849 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4850 # │%p │number of postponed messages * │
4851 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4852 # │%P │percentage of the way through the index │
4853 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4854 # │%r │modified/read-only/won't-write/attach-message indicator, according to │
4855 # │ │$status_chars │
4856 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4857 # │%R │number of read messages * │
4858 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4859 # │%s │current sorting mode ($sort) │
4860 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4861 # │%S │current aux sorting method ($sort_aux) │
4862 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4863 # │%t │number of tagged messages * │
4864 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4865 # │%u │number of unread messages * │
4866 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4867 # │%v │Mutt version string │
4868 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4869 # │%V │currently active limit pattern, if any * │
4870 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4871 # │%>X│right justify the rest of the string and pad with “X” │
4872 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4873 # │%|X│pad to the end of the line with “X” │
4874 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4875 # │%*X│soft-fill with character “X” as pad │
4876 # └───┴─────────────────────────────────────────────────────────────────────────┘
4878 # For an explanation of “soft-fill”, see the $index_format documentation.
4880 # * = can be optionally printed if nonzero
4882 # Some of the above sequences can be used to optionally print a string if their
4883 # value is nonzero. For example, you may only want to see the number of flagged
4884 # messages if such messages exist, since zero is not particularly meaningful. To
4885 # optionally print a string based upon one of the above sequences, the following
4886 # construct is used:
4888 # %?<sequence_char>?<optional_string>?
4890 # where sequence_char is a character from the table above, and optional_string is
4891 # the string you would like printed if sequence_char is nonzero. optional_string
4892 # may contain other sequences as well as normal text, but you may not nest
4895 # Here is an example illustrating how to optionally print the number of new
4896 # messages in a mailbox:
4898 # %?n?%n new messages.?
4900 # You can also switch between two strings using the following construct:
4902 # %?<sequence_char>?<if_string>&<else_string>?
4904 # If the value of sequence_char is non-zero, if_string will be expanded,
4905 # otherwise else_string will be expanded.
4907 # You can force the result of any printf(3)-like sequence to be lowercase by
4908 # prefixing the sequence character with an underscore (“_”) sign. For example, if
4909 # you want to display the local hostname in lowercase, you would use: “%_h”.
4911 # If you prefix the sequence character with a colon (“:”) character, mutt will
4912 # replace any dots in the expansion by underscores. This might be helpful with
4913 # IMAP folders that don't like dots in folder names.
4915 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) "
4918 # 3.338. status_on_top
4923 # Setting this variable causes the “status bar” to be displayed on the first line
4924 # of the screen rather than near the bottom. If $help is set, too it'll be placed
4929 # 3.339. strict_threads
4934 # If set, threading will only make use of the “In-Reply-To” and “References:”
4935 # fields when you $sort by message threads. By default, messages with the same
4936 # subject are grouped together in “pseudo threads.”. This may not always be
4937 # desirable, such as in a personal mailbox where you might have several unrelated
4938 # messages with the subjects like “hi” which will get grouped together. See also
4939 # $sort_re for a less drastic way of controlling this behavior.
4941 set strict_threads=yes
4949 # When unset, mutt won't stop when the user presses the terminal's susp key,
4950 # usually “^Z”. This is useful if you run mutt inside an xterm using a command
4951 # like “xterm -e mutt”.
4955 # 3.341. text_flowed
4960 # When set, mutt will generate “format=flowed” bodies with a content type of “
4961 # text/plain; format=flowed”. This format is easier to handle for some mailing
4962 # software, and generally just looks like ordinary text. To actually make use of
4963 # this format's features, you'll need support in your editor.
4965 # Note that $indent_string is ignored when this option is set.
4970 # 3.342. thorough_search
4975 # Affects the ~b and ~h search operations described in section “patterns”. If set
4976 # , the headers and body/attachments of messages to be searched are decoded
4977 # before searching. If unset, messages are searched as they appear in the folder.
4979 # Users searching attachments or for non-ASCII characters should set this value
4980 # because decoding also includes MIME parsing/decoding and possible character set
4981 # conversions. Otherwise mutt will attempt to match against the raw message
4982 # received (for example quoted-printable encoded or with encoded headers) which
4983 # may lead to incorrect search results.
4985 set thorough_search=yes
4988 # 3.343. thread_received
4993 # When set, mutt uses the date received rather than the date sent to thread
4994 # messages by subject.
4996 set thread_received=yes
5004 # When set, the internal-pager will pad blank lines to the bottom of the screen
5005 # with a tilde (“~”).
5015 # Along with $read_inc, $write_inc, and $net_inc, this variable controls the
5016 # frequency with which progress updates are displayed. It suppresses updates less
5017 # than $time_inc milliseconds apart. This can improve throughput on systems with
5018 # slow terminals, or when running mutt on a remote system.
5020 # Also see the “tuning” section of the manual for performance considerations.
5030 # When Mutt is waiting for user input either idling in menus or in an interactive
5031 # prompt, Mutt would block until input is present. Depending on the context, this
5032 # would prevent certain operations from working, like checking for new mail or
5033 # keeping an IMAP connection alive.
5035 # This variable controls how many seconds Mutt will at most wait until it aborts
5036 # waiting for input, performs these operations and continues to wait for input.
5038 # A value of zero or less will cause Mutt to never time out.
5047 # This variable allows you to specify where Mutt will place its temporary files
5048 # needed for displaying and composing messages. If this variable is not set, the
5049 # environment variable $TMPDIR is used. If $TMPDIR is not set then “/tmp” is
5059 # Controls the character used to indicate mail addressed to you. The first
5060 # character is the one used when the mail is not addressed to your address. The
5061 # second is used when you are the only recipient of the message. The third is
5062 # when your address appears in the “To:” header field, but you are not the only
5063 # recipient of the message. The fourth character is used when your address is
5064 # specified in the “Cc:” header field, but you are not the only recipient. The
5065 # fifth character is used to indicate mail that was sent by you. The sixth
5066 # character is used to indicate when a mail was sent to a mailing-list you
5076 # If set, this variable specifies the path of the trash folder where the mails
5077 # marked for deletion will be moved, instead of being irremediably purged.
5079 # NOTE: When you delete a message in the trash folder, it is really deleted, so
5080 # that you have a way to clean the trash.
5084 # 3.350. ts_icon_format
5087 # Default: “M%?n?AIL&ail?”
5089 # Controls the format of the icon title, as long as “$ts_enabled” is set. This
5090 # string is identical in formatting to the one used by “$status_format”.
5099 # Controls whether mutt tries to set the terminal status line and icon name. Most
5100 # terminal emulators emulate the status line in the window title.
5105 # 3.352. ts_status_format
5108 # Default: “Mutt with %?m?%m messages&no messages?%?n? [%n NEW]?”
5110 # Controls the format of the terminal status line (or window title), provided
5111 # that “$ts_enabled” has been set. This string is identical in formatting to the
5112 # one used by “$status_format”.
5114 set ts_status_format="mutt: %f%?V?[%V]&?"
5122 # Setting this variable will cause mutt to open a pipe to a command instead of a
5123 # raw socket. You may be able to use this to set up preauthenticated connections
5124 # to your IMAP/POP3/SMTP server. Example:
5126 # set tunnel="ssh -q mailhost.net /usr/local/libexec/imapd"
5128 # Note: For this example to work you must be able to log in to the remote machine
5129 # without having to enter a password.
5131 # When set, Mutt uses the tunnel for all remote connections. Please see “
5132 # account-hook” in the manual for how to use different tunnel commands per
5137 # 3.354. uncollapse_jump
5142 # When set, Mutt will jump to the next unread message, if any, when the current
5143 # thread is uncollapsed.
5147 # 3.355. uncollapse_new
5152 # When set, Mutt will automatically uncollapse any collapsed thread that receives
5153 # a new message. When unset, collapsed threads will remain collapsed. the
5154 # presence of the new message will still affect index sorting, though.
5158 # 3.356. use_8bitmime
5163 # Warning: do not set this variable unless you are using a version of sendmail
5164 # which supports the -B8BITMIME flag (such as sendmail 8.8.x) or you may not be
5165 # able to send mail.
5167 # When set, Mutt will invoke $sendmail with the -B8BITMIME flag when sending
5168 # 8-bit messages to enable ESMTP negotiation.
5177 # When set, Mutt will qualify all local addresses (ones without the “@host”
5178 # portion) with the value of $hostname. If unset, no addresses will be qualified.
5182 # 3.358. use_envelope_from
5187 # When set, mutt will set the envelope sender of the message. If
5188 # $envelope_from_address is set, it will be used as the sender address. If unset,
5189 # mutt will attempt to derive the sender from the “From:” header.
5191 # Note that this information is passed to sendmail command using the -f command
5192 # line switch. Therefore setting this option is not useful if the $sendmail
5193 # variable already contains -f or if the executable pointed to by $sendmail
5194 # doesn't support the -f switch.
5196 set use_envelope_from=yes
5204 # When set, Mutt will generate the “From:” header field when sending messages. If
5205 # unset, no “From:” header field will be generated unless the user explicitly
5206 # sets one using the “my_hdr” command.
5215 # When set, Mutt will look for IPv6 addresses of hosts it tries to contact. If
5216 # this option is unset, Mutt will restrict itself to IPv4 addresses. Normally,
5217 # the default should work.
5226 # When set, mutt will add a “User-Agent:” header to outgoing messages, indicating
5227 # which version of mutt was used for composing them.
5236 # Specifies the visual editor to invoke when the “~v” command is given in the
5246 # Controls whether Mutt will ask you to press a key after an external command has
5247 # been invoked by these functions: <shell-escape>, <pipe-message>, <pipe-entry>,
5248 # <print-message>, and <print-entry> commands.
5250 # It is also used when viewing attachments with “auto_view”, provided that the
5251 # corresponding mailcap entry has a needsterminal flag, and the external program
5254 # When set, Mutt will always ask for a key. When unset, Mutt will wait for a key
5255 # only if the external command returned a non-zero status.
5265 # When set, mutt will weed headers when displaying, forwarding, printing, or
5266 # replying to messages.
5275 # When set to a positive value, mutt will wrap text at $wrap characters. When set
5276 # to a negative value, mutt will wrap text so that there are $wrap characters of
5277 # empty space on the right side of the terminal. Setting it to zero makes mutt
5278 # wrap at the terminal width.
5280 # Also see $reflow_wrap.
5282 set wrap=$reflow_wrap
5285 # 3.366. wrap_headers
5290 # This option specifies the number of characters to use for wrapping an outgoing
5291 # message's headers. Allowed values are between 78 and 998 inclusive.
5293 # Note: This option usually shouldn't be changed. RFC5233 recommends a line
5294 # length of 78 (the default), so please only change this setting when you know
5295 # what you're doing.
5299 # 3.367. wrap_search
5304 # Controls whether searches wrap around the end.
5306 # When set, searches will wrap around the first (or last) item. When unset,
5307 # incremental searches will not wrap.
5316 # (DEPRECATED) Equivalent to setting $wrap with a negative value.
5325 # Controls whether mutt writes out the “Bcc:” header when preparing messages to
5326 # be sent. Exim users may wish to unset this. If mutt is set to deliver directly
5327 # via SMTP (see $smtp_url), this option does nothing: mutt will never write out
5328 # the “Bcc:” header in this case.
5337 # When writing a mailbox, a message will be printed every $write_inc messages to
5338 # indicate progress. If set to 0, only a single message will be displayed before
5339 # writing a mailbox.
5341 # Also see the $read_inc, $net_inc and $time_inc variables and the “tuning”
5342 # section of the manual for performance considerations.
5345 # vim:sw=12:noet:sts=12:ts=12:ft=muttrc