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

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