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.
651 set crypt_autosmime=no
654 # 3.45. crypt_confirmhook
659 # If set, then you will be prompted for confirmation of keys when using the
660 # crypt-hook command. If unset, no such confirmation prompt will be presented.
661 # This is generally considered unsafe, especially where typos are concerned.
665 # 3.46. crypt_opportunistic_encrypt
670 # Setting this variable will cause Mutt to automatically enable and disable
671 # encryption, based on whether all message recipient keys can be located by Mutt.
673 # When this option is enabled, Mutt will enable/disable encryption each time the
674 # TO, CC, and BCC lists are edited. If $edit_headers is set, Mutt will also do so
675 # each time the message is edited.
677 # While this is set, encryption can't be manually enabled/disabled. The pgp or
678 # smime menus provide a selection to temporarily disable this option for the
681 # If $crypt_autoencrypt or $crypt_replyencrypt enable encryption for a message,
682 # this option will be disabled for that message. It can be manually re-enabled in
683 # the pgp or smime menus. (Crypto only)
687 # 3.47. crypt_replyencrypt
692 # If set, automatically PGP or OpenSSL encrypt replies to messages which are
693 # encrypted. (Crypto only)
697 # 3.48. crypt_replysign
702 # If set, automatically PGP or OpenSSL sign replies to messages which are signed.
704 # Note: this does not work on messages that are encrypted and signed! (Crypto
707 set crypt_replysign=yes
710 # 3.49. crypt_replysignencrypted
715 # If set, automatically PGP or OpenSSL sign replies to messages which are
716 # encrypted. This makes sense in combination with $crypt_replyencrypt, because it
717 # allows you to sign all messages which are automatically encrypted. This works
718 # around the problem noted in $crypt_replysign, that mutt is not able to find out
719 # whether an encrypted message is also signed. (Crypto only)
721 set crypt_replysignencrypted=yes
724 # 3.50. crypt_timestamp
729 # If set, mutt will include a time stamp in the lines surrounding PGP or S/MIME
730 # output, so spoofing such lines is more difficult. If you are using colors to
731 # mark these lines, and rely on these, you may unset this setting. (Crypto only)
735 # 3.51. crypt_use_gpgme
740 # This variable controls the use of the GPGME-enabled crypto backends. If it is
741 # set and Mutt was built with gpgme support, the gpgme code for S/MIME and PGP
742 # will be used instead of the classic code. Note that you need to set this option
743 # in .muttrc; it won't have any effect when used interactively.
745 # Note that the GPGME backend does not support creating old-style inline
746 # (traditional) PGP encrypted or signed messages (see $pgp_autoinline).
750 # 3.52. crypt_use_pka
755 # Controls whether mutt uses PKA (see http://www.g10code.de/docs/
756 # pka-intro.de.pdf) during signature verification (only supported by the GPGME
759 set crypt_use_pka=yes
762 # 3.53. crypt_verify_sig
767 # If “yes”, always attempt to verify PGP or S/MIME signatures. If “ask-*”, ask
768 # whether or not to verify the signature. If “no”, never attempt to verify
769 # cryptographic signatures. (Crypto only)
776 # Default: “!%a, %b %d, %Y at %I:%M:%S%p %Z”
778 # This variable controls the format of the date printed by the “%d” sequence in
779 # $index_format. This is passed to the strftime(3) function to process the date,
780 # see the man page for the proper syntax.
782 # Unless the first character in the string is a bang (“!”), the month and week
783 # day names are expanded according to the locale. If the first character in the
784 # string is a bang, the bang is discarded, and the month and week day names in
785 # the rest of the string are expanded in the C locale (that is in US English).
787 set date_format="%F %T%Z"
793 # Default: “~f %s !~P | (~P ~C %s)”
795 # This variable controls how “message-hook”, “reply-hook”, “send-hook”, “
796 # send2-hook”, “save-hook”, and “fcc-hook” will be interpreted if they are
797 # specified with only a simple regexp, instead of a matching pattern. The hooks
798 # are expanded when they are declared, so a hook will be interpreted according to
799 # the value of this variable at the time the hook is declared.
801 # The default value matches if the message is either from a user matching the
802 # regular expression given, or if it is from you (if the from address matches “
803 # alternates”) and is to or cc'ed to a user matching the given regular
813 # Controls whether or not messages are really deleted when closing or
814 # synchronizing a mailbox. If set to yes, messages marked for deleting will
815 # automatically be purged without prompting. If set to no, messages marked for
816 # deletion will be kept in the mailbox.
826 # If this option is set, mutt will untag messages when marking them for deletion.
827 # This applies when you either explicitly delete a message, or when you save it
832 # 3.58. digest_collapse
837 # If this option is set, mutt's received-attachments menu will not show the
838 # subparts of individual messages in a multipart/digest. To see these subparts,
839 # press “v” on that menu.
843 # 3.59. display_filter
848 # When set, specifies a command used to filter messages. When a message is viewed
849 # it is passed as standard input to $display_filter, and the filtered message is
850 # read from the standard output.
854 # 3.60. dotlock_program
857 # Default: “/usr/bin/mutt_dotlock”
859 # Contains the path of the mutt_dotlock(8) binary to be used by mutt.
868 # This variable sets the request for when notification is returned. The string
869 # consists of a comma separated list (no spaces!) of one or more of the
870 # following: never, to never request notification, failure, to request
871 # notification on transmission failure, delay, to be notified of message delays,
872 # success, to be notified of successful transmission.
876 # set dsn_notify="failure,delay"
878 # Note: when using $sendmail for delivery, you should not enable this unless you
879 # are either using Sendmail 8.8.x or greater or a MTA providing a sendmail(1)
880 # -compatible interface supporting the -N option for DSN. For SMTP delivery, DSN
881 # support is auto-detected so that it depends on the server whether DSN will be
891 # This variable controls how much of your message is returned in DSN messages. It
892 # may be set to either hdrs to return just the message header, or full to return
897 # set dsn_return=hdrs
899 # Note: when using $sendmail for delivery, you should not enable this unless you
900 # are either using Sendmail 8.8.x or greater or a MTA providing a sendmail(1)
901 # -compatible interface supporting the -R option for DSN. For SMTP delivery, DSN
902 # support is auto-detected so that it depends on the server whether DSN will be
907 # 3.63. duplicate_threads
912 # This variable controls whether mutt, when $sort is set to threads, threads
913 # messages with the same Message-Id together. If it is set, it will indicate that
914 # it thinks they are duplicates of each other with an equals sign in the thread
924 # This option allows you to edit the header of your outgoing messages along with
925 # the body of your message.
927 # Although the compose menu may have localized header labels, the labels passed
928 # to your editor will be standard RFC 2822 headers, (e.g. To:, Cc:, Subject:).
929 # Headers added in your editor must also be RFC 2822 headers, or one of the
930 # pseudo headers listed in “edit-header”. Mutt will not understand localized
931 # header labels, just as it would not when parsing an actual email.
933 # Note that changes made to the References: and Date: headers are ignored for
934 # interoperability reasons.
944 # This variable specifies which editor is used by mutt. It defaults to the value
945 # of the $VISUAL, or $EDITOR, environment variable, or to the string “vi” if
946 # neither of those are set.
948 # The $editor string may contain a %s escape, which will be replaced by the name
949 # of the file to be edited. If the %s escape does not appear in $editor, a space
950 # and the name to be edited are appended.
952 # The resulting string is then executed by running
956 # where string is the expansion of $editor described above.
958 set editor="mailplate --edit --auto --keep-unknown"
966 # When set, mutt will quoted-printable encode messages when they contain the
967 # string “From ” (note the trailing space) in the beginning of a line. This is
968 # useful to avoid the tampering certain mail delivery and transport agents tend
969 # to do with messages (in order to prevent tools from misinterpreting the line as
970 # a mbox message separator).
979 # The file which includes random data that is used to initialize SSL library
984 # 3.68. envelope_from_address
986 # Type: e-mail address
989 # Manually sets the envelope sender for outgoing messages. This value is ignored
990 # if $use_envelope_from is unset.
994 # 3.69. error_history
999 # This variable controls the size (in number of strings remembered) of the error
1000 # messages displayed by mutt. These can be shown with the <error-history>
1001 # function. The history is cleared each time this variable is set.
1010 # Escape character to use for functions in the built-in editor.
1019 # When set, the initial prompt for recipients and subject are skipped when
1020 # replying to messages, and the initial prompt for subject is skipped when
1021 # forwarding messages.
1023 # Note: this variable has no effect when the $autoedit variable is set.
1032 # This variable controls whether or not attachments on outgoing messages are
1033 # saved along with the main body of your message.
1043 # When this variable is set, FCCs will be stored unencrypted and unsigned, even
1044 # when the actual message is encrypted and/or signed. (PGP only)
1053 # If set, flagged messages cannot be deleted.
1062 # Specifies the default location of your mailboxes. A “+” or “=” at the beginning
1063 # of a pathname will be expanded to the value of this variable. Note that if you
1064 # change this variable (from the default) value you need to make sure that the
1065 # assignment occurs before you use “+” or “=” for any other variables since
1066 # expansion takes place when handling the “mailboxes” command.
1071 # 3.76. folder_format
1074 # Default: “%2C %t %N %F %2l %-8.8u %-8.8g %8s %d %f”
1076 # This variable allows you to customize the file browser display to your personal
1077 # taste. This string is similar to $index_format, but has its own set of printf
1078 # (3)-like sequences:
1080 # ┌───┬─────────────────────────────────────────────────────────────────────────┐
1081 # │%C │current file number │
1082 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1083 # │%d │date/time folder was last modified │
1084 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1085 # │%D │date/time folder was last modified using $date_format. │
1086 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1087 # │%f │filename (“/” is appended to directory names, “@” to symbolic links and “│
1088 # │ │*” to executable files) │
1089 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1090 # │%F │file permissions │
1091 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1092 # │%g │group name (or numeric gid, if missing) │
1093 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1094 # │%l │number of hard links │
1095 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1096 # │%m │number of messages in the mailbox * │
1097 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1098 # │%n │number of unread messages in the mailbox * │
1099 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1100 # │%N │N if mailbox has new mail, blank otherwise │
1101 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1102 # │%s │size in bytes │
1103 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1104 # │%t │“*” if the file is tagged, blank otherwise │
1105 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1106 # │%u │owner name (or numeric uid, if missing) │
1107 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1108 # │%>X│right justify the rest of the string and pad with character “X” │
1109 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1110 # │%|X│pad to the end of the line with character “X” │
1111 # ├───┼─────────────────────────────────────────────────────────────────────────┤
1112 # │%*X│soft-fill with character “X” as pad │
1113 # └───┴─────────────────────────────────────────────────────────────────────────┘
1115 # For an explanation of “soft-fill”, see the $index_format documentation.
1117 # * = can be optionally printed if nonzero
1119 # %m, %n, and %N only work for monitored mailboxes. %m requires $mail_check_stats
1120 # to be set. %n requires $mail_check_stats to be set (except for IMAP mailboxes).
1129 # Controls whether or not the “Mail-Followup-To:” header field is generated when
1130 # sending mail. When set, Mutt will generate this field when you are replying to
1131 # a known mailing list, specified with the “subscribe” or “lists” commands.
1133 # This field has two purposes. First, preventing you from receiving duplicate
1134 # copies of replies to messages which you send to mailing lists, and second,
1135 # ensuring that you do get a reply separately for any messages sent to known
1136 # lists to which you are not subscribed.
1138 # The header will contain only the list's address for subscribed lists, and both
1139 # the list address and your own email address for unsubscribed lists. Without
1140 # this header, a group reply to your message sent to a subscribed list will be
1141 # sent to both the list and your address, resulting in two copies of the same
1151 # This variable is similar to $save_name, except that Mutt will store a copy of
1152 # your outgoing message by the username of the address you are sending to even if
1153 # that mailbox does not exist.
1155 # Also see the $record variable.
1159 # 3.79. forward_attribution_intro
1162 # Default: “----- Forwarded message from %f -----”
1164 # This is the string that will precede a message which has been forwarded in the
1165 # main body of a message (when $mime_forward is unset). For a full listing of
1166 # defined printf(3)-like sequences see the section on $index_format. See also
1167 # $attribution_locale.
1171 # 3.80. forward_attribution_trailer
1174 # Default: “----- End forwarded message -----”
1176 # This is the string that will follow a message which has been forwarded in the
1177 # main body of a message (when $mime_forward is unset). For a full listing of
1178 # defined printf(3)-like sequences see the section on $index_format. See also
1179 # $attribution_locale.
1183 # 3.81. forward_decode
1188 # Controls the decoding of complex MIME messages into text/plain when forwarding
1189 # a message. The message header is also RFC2047 decoded. This variable is only
1190 # used, if $mime_forward is unset, otherwise $mime_forward_decode is used
1195 # 3.82. forward_decrypt
1200 # Controls the handling of encrypted messages when forwarding a message. When set
1201 # , the outer layer of encryption is stripped off. This variable is only used if
1202 # $mime_forward is set and $mime_forward_decode is unset. (PGP only)
1206 # 3.83. forward_edit
1211 # This quadoption controls whether or not the user is automatically placed in the
1212 # editor when forwarding messages. For those who always want to forward with no
1213 # modification, use a setting of “no”.
1217 # 3.84. forward_format
1220 # Default: “[%a: %s]”
1222 # This variable controls the default subject when forwarding a message. It uses
1223 # the same format sequences as the $index_format variable.
1225 set forward_format="(fwd) %s"
1228 # 3.85. forward_quote
1233 # When set, forwarded messages included in the main body of the message (when
1234 # $mime_forward is unset) will be quoted using $indent_string.
1240 # Type: e-mail address
1243 # When set, this variable contains a default from address. It can be overridden
1244 # using “my_hdr” (including from a “send-hook”) and $reverse_name. This variable
1245 # is ignored if $use_from is unset.
1247 # This setting defaults to the contents of the environment variable $EMAIL.
1249 set from='martin f krafft <madduck@madduck.net>'
1254 # Type: regular expression
1257 # A regular expression used by mutt to parse the GECOS field of a password entry
1258 # when expanding the alias. The default value will return the string up to the
1259 # first “,” encountered. If the GECOS field contains a string like “lastname,
1260 # firstname” then you should set it to “.*”.
1262 # This can be useful if you see the following behavior: you address an e-mail to
1263 # user ID “stevef” whose full name is “Steve Franklin”. If mutt expands “stevef”
1264 # to “"Franklin" stevef@foo.bar” then you should set the $gecos_mask to a regular
1265 # expression that will match the whole name so mutt will expand “Franklin” to “
1275 # When unset, the header fields normally added by the “my_hdr” command are not
1276 # created. This variable must be unset before composing a new message or replying
1277 # in order to take effect. If set, the user defined header fields are added to
1278 # every new message.
1287 # When set, this variable causes Mutt to include the header of the message you
1288 # are replying to into the edit buffer. The $weed setting applies.
1292 # 3.90. header_cache
1297 # This variable points to the header cache database. If pointing to a directory
1298 # Mutt will contain a header cache database file per folder, if pointing to a
1299 # file that file will be a single global header cache. By default it is unset so
1300 # no header caching will be used.
1302 # Header caching can greatly improve speed when opening POP, IMAP MH or Maildir
1303 # folders, see “caching” for details.
1305 set header_cache="~/.var/mutt/header_cache"
1308 # 3.91. header_cache_compress
1313 # When mutt is compiled with qdbm, tokyocabinet, or kyotocabinet as header cache
1314 # backend, this option determines whether the database will be compressed.
1315 # Compression results in database files roughly being one fifth of the usual
1316 # diskspace, but the decompression can result in a slower opening of cached
1317 # folder(s) which in general is still much faster than opening non header cached
1320 set header_cache_compress=no
1323 # 3.92. header_cache_pagesize
1328 # When mutt is compiled with either gdbm or bdb4 as the header cache backend,
1329 # this option changes the database page size. Too large or too small values can
1330 # waste space, memory, or CPU time. The default should be more or less optimal
1331 # for most use cases.
1335 # 3.93. header_color_partial
1340 # When set, color header regexps behave like color body regexps: color is applied
1341 # to the exact text matched by the regexp. When unset, color is applied to the
1344 # One use of this option might be to apply color to just the header labels.
1346 # See “color” for more details.
1355 # When set, help lines describing the bindings for the major functions provided
1356 # by each menu are displayed on the first line of the screen.
1358 # Note: The binding will not be displayed correctly if the function is bound to a
1359 # sequence rather than a single keystroke. Also, the help line may not be updated
1360 # if a binding is changed while Mutt is running. Since this variable is primarily
1361 # aimed at new users, neither of these should present a major problem.
1370 # When set, mutt will skip the host name part of $hostname variable when adding
1371 # the domain part to addresses. This variable does not affect the generation of
1372 # Message-IDs, and it will not lead to the cut-off of first-level domains.
1376 # 3.96. hide_limited
1381 # When set, mutt will not show the presence of messages that are hidden by
1382 # limiting, in the thread tree.
1386 # 3.97. hide_missing
1391 # When set, mutt will not show the presence of missing messages in the thread
1396 # 3.98. hide_thread_subject
1401 # When set, mutt will not show the subject of messages in the thread tree that
1402 # have the same subject as their parent or closest previously displayed sibling.
1406 # 3.99. hide_top_limited
1411 # When set, mutt will not show the presence of messages that are hidden by
1412 # limiting, at the top of threads in the thread tree. Note that when
1413 # $hide_limited is set, this option will have no effect.
1417 # 3.100. hide_top_missing
1422 # When set, mutt will not show the presence of missing messages at the top of
1423 # threads in the thread tree. Note that when $hide_missing is set, this option
1424 # will have no effect.
1433 # This variable controls the size (in number of strings remembered) of the string
1434 # history buffer per category. The buffer is cleared each time the variable is
1439 # 3.102. history_file
1442 # Default: “~/.mutthistory”
1444 # The file in which Mutt will save its history.
1446 # Also see $save_history.
1448 set history_file="~/.var/mutt/history"
1451 # 3.103. history_remove_dups
1456 # When set, all of the string history will be scanned for duplicates when a new
1457 # entry is added. Duplicate entries in the $history_file will also be removed
1458 # when it is periodically compacted.
1462 # 3.104. honor_disposition
1467 # When set, Mutt will not display attachments with a disposition of “attachment”
1468 # inline even if it could render the part to plain text. These MIME parts can
1469 # only be viewed from the attachment menu.
1471 # If unset, Mutt will render all MIME parts it can properly transform to plain
1476 # 3.105. honor_followup_to
1481 # This variable controls whether or not a Mail-Followup-To header is honored when
1482 # group-replying to a message.
1491 # Specifies the fully-qualified hostname of the system mutt is running on
1492 # containing the host's name and the DNS domain it belongs to. It is used as the
1493 # domain part (after “@”) for local email addresses as well as Message-Id
1496 # Its value is determined at startup as follows: the node's hostname is first
1497 # determined by the uname(3) function. The domain is then looked up using the
1498 # gethostname(2) and getaddrinfo(3) functions. If those calls are unable to
1499 # determine the domain, the full value returned by uname is used. Optionally,
1500 # Mutt can be compiled with a fixed domain name in which case a detected one is
1503 # Also see $use_domain and $hidden_host.
1512 # When set, Mutt will show you international domain names decoded. Note: You can
1513 # use IDNs for addresses even if this is unset. This variable only affects
1514 # decoding. (IDN only)
1523 # When set, Mutt will encode international domain names using IDN. Unset this if
1524 # your SMTP server can handle newer (RFC 6531) UTF-8 encoded domains. (IDN only)
1528 # 3.109. ignore_linear_white_space
1533 # This option replaces linear-white-space between encoded-word and text to a
1534 # single space to prevent the display of MIME-encoded “Subject:” field from being
1535 # divided into multiple lines.
1539 # 3.110. ignore_list_reply_to
1544 # Affects the behavior of the <reply> function when replying to messages from
1545 # mailing lists (as defined by the “subscribe” or “lists” commands). When set, if
1546 # the “Reply-To:” field is set to the same value as the “To:” field, Mutt assumes
1547 # that the “Reply-To:” field was set by the mailing list to automate responses to
1548 # the list, and will ignore this field. To direct a response to the mailing list
1549 # when this option is set, use the <list-reply> function; <group-reply> will
1550 # reply to both the sender and the list.
1552 set ignore_list_reply_to=yes
1555 # 3.111. imap_authenticators
1560 # This is a colon-delimited list of authentication methods mutt may attempt to
1561 # use to log in to an IMAP server, in the order mutt should try them.
1562 # Authentication methods are either “login” or the right side of an IMAP “AUTH=
1563 # xxx” capability string, e.g. “digest-md5”, “gssapi” or “cram-md5”. This option
1564 # is case-insensitive. If it's unset (the default) mutt will try all available
1565 # methods, in order from most-secure to least-secure.
1569 # set imap_authenticators="gssapi:cram-md5:login"
1571 # Note: Mutt will only fall back to other authentication methods if the previous
1572 # methods are unavailable. If a method is available but authentication fails,
1573 # mutt will not connect to the IMAP server.
1577 # 3.112. imap_check_subscribed
1582 # When set, mutt will fetch the set of subscribed folders from your server on
1583 # connection, and add them to the set of mailboxes it polls for new mail just as
1584 # if you had issued individual “mailboxes” commands.
1588 # 3.113. imap_delim_chars
1593 # This contains the list of characters which you would like to treat as folder
1594 # separators for displaying IMAP paths. In particular it helps in using the “=”
1595 # shortcut for your folder variable.
1599 # 3.114. imap_headers
1604 # Mutt requests these header fields in addition to the default headers (“Date:”,
1605 # “From:”, “Subject:”, “To:”, “Cc:”, “Message-Id:”, “References:”, “Content-Type:
1606 # ”, “Content-Description:”, “In-Reply-To:”, “Reply-To:”, “Lines:”, “List-Post:”,
1607 # “X-Label:”) from IMAP servers before displaying the index menu. You may want to
1608 # add more headers for spam detection.
1610 # Note: This is a space separated list, items should be uppercase and not contain
1611 # the colon, e.g. “X-BOGOSITY X-SPAM-STATUS” for the “X-Bogosity:” and “
1612 # X-Spam-Status:” header fields.
1621 # When set, mutt will attempt to use the IMAP IDLE extension to check for new
1622 # mail in the current mailbox. Some servers (dovecot was the inspiration for this
1623 # option) react badly to mutt's implementation. If your connection seems to
1624 # freeze up periodically, try unsetting this.
1628 # 3.116. imap_keepalive
1633 # This variable specifies the maximum amount of time in seconds that mutt will
1634 # wait before polling open IMAP connections, to prevent the server from closing
1635 # them before mutt has finished with them. The default is well within the
1636 # RFC-specified minimum amount of time (30 minutes) before a server is allowed to
1637 # do this, but in practice the RFC does get violated every now and then. Reduce
1638 # this number if you find yourself getting disconnected from your IMAP server due
1643 # 3.117. imap_list_subscribed
1648 # This variable configures whether IMAP folder browsing will look for only
1649 # subscribed folders or all folders. This can be toggled in the IMAP browser with
1650 # the <toggle-subscribed> function.
1659 # Your login name on the IMAP server.
1661 # This variable defaults to the value of $imap_user.
1665 # 3.119. imap_oauth_refresh_command
1670 # The command to run to generate an OAUTH refresh token for authorizing your
1671 # connection to your IMAP server. This command will be run on every connection
1672 # attempt that uses the OAUTHBEARER authentication mechanism.
1681 # Specifies the password for your IMAP account. If unset, Mutt will prompt you
1682 # for your password when you invoke the <imap-fetch-mail> function or try to open
1685 # Warning: you should only use this option when you are on a fairly secure
1686 # machine, because the superuser can read your muttrc even if you are the only
1687 # one who can read the file.
1691 # 3.121. imap_passive
1696 # When set, mutt will not open new IMAP connections to check for new mail. Mutt
1697 # will only check for new mail over existing IMAP connections. This is useful if
1698 # you don't want to be prompted to user/password pairs on mutt invocation, or if
1699 # opening the connection is slow.
1708 # When set, mutt will avoid implicitly marking your mail as read whenever you
1709 # fetch a message from the server. This is generally a good thing, but can make
1710 # closing an IMAP folder somewhat slower. This option exists to appease speed
1715 # 3.123. imap_pipeline_depth
1720 # Controls the number of IMAP commands that may be queued up before they are sent
1721 # to the server. A deeper pipeline reduces the amount of time mutt must wait for
1722 # the server, and can make IMAP servers feel much more responsive. But not all
1723 # servers correctly handle pipelined commands, so if you have problems you might
1724 # want to try setting this variable to 0.
1726 # Note: Changes to this variable have no effect on open connections.
1730 # 3.124. imap_poll_timeout
1735 # This variable specifies the maximum amount of time in seconds that mutt will
1736 # wait for a response when polling IMAP connections for new mail, before timing
1737 # out and closing the connection. Set to 0 to disable timing out.
1741 # 3.125. imap_servernoise
1746 # When set, mutt will display warning messages from the IMAP server as error
1747 # messages. Since these messages are often harmless, or generated due to
1748 # configuration problems on the server which are out of the users' hands, you may
1749 # wish to suppress them at some point.
1758 # The name of the user whose mail you intend to access on the IMAP server.
1760 # This variable defaults to your user name on the local machine.
1764 # 3.127. implicit_autoview
1769 # If set to “yes”, mutt will look for a mailcap entry with the “copiousoutput”
1770 # flag set for every MIME attachment it doesn't have an internal viewer defined
1771 # for. If such an entry is found, mutt will use the viewer defined in that entry
1772 # to convert the body part to text form.
1774 set implicit_autoview=no
1782 # Controls whether or not a copy of the message(s) you are replying to is
1783 # included in your reply.
1788 # 3.129. include_onlyfirst
1793 # Controls whether or not Mutt includes only the first attachment of the message
1798 # 3.130. indent_string
1803 # Specifies the string to prepend to each line of text quoted in a message to
1804 # which you are replying. You are strongly encouraged not to change this value,
1805 # as it tends to agitate the more fanatical netizens.
1807 # The value of this option is ignored if $text_flowed is set, because the quoting
1808 # mechanism is strictly defined for format=flowed.
1810 # This option is a format string, please see the description of $index_format for
1811 # supported printf(3)-style sequences.
1815 # 3.131. index_format
1818 # Default: “%4C %Z %{%b %d} %-15.15L (%?l?%4l&%4c?) %s”
1820 # This variable allows you to customize the message index display to your
1823 # “Format strings” are similar to the strings used in the C function printf(3) to
1824 # format output (see the man page for more details). For an explanation of the %?
1825 # construct, see the $status_format description. The following sequences are
1828 # ┌─────┬───────────────────────────────────────────────────────────────────────┐
1829 # │%a │address of the author │
1830 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1831 # │%A │reply-to address (if present; otherwise: address of author) │
1832 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1833 # │%b │filename of the original message folder (think mailbox) │
1834 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1835 # │%B │the list to which the letter was sent, or else the folder name (%b). │
1836 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1837 # │%c │number of characters (bytes) in the message │
1838 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1839 # │%C │current message number │
1840 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1841 # │%d │date and time of the message in the format specified by $date_format │
1842 # │ │converted to sender's time zone │
1843 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1844 # │%D │date and time of the message in the format specified by $date_format │
1845 # │ │converted to the local time zone │
1846 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1847 # │%e │current message number in thread │
1848 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1849 # │%E │number of messages in current thread │
1850 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1851 # │%f │sender (address + real name), either From: or Return-Path: │
1852 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1853 # │%F │author name, or recipient name if the message is from you │
1854 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1855 # │%H │spam attribute(s) of this message │
1856 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1857 # │%i │message-id of the current message │
1858 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1859 # │%l │number of lines in the message (does not work with maildir, mh, and │
1860 # │ │possibly IMAP folders) │
1861 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1862 # │ │If an address in the “To:” or “Cc:” header field matches an address │
1863 # │%L │defined by the users “subscribe” command, this displays "To <list-name>│
1864 # │ │", otherwise the same as %F. │
1865 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1866 # │%m │total number of message in the mailbox │
1867 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1868 # │%M │number of hidden messages if the thread is collapsed. │
1869 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1870 # │%N │message score │
1871 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1872 # │%n │author's real name (or address if missing) │
1873 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1874 # │%O │original save folder where mutt would formerly have stashed the │
1875 # │ │message: list name or recipient name if not sent to a list │
1876 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1877 # │%P │progress indicator for the built-in pager (how much of the file has │
1878 # │ │been displayed) │
1879 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1880 # │%r │comma separated list of “To:” recipients │
1881 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1882 # │%R │comma separated list of “Cc:” recipients │
1883 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1884 # │%s │subject of the message │
1885 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1886 # │%S │single character status of the message (“N”/“O”/“D”/“d”/“!”/“r”/“*”) │
1887 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1888 # │%t │“To:” field (recipients) │
1889 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1890 # │%T │the appropriate character from the $to_chars string │
1891 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1892 # │%u │user (login) name of the author │
1893 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1894 # │%v │first name of the author, or the recipient if the message is from you │
1895 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1896 # │%X │number of attachments (please see the “attachments” section for │
1897 # │ │possible speed effects) │
1898 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1899 # │%y │“X-Label:” field, if present │
1900 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1901 # │ │“X-Label:” field, if present, and (1) not at part of a thread tree, (2)│
1902 # │%Y │at the top of a thread, or (3) “X-Label:” is different from preceding │
1903 # │ │message's “X-Label:”. │
1904 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1905 # │ │a three character set of message status flags. the first character is │
1906 # │%Z │new/read/replied flags (“n”/“o”/“r”/“O”/“N”). the second is deleted or │
1907 # │ │encryption flags (“D”/“d”/“S”/“P”/“s”/“K”). the third is either tagged/│
1908 # │ │flagged (“*”/“!”), or one of the characters listed in $to_chars. │
1909 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1910 # │% │the date and time of the message is converted to sender's time zone, │
1911 # │{fmt}│and “fmt” is expanded by the library function strftime(3); a leading │
1912 # │ │bang disables locales │
1913 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1914 # │% │the date and time of the message is converted to the local time zone, │
1915 # │[fmt]│and “fmt” is expanded by the library function strftime(3); a leading │
1916 # │ │bang disables locales │
1917 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1918 # │% │the local date and time when the message was received. “fmt” is │
1919 # │(fmt)│expanded by the library function strftime(3); a leading bang disables │
1921 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1922 # │% │the current local time. “fmt” is expanded by the library function │
1923 # │<fmt>│strftime(3); a leading bang disables locales. │
1924 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1925 # │%>X │right justify the rest of the string and pad with character “X” │
1926 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1927 # │%|X │pad to the end of the line with character “X” │
1928 # ├─────┼───────────────────────────────────────────────────────────────────────┤
1929 # │%*X │soft-fill with character “X” as pad │
1930 # └─────┴───────────────────────────────────────────────────────────────────────┘
1932 # “Soft-fill” deserves some explanation: Normal right-justification will print
1933 # everything to the left of the “%>”, displaying padding and whatever lies to the
1934 # right only if there's room. By contrast, soft-fill gives priority to the
1935 # right-hand side, guaranteeing space to display it and showing padding only if
1936 # there's still room. If necessary, soft-fill will eat text leftwards to make
1937 # room for rightward text.
1939 # Note that these expandos are supported in “save-hook”, “fcc-hook” and “
1940 # fcc-save-hook”, too.
1949 # How to invoke ispell (GNU's spell-checking software).
1953 # 3.133. keep_flagged
1958 # If set, read messages marked as flagged will not be moved from your spool
1959 # mailbox to your $mbox mailbox, or as a result of a “mbox-hook” command.
1968 # This variable configures how often (in seconds) mutt should look for new mail.
1969 # Also see the $timeout variable.
1973 # 3.135. mail_check_recent
1978 # When set, Mutt will only notify you about new mail that has been received since
1979 # the last time you opened the mailbox. When unset, Mutt will notify you if any
1980 # new mail exists in the mailbox, regardless of whether you have visited it
1983 # When $mark_old is set, Mutt does not consider the mailbox to contain new mail
1984 # if only old messages exist.
1988 # 3.136. mail_check_stats
1993 # When set, mutt will periodically calculate message statistics of a mailbox
1994 # while polling for new mail. It will check for unread, flagged, and total
1995 # message counts. Because this operation is more performance intensive, it
1996 # defaults to unset, and has a separate option, $mail_check_stats_interval, to
1997 # control how often to update these counts.
1999 set mail_check_stats=yes
2002 # 3.137. mail_check_stats_interval
2007 # When $mail_check_stats is set, this variable configures how often (in seconds)
2008 # mutt will update message counts.
2012 # 3.138. mailcap_path
2017 # This variable specifies which files to consult when attempting to display MIME
2018 # bodies not directly supported by Mutt.
2020 set mailcap_path="$my_confdir/mailcap.icalendar:$my_confdir/mailcap.backgrounding:$my_confdir/mailcap.htmldump"
2023 # 3.139. mailcap_sanitize
2028 # If set, mutt will restrict possible characters in mailcap % expandos to a
2029 # well-defined set of safe characters. This is the safe setting, but we are not
2030 # sure it doesn't break some more advanced MIME stuff.
2032 # DON'T CHANGE THIS SETTING UNLESS YOU ARE REALLY SURE WHAT YOU ARE DOING!
2036 # 3.140. maildir_header_cache_verify
2041 # Check for Maildir unaware programs other than mutt having modified maildir
2042 # files when the header cache is in use. This incurs one stat(2) per message
2043 # every time the folder is opened (which can be very slow for NFS folders).
2045 set maildir_header_cache_verify=no
2048 # 3.141. maildir_trash
2053 # If set, messages marked as deleted will be saved with the maildir trashed flag
2054 # instead of unlinked. Note: this only applies to maildir-style mailboxes.
2055 # Setting it will have no effect on other mailbox types.
2059 # 3.142. maildir_check_cur
2064 # If set, mutt will poll both the new and cur directories of a maildir folder for
2065 # new messages. This might be useful if other programs interacting with the
2066 # folder (e.g. dovecot) are moving new messages to the cur directory. Note that
2067 # setting this option may slow down polling for new messages in large folders,
2068 # since mutt has to scan all cur messages.
2072 # 3.143. mark_macro_prefix
2077 # Prefix for macros created using mark-message. A new macro automatically
2078 # generated with <mark-message>a will be composed from this prefix and the letter
2088 # Controls whether or not mutt marks new unread messages as old if you exit a
2089 # mailbox without reading them. With this option set, the next time you start
2090 # mutt, the messages will show up with an “O” next to them in the index menu,
2091 # indicating that they are old.
2101 # Controls the display of wrapped lines in the internal pager. If set, a “+”
2102 # marker is displayed at the beginning of wrapped lines.
2104 # Also see the $smart_wrap variable.
2111 # Type: regular expression
2112 # Default: “!^.[^.]”
2114 # A regular expression used in the file browser, optionally preceded by the not
2115 # operator “!”. Only files whose names match this mask will be shown. The match
2116 # is always case-sensitive.
2125 # This specifies the folder into which read mail in your $spoolfile folder will
2128 # Also see the $move variable.
2134 # Type: folder magic
2137 # The default mailbox type used when creating new folders. May be any of “mbox”,
2138 # “MMDF”, “MH” and “Maildir”. This is overridden by the -m command-line option.
2140 set mbox_type=Maildir
2143 # 3.149. menu_context
2148 # This variable controls the number of lines of context that are given when
2149 # scrolling through menus. (Similar to $pager_context.)
2154 # 3.150. menu_move_off
2159 # When unset, the bottom entry of menus will never scroll up past the bottom of
2160 # the screen, unless there are less entries than lines. When set, the bottom
2161 # entry may move off the bottom.
2165 # 3.151. menu_scroll
2170 # When set, menus will be scrolled up or down one line when you attempt to move
2171 # across a screen boundary. If unset, the screen is cleared and the next or
2172 # previous page of the menu is displayed (useful for slow links to avoid many
2178 # 3.152. message_cache_clean
2183 # If set, mutt will clean out obsolete entries from the message cache when the
2184 # mailbox is synchronized. You probably only want to set it every once in a
2185 # while, since it can be a little slow (especially for large folders).
2189 # 3.153. message_cachedir
2194 # Set this to a directory and mutt will cache copies of messages from your IMAP
2195 # and POP servers here. You are free to remove entries at any time.
2197 # When setting this variable to a directory, mutt needs to fetch every remote
2198 # message only once and can perform regular expression searches as fast as for
2201 # Also see the $message_cache_clean variable.
2205 # 3.154. message_format
2210 # This is the string displayed in the “attachment” menu for attachments of type
2211 # message/rfc822. For a full listing of defined printf(3)-like sequences see the
2212 # section on $index_format.
2221 # If set, forces Mutt to interpret keystrokes with the high bit (bit 8) set as if
2222 # the user had pressed the Esc key and whatever key remains after having the high
2223 # bit removed. For example, if the key pressed has an ASCII value of 0xf8, then
2224 # this is treated as if the user had pressed Esc then “x”. This is because the
2225 # result of removing the high bit from 0xf8 is 0x78, which is the ASCII character
2235 # If unset, Mutt will remove your address (see the “alternates” command) from the
2236 # list of recipients when replying to a message.
2245 # When unset, mutt will mimic mh's behavior and rename deleted messages to ,<old
2246 # file name> in mh folders instead of really deleting them. This leaves the
2247 # message on disk but makes programs reading the folder ignore it. If the
2248 # variable is set, the message files will simply be deleted.
2250 # This option is similar to $maildir_trash for Maildir folders.
2254 # 3.158. mh_seq_flagged
2257 # Default: “flagged”
2259 # The name of the MH sequence used for flagged messages.
2263 # 3.159. mh_seq_replied
2266 # Default: “replied”
2268 # The name of the MH sequence used to tag replied messages.
2272 # 3.160. mh_seq_unseen
2277 # The name of the MH sequence used for unseen messages.
2281 # 3.161. mime_forward
2286 # When set, the message you are forwarding will be attached as a separate message
2287 # /rfc822 MIME part instead of included in the main body of the message. This is
2288 # useful for forwarding MIME messages so the receiver can properly view the
2289 # message as it was delivered to you. If you like to switch between MIME and not
2290 # MIME from mail to mail, set this variable to “ask-no” or “ask-yes”.
2292 # Also see $forward_decode and $mime_forward_decode.
2294 set mime_forward=ask-yes
2297 # 3.162. mime_forward_decode
2302 # Controls the decoding of complex MIME messages into text/plain when forwarding
2303 # a message while $mime_forward is set. Otherwise $forward_decode is used
2308 # 3.163. mime_forward_rest
2313 # When forwarding multiple attachments of a MIME message from the attachment
2314 # menu, attachments which cannot be decoded in a reasonable manner will be
2315 # attached to the newly composed message if this option is set.
2319 # 3.164. mime_type_query_command
2324 # This specifies a command to run, to determine the mime type of a new attachment
2325 # when composing a message. Unless $mime_type_query_first is set, this will only
2326 # be run if the attachment's extension is not found in the mime.types file.
2328 # The string may contain a “%s”, which will be substituted with the attachment
2329 # filename. Mutt will add quotes around the string substituted for “%s”
2330 # automatically according to shell quoting rules, so you should avoid adding your
2331 # own. If no “%s” is found in the string, Mutt will append the attachment
2332 # filename to the end of the string.
2334 # The command should output a single line containing the attachment's mime type.
2336 # Suggested values are “xdg-mime query filetype” or “file -bi”.
2340 # 3.165. mime_type_query_first
2345 # When set, the $mime_type_query_command will be run before the mime.types
2350 # 3.166. mix_entry_format
2353 # Default: “%4n %c %-16s %a”
2355 # This variable describes the format of a remailer line on the mixmaster chain
2356 # selection screen. The following printf(3)-like sequences are supported:
2358 # ┌──┬───────────────────────────────┐
2359 # │%n│The running number on the menu.│
2360 # ├──┼───────────────────────────────┤
2361 # │%c│Remailer capabilities. │
2362 # ├──┼───────────────────────────────┤
2363 # │%s│The remailer's short name. │
2364 # ├──┼───────────────────────────────┤
2365 # │%a│The remailer's e-mail address. │
2366 # └──┴───────────────────────────────┘
2373 # Default: “mixmaster”
2375 # This variable contains the path to the Mixmaster binary on your system. It is
2376 # used with various sets of parameters to gather the list of known remailers, and
2377 # to finally send a message through the mixmaster chain.
2379 set mixmaster="mixmaster-filter"
2387 # Controls whether or not Mutt will move read messages from your spool mailbox to
2388 # your $mbox mailbox, or as a result of a “mbox-hook” command.
2393 # 3.169. narrow_tree
2398 # This variable, when set, makes the thread tree narrower, allowing deeper
2399 # threads to fit on the screen.
2409 # Operations that expect to transfer a large amount of data over the network will
2410 # update their progress every $net_inc kilobytes. If set to 0, no progress
2411 # messages will be displayed.
2413 # See also $read_inc, $write_inc and $net_inc.
2417 # 3.171. new_mail_command
2422 # If set, Mutt will call this command after a new message is received. See the
2423 # $status_format documentation for the values that can be formatted into this
2431 # Default: “builtin”
2433 # This variable specifies which pager you would like to use to view messages. The
2434 # value “builtin” means to use the built-in pager, otherwise this variable should
2435 # specify the pathname of the external pager you would like to use.
2437 # Using an external pager may have some disadvantages: Additional keystrokes are
2438 # necessary because you can't call mutt functions directly from the pager, and
2439 # screen resizes cause lines longer than the screen width to be badly formatted
2444 # 3.173. pager_context
2449 # This variable controls the number of lines of context that are given when
2450 # displaying the next or previous page in the internal pager. By default, Mutt
2451 # will display the line after the last one on the screen at the top of the next
2452 # page (0 lines of context).
2454 # This variable also specifies the amount of context given for search results. If
2455 # positive, this many lines will be given before a match, if 0, the match will be
2461 # 3.174. pager_format
2464 # Default: “-%Z- %C/%m: %-20.20n %s%* -- (%P)”
2466 # This variable controls the format of the one-line message “status” displayed
2467 # before each message in either the internal or an external pager. The valid
2468 # sequences are listed in the $index_format section.
2470 set pager_format="<%a> %* %i (%P)"
2473 # 3.175. pager_index_lines
2478 # Determines the number of lines of a mini-index which is shown when in the
2479 # pager. The current message, unless near the top or bottom of the folder, will
2480 # be roughly one third of the way down this mini-index, giving the reader the
2481 # context of a few messages before and after the message. This is useful, for
2482 # example, to determine how many messages remain to be read in the current
2483 # thread. One of the lines is reserved for the status bar from the index, so a
2484 # setting of 6 will only show 5 lines of the actual index. A value of 0 results
2485 # in no index being shown. If the number of messages in the current folder is
2486 # less than $pager_index_lines, then the index will only use as many lines as it
2489 set pager_index_lines=5
2497 # When set, the internal-pager will not move to the next message when you are at
2498 # the end of a message and invoke the <next-page> function.
2503 # 3.177. pgp_auto_decode
2508 # If set, mutt will automatically attempt to decrypt traditional PGP messages
2509 # whenever the user performs an operation which ordinarily would result in the
2510 # contents of the message being operated on. For example, if the user displays a
2511 # pgp-traditional message which has not been manually checked with the
2512 # <check-traditional-pgp> function, mutt will automatically check the message for
2515 set pgp_auto_decode=yes
2518 # 3.178. pgp_autoinline
2523 # This option controls whether Mutt generates old-style inline (traditional) PGP
2524 # encrypted or signed messages under certain circumstances. This can be
2525 # overridden by use of the pgp menu, when inline is not required. The GPGME
2526 # backend does not support this option.
2528 # Note that Mutt might automatically use PGP/MIME for messages which consist of
2529 # more than a single MIME part. Mutt can be configured to ask before sending PGP/
2530 # MIME messages when inline (traditional) would not work.
2532 # Also see the $pgp_mime_auto variable.
2534 # Also note that using the old-style PGP message format is strongly deprecated.
2539 # 3.179. pgp_check_exit
2544 # If set, mutt will check the exit code of the PGP subprocess when signing or
2545 # encrypting. A non-zero exit code means that the subprocess failed. (PGP only)
2549 # 3.180. pgp_check_gpg_decrypt_status_fd
2554 # If set, mutt will check the status file descriptor output of
2555 # $pgp_decrypt_command and $pgp_decode_command for GnuPG status codes indicating
2556 # successful decryption. This will check for the presence of DECRYPTION_OKAY,
2557 # absence of DECRYPTION_FAILED, and that all PLAINTEXT occurs between the
2558 # BEGIN_DECRYPTION and END_DECRYPTION status codes.
2560 # If unset, mutt will instead match the status fd output against
2561 # $pgp_decryption_okay. (PGP only)
2565 # 3.181. pgp_clearsign_command
2570 # This format is used to create an old-style “clearsigned” PGP message. Note that
2571 # the use of this format is strongly deprecated.
2573 # This is a format string, see the $pgp_decode_command command for possible
2574 # printf(3)-like sequences. (PGP only)
2578 # 3.182. pgp_decode_command
2583 # This format strings specifies a command which is used to decode application/pgp
2586 # The PGP command formats have their own set of printf(3)-like sequences:
2588 # ┌──┬──────────────────────────────────────────────────────────────────────────┐
2589 # │%p│Expands to PGPPASSFD=0 when a pass phrase is needed, to an empty string │
2590 # │ │otherwise. Note: This may be used with a %? construct. │
2591 # ├──┼──────────────────────────────────────────────────────────────────────────┤
2592 # │%f│Expands to the name of a file containing a message. │
2593 # ├──┼──────────────────────────────────────────────────────────────────────────┤
2594 # │%s│Expands to the name of a file containing the signature part of a multipart│
2595 # │ │/signed attachment when verifying it. │
2596 # ├──┼──────────────────────────────────────────────────────────────────────────┤
2597 # │%a│The value of $pgp_sign_as if set, otherwise the value of $pgp_default_key.│
2598 # ├──┼──────────────────────────────────────────────────────────────────────────┤
2599 # │%r│One or more key IDs (or fingerprints if available). │
2600 # └──┴──────────────────────────────────────────────────────────────────────────┘
2602 # For examples on how to configure these formats for the various versions of PGP
2603 # which are floating around, see the pgp and gpg sample configuration files in
2604 # the samples/ subdirectory which has been installed on your system alongside the
2605 # documentation. (PGP only)
2609 # 3.183. pgp_decrypt_command
2614 # This command is used to decrypt a PGP encrypted message.
2616 # This is a format string, see the $pgp_decode_command command for possible
2617 # printf(3)-like sequences. (PGP only)
2621 # 3.184. pgp_decryption_okay
2623 # Type: regular expression
2626 # If you assign text to this variable, then an encrypted PGP message is only
2627 # considered successfully decrypted if the output from $pgp_decrypt_command
2628 # contains the text. This is used to protect against a spoofed encrypted message,
2629 # with multipart/encrypted headers but containing a block that is not actually
2630 # encrypted. (e.g. simply signed and ascii armored text).
2632 # Note that if $pgp_check_gpg_decrypt_status_fd is set, this variable is ignored.
2637 # 3.185. pgp_default_key
2642 # This is the default key-pair to use for PGP operations. It will be used for
2643 # encryption (see $postpone_encrypt and $pgp_self_encrypt).
2645 # It will also be used for signing unless $pgp_sign_as is set.
2647 # The (now deprecated) pgp_self_encrypt_as is an alias for this variable, and
2648 # should no longer be used. (PGP only)
2652 # 3.186. pgp_encrypt_only_command
2657 # This command is used to encrypt a body part without signing it.
2659 # This is a format string, see the $pgp_decode_command command for possible
2660 # printf(3)-like sequences. (PGP only)
2664 # 3.187. pgp_encrypt_sign_command
2669 # This command is used to both sign and encrypt a body part.
2671 # This is a format string, see the $pgp_decode_command command for possible
2672 # printf(3)-like sequences. (PGP only)
2676 # 3.188. pgp_entry_format
2679 # Default: “%4n %t%f %4l/0x%k %-4a %2c %u”
2681 # This variable allows you to customize the PGP key selection menu to your
2682 # personal taste. This string is similar to $index_format, but has its own set of
2683 # printf(3)-like sequences:
2685 # ┌──────┬──────────────────────────────────────────────────────┐
2687 # ├──────┼──────────────────────────────────────────────────────┤
2689 # ├──────┼──────────────────────────────────────────────────────┤
2691 # ├──────┼──────────────────────────────────────────────────────┤
2693 # ├──────┼──────────────────────────────────────────────────────┤
2695 # ├──────┼──────────────────────────────────────────────────────┤
2697 # ├──────┼──────────────────────────────────────────────────────┤
2698 # │%c │capabilities │
2699 # ├──────┼──────────────────────────────────────────────────────┤
2700 # │%t │trust/validity of the key-uid association │
2701 # ├──────┼──────────────────────────────────────────────────────┤
2702 # │%[<s>]│date of the key where <s> is an strftime(3) expression│
2703 # └──────┴──────────────────────────────────────────────────────┘
2709 # 3.189. pgp_export_command
2714 # This command is used to export a public key from the user's key ring.
2716 # This is a format string, see the $pgp_decode_command command for possible
2717 # printf(3)-like sequences. (PGP only)
2721 # 3.190. pgp_getkeys_command
2726 # This command is invoked whenever Mutt needs to fetch the public key associated
2727 # with an email address. Of the sequences supported by $pgp_decode_command, %r is
2728 # the only printf(3)-like sequence used with this format. Note that in this case,
2729 # %r expands to the email address, not the public key ID (the key ID is unknown,
2730 # which is why Mutt is invoking this command). (PGP only)
2734 # 3.191. pgp_good_sign
2736 # Type: regular expression
2739 # If you assign a text to this variable, then a PGP signature is only considered
2740 # verified if the output from $pgp_verify_command contains the text. Use this
2741 # variable if the exit code from the command is 0 even for bad signatures. (PGP
2746 # 3.192. pgp_ignore_subkeys
2751 # Setting this variable will cause Mutt to ignore OpenPGP subkeys. Instead, the
2752 # principal key will inherit the subkeys' capabilities. Unset this if you want to
2753 # play interesting key selection games. (PGP only)
2757 # 3.193. pgp_import_command
2762 # This command is used to import a key from a message into the user's public key
2765 # This is a format string, see the $pgp_decode_command command for possible
2766 # printf(3)-like sequences. (PGP only)
2770 # 3.194. pgp_list_pubring_command
2775 # This command is used to list the public key ring's contents. The output format
2776 # must be analogous to the one used by
2778 # gpg --list-keys --with-colons --with-fingerprint
2780 # This format is also generated by the pgpring utility which comes with mutt.
2782 # Note: gpg's fixed-list-mode option should not be used. It produces a different
2783 # date format which may result in mutt showing incorrect key generation dates.
2785 # This is a format string, see the $pgp_decode_command command for possible
2786 # printf(3)-like sequences. (PGP only)
2790 # 3.195. pgp_list_secring_command
2795 # This command is used to list the secret key ring's contents. The output format
2796 # must be analogous to the one used by:
2798 # gpg --list-keys --with-colons --with-fingerprint
2800 # This format is also generated by the pgpring utility which comes with mutt.
2802 # Note: gpg's fixed-list-mode option should not be used. It produces a different
2803 # date format which may result in mutt showing incorrect key generation dates.
2805 # This is a format string, see the $pgp_decode_command command for possible
2806 # printf(3)-like sequences. (PGP only)
2810 # 3.196. pgp_long_ids
2815 # If set, use 64 bit PGP key IDs, if unset use the normal 32 bit key IDs. NOTE:
2816 # Internally, Mutt has transitioned to using fingerprints (or long key IDs as a
2817 # fallback). This option now only controls the display of key IDs in the key
2818 # selection menu and a few other places. (PGP only)
2822 # 3.197. pgp_mime_auto
2827 # This option controls whether Mutt will prompt you for automatically sending a
2828 # (signed/encrypted) message using PGP/MIME when inline (traditional) fails (for
2831 # Also note that using the old-style PGP message format is strongly deprecated.
2836 # 3.198. pgp_replyinline
2841 # Setting this variable will cause Mutt to always attempt to create an inline
2842 # (traditional) message when replying to a message which is PGP encrypted/signed
2843 # inline. This can be overridden by use of the pgp menu, when inline is not
2844 # required. This option does not automatically detect if the (replied-to) message
2845 # is inline; instead it relies on Mutt internals for previously checked/flagged
2848 # Note that Mutt might automatically use PGP/MIME for messages which consist of
2849 # more than a single MIME part. Mutt can be configured to ask before sending PGP/
2850 # MIME messages when inline (traditional) would not work.
2852 # Also see the $pgp_mime_auto variable.
2854 # Also note that using the old-style PGP message format is strongly deprecated.
2859 # 3.199. pgp_retainable_sigs
2864 # If set, signed and encrypted messages will consist of nested multipart/signed
2865 # and multipart/encrypted body parts.
2867 # This is useful for applications like encrypted and signed mailing lists, where
2868 # the outer layer (multipart/encrypted) can be easily removed, while the inner
2869 # multipart/signed part is retained. (PGP only)
2871 set pgp_retainable_sigs=yes
2874 # 3.200. pgp_self_encrypt
2879 # When set, PGP encrypted messages will also be encrypted using the key in
2880 # $pgp_default_key. (PGP only)
2884 # 3.201. pgp_show_unusable
2889 # If set, mutt will display non-usable keys on the PGP key selection menu. This
2890 # includes keys which have been revoked, have expired, or have been marked as “
2891 # disabled” by the user. (PGP only)
2893 set pgp_show_unusable=no
2896 # 3.202. pgp_sign_as
2901 # If you have a different key pair to use for signing, you should set this to the
2902 # signing key. Most people will only need to set $pgp_default_key. It is
2903 # recommended that you use the keyid form to specify your key (e.g. 0x00112233).
2906 set pgp_sign_as="0x9C9D6979AE941637"
2909 # 3.203. pgp_sign_command
2914 # This command is used to create the detached PGP signature for a multipart/
2915 # signed PGP/MIME body part.
2917 # This is a format string, see the $pgp_decode_command command for possible
2918 # printf(3)-like sequences. (PGP only)
2922 # 3.204. pgp_sort_keys
2927 # Specifies how the entries in the pgp menu are sorted. The following are legal
2930 # ┌───────┬──────────────────────────────┐
2931 # │address│sort alphabetically by user id│
2932 # ├───────┼──────────────────────────────┤
2933 # │keyid │sort alphabetically by key id │
2934 # ├───────┼──────────────────────────────┤
2935 # │date │sort by key creation date │
2936 # ├───────┼──────────────────────────────┤
2937 # │trust │sort by the trust of the key │
2938 # └───────┴──────────────────────────────┘
2940 # If you prefer reverse order of the above values, prefix it with “reverse-”.
2945 # 3.205. pgp_strict_enc
2950 # If set, Mutt will automatically encode PGP/MIME signed messages as
2951 # quoted-printable. Please note that unsetting this variable may lead to problems
2952 # with non-verifyable PGP signatures, so only change this if you know what you
2953 # are doing. (PGP only)
2957 # 3.206. pgp_timeout
2962 # The number of seconds after which a cached passphrase will expire if not used.
2967 # 3.207. pgp_use_gpg_agent
2972 # If set, mutt will use a possibly-running gpg-agent(1) process. Note that as of
2973 # version 2.1, GnuPG no longer exports GPG_AGENT_INFO, so mutt no longer verifies
2974 # if the agent is running. (PGP only)
2976 set pgp_use_gpg_agent=yes
2979 # 3.208. pgp_verify_command
2984 # This command is used to verify PGP signatures.
2986 # This is a format string, see the $pgp_decode_command command for possible
2987 # printf(3)-like sequences. (PGP only)
2991 # 3.209. pgp_verify_key_command
2996 # This command is used to verify key information from the key selection menu.
2998 # This is a format string, see the $pgp_decode_command command for possible
2999 # printf(3)-like sequences. (PGP only)
3003 # 3.210. pipe_decode
3008 # Used in connection with the <pipe-message> command. When unset, Mutt will pipe
3009 # the messages without any preprocessing. When set, Mutt will weed headers and
3010 # will attempt to decode the messages first.
3019 # The separator to add between messages when piping a list of tagged messages to
3020 # an external Unix command.
3029 # Used in connection with the <pipe-message> function following <tag-prefix>. If
3030 # this variable is unset, when piping a list of tagged messages Mutt will
3031 # concatenate the messages and will pipe them all concatenated. When set, Mutt
3032 # will pipe the messages one by one. In both cases the messages are piped in the
3033 # current sorted order, and the $pipe_sep separator is added after each message.
3037 # 3.213. pop_auth_try_all
3042 # If set, Mutt will try all available authentication methods. When unset, Mutt
3043 # will only fall back to other authentication methods if the previous methods are
3044 # unavailable. If a method is available but authentication fails, Mutt will not
3045 # connect to the POP server.
3049 # 3.214. pop_authenticators
3054 # This is a colon-delimited list of authentication methods mutt may attempt to
3055 # use to log in to an POP server, in the order mutt should try them.
3056 # Authentication methods are either “user”, “apop” or any SASL mechanism, e.g. “
3057 # digest-md5”, “gssapi” or “cram-md5”. This option is case-insensitive. If this
3058 # option is unset (the default) mutt will try all available methods, in order
3059 # from most-secure to least-secure.
3063 # set pop_authenticators="digest-md5:apop:user"
3067 # 3.215. pop_checkinterval
3072 # This variable configures how often (in seconds) mutt should look for new mail
3073 # in the currently selected mailbox if it is a POP mailbox.
3082 # If set, Mutt will delete successfully downloaded messages from the POP server
3083 # when using the <fetch-mail> function. When unset, Mutt will download messages
3084 # but also leave them on the POP server.
3093 # The name of your POP server for the <fetch-mail> function. You can also specify
3094 # an alternative port, username and password, i.e.:
3096 # [pop[s]://][username[:password]@]popserver[:port]
3098 # where “[...]” denotes an optional part.
3107 # If this variable is set, mutt will try to use the “LAST” POP command for
3108 # retrieving only unread messages from the POP server when using the <fetch-mail>
3113 # 3.219. pop_oauth_refresh_command
3118 # The command to run to generate an OAUTH refresh token for authorizing your
3119 # connection to your POP server. This command will be run on every connection
3120 # attempt that uses the OAUTHBEARER authentication mechanism.
3129 # Specifies the password for your POP account. If unset, Mutt will prompt you for
3130 # your password when you open a POP mailbox.
3132 # Warning: you should only use this option when you are on a fairly secure
3133 # machine, because the superuser can read your muttrc even if you are the only
3134 # one who can read the file.
3138 # 3.221. pop_reconnect
3143 # Controls whether or not Mutt will try to reconnect to the POP server if the
3144 # connection is lost.
3153 # Your login name on the POP server.
3155 # This variable defaults to your user name on the local machine.
3159 # 3.223. post_indent_string
3164 # Similar to the $attribution variable, Mutt will append this string after the
3165 # inclusion of a message which is being replied to.
3174 # Controls whether or not messages are saved in the $postponed mailbox when you
3175 # elect not to send immediately.
3177 # Also see the $recall variable.
3184 # Default: “~/postponed”
3186 # Mutt allows you to indefinitely “postpone sending a message” which you are
3187 # editing. When you choose to postpone a message, Mutt saves it in the mailbox
3188 # specified by this variable.
3190 # Also see the $postpone variable.
3192 set postponed="=drafts"
3195 # 3.226. postpone_encrypt
3200 # When set, postponed messages that are marked for encryption will be
3201 # self-encrypted. Mutt will first try to encrypt using the value specified in
3202 # $pgp_default_key or $smime_default_key. If those are not set, it will try the
3203 # deprecated $postpone_encrypt_as. (Crypto only)
3207 # 3.227. postpone_encrypt_as
3212 # This is a deprecated fall-back variable for $postpone_encrypt. Please use
3213 # $pgp_default_key or $smime_default_key. (Crypto only)
3222 # If set, a shell command to be executed if mutt fails to establish a connection
3223 # to the server. This is useful for setting up secure connections, e.g. with ssh
3224 # (1). If the command returns a nonzero status, mutt gives up opening the server.
3227 # set preconnect="ssh -f -q -L 1234:mailhost.net:143 mailhost.net sleep 20 < /dev/null > /dev/null"
3229 # Mailbox “foo” on “mailhost.net” can now be reached as “{localhost:1234}foo”.
3231 # Note: For this example to work, you must be able to log in to the remote
3232 # machine without having to enter a password.
3241 # Controls whether or not Mutt really prints messages. This is set to “ask-no” by
3242 # default, because some people accidentally hit “p” often.
3246 # 3.230. print_command
3251 # This specifies the command pipe that should be used to print messages.
3253 set print_command="muttprint"
3256 # 3.231. print_decode
3261 # Used in connection with the <print-message> command. If this option is set, the
3262 # message is decoded before it is passed to the external command specified by
3263 # $print_command. If this option is unset, no processing will be applied to the
3264 # message when printing it. The latter setting may be useful if you are using
3265 # some advanced printer filter which is able to properly format e-mail messages
3270 # 3.232. print_split
3275 # Used in connection with the <print-message> command. If this option is set, the
3276 # command specified by $print_command is executed once for each message which is
3277 # to be printed. If this option is unset, the command specified by $print_command
3278 # is executed only once, and all the messages are concatenated, with a form feed
3279 # as the message separator.
3281 # Those who use the enscript(1) program's mail-printing mode will most likely
3282 # want to set this option.
3287 # 3.233. prompt_after
3292 # If you use an external $pager, setting this variable will cause Mutt to prompt
3293 # you for a command when the pager exits rather than returning to the index menu.
3294 # If unset, Mutt will return to the index menu when the external pager exits.
3298 # 3.234. query_command
3303 # This specifies the command Mutt will use to make external address queries. The
3304 # string may contain a “%s”, which will be substituted with the query string the
3305 # user types. Mutt will add quotes around the string substituted for “%s”
3306 # automatically according to shell quoting rules, so you should avoid adding your
3307 # own. If no “%s” is found in the string, Mutt will append the user's query to
3308 # the end of the string. See “query” for more information.
3310 set query_command="lbdbq"
3313 # 3.235. query_format
3316 # Default: “%4c %t %-25.25a %-25.25n %?e?(%e)?”
3318 # This variable describes the format of the “query” menu. The following printf(3)
3319 # -style sequences are understood:
3321 # ┌───┬─────────────────────────────────────────────────────┐
3322 # │%a │destination address │
3323 # ├───┼─────────────────────────────────────────────────────┤
3324 # │%c │current entry number │
3325 # ├───┼─────────────────────────────────────────────────────┤
3326 # │%e │extra information * │
3327 # ├───┼─────────────────────────────────────────────────────┤
3328 # │%n │destination name │
3329 # ├───┼─────────────────────────────────────────────────────┤
3330 # │%t │“*” if current entry is tagged, a space otherwise │
3331 # ├───┼─────────────────────────────────────────────────────┤
3332 # │%>X│right justify the rest of the string and pad with “X”│
3333 # ├───┼─────────────────────────────────────────────────────┤
3334 # │%|X│pad to the end of the line with “X” │
3335 # ├───┼─────────────────────────────────────────────────────┤
3336 # │%*X│soft-fill with character “X” as pad │
3337 # └───┴─────────────────────────────────────────────────────┘
3339 # For an explanation of “soft-fill”, see the $index_format documentation.
3341 # * = can be optionally printed if nonzero, see the $status_format documentation.
3350 # This variable controls whether “quit” and “exit” actually quit from mutt. If
3351 # this option is set, they do quit, if it is unset, they have no effect, and if
3352 # it is set to ask-yes or ask-no, you are prompted for confirmation when you try
3357 # 3.237. quote_regexp
3359 # Type: regular expression
3360 # Default: “^([ t]*[|>:}#])+”
3362 # A regular expression used in the internal pager to determine quoted sections of
3363 # text in the body of a message. Quoted text may be filtered out using the
3364 # <toggle-quoted> command, or colored according to the “color quoted” family of
3367 # Higher levels of quoting may be colored differently (“color quoted1”, “color
3368 # quoted2”, etc.). The quoting level is determined by removing the last character
3369 # from the matched text and recursively reapplying the regular expression until
3370 # it fails to produce a match.
3372 # Match detection may be overridden by the $smileys regular expression.
3381 # If set to a value greater than 0, Mutt will display which message it is
3382 # currently on when reading a mailbox or when performing search actions such as
3383 # search and limit. The message is printed after this many messages have been
3384 # read or searched (e.g., if set to 25, Mutt will print a message when it is at
3385 # message 25, and then again when it gets to message 50). This variable is meant
3386 # to indicate progress when reading or searching large mailboxes which may take
3387 # some time. When set to 0, only a single message will appear before the reading
3390 # Also see the $write_inc, $net_inc and $time_inc variables and the “tuning”
3391 # section of the manual for performance considerations.
3400 # If set, all folders are opened in read-only mode.
3409 # This variable specifies what “real” or “personal” name should be used when
3412 # By default, this is the GECOS field from /etc/passwd. Note that this variable
3413 # will not be used when the user has set a real name in the $from variable.
3422 # Controls whether or not Mutt recalls postponed messages when composing a new
3425 # Setting this variable to yes is not generally useful, and thus not recommended.
3426 # Note that the <recall-message> function can be used to manually recall
3427 # postponed messages.
3429 # Also see $postponed variable.
3439 # This specifies the file into which your outgoing messages should be appended.
3440 # (This is meant as the primary method for saving a copy of your messages, but
3441 # another way to do this is using the “my_hdr” command to create a “Bcc:” field
3442 # with your email address in it.)
3444 # The value of $record is overridden by the $force_name and $save_name variables,
3445 # and the “fcc-hook” command.
3450 # 3.243. reflow_space_quotes
3455 # This option controls how quotes from format=flowed messages are displayed in
3456 # the pager and when replying (with $text_flowed unset). When set, this option
3457 # adds spaces after each level of quote marks, turning ">>>foo" into "> > > foo".
3459 # Note: If $reflow_text is unset, this option has no effect. Also, this option
3460 # does not affect replies when $text_flowed is set.
3464 # 3.244. reflow_text
3469 # When set, Mutt will reformat paragraphs in text/plain parts marked format=
3470 # flowed. If unset, Mutt will display paragraphs unaltered from how they appear
3471 # in the message body. See RFC3676 for details on the format=flowed format.
3473 # Also see $reflow_wrap, and $wrap.
3477 # 3.245. reflow_wrap
3482 # This variable controls the maximum paragraph width when reformatting text/plain
3483 # parts when $reflow_text is set. When the value is 0, paragraphs will be wrapped
3484 # at the terminal's right margin. A positive value sets the paragraph width
3485 # relative to the left margin. A negative value set the paragraph width relative
3486 # to the right margin.
3493 # 3.246. reply_regexp
3495 # Type: regular expression
3496 # Default: “^(re([[0-9]+])*|aw):[ t]*”
3498 # A regular expression used to recognize reply messages when threading and
3499 # replying. The default value corresponds to the English "Re:" and the German
3502 set reply_regexp="^((re([-[(]?[[:digit:]]+[)]]?)?|a(nt)?w(ort)?|wg|s(gkb|v)):[[:space:]]*)+"
3510 # If unset and you are replying to a message sent by you, Mutt will assume that
3511 # you want to reply to the recipients of that message rather than to yourself.
3513 # Also see the “alternates” command.
3522 # If set, when replying to a message, Mutt will use the address listed in the
3523 # Reply-to: header as the recipient of the reply. If unset, it will use the
3524 # address in the From: header field instead. This option is useful for reading a
3525 # mailing list that sets the Reply-To: header field to the list address and you
3526 # want to send a private message to the author of a message.
3535 # When set, the cursor will be automatically advanced to the next (possibly
3536 # undeleted) message whenever a command that modifies the current message is
3541 # 3.250. resume_draft_files
3546 # If set, draft files (specified by -H on the command line) are processed
3547 # similarly to when resuming a postponed message. Recipients are not prompted
3548 # for; send-hooks are not evaluated; no alias expansion takes place; user-defined
3549 # headers and signatures are not added to the message.
3553 # 3.251. resume_edited_draft_files
3558 # If set, draft files previously edited (via -E -H on the command line) will have
3559 # $resume_draft_files automatically set when they are used as a draft file again.
3561 # The first time a draft file is saved, mutt will add a header,
3562 # X-Mutt-Resume-Draft to the saved file. The next time the draft file is read in,
3563 # if mutt sees the header, it will set $resume_draft_files.
3565 # This option is designed to prevent multiple signatures, user-defined headers,
3566 # and other processing effects from being made multiple times to the draft file.
3570 # 3.252. reverse_alias
3575 # This variable controls whether or not Mutt will display the “personal” name
3576 # from your aliases in the index menu if it finds an alias that matches the
3577 # message's sender. For example, if you have the following alias:
3579 # alias juser abd30425@somewhere.net (Joe User)
3581 # and then you receive mail which contains the following header:
3583 # From: abd30425@somewhere.net
3585 # It would be displayed in the index menu as “Joe User” instead of “
3586 # abd30425@somewhere.net.” This is useful when the person's e-mail address is not
3591 # 3.253. reverse_name
3596 # It may sometimes arrive that you receive mail to a certain machine, move the
3597 # messages to another machine, and reply to some the messages from there. If this
3598 # variable is set, the default From: line of the reply messages is built using
3599 # the address where you received the messages you are replying to if that address
3600 # matches your “alternates”. If the variable is unset, or the address that would
3601 # be used doesn't match your “alternates”, the From: line will use your address
3602 # on the current machine.
3604 # Also see the “alternates” command.
3606 set reverse_name=yes
3609 # 3.254. reverse_realname
3614 # This variable fine-tunes the behavior of the $reverse_name feature. When it is
3615 # set, mutt will use the address from incoming messages as-is, possibly including
3616 # eventual real names. When it is unset, mutt will override any such real names
3617 # with the setting of the $realname variable.
3621 # 3.255. rfc2047_parameters
3626 # When this variable is set, Mutt will decode RFC2047-encoded MIME parameters.
3627 # You want to set this variable when mutt suggests you to save attachments to
3630 # =?iso-8859-1?Q?file=5F=E4=5F991116=2Ezip?=
3632 # When this variable is set interactively, the change won't be active until you
3635 # Note that this use of RFC2047's encoding is explicitly prohibited by the
3636 # standard, but nevertheless encountered in the wild.
3638 # Also note that setting this parameter will not have the effect that mutt
3639 # generates this kind of encoding. Instead, mutt will unconditionally use the
3640 # encoding specified in RFC2231.
3642 set rfc2047_parameters=yes
3645 # 3.256. save_address
3650 # If set, mutt will take the sender's full address when choosing a default folder
3651 # for saving a mail. If $save_name or $force_name is set too, the selection of
3652 # the Fcc folder will be changed as well.
3661 # When unset, mailboxes which contain no saved messages will be removed when
3662 # closed (the exception is $spoolfile which is never removed). If set, mailboxes
3663 # are never removed.
3665 # Note: This only applies to mbox and MMDF folders, Mutt does not delete MH and
3666 # Maildir directories.
3670 # 3.258. save_history
3675 # This variable controls the size of the history (per category) saved in the
3676 # $history_file file.
3678 set save_history=100
3686 # This variable controls how copies of outgoing messages are saved. When set, a
3687 # check is made to see if a mailbox specified by the recipient address exists
3688 # (this is done by searching for a mailbox in the $folder directory with the
3689 # username part of the recipient address). If the mailbox exists, the outgoing
3690 # message will be saved to that mailbox, otherwise the message is saved to the
3693 # Also see the $force_name variable.
3702 # When this variable is unset, scoring is turned off. This can be useful to
3703 # selectively disable scoring for certain folders when the
3704 # $score_threshold_delete variable and related are used.
3708 # 3.261. score_threshold_delete
3713 # Messages which have been assigned a score equal to or lower than the value of
3714 # this variable are automatically marked for deletion by mutt. Since mutt scores
3715 # are always greater than or equal to zero, the default setting of this variable
3716 # will never mark a message for deletion.
3720 # 3.262. score_threshold_flag
3725 # Messages which have been assigned a score greater than or equal to this
3726 # variable's value are automatically marked "flagged".
3730 # 3.263. score_threshold_read
3735 # Messages which have been assigned a score equal to or lower than the value of
3736 # this variable are automatically marked as read by mutt. Since mutt scores are
3737 # always greater than or equal to zero, the default setting of this variable will
3738 # never mark a message read.
3742 # 3.264. search_context
3747 # For the pager, this variable specifies the number of lines shown before search
3748 # results. By default, search results will be top-aligned.
3750 set search_context=5
3753 # 3.265. send_charset
3756 # Default: “us-ascii:iso-8859-1:utf-8”
3758 # A colon-delimited list of character sets for outgoing messages. Mutt will use
3759 # the first character set into which the text can be converted exactly. If your
3760 # $charset is not “iso-8859-1” and recipients may not understand “UTF-8”, it is
3761 # advisable to include in the list an appropriate widely used standard character
3762 # set (such as “iso-8859-2”, “koi8-r” or “iso-2022-jp”) either instead of or
3763 # after “iso-8859-1”.
3765 # In case the text cannot be converted into one of these exactly, mutt uses
3766 # $charset as a fallback.
3768 set send_charset="utf-8"
3774 # Default: “/usr/sbin/sendmail -oem -oi”
3776 # Specifies the program and arguments used to deliver mail sent by Mutt. Mutt
3777 # expects that the specified program interprets additional arguments as recipient
3778 # addresses. Mutt appends all recipients after adding a -- delimiter (if not
3779 # already present). Additional flags, such as for $use_8bitmime,
3780 # $use_envelope_from, $dsn_notify, or $dsn_return will be added before the
3783 set sendmail="$my_confdir/sendmail"
3786 # 3.267. sendmail_wait
3791 # Specifies the number of seconds to wait for the $sendmail process to finish
3792 # before giving up and putting delivery in the background.
3794 # Mutt interprets the value of this variable as follows:
3796 # ┌──┬──────────────────────────────────────────────────────────────────┐
3797 # │>0│number of seconds to wait for sendmail to finish before continuing│
3798 # ├──┼──────────────────────────────────────────────────────────────────┤
3799 # │0 │wait forever for sendmail to finish │
3800 # ├──┼──────────────────────────────────────────────────────────────────┤
3801 # │<0│always put sendmail in the background without waiting │
3802 # └──┴──────────────────────────────────────────────────────────────────┘
3804 # Note that if you specify a value other than 0, the output of the child process
3805 # will be put in a temporary file. If there is some error, you will be informed
3806 # as to where to find the output.
3815 # Command to use when spawning a subshell. By default, the user's login shell
3816 # from /etc/passwd is used.
3820 # 3.269. sidebar_delim_chars
3825 # This contains the list of characters which you would like to treat as folder
3826 # separators for displaying paths in the sidebar.
3828 # Local mail is often arranged in directories: `dir1/dir2/mailbox'.
3830 # set sidebar_delim_chars='/'
3832 # IMAP mailboxes are often named: `folder1.folder2.mailbox'.
3834 # set sidebar_delim_chars='.'
3836 # See also: $sidebar_short_path, $sidebar_folder_indent, $sidebar_indent_string.
3840 # 3.270. sidebar_divider_char
3845 # This specifies the characters to be drawn between the sidebar (when visible)
3846 # and the other Mutt panels. ASCII and Unicode line-drawing characters are
3849 set sidebar_divider_char=" "
3852 # 3.271. sidebar_folder_indent
3857 # Set this to indent mailboxes in the sidebar.
3859 # See also: $sidebar_short_path, $sidebar_indent_string, $sidebar_delim_chars.
3861 set sidebar_folder_indent=yes
3864 # 3.272. sidebar_format
3867 # Default: “%B%* %n”
3869 # This variable allows you to customize the sidebar display. This string is
3870 # similar to $index_format, but has its own set of printf(3)-like sequences:
3872 # ┌───┬─────────────────────────────────────────────────────────────────────────┐
3873 # │%B │Name of the mailbox │
3874 # ├───┼─────────────────────────────────────────────────────────────────────────┤
3875 # │%S │* Size of mailbox (total number of messages) │
3876 # ├───┼─────────────────────────────────────────────────────────────────────────┤
3877 # │%N │* Number of unread messages in the mailbox │
3878 # ├───┼─────────────────────────────────────────────────────────────────────────┤
3879 # │%n │N if mailbox has new mail, blank otherwise │
3880 # ├───┼─────────────────────────────────────────────────────────────────────────┤
3881 # │%F │* Number of Flagged messages in the mailbox │
3882 # ├───┼─────────────────────────────────────────────────────────────────────────┤
3883 # │%! │“!” : one flagged message; “!!” : two flagged messages; “n!” : n flagged │
3884 # │ │messages (for n > 2). Otherwise prints nothing. │
3885 # ├───┼─────────────────────────────────────────────────────────────────────────┤
3886 # │%d │* @ Number of deleted messages │
3887 # ├───┼─────────────────────────────────────────────────────────────────────────┤
3888 # │%L │* @ Number of messages after limiting │
3889 # ├───┼─────────────────────────────────────────────────────────────────────────┤
3890 # │%t │* @ Number of tagged messages │
3891 # ├───┼─────────────────────────────────────────────────────────────────────────┤
3892 # │%>X│right justify the rest of the string and pad with “X” │
3893 # ├───┼─────────────────────────────────────────────────────────────────────────┤
3894 # │%|X│pad to the end of the line with “X” │
3895 # ├───┼─────────────────────────────────────────────────────────────────────────┤
3896 # │%*X│soft-fill with character “X” as pad │
3897 # └───┴─────────────────────────────────────────────────────────────────────────┘
3899 # * = Can be optionally printed if nonzero @ = Only applicable to the current
3902 # In order to use %S, %N, %F, and %!, $mail_check_stats must be set. When thus
3903 # set, a suggested value for this option is "%B%?F? [%F]?%* %?N?%N/?%S".
3905 set sidebar_format="%B%?F? [%F]?%* %?N?%N/?%S"
3908 # 3.273. sidebar_indent_string
3913 # This specifies the string that is used to indent mailboxes in the sidebar. It
3914 # defaults to two spaces.
3916 # See also: $sidebar_short_path, $sidebar_folder_indent, $sidebar_delim_chars.
3918 set sidebar_indent_string=" "
3921 # 3.274. sidebar_new_mail_only
3926 # When set, the sidebar will only display mailboxes containing new, or flagged,
3929 # See also: sidebar_whitelist.
3933 # 3.275. sidebar_next_new_wrap
3938 # When set, the <sidebar-next-new> command will not stop and the end of the list
3939 # of mailboxes, but wrap around to the beginning. The <sidebar-prev-new> command
3940 # is similarly affected, wrapping around to the end of the list.
3942 set sidebar_next_new_wrap=yes
3945 # 3.276. sidebar_short_path
3950 # By default the sidebar will show the mailbox's path, relative to the $folder
3951 # variable. Setting sidebar_shortpath=yes will shorten the names relative to the
3952 # previous name. Here's an example:
3954 # ┌────────────┬─────────────┬───────────────────────────────────────────────┐
3955 # │shortpath=no│shortpath=yes│shortpath=yes, folderindent=yes, indentstr=".."│
3956 # ├────────────┼─────────────┼───────────────────────────────────────────────┤
3957 # │fruit │fruit │fruit │
3958 # ├────────────┼─────────────┼───────────────────────────────────────────────┤
3959 # │fruit.apple │apple │..apple │
3960 # ├────────────┼─────────────┼───────────────────────────────────────────────┤
3961 # │fruit.banana│banana │..banana │
3962 # ├────────────┼─────────────┼───────────────────────────────────────────────┤
3963 # │fruit.cherry│cherry │..cherry │
3964 # └────────────┴─────────────┴───────────────────────────────────────────────┘
3966 # See also: $sidebar_delim_chars, $sidebar_folder_indent, $sidebar_indent_string.
3968 set sidebar_short_path=yes
3971 # 3.277. sidebar_sort_method
3976 # Specifies how to sort entries in the file browser. By default, the entries are
3977 # sorted alphabetically. Valid values:
3979 # • alpha (alphabetically)
3981 # • count (all message count)
3983 # • flagged (flagged message count)
3985 # • name (alphabetically)
3987 # • new (unread message count)
3989 # • path (alphabetically)
3991 # • unread (unread message count)
3995 # You may optionally use the “reverse-” prefix to specify reverse sorting order
3996 # (example: “set sort_browser=reverse-date”).
3998 set sidebar_sort_method=path
4001 # 3.278. sidebar_visible
4006 # This specifies whether or not to show sidebar. The sidebar shows a list of all
4009 # See also: $sidebar_format, $sidebar_width
4011 set sidebar_visible=yes
4014 # 3.279. sidebar_width
4019 # This controls the width of the sidebar. It is measured in screen columns. For
4020 # example: sidebar_width=20 could display 20 ASCII characters, or 10 Chinese
4023 set sidebar_width=20
4031 # If set, a line containing “-- ” (note the trailing space) will be inserted
4032 # before your $signature. It is strongly recommended that you not unset this
4033 # variable unless your signature contains just your name. The reason for this is
4034 # because many software packages use “-- n” to detect your signature. For
4035 # example, Mutt has the ability to highlight the signature in a different color
4036 # in the built-in pager.
4046 # If set, the signature will be included before any quoted or forwarded text. It
4047 # is strongly recommended that you do not set this variable unless you really
4048 # know what you are doing, and are prepared to take some heat from netiquette
4056 # Default: “~/.signature”
4058 # Specifies the filename of your signature, which is appended to all outgoing
4059 # messages. If the filename ends with a pipe (“|”), it is assumed that filename
4060 # is a shell command and input should be read from its standard output.
4064 # 3.283. simple_search
4067 # Default: “~f %s | ~s %s”
4069 # Specifies how Mutt should expand a simple search into a real search pattern. A
4070 # simple search is one that does not contain any of the “~” pattern operators.
4071 # See “patterns” for more information on search patterns.
4073 # For example, if you simply type “joe” at a search or limit prompt, Mutt will
4074 # automatically expand it to the value specified by this variable by replacing “
4075 # %s” with the supplied string. For the default value, “joe” would be expanded
4076 # to: “~f joe | ~s joe”.
4078 set simple_search="~L %s | ~s %s"
4086 # Specifies time, in seconds, to pause while displaying certain informational
4087 # messages, while moving from folder to folder and after expunging messages from
4088 # the current folder. The default is to pause one second, so a value of zero for
4089 # this option suppresses the pause.
4098 # Controls the display of lines longer than the screen width in the internal
4099 # pager. If set, long lines are wrapped at a word boundary. If unset, lines are
4100 # simply wrapped at the screen edge. Also see the $markers variable.
4106 # Type: regular expression
4107 # Default: “(>From )|(:[-^]?[][)(><}{|/DP])”
4109 # The pager uses this variable to catch some common false positives of
4110 # $quote_regexp, most notably smileys and not consider a line quoted text if it
4111 # also matches $smileys. This mostly happens at the beginning of a line.
4115 # 3.287. smime_ask_cert_label
4120 # This flag controls whether you want to be asked to enter a label for a
4121 # certificate about to be added to the database or not. It is set by default. (S/
4126 # 3.288. smime_ca_location
4131 # This variable contains the name of either a directory, or a file which contains
4132 # trusted certificates for use with OpenSSL. (S/MIME only)
4136 # 3.289. smime_certificates
4141 # Since for S/MIME there is no pubring/secring as with PGP, mutt has to handle
4142 # storage and retrieval of keys by itself. This is very basic right now, and keys
4143 # and certificates are stored in two different directories, both named as the
4144 # hash-value retrieved from OpenSSL. There is an index file which contains
4145 # mailbox-address keyid pairs, and which can be manually edited. This option
4146 # points to the location of the certificates. (S/MIME only)
4148 set smime_certificates="~/.smime/certificates"
4151 # 3.290. smime_decrypt_command
4156 # This format string specifies a command which is used to decrypt application/
4157 # x-pkcs7-mime attachments.
4159 # The OpenSSL command formats have their own set of printf(3)-like sequences
4162 # ┌──┬──────────────────────────────────────────────────────────────────────────┐
4163 # │%f│Expands to the name of a file containing a message. │
4164 # ├──┼──────────────────────────────────────────────────────────────────────────┤
4165 # │%s│Expands to the name of a file containing the signature part of a multipart│
4166 # │ │/signed attachment when verifying it. │
4167 # ├──┼──────────────────────────────────────────────────────────────────────────┤
4168 # │%k│The key-pair specified with $smime_default_key │
4169 # ├──┼──────────────────────────────────────────────────────────────────────────┤
4170 # │%c│One or more certificate IDs. │
4171 # ├──┼──────────────────────────────────────────────────────────────────────────┤
4172 # │%a│The algorithm used for encryption. │
4173 # ├──┼──────────────────────────────────────────────────────────────────────────┤
4174 # │%d│The message digest algorithm specified with $smime_sign_digest_alg. │
4175 # ├──┼──────────────────────────────────────────────────────────────────────────┤
4176 # │ │CA location: Depending on whether $smime_ca_location points to a directory│
4177 # │%C│or file, this expands to “-CApath $smime_ca_location” or “-CAfile │
4178 # │ │$smime_ca_location”. │
4179 # └──┴──────────────────────────────────────────────────────────────────────────┘
4181 # For examples on how to configure these formats, see the smime.rc in the samples
4182 # / subdirectory which has been installed on your system alongside the
4183 # documentation. (S/MIME only)
4187 # 3.291. smime_decrypt_use_default_key
4192 # If set (default) this tells mutt to use the default key for decryption.
4193 # Otherwise, if managing multiple certificate-key-pairs, mutt will try to use the
4194 # mailbox-address to determine the key to use. It will ask you to supply a key,
4195 # if it can't find one. (S/MIME only)
4199 # 3.292. smime_default_key
4204 # This is the default key-pair to use for S/MIME operations, and must be set to
4205 # the keyid (the hash-value that OpenSSL generates) to work properly.
4207 # It will be used for encryption (see $postpone_encrypt and $smime_self_encrypt).
4209 # It will be used for decryption unless $smime_decrypt_use_default_key is unset.
4211 # It will also be used for signing unless $smime_sign_as is set.
4213 # The (now deprecated) smime_self_encrypt_as is an alias for this variable, and
4214 # should no longer be used. (S/MIME only)
4218 # 3.293. smime_encrypt_command
4223 # This command is used to create encrypted S/MIME messages.
4225 # This is a format string, see the $smime_decrypt_command command for possible
4226 # printf(3)-like sequences. (S/MIME only)
4230 # 3.294. smime_encrypt_with
4235 # This sets the algorithm that should be used for encryption. Valid choices are “
4236 # aes128”, “aes192”, “aes256”, “des”, “des3”, “rc2-40”, “rc2-64”, “rc2-128”. (S/
4241 # 3.295. smime_get_cert_command
4246 # This command is used to extract X509 certificates from a PKCS7 structure.
4248 # This is a format string, see the $smime_decrypt_command command for possible
4249 # printf(3)-like sequences. (S/MIME only)
4253 # 3.296. smime_get_cert_email_command
4258 # This command is used to extract the mail address(es) used for storing X509
4259 # certificates, and for verification purposes (to check whether the certificate
4260 # was issued for the sender's mailbox).
4262 # This is a format string, see the $smime_decrypt_command command for possible
4263 # printf(3)-like sequences. (S/MIME only)
4267 # 3.297. smime_get_signer_cert_command
4272 # This command is used to extract only the signers X509 certificate from a S/MIME
4273 # signature, so that the certificate's owner may get compared to the email's “
4276 # This is a format string, see the $smime_decrypt_command command for possible
4277 # printf(3)-like sequences. (S/MIME only)
4281 # 3.298. smime_import_cert_command
4286 # This command is used to import a certificate via smime_keys.
4288 # This is a format string, see the $smime_decrypt_command command for possible
4289 # printf(3)-like sequences. (S/MIME only)
4293 # 3.299. smime_is_default
4298 # The default behavior of mutt is to use PGP on all auto-sign/encryption
4299 # operations. To override and to use OpenSSL instead this must be set. However,
4300 # this has no effect while replying, since mutt will automatically select the
4301 # same application that was used to sign/encrypt the original message. (Note that
4302 # this variable can be overridden by unsetting $crypt_autosmime.) (S/MIME only)
4311 # Since for S/MIME there is no pubring/secring as with PGP, mutt has to handle
4312 # storage and retrieval of keys/certs by itself. This is very basic right now,
4313 # and stores keys and certificates in two different directories, both named as
4314 # the hash-value retrieved from OpenSSL. There is an index file which contains
4315 # mailbox-address keyid pair, and which can be manually edited. This option
4316 # points to the location of the private keys. (S/MIME only)
4318 set smime_keys="~/.smime/keys"
4321 # 3.301. smime_pk7out_command
4326 # This command is used to extract PKCS7 structures of S/MIME signatures, in order
4327 # to extract the public X509 certificate(s).
4329 # This is a format string, see the $smime_decrypt_command command for possible
4330 # printf(3)-like sequences. (S/MIME only)
4334 # 3.302. smime_self_encrypt
4339 # When set, S/MIME encrypted messages will also be encrypted using the
4340 # certificate in $smime_default_key. (S/MIME only)
4344 # 3.303. smime_sign_as
4349 # If you have a separate key to use for signing, you should set this to the
4350 # signing key. Most people will only need to set $smime_default_key. (S/MIME
4355 # 3.304. smime_sign_command
4360 # This command is used to created S/MIME signatures of type multipart/signed,
4361 # which can be read by all mail clients.
4363 # This is a format string, see the $smime_decrypt_command command for possible
4364 # printf(3)-like sequences. NOTE: %c and %k will default to $smime_sign_as if
4365 # set, otherwise $smime_default_key. (S/MIME only)
4369 # 3.305. smime_sign_digest_alg
4374 # This sets the algorithm that should be used for the signature message digest.
4375 # Valid choices are “md5”, “sha1”, “sha224”, “sha256”, “sha384”, “sha512”. (S/
4380 # 3.306. smime_sign_opaque_command
4385 # This command is used to created S/MIME signatures of type application/
4386 # x-pkcs7-signature, which can only be handled by mail clients supporting the S/
4389 # This is a format string, see the $smime_decrypt_command command for possible
4390 # printf(3)-like sequences. (S/MIME only)
4394 # 3.307. smime_timeout
4399 # The number of seconds after which a cached passphrase will expire if not used.
4404 # 3.308. smime_verify_command
4409 # This command is used to verify S/MIME signatures of type multipart/signed.
4411 # This is a format string, see the $smime_decrypt_command command for possible
4412 # printf(3)-like sequences. (S/MIME only)
4416 # 3.309. smime_verify_opaque_command
4421 # This command is used to verify S/MIME signatures of type application/
4424 # This is a format string, see the $smime_decrypt_command command for possible
4425 # printf(3)-like sequences. (S/MIME only)
4429 # 3.310. smtp_authenticators
4434 # This is a colon-delimited list of authentication methods mutt may attempt to
4435 # use to log in to an SMTP server, in the order mutt should try them.
4436 # Authentication methods are any SASL mechanism, e.g. “digest-md5”, “gssapi” or “
4437 # cram-md5”. This option is case-insensitive. If it is “unset” (the default) mutt
4438 # will try all available methods, in order from most-secure to least-secure.
4442 # set smtp_authenticators="digest-md5:cram-md5"
4446 # 3.311. smtp_oauth_refresh_command
4451 # The command to run to generate an OAUTH refresh token for authorizing your
4452 # connection to your SMTP server. This command will be run on every connection
4453 # attempt that uses the OAUTHBEARER authentication mechanism.
4462 # Specifies the password for your SMTP account. If unset, Mutt will prompt you
4463 # for your password when you first send mail via SMTP. See $smtp_url to configure
4464 # mutt to send mail via SMTP.
4466 # Warning: you should only use this option when you are on a fairly secure
4467 # machine, because the superuser can read your muttrc even if you are the only
4468 # one who can read the file.
4477 # Defines the SMTP smarthost where sent messages should relayed for delivery.
4478 # This should take the form of an SMTP URL, e.g.:
4480 # smtp[s]://[user[:pass]@]host[:port]
4482 # where “[...]” denotes an optional part. Setting this variable overrides the
4483 # value of the $sendmail variable.
4492 # Specifies how to sort messages in the “index” menu. Valid values are:
4494 # • date or date-sent
4500 # • mailbox-order (unsorted)
4514 # You may optionally use the “reverse-” prefix to specify reverse sorting order
4515 # (example: “set sort=reverse-date-sent”).
4525 # Specifies how the entries in the “alias” menu are sorted. The following are
4528 # • address (sort alphabetically by email address)
4530 # • alias (sort alphabetically by alias name)
4532 # • unsorted (leave in order specified in .muttrc)
4541 # When sorting by threads, this variable controls how threads are sorted in
4542 # relation to other threads, and how the branches of the thread trees are sorted.
4543 # This can be set to any value that $sort can, except “threads” (in that case,
4544 # mutt will just use “date-sent”). You can also specify the “last-” prefix in
4545 # addition to the “reverse-” prefix, but “last-” must come after “reverse-”. The
4546 # “last-” prefix causes messages to be sorted against its siblings by which has
4547 # the last descendant, using the rest of $sort_aux as an ordering. For instance,
4549 # set sort_aux=last-date-received
4551 # would mean that if a new message is received in a thread, that thread becomes
4552 # the last one displayed (or the first, if you have “set sort=reverse-threads”.)
4554 # Note: For reversed $sort order $sort_aux is reversed again (which is not the
4555 # right thing to do, but kept to not break any existing configuration setting).
4557 set sort_aux=last-date-received
4560 # 3.317. sort_browser
4565 # Specifies how to sort entries in the file browser. By default, the entries are
4566 # sorted alphabetically. Valid values:
4568 # • alpha (alphabetically)
4580 # You may optionally use the “reverse-” prefix to specify reverse sorting order
4581 # (example: “set sort_browser=reverse-date”).
4590 # This variable is only useful when sorting by threads with $strict_threads unset
4591 # . In that case, it changes the heuristic mutt uses to thread messages by
4592 # subject. With $sort_re set, mutt will only attach a message as the child of
4593 # another message by subject if the subject of the child message starts with a
4594 # substring matching the setting of $reply_regexp. With $sort_re unset, mutt will
4595 # attach the message whether or not this is the case, as long as the non-
4596 # $reply_regexp parts of both messages are identical.
4600 # 3.319. spam_separator
4605 # This variable controls what happens when multiple spam headers are matched: if
4606 # unset, each successive header will overwrite any previous matches value for the
4607 # spam label. If set, each successive match will append to the previous, using
4608 # this variable's value as a separator.
4617 # If your spool mailbox is in a non-default place where Mutt cannot find it, you
4618 # can specify its location with this variable. Mutt will initially set this
4619 # variable to the value of the environment variable $MAIL or $MAILDIR if either
4622 set spoolfile="=inbox"
4625 # 3.321. ssl_ca_certificates_file
4630 # This variable specifies a file containing trusted CA certificates. Any server
4631 # certificate that is signed with one of these CA certificates is also
4632 # automatically accepted. (GnuTLS only)
4636 # set ssl_ca_certificates_file=/etc/ssl/certs/ca-certificates.crt
4638 set ssl_ca_certificates_file="/etc/ssl/certs/ca-certificates.crt"
4641 # 3.322. ssl_client_cert
4646 # The file containing a client certificate and its associated private key.
4650 # 3.323. ssl_force_tls
4655 # If this variable is set, Mutt will require that all connections to remote
4656 # servers be encrypted. Furthermore it will attempt to negotiate TLS even if the
4657 # server does not advertise the capability, since it would otherwise have to
4658 # abort the connection anyway. This option supersedes $ssl_starttls.
4662 # 3.324. ssl_min_dh_prime_bits
4667 # This variable specifies the minimum acceptable prime size (in bits) for use in
4668 # any Diffie-Hellman key exchange. A value of 0 will use the default from the
4669 # GNUTLS library. (GnuTLS only)
4673 # 3.325. ssl_starttls
4678 # If set (the default), mutt will attempt to use STARTTLS on servers advertising
4679 # the capability. When unset, mutt will not attempt to use STARTTLS regardless of
4680 # the server's capabilities.
4684 # 3.326. ssl_use_sslv2
4689 # This variable specifies whether to attempt to use SSLv2 in the SSL
4690 # authentication process. Note that SSLv2 and SSLv3 are now considered
4691 # fundamentally insecure and are no longer recommended. (OpenSSL only)
4695 # 3.327. ssl_use_sslv3
4700 # This variable specifies whether to attempt to use SSLv3 in the SSL
4701 # authentication process. Note that SSLv2 and SSLv3 are now considered
4702 # fundamentally insecure and are no longer recommended.
4706 # 3.328. ssl_use_tlsv1
4711 # This variable specifies whether to attempt to use TLSv1.0 in the SSL
4712 # authentication process.
4716 # 3.329. ssl_use_tlsv1_1
4721 # This variable specifies whether to attempt to use TLSv1.1 in the SSL
4722 # authentication process.
4726 # 3.330. ssl_use_tlsv1_2
4731 # This variable specifies whether to attempt to use TLSv1.2 in the SSL
4732 # authentication process.
4736 # 3.331. ssl_usesystemcerts
4741 # If set to yes, mutt will use CA certificates in the system-wide certificate
4742 # store when checking if a server certificate is signed by a trusted CA. (OpenSSL
4747 # 3.332. ssl_verify_dates
4752 # If set (the default), mutt will not automatically accept a server certificate
4753 # that is either not yet valid or already expired. You should only unset this for
4754 # particular known hosts, using the <account-hook> function.
4758 # 3.333. ssl_verify_host
4763 # If set (the default), mutt will not automatically accept a server certificate
4764 # whose host name does not match the host used in your folder URL. You should
4765 # only unset this for particular known hosts, using the <account-hook> function.
4769 # 3.334. ssl_verify_partial_chains
4774 # This option should not be changed from the default unless you understand what
4777 # Setting this variable to yes will permit verifying partial certification
4778 # chains, i. e. a certificate chain where not the root, but an intermediate
4779 # certificate CA, or the host certificate, are marked trusted (in
4780 # $certificate_file), without marking the root signing CA as trusted.
4782 # (OpenSSL 1.0.2b and newer only).
4786 # 3.335. ssl_ciphers
4791 # Contains a colon-seperated list of ciphers to use when using SSL. For OpenSSL,
4792 # see ciphers(1) for the syntax of the string.
4794 # For GnuTLS, this option will be used in place of "NORMAL" at the start of the
4795 # priority string. See gnutls_priority_init(3) for the syntax and more details.
4796 # (Note: GnuTLS version 2.1.7 or higher is required.)
4800 # 3.336. status_chars
4805 # Controls the characters used by the “%r” indicator in $status_format. The first
4806 # character is used when the mailbox is unchanged. The second is used when the
4807 # mailbox has been changed, and it needs to be resynchronized. The third is used
4808 # if the mailbox is in read-only mode, or if the mailbox will not be written when
4809 # exiting that mailbox (You can toggle whether to write changes to a mailbox with
4810 # the <toggle-write> operation, bound by default to “%”). The fourth is used to
4811 # indicate that the current folder has been opened in attach- message mode
4812 # (Certain operations like composing a new mail, replying, forwarding, etc. are
4813 # not permitted in this mode).
4817 # 3.337. status_format
4820 # Default: “-%r-Mutt: %f [Msgs:%?M?%M/?%m%?n? New:%n?%?o? Old:%o?%?d? Del:%d?%?F?
4821 # Flag:%F?%?t? Tag:%t?%?p? Post:%p?%?b? Inc:%b?%?l? %l?]---(%s/%S)-%>-(%P)---”
4823 # Controls the format of the status line displayed in the “index” menu. This
4824 # string is similar to $index_format, but has its own set of printf(3)-like
4827 # ┌───┬─────────────────────────────────────────────────────────────────────────┐
4828 # │%b │number of mailboxes with new mail * │
4829 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4830 # │%d │number of deleted messages * │
4831 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4832 # │%f │the full pathname of the current mailbox │
4833 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4834 # │%F │number of flagged messages * │
4835 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4836 # │%h │local hostname │
4837 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4838 # │%l │size (in bytes) of the current mailbox * │
4839 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4840 # │%L │size (in bytes) of the messages shown (i.e., which match the current │
4842 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4843 # │%m │the number of messages in the mailbox * │
4844 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4845 # │%M │the number of messages shown (i.e., which match the current limit) * │
4846 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4847 # │%n │number of new messages in the mailbox * │
4848 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4849 # │%o │number of old unread messages * │
4850 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4851 # │%p │number of postponed messages * │
4852 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4853 # │%P │percentage of the way through the index │
4854 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4855 # │%r │modified/read-only/won't-write/attach-message indicator, according to │
4856 # │ │$status_chars │
4857 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4858 # │%R │number of read messages * │
4859 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4860 # │%s │current sorting mode ($sort) │
4861 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4862 # │%S │current aux sorting method ($sort_aux) │
4863 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4864 # │%t │number of tagged messages * │
4865 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4866 # │%u │number of unread messages * │
4867 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4868 # │%v │Mutt version string │
4869 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4870 # │%V │currently active limit pattern, if any * │
4871 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4872 # │%>X│right justify the rest of the string and pad with “X” │
4873 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4874 # │%|X│pad to the end of the line with “X” │
4875 # ├───┼─────────────────────────────────────────────────────────────────────────┤
4876 # │%*X│soft-fill with character “X” as pad │
4877 # └───┴─────────────────────────────────────────────────────────────────────────┘
4879 # For an explanation of “soft-fill”, see the $index_format documentation.
4881 # * = can be optionally printed if nonzero
4883 # Some of the above sequences can be used to optionally print a string if their
4884 # value is nonzero. For example, you may only want to see the number of flagged
4885 # messages if such messages exist, since zero is not particularly meaningful. To
4886 # optionally print a string based upon one of the above sequences, the following
4887 # construct is used:
4889 # %?<sequence_char>?<optional_string>?
4891 # where sequence_char is a character from the table above, and optional_string is
4892 # the string you would like printed if sequence_char is nonzero. optional_string
4893 # may contain other sequences as well as normal text, but you may not nest
4896 # Here is an example illustrating how to optionally print the number of new
4897 # messages in a mailbox:
4899 # %?n?%n new messages.?
4901 # You can also switch between two strings using the following construct:
4903 # %?<sequence_char>?<if_string>&<else_string>?
4905 # If the value of sequence_char is non-zero, if_string will be expanded,
4906 # otherwise else_string will be expanded.
4908 # You can force the result of any printf(3)-like sequence to be lowercase by
4909 # prefixing the sequence character with an underscore (“_”) sign. For example, if
4910 # you want to display the local hostname in lowercase, you would use: “%_h”.
4912 # If you prefix the sequence character with a colon (“:”) character, mutt will
4913 # replace any dots in the expansion by underscores. This might be helpful with
4914 # IMAP folders that don't like dots in folder names.
4916 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) "
4919 # 3.338. status_on_top
4924 # Setting this variable causes the “status bar” to be displayed on the first line
4925 # of the screen rather than near the bottom. If $help is set, too it'll be placed
4930 # 3.339. strict_threads
4935 # If set, threading will only make use of the “In-Reply-To” and “References:”
4936 # fields when you $sort by message threads. By default, messages with the same
4937 # subject are grouped together in “pseudo threads.”. This may not always be
4938 # desirable, such as in a personal mailbox where you might have several unrelated
4939 # messages with the subjects like “hi” which will get grouped together. See also
4940 # $sort_re for a less drastic way of controlling this behavior.
4942 set strict_threads=yes
4950 # When unset, mutt won't stop when the user presses the terminal's susp key,
4951 # usually “^Z”. This is useful if you run mutt inside an xterm using a command
4952 # like “xterm -e mutt”.
4956 # 3.341. text_flowed
4961 # When set, mutt will generate “format=flowed” bodies with a content type of “
4962 # text/plain; format=flowed”. This format is easier to handle for some mailing
4963 # software, and generally just looks like ordinary text. To actually make use of
4964 # this format's features, you'll need support in your editor.
4966 # Note that $indent_string is ignored when this option is set.
4971 # 3.342. thorough_search
4976 # Affects the ~b and ~h search operations described in section “patterns”. If set
4977 # , the headers and body/attachments of messages to be searched are decoded
4978 # before searching. If unset, messages are searched as they appear in the folder.
4980 # Users searching attachments or for non-ASCII characters should set this value
4981 # because decoding also includes MIME parsing/decoding and possible character set
4982 # conversions. Otherwise mutt will attempt to match against the raw message
4983 # received (for example quoted-printable encoded or with encoded headers) which
4984 # may lead to incorrect search results.
4986 set thorough_search=yes
4989 # 3.343. thread_received
4994 # When set, mutt uses the date received rather than the date sent to thread
4995 # messages by subject.
4997 set thread_received=yes
5005 # When set, the internal-pager will pad blank lines to the bottom of the screen
5006 # with a tilde (“~”).
5016 # Along with $read_inc, $write_inc, and $net_inc, this variable controls the
5017 # frequency with which progress updates are displayed. It suppresses updates less
5018 # than $time_inc milliseconds apart. This can improve throughput on systems with
5019 # slow terminals, or when running mutt on a remote system.
5021 # Also see the “tuning” section of the manual for performance considerations.
5031 # When Mutt is waiting for user input either idling in menus or in an interactive
5032 # prompt, Mutt would block until input is present. Depending on the context, this
5033 # would prevent certain operations from working, like checking for new mail or
5034 # keeping an IMAP connection alive.
5036 # This variable controls how many seconds Mutt will at most wait until it aborts
5037 # waiting for input, performs these operations and continues to wait for input.
5039 # A value of zero or less will cause Mutt to never time out.
5048 # This variable allows you to specify where Mutt will place its temporary files
5049 # needed for displaying and composing messages. If this variable is not set, the
5050 # environment variable $TMPDIR is used. If $TMPDIR is not set then “/tmp” is
5060 # Controls the character used to indicate mail addressed to you. The first
5061 # character is the one used when the mail is not addressed to your address. The
5062 # second is used when you are the only recipient of the message. The third is
5063 # when your address appears in the “To:” header field, but you are not the only
5064 # recipient of the message. The fourth character is used when your address is
5065 # specified in the “Cc:” header field, but you are not the only recipient. The
5066 # fifth character is used to indicate mail that was sent by you. The sixth
5067 # character is used to indicate when a mail was sent to a mailing-list you
5077 # If set, this variable specifies the path of the trash folder where the mails
5078 # marked for deletion will be moved, instead of being irremediably purged.
5080 # NOTE: When you delete a message in the trash folder, it is really deleted, so
5081 # that you have a way to clean the trash.
5085 # 3.350. ts_icon_format
5088 # Default: “M%?n?AIL&ail?”
5090 # Controls the format of the icon title, as long as “$ts_enabled” is set. This
5091 # string is identical in formatting to the one used by “$status_format”.
5100 # Controls whether mutt tries to set the terminal status line and icon name. Most
5101 # terminal emulators emulate the status line in the window title.
5106 # 3.352. ts_status_format
5109 # Default: “Mutt with %?m?%m messages&no messages?%?n? [%n NEW]?”
5111 # Controls the format of the terminal status line (or window title), provided
5112 # that “$ts_enabled” has been set. This string is identical in formatting to the
5113 # one used by “$status_format”.
5115 set ts_status_format="mutt: %f%?V?[%V]&?"
5123 # Setting this variable will cause mutt to open a pipe to a command instead of a
5124 # raw socket. You may be able to use this to set up preauthenticated connections
5125 # to your IMAP/POP3/SMTP server. Example:
5127 # set tunnel="ssh -q mailhost.net /usr/local/libexec/imapd"
5129 # Note: For this example to work you must be able to log in to the remote machine
5130 # without having to enter a password.
5132 # When set, Mutt uses the tunnel for all remote connections. Please see “
5133 # account-hook” in the manual for how to use different tunnel commands per
5138 # 3.354. uncollapse_jump
5143 # When set, Mutt will jump to the next unread message, if any, when the current
5144 # thread is uncollapsed.
5148 # 3.355. uncollapse_new
5153 # When set, Mutt will automatically uncollapse any collapsed thread that receives
5154 # a new message. When unset, collapsed threads will remain collapsed. the
5155 # presence of the new message will still affect index sorting, though.
5159 # 3.356. use_8bitmime
5164 # Warning: do not set this variable unless you are using a version of sendmail
5165 # which supports the -B8BITMIME flag (such as sendmail 8.8.x) or you may not be
5166 # able to send mail.
5168 # When set, Mutt will invoke $sendmail with the -B8BITMIME flag when sending
5169 # 8-bit messages to enable ESMTP negotiation.
5178 # When set, Mutt will qualify all local addresses (ones without the “@host”
5179 # portion) with the value of $hostname. If unset, no addresses will be qualified.
5183 # 3.358. use_envelope_from
5188 # When set, mutt will set the envelope sender of the message. If
5189 # $envelope_from_address is set, it will be used as the sender address. If unset,
5190 # mutt will attempt to derive the sender from the “From:” header.
5192 # Note that this information is passed to sendmail command using the -f command
5193 # line switch. Therefore setting this option is not useful if the $sendmail
5194 # variable already contains -f or if the executable pointed to by $sendmail
5195 # doesn't support the -f switch.
5197 set use_envelope_from=yes
5205 # When set, Mutt will generate the “From:” header field when sending messages. If
5206 # unset, no “From:” header field will be generated unless the user explicitly
5207 # sets one using the “my_hdr” command.
5216 # When set, Mutt will look for IPv6 addresses of hosts it tries to contact. If
5217 # this option is unset, Mutt will restrict itself to IPv4 addresses. Normally,
5218 # the default should work.
5227 # When set, mutt will add a “User-Agent:” header to outgoing messages, indicating
5228 # which version of mutt was used for composing them.
5237 # Specifies the visual editor to invoke when the “~v” command is given in the
5247 # Controls whether Mutt will ask you to press a key after an external command has
5248 # been invoked by these functions: <shell-escape>, <pipe-message>, <pipe-entry>,
5249 # <print-message>, and <print-entry> commands.
5251 # It is also used when viewing attachments with “auto_view”, provided that the
5252 # corresponding mailcap entry has a needsterminal flag, and the external program
5255 # When set, Mutt will always ask for a key. When unset, Mutt will wait for a key
5256 # only if the external command returned a non-zero status.
5266 # When set, mutt will weed headers when displaying, forwarding, printing, or
5267 # replying to messages.
5276 # When set to a positive value, mutt will wrap text at $wrap characters. When set
5277 # to a negative value, mutt will wrap text so that there are $wrap characters of
5278 # empty space on the right side of the terminal. Setting it to zero makes mutt
5279 # wrap at the terminal width.
5281 # Also see $reflow_wrap.
5283 set wrap=$reflow_wrap
5286 # 3.366. wrap_headers
5291 # This option specifies the number of characters to use for wrapping an outgoing
5292 # message's headers. Allowed values are between 78 and 998 inclusive.
5294 # Note: This option usually shouldn't be changed. RFC5233 recommends a line
5295 # length of 78 (the default), so please only change this setting when you know
5296 # what you're doing.
5300 # 3.367. wrap_search
5305 # Controls whether searches wrap around the end.
5307 # When set, searches will wrap around the first (or last) item. When unset,
5308 # incremental searches will not wrap.
5317 # (DEPRECATED) Equivalent to setting $wrap with a negative value.
5326 # Controls whether mutt writes out the “Bcc:” header when preparing messages to
5327 # be sent. Exim users may wish to unset this. If mutt is set to deliver directly
5328 # via SMTP (see $smtp_url), this option does nothing: mutt will never write out
5329 # the “Bcc:” header in this case.
5338 # When writing a mailbox, a message will be printed every $write_inc messages to
5339 # indicate progress. If set to 0, only a single message will be displayed before
5340 # writing a mailbox.
5342 # Also see the $read_inc, $net_inc and $time_inc variables and the “tuning”
5343 # section of the manual for performance considerations.
5346 # vim:sw=12:noet:sts=12:ts=12:ft=muttrc