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

madduck's git repository

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

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

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

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

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

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