Config Options#
This section is a reference list of NeoMutt configuration options: what they are called, what they do.
If you’re new to configuration, you may find it helpful to first read about:
These pages explain how these settings work and how to apply them.
Address Alias Attach Autocrypt Browser Compose Conn Email General Gui Hcache History Hooks Imap Index Maildir Mbox Menu Mh Ncrypt Nntp Notmuch Pager Pattern Pop Progress Send Sidebar
A#
Config Option |
Description |
|---|---|
Hitting backspace against an empty prompt aborts the prompt |
|
String representation of key to abort prompts |
|
Abort sending the email if attachments are missing |
|
Regex to match text indicating attachments are expected |
|
|
Renamed to: |
Abort creating the email if subject is missing |
|
Abort the sending if the message hasn’t been edited |
|
Shell command to retrieve account credentials |
|
Save new aliases to this file |
|
Format string for the Alias Dialog |
|
Sort method for the Alias Dialog |
|
Allow 8-bit messages, don’t use quoted-printable or base64 |
|
Allow ANSI color codes in rich text messages |
|
Use an arrow |
|
Use a custom string for |
|
Use plain ASCII characters, when drawing email threads |
|
|
Renamed to: |
|
Renamed to: |
Ask the user for the blind-carbon-copy recipients |
|
Ask the user for the carbon-copy recipients |
|
Ask the user for follow-up groups before editing |
|
|
Renamed to: |
Ask the user for the |
|
If a message is missing a character set, assume this character set |
|
When attaching files, use one of these character sets |
|
Format string for the Attach Dialog |
|
|
Renamed to: |
Default directory where attachments are saved |
|
If true, then don’t prompt to save |
|
Separator to add between saved/printed/piped attachments |
|
Save/print/pipe tagged messages individually |
|
|
Renamed to: |
Message to start a reply, “On DATE, PERSON wrote:” |
|
Locale for dates in the |
|
Suffix message to add after reply text |
|
Enables the Autocrypt feature |
|
Format string for the Autocrypt Account Dialog |
|
Location of Autocrypt files, including the GPG keyring and SQLite database |
|
Replying to an Autocrypt email automatically enables Autocrypt in the reply |
|
|
Renamed to: |
Skip the initial compose menu and edit the email |
|
Automatically check if the user is subscribed to a mailing list |
|
Automatically apply actions to all tagged messages |
B#
Config Option |
Description |
|---|---|
Make a noise when an error occurs |
|
Make a noise when new mail arrives |
|
Confirm before bouncing a message |
|
Add |
|
Move the cursor to the beginning of the line |
|
Abbreviate mailboxes using |
|
Sort method for the browser |
|
Group directories before files in the browser |
C#
Config Option |
Description |
|---|---|
Mark all articles as read when leaving a newsgroup |
|
File containing trusted certificates |
|
Suggest the next folder, rather than the first when using |
|
Default character set for displaying text on screen |
|
Use mailbox size as an indicator of new mail |
|
Check for new mail while the mailbox is open |
|
Collapse all threads when entering a folder |
|
Prevent the collapse of threads with flagged emails |
|
Prevent the collapse of threads with unread emails |
|
Use 24bit colors (aka truecolor or directcolor) |
|
Prevent the accidental deletion of the composed message |
|
Format string for the Compose Dialog’s status bar |
|
Show the message preview above the attachments list. By default it is shown below it. |
|
Hide the preview if it has fewer than this number of rows |
|
Display a preview of the message body in the Compose Dialog |
|
Controls whether or not custom headers are shown in the compose envelope |
|
Character set that the config files are in |
|
|
Renamed to: |
|
Renamed to: |
Confirm before appending emails to a mailbox |
|
Confirm before creating a new mailbox |
|
Ask for a confirmation before sending an email with an empty |
|
|
Renamed to: |
Default |
|
Save outgoing emails to |
|
Controls whether to weed headers when copying or saving emails |
|
Recurse inside |
|
|
Renamed to: |
|
Renamed to: |
|
Renamed to: |
|
Renamed to: |
Automatically PGP encrypt all outgoing mail |
|
Allow automatic PGP functions |
|
Automatically PGP sign all outgoing mail |
|
Allow automatic SMIME functions |
|
User-configurable crypto flags: signed, encrypted etc. |
|
|
Renamed to: |
Prompt the user to confirm keys before use |
|
Add an informative block with details about the encryption |
|
Enable encryption when the recipient’s key is available |
|
Enable encryption only when strong a key is available |
|
Display protected headers (Memory Hole) in the pager |
|
Save the cleartext |
|
Use this as the subject for encrypted emails |
|
Controls whether NeoMutt will weed protected header fields |
|
Generate protected header (Memory Hole) for signed and encrypted emails |
|
|
Renamed to: |
|
Renamed to: |
|
Renamed to: |
Encrypt replies to encrypted messages |
|
Sign replies to signed messages |
|
Sign replies to encrypted messages |
|
Add a timestamp to PGP or SMIME output to prevent spoofing |
|
Use GPGME crypto backend |
|
Use GPGME to use PKA (lookup PGP keys using DNS) |
|
Verify PGP or SMIME signatures |
|
|
Deprecated |
D#
Config Option |
Description |
|---|---|
|
|
File to save debug logs |
|
Logging level for debug logs |
|
Pattern to use for hooks that only have a simple regex |
|
Really delete messages, when the mailbox is closed |
|
Untag messages when they are marked for deletion |
|
Devel feature: Security – Issue #4251 |
|
Hide the subparts of a multipart/digest |
|
External command to pre-process an email before display |
|
Request notification for message delivery or delay |
|
What to send as a notification of message delivery or delay |
|
Highlight messages with duplicated message IDs |
E#
Config Option |
Description |
|---|---|
External command to use as an email editor |
|
|
Renamed to: |
Let the user edit the email headers whilst editing an email |
|
Subject to use when replying to an email with none |
|
Encode |
|
File/device containing random data to initialise SSL |
|
|
Renamed to: |
Manually set the sender for outgoing messages |
|
|
Deprecated |
External search command |
F#
Config Option |
Description |
|---|---|
Don’t prompt for the recipients and subject when replying/forwarding |
|
Save sent message with all their attachments |
|
Save FCCs before sending the message |
|
Save sent messages unencrypted and unsigned |
|
User-configurable index flags: tagged, new, etc |
|
Protect flagged messages from deletion |
|
Base folder for a set of mailboxes |
|
Format string for the Browser Dialog’s display of folders |
|
Add the |
|
Reply to the poster if “poster” is in the |
|
Save outgoing mail in a folder of their name |
|
Forward attachments when forwarding a message |
|
Prefix message for forwarded messages |
|
Suffix message for forwarded messages |
|
Decode the message when forwarding it |
|
Decrypt the message when forwarding it |
|
Automatically start the editor when forwarding a message |
|
Format string to control the subject when forwarding a message |
|
Automatically quote a forwarded message using |
|
Set the |
|
|
Renamed to: |
|
Renamed to: |
|
Renamed to: |
|
Renamed to: |
Default |
|
User-configurable index flags: to address, cc address, etc |
G#
Config Option |
Description |
|---|---|
Regex for parsing GECOS field of |
|
Greeting string added to the top of all messages |
|
Format string for the Browser Dialog’s display of newsgroups |
H#
Config Option |
Description |
|---|---|
Add custom headers to outgoing mail |
|
|
Renamed to: |
Include the message headers in the reply email (Weed applies) |
|
Directory/file for the header cache database |
|
Header cache backend to use |
|
|
Deprecated |
Level of compression for method |
|
Enable generic hcache database compression |
|
|
Deprecated |
Only color the part of the header matching the regex |
|
Display a help line with common key bindings |
|
Don’t use the hostname, just the domain, when generating the message id |
|
List of tags that shouldn’t be displayed on screen (comma-separated) |
|
Don’t indicate hidden messages, in the thread tree |
|
Don’t indicate missing messages, in the thread tree |
|
Hide subjects that are similar to that of the parent message |
|
Don’t indicate hidden top message, in the thread tree |
|
Don’t indicate missing top message, in the thread tree |
|
Number of history entries to keep in memory per category |
|
File to save history in |
|
Format string for the History Dialog |
|
Remove duplicate entries from the history |
|
Don’t display MIME parts inline if they have a disposition of “attachment” |
|
Honour the |
|
Fully-qualified domain name of this machine |
I#
Config Option |
Description |
|---|---|
Decode international domain names |
|
Encode international domain names |
|
|
Deprecated |
Ignore the |
|
List of allowed IMAP authentication methods (colon-separated) |
|
When opening a mailbox, ask the server for a list of subscribed folders |
|
Enable the |
|
Compress network traffic |
|
Characters that denote separators in IMAP folders |
|
Download headers in blocks of this size |
|
Additional email headers to download when getting index |
|
Use the IMAP |
|
|
Renamed to: |
Time to wait before polling an open IMAP connection |
|
When browsing a mailbox, only display subscribed folders |
|
Login name for the IMAP server (defaults to |
|
External command to generate |
|
Password for the IMAP server |
|
Reuse an existing IMAP connection to check for new mail |
|
Don’t mark messages as read when fetching them from the server |
|
Number of IMAP commands that may be queued up |
|
Maximum time to wait for a server response |
|
Enable the |
|
Use the IMAP |
|
Send ID command when logging in |
|
|
Renamed to: |
Display server warnings as error messages |
|
Username for the IMAP server |
|
|
Renamed to: |
Display MIME attachments inline if a |
|
Include a copy of the email that’s being replied to |
|
Whether to include encrypted content when replying |
|
|
Renamed to: |
Only include the first attachment when replying |
|
|
Renamed to: |
String used to indent “reply” text |
|
Format string for the Index Dialog (emails) |
|
External command to post news articles |
|
External command to perform spell-checking |
K#
Config Option |
Description |
|---|---|
Don’t move flagged messages from |
L#
Config Option |
Description |
|---|---|
Convert the date in the Date header of sent emails into local timezone, UTC otherwise |
M#
Config Option |
Description |
|---|---|
Format string for the Browser Dialog’s display of mailbox folders |
|
List of mailcap files (colon-separated) |
|
Restrict the possible characters in mailcap expandos |
|
Check both |
|
Field delimiter to be used for maildir email files (default is colon, recommended alternative is semi-colon) |
|
Check for maildir changes when opening mailbox |
|
Use the maildir |
|
Number of seconds before NeoMutt checks for new mail |
|
Notify the user about new mail since the last time the mailbox was opened |
|
Periodically check for new mail |
|
How often to check for new mail |
|
Display a |
|
Prefix for macros using |
|
Mark new emails as old when leaving the mailbox |
|
Only display files/dirs matching this regex in the browser |
|
Folder that receives read emails |
|
Default type for creating new mailboxes |
|
Number of lines of overlap when changing pages in the index |
|
Allow the last menu item to move off the bottom of the screen |
|
Scroll the menu/index by one line, rather than a page |
|
|
Renamed to: |
Clean out obsolete entries from the message cache |
|
Directory for the message cache |
|
Format string for listing attached messages |
|
Format string for customising the |
|
Interpret ‘ALT-x’ as ‘ESC-x’ |
|
|
Renamed to: |
Remove the user’s address from the list of recipients |
|
Really delete files in MH mailboxes |
|
MH sequence for flagged message |
|
MH sequence to tag replied messages |
|
MH sequence for unseen messages |
|
Forward a message as a |
|
Decode the forwarded message before attaching it |
|
Forward all attachments, even if they can’t be decoded |
|
|
Renamed to: |
|
Deprecated |
External command to determine the MIME type of an attachment |
|
Run the |
|
|
Deprecated |
|
Deprecated |
Move emails from |
|
|
Renamed to: |
N#
Config Option |
Description |
|---|---|
Draw a narrower thread tree in the index |
|
Update the progress bar after this many KB sent/received (0 to disable) |
|
Character set of newsgroups’ descriptions |
|
File containing list of subscribed newsgroups |
|
Directory for cached news articles |
|
URL of the news server |
|
External command to run when new mail arrives |
|
Configuration file for notmuch. Use |
|
Configuration profile for notmuch. |
|
Default limit for Notmuch queries |
|
|
Renamed to: |
Path to the Notmuch database |
|
Exclude messages with these tags |
|
Tag to use for flagged messages |
|
Database timeout |
|
Default query type: |
|
Position of current search window |
|
Current search parameters |
|
Time duration of the current search window |
|
Enable query windows |
|
Additional notmuch search terms for messages to be shown regardless of date |
|
Units for the time duration |
|
If the |
|
Tags to apply to the |
|
Tag to use for replied messages |
|
Tag to use for unread messages |
|
Allowed authentication methods |
|
Maximum number of articles to list (0 for all articles) |
|
Check all articles when opening a newsgroup |
|
Load descriptions for newsgroups when adding to the list |
|
Password for the news server |
|
Interval between checks for new posts |
|
Username for the news server |
P#
Config Option |
Description |
|---|---|
External command for viewing messages, or empty to use NeoMutt’s |
|
Number of lines of overlap when changing pages in the pager |
|
Format string for the Pager Dialog’s status bar |
|
Number of index lines to display above the pager |
|
Number of seconds to wait before marking a message read |
|
Lines of context to show when skipping quoted text |
|
Don’t automatically open the next message when at the end of a message |
|
Format string for the Pattern Completion Dialog |
|
|
Renamed to: |
|
Renamed to: |
|
Renamed to: |
Automatically decrypt PGP messages |
|
Use old-style inline PGP messages (not recommended) |
|
|
Renamed to: |
Check the exit code of PGP subprocess |
|
File descriptor used for status info |
|
|
Renamed to: |
External command to inline-sign a message |
|
|
Renamed to: |
External command to decode a PGP attachment |
|
Text indicating a successful decryption |
|
External command to decrypt a PGP message |
|
Default key to use for PGP operations |
|
External command to encrypt, but not sign a message |
|
|
Deprecated |
External command to encrypt and sign a message |
|
Format string for the PGP Key Dialog |
|
External command to export a public key from the user’s keyring |
|
|
Renamed to: |
External command to download a key for an email address |
|
Text indicating a good signature |
|
Only use the principal PGP key |
|
External command to import a key into the user’s keyring |
|
Sort order for PGP keys |
|
External command to list the public keys in a user’s keyring |
|
External command to list the private keys in a user’s keyring |
|
Display long PGP key IDs to the user |
|
Prompt the user to use MIME if inline PGP fails |
|
|
Renamed to: |
|
Renamed to: |
|
Renamed to: |
|
Renamed to: |
Reply using old-style inline PGP messages (not recommended) |
|
Create nested multipart/signed or encrypted messages |
|
Encrypted messages will also be encrypted to |
|
|
Renamed to: |
Show non-usable keys in the key selection |
|
Use this alternative key for signing messages |
|
External command to create a detached PGP signature |
|
|
Renamed to: |
Encode PGP signed messages with quoted-printable (don’t unset) |
|
Time in seconds to cache a passphrase |
|
Use a PGP agent for caching passwords |
|
External command to verify PGP signatures |
|
External command to verify key information |
|
|
Renamed to: |
Decode the message when piping it |
|
Control whether to weed headers when piping an email |
|
Separator to add between multiple piped messages |
|
Run the pipe command on each message separately |
|
List of allowed authentication methods (colon-separated) |
|
Try all available authentication methods |
|
|
Renamed to: |
Interval between checks for new mail |
|
After downloading POP messages, delete them on the server |
|
URL of the POP server |
|
Use the |
|
External command to generate OAUTH refresh token |
|
Password of the POP server |
|
Reconnect to the server is the connection is lost |
|
Username of the POP server |
|
Save messages to the |
|
Folder to store postponed messages |
|
Self-encrypt postponed messages |
|
Fallback encryption key for postponed messages |
|
|
Renamed to: |
|
Renamed to: |
Allow posting to moderated newsgroups |
|
External command to run prior to opening a socket |
|
List of Preferred Languages for multilingual MIME (comma-separated) |
|
Confirm before printing a message |
|
|
Renamed to: |
External command to print a message |
|
Decode message before printing it |
|
Control whether to weed headers when printing an email |
|
Print multiple messages separately |
|
Pause after running an external pager |
Q#
Config Option |
Description |
|---|---|
External command to query an external address book |
|
Format string for the Query Dialog (address book) |
|
Prompt before exiting NeoMutt |
|
Regex to match quoted text in a reply |
|
|
Renamed to: |
R#
Config Option |
Description |
|---|---|
Update the progress bar after this many records read (0 to disable) |
|
Open folders in read-only mode |
|
|
Renamed to: |
Real name of the user |
|
Recall postponed mesaages when asked to compose a message |
|
Folder to save ‘sent’ messages |
|
Insert spaces into reply quotes for |
|
Reformat paragraphs of |
|
Maximum paragraph width for reformatting |
|
Regex to match message reply subjects like |
|
|
Renamed to: |
Really reply to yourself, when replying to your own email |
|
Address to use as a |
|
Create |
|
Move to the next email whenever a command modifies an email |
|
Process draft files like postponed messages |
|
Resume editing previously saved draft files |
|
Display the alias in the index, rather than the message’s sender |
|
Set the |
|
|
Renamed to: |
Set the |
|
Decode RFC2047-encoded MIME parameters |
S#
Config Option |
Description |
|---|---|
Use sender’s full address as a default save folder |
|
Preserve empty mailboxes |
|
Number of history entries to save per category |
|
Save outgoing message to mailbox of recipient’s name if it exists |
|
Save a list of unsubscribed newsgroups to the |
|
Use message scoring |
|
Messages with a lower score will be automatically deleted |
|
Messages with a greater score will be automatically flagged |
|
Messages with a lower score will be automatically marked read |
|
Context to display around search matches |
|
External command to send email |
|
Time to wait for sendmail to finish |
|
Character sets for outgoing mail |
|
External command to run subshells in |
|
How to display |
|
Check for new newsgroups when entering the browser |
|
Only show subscribed newsgroups with unread articles |
|
Strip leading path components from sidebar folders |
|
Characters that separate nested folders |
|
Character to draw between the sidebar and index |
|
Indent nested folders |
|
Format string for the Sidebar |
|
Indent nested folders using this string |
|
Only show folders with new/flagged email |
|
Wrap around when searching for the next mailbox with new email |
|
Only show folders with a non-zero number of emails |
|
Display the sidebar on the right |
|
Abbreviate the paths using the |
|
Sort method for the Sidebar |
|
|
Renamed to: |
Show the Sidebar |
|
Width of the sidebar |
|
File containing a signature to append to all mail |
|
Insert |
|
Insert the signature before the quoted text |
|
Pattern to search for when search doesn’t contain |
|
Show smaller sizes in bytes |
|
Show size fractions with a single decimal place |
|
Show sizes in megabytes for sizes greater than 1 megabyte |
|
Show the units as a prefix to the size |
|
|
Renamed to: |
Time to pause after certain info messages |
|
Wrap text at word boundaries |
|
Regex to match smileys to prevent mistakes when quoting text |
|
Prompt the user for a label for SMIME certificates |
|
File containing trusted certificates |
|
File containing user’s public certificates |
|
External command to decrypt an SMIME message |
|
Use the default key for decryption |
|
Default key for SMIME operations |
|
External command to encrypt a message |
|
|
Deprecated |
Algorithm for encryption |
|
External command to extract a certificate from a message |
|
External command to get a certificate for an email |
|
External command to extract a certificate from an email |
|
External command to import a certificate |
|
Use SMIME rather than PGP by default |
|
File containing user’s private certificates |
|
External command to extract a public certificate |
|
Encrypted messages will also be encrypt to |
|
|
Renamed to: |
Use this alternative key for signing messages |
|
External command to sign a message |
|
Digest algorithm |
|
Time in seconds to cache a passphrase |
|
External command to verify a signed message |
|
External command to verify a signature |
|
List of allowed authentication methods (colon-separated) |
|
External command to generate OAUTH refresh token |
|
Password for the SMTP server |
|
URL of the SMTP server |
|
Username for the SMTP server |
|
Timeout for socket connect/read/write operations (-1 to wait indefinitely) |
|
Sort method for the Index Dialog |
|
|
Renamed to: |
Secondary sort method for the Index |
|
|
Renamed to: |
Whether |
|
Separator for multiple spam headers |
|
|
Renamed to: |
Inbox |
|
File containing trusted CA certificates |
|
Ciphers to use when using SSL |
|
File containing client certificates |
|
Require TLS encryption for all connections |
|
Minimum keysize for Diffie-Hellman key exchange |
|
Use STARTTLS on servers advertising the capability |
|
|
Renamed to: |
|
Deprecated |
|
Deprecated |
Use CA certificates in the system-wide store |
|
|
Deprecated |
|
Deprecated |
Use TLSv1.2 for authentication |
|
Use TLSv1.3 for authentication |
|
Verify the dates on the server certificate |
|
Verify the server’s hostname against the certificate |
|
Allow verification using partial certificate chains |
|
Indicator characters for the status bar |
|
Format string for the Index Dialog’s status bar |
|
Display the status bar at the top |
|
Thread messages using |
|
Allow the user to suspend NeoMutt using |
T#
Config Option |
Description |
|---|---|
Generate |
|
Decode headers and messages before searching them |
|
Sort threaded messages by their received date |
|
Display |
|
Time to wait for user input in menus |
|
Frequency of progress bar updates (milliseconds) |
|
|
Renamed to: |
Directory for temporary files |
|
Directory for Compose temporary files |
|
Number of quote levels to show with toggle-quoted |
|
Indicator characters for the |
|
Folder to put deleted emails |
|
Allow NeoMutt to set the terminal status line and icon |
|
Format string for the Terminal’s icon title |
|
Format string for the Terminal’s status (window title) |
|
Shell command to establish a tunnel |
|
Assume a tunneled connection is secure |
U#
Config Option |
Description |
|---|---|
When opening a thread, jump to the next unread message |
|
Open collapsed threads when new mail arrives |
|
Add a |
|
|
Renamed to: |
Use 8-bit messages and ESMTP to send messages |
|
Qualify local addresses using this domain |
|
Set the envelope sender of the message |
|
Set the |
|
Lookup IPv6 addresses when making connections |
|
Whether to use threads for the index |
V#
Config Option |
Description |
|---|---|
|
Deprecated |
|
Renamed to: |
Use the first virtual mailbox as a spool file |
|
|
Deprecated |
W#
Config Option |
Description |
|---|---|
Prompt to press a key after running external commands |
|
Filter headers when displaying/forwarding/printing/replying |
|
Width to wrap text in the pager |
|
Width to wrap headers in outgoing messages |
|
Wrap around when the search hits the end |
|
Write out the |
|
Update the progress bar after this many records written (0 to disable) |
X#
Config Option |
Description |
|---|---|
|
Renamed to: |
|
Renamed to: |
|
Renamed to: |
Add |