Pager Options#
$allow_ansi#
- Description:
Allow ANSI color codes in rich text messages
- Type:
- Default:
set allow_ansi = no
Controls whether ANSI color codes in messages (and color tags in rich text messages) are to be interpreted. Messages containing these codes are rare, but if this option is set, their text will be colored accordingly. Note that this may override your color choices, and even present a security problem, since a message could include a line like:
[-- PGP output follows ...
and give it the same color as your attachment color
See also
$display_filter#
- Description:
External command to pre-process an email before display
- Type:
- Default:
(empty)
set display_filter = ""
When set, specifies a command used to filter messages.
When a message is viewed it is passed as standard input to $display_filter, and the filtered message is read from the standard output.
When preparing the message, NeoMutt inserts some escape sequences into the text.
They are of the form: <esc>]9;XXX<bel> where “XXX” is a random 64-bit number.
If these escape sequences interfere with your filter, they can be removed using a tool like ansifilter or sed 's/^\x1b]9;[0-9]\+\x7//'
If they are removed, then PGP and MIME headers will no longer be coloured.
This can be fixed by adding this to your config:
color body magenta default '^\[-- .* --\]$'.
$header_color_partial#
- Description:
Only color the part of the header matching the regex
- Type:
- Default:
set header_color_partial = no
When set, color header regexes behave like color body regexes: color is applied to the exact text matched by the regex. When unset, color is applied to the entire header.
One use of this option might be to apply color to just the header labels.
See also
$markers#
- Description:
Display a
+at the beginning of wrapped lines in the pager- Type:
- Default:
set markers = yes
Controls the display of wrapped lines in the internal pager.
If set, a + marker is displayed at the beginning of wrapped lines.
See also
$pager#
- Description:
External command for viewing messages, or empty to use NeoMutt’s
- Type:
- Default:
(empty)
set pager = ""
Specify which pager to use for viewing messages. When empty, NeoMutt will use the built-in pager, otherwise this option should specify the pathname of the external pager you would like to use.
Using an external pager may have some disadvantages: Additional keystrokes are necessary because you can’t call NeoMutt functions directly from the pager, and screen resizes cause lines longer than the screen width to be badly formatted in the help menu.
$pager_context#
- Description:
Number of lines of overlap when changing pages in the pager
- Type:
- Notes:
- Default:
set pager_context = 0
Control the number of lines of context given when displaying the next or previous page in the internal pager. By default, NeoMutt will display the line after the last one on the screen at the top of the next page (0 lines of context).
Also specify the amount of context given for search results. If positive, this many lines will be given before a match, if 0, the match will be top-aligned.
$pager_format#
- Description:
Format string for the Pager Dialog’s status bar
- Type:
- Notes:
- Default:
set pager_format = "-%Z- %C/%m: %-20.20n %s%* -- (%P)"
- Alternative:
set pager_format = "-%{combined-flags}- %{number}/%{message-count}: %-20.20{name} %{subject}%{padding-soft: } -- (%{percentage})"
Specify the format of the data displayed in the Pager Dialog’s status bar.
See also
$index_formatfor a full list of expandosExpandos: Tutorial Conditional, Howto Conditional, Formatting, Reference
$pager_index_lines#
- Description:
Number of index lines to display above the pager
- Type:
- Notes:
- Default:
set pager_index_lines = 0
Determines the number of lines of a mini-index which is shown when in the pager. The current message, unless near the top or bottom of the folder, will be roughly one third of the way down this mini-index, giving the reader the context of a few messages before and after the message. This is useful, for example, to determine how many messages remain to be read in the current thread. A value of 0 results in no index being shown.
$pager_read_delay#
- Description:
Number of seconds to wait before marking a message read
- Type:
- Notes:
- Default:
set pager_read_delay = 0
Determines the number of seconds that must elapse after first opening a new message in the pager before that message will be marked as read.
A value of 0 results in the message being marked read unconditionally; for other values, navigating to another message or exiting the pager before the timeout will leave the message marked unread.
This setting is ignored if $pager is set.
$pager_skip_quoted_context#
- Description:
Lines of context to show when skipping quoted text
- Type:
- Notes:
- Default:
set pager_skip_quoted_context = 0
Determines the number of lines of context to show before the unquoted text when using <skip-quoted>.
When set to a positive number at most that many lines of the previous quote are displayed.
If the previous quote is shorter the whole quote is displayed.
$pager_stop#
- Description:
Don’t automatically open the next message when at the end of a message
- Type:
- Default:
set pager_stop = no
When set, the internal-pager will not move to the next message when you are at the end of a message and invoke <next-page>.
$prompt_after#
- Description:
Pause after running an external pager
- Type:
- Default:
set prompt_after = yes
If you use an external $pager, setting this option will cause NeoMutt to prompt you for a command when the pager exits rather than returning to the index menu.
If unset, NeoMutt will return to the index menu when the external pager exits.
$search_context#
- Description:
Context to display around search matches
- Type:
- Notes:
- Default:
set search_context = 0
For the pager, this option specifies the number of lines shown before search results. By default, search results will be top-aligned.
$smart_wrap#
- Description:
Wrap text at word boundaries
- Type:
- Default:
set smart_wrap = yes
Controls the display of lines longer than the screen width in the internal pager. If set, long lines are wrapped at a word boundary. If unset, lines are simply wrapped at the screen edge.
See also
$smileys#
- Description:
Regex to match smileys to prevent mistakes when quoting text
- Type:
- Notes:
- Default:
set smileys = "(>From )|(:[-^]?[][)(><}{|/DP])"
The pager uses this option to catch some common false positives of $quote_regex, most notably smileys and not consider a line quoted text if it also matches $smileys.
This mostly happens at the beginning of a line.
$tilde#
- Description:
Display
~in the pager after the end of the email- Type:
- Default:
set tilde = no
When set, the internal-pager will pad blank lines to the bottom of the screen with a tilde (~).
See also
$toggle_quoted_show_levels#
- Description:
Number of quote levels to show with toggle-quoted
- Type:
- Notes:
- Default:
set toggle_quoted_show_levels = 0
Quoted text may be filtered out using the <toggle-quoted> command.
If set to a number greater than 0, then the <toggle-quoted> command will only filter out quote levels above this number.