.\" Generated by scdoc 1.11.3
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "AERC" "1" "2025-08-29"
.PP
.SH NAME
.PP
aerc - a pretty good email client.\&
.PP
.SH SYNOPSIS
.PP
\fBaerc\fR [\fB-h\fR] [\fB-v\fR] [\fB-a\fR \fI<name>\fR] [\fB-C\fR \fI<file>\fR] [\fB-A\fR \fI<file>\fR] [\fB-B\fR
\fI<file>\fR] [\fB-I\fR] [\fBmailto:\fR\fI<.\&.\&.\&>\fR | \fBmbox:\fR\fI<file>\fR | :\fI<command.\&.\&.\&>\fR]
.PP
For a guided tutorial, use \fB:help tutorial\fR from aerc, or \fBman aerc-tutorial\fR
from your terminal.\&
.PP
.SH OPTIONS
.PP
\fB-h\fR, \fB--help\fR
.RS 4
Show aerc usage help and exit.\&
.PP
.RE
\fB-v\fR, \fB--version\fR
.RS 4
Print the installed version of aerc and exit.\&
.PP
.RE
\fB-a\fR \fI<name>\fR
.br
\fB--account\fR \fI<name>\fR
.RS 4
Load only the named account, as opposed to all configured accounts.\& It
can also be a comma separated list of names.\& This option may be
specified multiple times.\& The account order will be preserved.\&
.PP
.RE
\fB-C\fR \fI</path/to/aerc.\&conf>\fR
.br
\fB--aerc-conf\fR \fI</path/to/aerc.\&conf>\fR
.RS 4
Instead of using \fI$XDG_CONFIG_HOME/aerc/aerc.\&conf\fR use the file at the
specified path for configuring aerc.\&
.PP
.RE
\fB-A\fR \fI</path/to/accounts.\&conf>\fR
.br
\fB--accounts-conf\fR \fI</path/to/accounts.\&conf>\fR
.RS 4
Instead of using \fI$XDG_CONFIG_HOME/aerc/accounts.\&conf\fR use the file at the
specified path for configuring accounts.\&
.PP
.RE
\fB-B\fR \fI</path/to/binds.\&conf>\fR
.br
\fB--binds-conf\fR \fI</path/to/binds.\&conf>\fR
.RS 4
Instead of using \fI$XDG_CONFIG_HOME/aerc/binds.\&conf\fR use the file at the
specified path for configuring binds.\&
.PP
.RE
\fB-I\fR, \fB--no-ipc\fR
.RS 4
Run commands (\fBmailto:\fR\fI.\&.\&.\&\fR, \fB:\fR\fI<command.\&.\&.\&>\fR, \fBmbox:\fR\fI<file>\fR) directly
in this instance rather than over IPC in an existing aerc instance.\& Also
disable creation of an IPC server for subsequent aerc instances to
communicate with this one.\&
.PP
.RE
\fBmailto:\fR\fIaddress[,address][?\&query[&query]]\fR
.RS 4
Open the composer with the address(es) in the To field.\& These
addresses must not be percent encoded.\&
.PP
If aerc is already running (and IPC is not disabled), the composer is
started in that instance; otherwise a new instance is started with the
composer.\&
.PP
The following (optional) query parameters are supported:
.PP
.RE
.TS
allbox;l l
l l
l l
l l
l l
l l
l l
l l.
T{
\fBQuery\fR
T}	T{
\fBDescription\fR
T}
T{
\fIsubject=<text>\fR
T}	T{
Subject line will be completed with the \fI<text>\fR
T}
T{
\fIbody=<text>\fR
T}	T{
Message body will be completed with the \fI<text>\fR
T}
T{
\fIcc=<address>[,<address>]\fR
T}	T{
Cc header will be completed with the list of addresses
T}
T{
\fIbcc=<address>[,<address>]\fR
T}	T{
Bcc header will be completed with the list of addresses
T}
T{
\fIin-reply-to=<message-id>\fR
T}	T{
In-reply-to header will be set to the message id
T}
T{
\fIaccount=<accountname>\fR
T}	T{
Specify the account (must be in \fIaccounts.\&conf\fR; default is the selected account)
T}
T{
\fItemplate=<template-file>\fR
T}	T{
Template sets the template file for creating the message
T}
.TE
.sp 1
.RS 4
Note that reserved characters in the queries must be percent encoded.\&
.PP
.RE
\fB:\fR\fI<command.\&.\&.\&>\fR
.RS 4
Run an aerc-internal command as you would in Ex-Mode.\& See \fBRUNTIME
COMMANDS\fR below.\&
.PP
The command to be executed and its arguments can either be passed as
separate arguments in the shell (e.\&g.\&, \fIaerc :cmd arg1 arg2\fR) or as a single
argument in the shell (e.\&g.\&, \fIaerc ":cmd arg1 arg2"\fR).\& In the former case,
aerc may add quotes to the command before it is parsed in an attempt to
preserve arguments containing spaces and other special characters.\& In the
latter case, aerc will parse the command verbatim, as if it had been typed
directly on aerc'\&s command line.\& This latter form can be helpful for
commands that don'\&t interpret quotes in their arguments.\&
.PP
If aerc is already running (and IPC is not disabled), the command is run in
that instance; otherwise a new instance is started with the command.\&
.PP
.RE
\fBmbox:\fR\fI<file>\fR
.RS 4
Open the specified mbox file as a virtual temporary account.\&
.PP
If aerc is already running (and IPC is not disabled), the file is opened in
that instance; otherwise a new instance is started with the file.\&
.PP
.RE
.SH RUNTIME COMMANDS
.PP
To execute a command, press \fB:\fR to bring up the command interface.\& Commands may
also be bound to keys, see \fBaerc-binds\fR(5) for details.\& In some contexts, such
as the terminal emulator, \fB<c-x>\fR is used to bring up the command interface.\&
.PP
Different commands work in different contexts, depending on the kind of tab you
have selected.\&
.PP
Dynamic arguments are expanded following \fBaerc-templates\fR(7) depending on the
context.\& For example, if you have a message selected, the following command:
.PP
.nf
.RS 4
:filter -f "{{index (\&.From | emails) 0}}"
.fi
.RE
.PP
Will filter all messages sent by the same sender.\&
.PP
Aerc stores a history of commands, which can be cycled through in command mode.\&
Pressing the up key cycles backwards in history, while pressing down cycles
forwards.\&
.PP
.SS GLOBAL COMMANDS
.PP
These commands work in any context.\&
.PP
\fB:help\fR \fI<topic>\fR
.br
\fB:man\fR \fI<topic>\fR
.RS 4
Display one of aerc'\&s man pages in the embedded terminal.\&
.PP
.RE
\fB:help\fR \fBkeys\fR
.br
\fB:man\fR \fBkeys\fR
.RS 4
Display the active key bindings in the current context.\&
.PP
.RE
\fB:new-account\fR [\fB-t\fR]
.RS 4
Start the new account wizard.\&
.PP
\fB-t\fR: Create a temporary account.\& Do not modify \fIaccounts.\&conf\fR.\&
.PP
.RE
\fB:cd\fR \fI<directory>\fR
.RS 4
Changes aerc'\&s current working directory.\&
.PP
.RE
\fB:z\fR \fI<directory or zoxide query>\fR
.RS 4
Changes aerc'\&s current working directory using zoxide.\& If zoxide is not on
\fB$PATH\fR.\&, the command will not be registered.\&
.PP
.RE
\fB:change-tab\fR [\fB+\fR|\fB-\fR]\fI<tab name or index>\fR
.br
\fB:ct\fR [\fB+\fR|\fB-\fR]\fI<tab name or index>\fR
.RS 4
Changes the focus to the tab with the given name.\& If a number is given,
it'\&s treated as an index.\& If the number is prepended with \fB+\fR or \fB-\fR, the number
is interpreted as a delta from the selected tab.\& If only a \fB-\fR is given, changes
the focus to the previously selected tab.\&
.PP
.RE
\fB:exec\fR \fI<command>\fR
.RS 4
Executes an arbitrary command in the background.\& Aerc will set the
environment variables \fB$account\fR and \fB$folder\fR when the command is
executed from an Account tab or an opened message.\&
.PP
Note: commands executed in this way are not executed with the shell.\&
.PP
.RE
\fB:echo\fR \fI<string>\fR
.RS 4
Resolve templates in \fI<string>\fR and print it.\&
.PP
.RE
\fB:eml\fR [\fI<path>\fR]
.br
\fB:preview\fR [\fI<path>\fR]
.RS 4
Opens an eml file and displays the message in the message viewer.\&
.PP
Can also be used in the message viewer to open an rfc822 attachment or
in the composer to preview the message.\&
.PP
.RE
\fB:pwd\fR
.RS 4
Displays aerc'\&s current working directory in the status bar.\&
.PP
.RE
\fB:version\fR
.RS 4
Displays the version of the running aerc instance.\&
.PP
.RE
\fB:send-keys\fR \fI<keystrokes>\fR
.RS 4
Send keystrokes to the currently visible terminal, if any.\& Can be used to
control embedded editors to save drafts or quit in a safe manner.\&
.PP
Here'\&s an example of quitting a Vim-like editor:
.PP
.RS 4
\fB:send-keys\fR \fI<Esc>:wq!\&<Enter>\fR
.PP
.RE
Note: when used in \fIbinds.\&conf\fR (see \fBaerc-binds\fR(5)), angle brackets
need to be escaped in order to make their way to the command:
.PP
.RS 4
<C-q> = :send-keys \e<Esc\e>:wq!\&\e<Enter\e><Enter>
.PP
.RE
This way the \fI<Esc>\fR and the first \fI<Enter>\fR keystrokes are passed to
\fB:send-keys\fR, while the last \fI<Enter>\fR keystroke is executed directly,
committing the \fB:send-keys\fR command'\&s execution.\&
.PP
.RE
\fB:term\fR [\fI<command>.\&.\&.\&\fR]
.br
\fB:terminal\fR [\fI<command>.\&.\&.\&\fR]
.RS 4
Opens a new terminal tab with a shell running in the current working
directory, or the specified command.\&
.PP
.RE
\fB:move-tab\fR [\fI+\fR|\fI-\fR]\fI<index>\fR
.RS 4
Moves the selected tab to the given index.\& If \fI+\fR or \fI-\fR is specified, the
number is interpreted as a delta from the selected tab.\&
.PP
.RE
\fB:prev-tab\fR [\fI<n>\fR]
.br
\fB:next-tab\fR [\fI<n>\fR]
.RS 4
Cycles to the previous or next tab in the list, repeating \fI<n>\fR times
(default: \fI1\fR).\&
.PP
.RE
\fB:pin-tab\fR
.RS 4
Moves the current tab to the left of all non-pinned tabs and displays
the \fBpinned-tab-marker\fR (default: \fI`\fR) to the left of the tab title.\&
.PP
.RE
\fB:unpin-tab\fR
.RS 4
Removes the \fBpinned-tab-marker\fR from the current tab and returns the tab
to its previous location.\&
.PP
.RE
\fB:prompt\fR \fI<prompt>\fR \fI<command>.\&.\&.\&\fR
.RS 4
Displays the prompt on the status bar, waits for user input, then appends
that input as the last argument to the command and executes it.\& The input is
passed as one argument to the command, unless it is empty, in which case no
extra argument is added.\&
.PP
.RE
\fB:menu\fR [\fB-c\fR \fI"<shell-cmd>"\fR] [\fB-e\fR] [\fB-b\fR] [\fB-a\fR] [\fB-d\fR] [\fB-t\fR \fI"<title>"\fR]
\fI<aerc-cmd .\&.\&.\&>\fR
.RS 4
Opens a popover dialog running \fIsh -c "<shell-cmd>"\fR (if not specified
\fB[general].\&default-menu-cmd\fR will be used).\& When the command exits, all
lines printed on its standard output will be appended to \fI<aerc-cmd .\&.\&.\&>\fR
and executed as a standard aerc command like \fBxargs\fR(1) would do when
used in a shell.\& A colon (\fB:\fR) prefix is supported for \fI<aerc-cmd .\&.\&.\&>\fR
but is not required.\&
.PP
\fB:menu\fR can be used without an external program by setting \fI<shell-cmd>\fR
to \fI-\fR.\& This also acts as a fallback in case where no \fI<shell-cmd>\fR was
specified at all or the executable in the \fI<shell-cmd>\fR was not found.\&
.PP
\fB-c\fR \fI"<shell-cmd>"\fR
.RS 4
Override \fB[general].\&default-menu-cmd\fR.\& See \fBaerc-config\fR(5) for
more details.\&
.PP
.RE
\fB-e\fR: Stop executing commands on the first error.\&
.PP
\fB-b\fR: Do \fBNOT\fR spawn the popover dialog.\& Start the commands in the
background (\fBNOT\fR in a virtual terminal).\& Use this if \fI<shell-cmd>\fR is
a graphical application that does not need a terminal.\&
.PP
\fB-t\fR: Override the dialog title (otherwise derived from \fI<shell-cmd>\fR)
.PP
\fI<shell-cmd>\fR may be fed with input text using the following flags:
.RS 4
\fB-a\fR: All account names, one per line.\& E.\&g.\&:
.PP
.RS 4
\&'\&<account>'\& LF
.PP
.RE
\fB-d\fR: All current account directory names, one per line.\& E.\&g.\&:
.PP
.RS 4
\&'\&<directory>'\& LF
.PP
.RE
\fB-ad\fR: All directories of all accounts, one per line.\& E.\&g.\&:
.PP
.RS 4
\&'\&<account>'\& '\&<directory>'\& LF
.PP
.RE
Quotes may be added by aerc when either tokens contain special
characters.\& The quotes should be preserved for \fI<aerc-cmd .\&.\&.\&>\fR.\&
.PP
.RE
Examples:
.PP
.nf
.RS 4
:menu -adc fzf :cf -a
:menu -c \&'fzf --multi\&' :attach
:menu -dc \&'fzf --multi\&' :cp
:menu -bc \&'dmenu -l 20\&' :cf
:menu -c \&'ranger --choosefiles=%f\&' :attach
.fi
.RE
.PP
This may also be used in key bindings (see \fBaerc-binds\fR(5)):
.PP
.nf
.RS 4
<C-p> = :menu -adc fzf :cf -a<Enter>
.fi
.RE
.PP
.RE
\fB:choose\fR \fB-o\fR \fI<key>\fR \fI<text>\fR \fI<command>\fR [\fB-o\fR \fI<key>\fR \fI<text>\fR \fI<command>\fR].\&.\&.\&
.RS 4
Prompts the user to choose from various options.\&
.PP
.RE
\fB:reload\fR [\fB-B\fR] [\fB-C\fR] [\fB-s\fR \fI<styleset-name>\fR]
.RS 4
Hot-reloads the config files for the key binds and general \fBaerc\fR config.\&
Reloading of the account config file is not supported.\&
.PP
If no flags are provided, \fIbinds.\&conf\fR, \fIaerc.\&conf\fR, and the current
styleset will all be reloaded.\&
.PP
\fB-B\fR: Reload \fIbinds.\&conf\fR.\&
.PP
\fB-C\fR: Reload \fIaerc.\&conf\fR.\&
.PP
\fB-s\fR \fI<styleset-name>\fR
.RS 4
Load the specified styleset.\&
.PP
.RE
.RE
\fB:suspend\fR
.RS 4
Suspends the aerc process.\& Some ongoing connections may be terminated.\&
.PP
.RE
\fB:quit\fR [\fB-f\fR]
.br
\fB:exit\fR [\fB-f\fR]
.br
\fB:q\fR    [\fB-f\fR]
.RS 4
Exits aerc.\& If a task is being performed that should not be interrupted
(like sending a message), a normal quit call might fail.\& In this case,
closing aerc can be forced with the \fB-f\fR option.\&
.PP
.RE
\fB:redraw\fR
.RS 4
Force a full redraw of the screen.\&
.PP
.RE
.SS MESSAGE COMMANDS
.PP
These commands are valid in any context that has a selected message (e.\&g.\& the
message list, the message in the message viewer, etc).\&
.PP
\fB:archive\fR [\fB-m\fR \fI<strategy>\fR] \fI<scheme>\fR
.RS 4
Moves the selected message to the archive.\& The available schemes are:
.PP
\fIflat\fR: No special structure, all messages in the archive directory
.PP
\fIyear\fR: Messages are stored in folders per year
.PP
\fImonth\fR: Messages are stored in folders per year and subfolders per month
.PP
The \fB-m\fR option sets the multi-file strategy.\& See \fBaerc-notmuch\fR(5) for more
details.\&
.PP
.RE
\fB:accept\fR [\fB-e\fR|\fB-E\fR] [\fB-s\fR]
.RS 4
Accepts an iCalendar meeting invitation.\& This opens a compose window
with a specially crafted attachment.\& Sending the email will let the
inviter know that you accepted and will likely update their calendar as
well.\& This will NOT add the meeting to your own calendar, that must be
done as a separate manual step (e.\&g.\& by piping the text/calendar part to
an appropriate script).\&
.PP
\fB-e\fR: Forces \fB[compose].\&edit-headers\fR = \fItrue\fR for this message only.\&
.PP
\fB-E\fR: Forces \fB[compose].\&edit-headers\fR = \fIfalse\fR for this message only.\&
.PP
\fB-s\fR: Skips the editor and goes directly to the review screen.\&
.PP
.RE
\fB:accept-tentative\fR [\fB-e\fR|\fB-E\fR] [\fB-s\fR]
.RS 4
Accepts an iCalendar meeting invitation tentatively.\&
.PP
\fB-e\fR: Forces \fB[compose].\&edit-headers\fR = \fItrue\fR for this message only.\&
.PP
\fB-E\fR: Forces \fB[compose].\&edit-headers\fR = \fIfalse\fR for this message only.\&
.PP
\fB-s\fR: Skips the editor and goes directly to the review screen.\&
.PP
.RE
\fB:copy\fR [\fB-dp\fR] [\fB-a\fR \fI<account>\fR] [\fB-m\fR \fI<strategy>\fR] \fI<folder>\fR
.br
\fB:cp\fR [\fB-dp\fR] [\fB-a\fR \fI<account>\fR] [\fB-m\fR \fI<strategy>\fR] \fI<folder>\fR
.RS 4
Copies the selected message(s) to \fI<folder>\fR.\&
.PP
\fB-d\fR: Decrypt the message before copying.\&
.PP
\fB-p\fR: Create \fI<folder>\fR if it does not exist.\&
.PP
\fB-a\fR: Copy to \fI<folder>\fR of \fI<account>\fR.\& If \fI<folder>\fR does
not exist, it will be created whether or not \fB-p\fR is used.\&
.PP
\fB-m\fR: Set the multi-file strategy.\& See \fBaerc-notmuch\fR(5) for more details.\&
.PP
.RE
\fB:decline\fR [\fB-e\fR|\fB-E\fR] [\fB-s\fR]
.RS 4
Declines an iCalendar meeting invitation.\&
.PP
\fB-e\fR: Forces \fB[compose].\&edit-headers\fR = \fItrue\fR for this message only.\&
.PP
\fB-E\fR: Forces \fB[compose].\&edit-headers\fR = \fIfalse\fR for this message only.\&
.PP
\fB-s\fR: Skips the editor and goes directly to the review screen.\&
.PP
.RE
\fB:delete\fR [\fB-m\fR \fI<strategy>\fR]
.br
\fB:delete-message\fR [\fB-m\fR \fI<strategy>\fR]
.RS 4
Deletes the selected message.\&
.PP
\fB-m\fR: Set the multi-file strategy.\& See \fBaerc-notmuch\fR(5) for more details.\&
.PP
.RE
\fB:envelope\fR [\fB-h\fR] [\fB-s\fR \fI<format-specifier>\fR]
.RS 4
Opens the message envelope in a dialog popup.\&
.PP
\fB-h\fR: Show all header fields
.PP
\fB-s\fR \fI<format-specifier>\fR
.RS 4
User-defined format specifier requiring two \fI%s\fR for the key and
value strings.\& Default format: \fI%-20.\&20s: %s\fR
.PP
.RE
.RE
\fB:recall\fR [\fB-f\fR] [\fB-e\fR|\fB-E\fR] [\fB-s\fR]
.RS 4
Opens the selected message for re-editing.\& Messages can only be
recalled from the postpone directory.\&
.PP
\fB-f\fR: Open the message for re-editing even if it is not in the postpone
directory.\& Aerc remembers the folder, so the further \fB:postpone\fR call will
save the message back there.\&
.PP
\fB-e\fR: Forces \fB[compose].\&edit-headers\fR = \fItrue\fR for this message only.\&
.PP
\fB-E\fR: Forces \fB[compose].\&edit-headers\fR = \fIfalse\fR for this message only.\&
.PP
\fB-s\fR: Skips the editor and goes directly to the review screen.\&
.PP
Original recalled messages are deleted if they are sent or postponed again.\&
In both cases you have another copy of the message somewhere.\& Otherwise the
recalled message is left intact.\& This happens if the recalled message is
discarded after editing.\& It can be deleted with \fB:rm\fR if it is not needed.\&
.PP
.RE
\fB:forward\fR [\fB-A\fR|\fB-F\fR] [\fB-T\fR \fI<template-file>\fR] [\fB-a\fR \fI<account>\fR] [\fB-e\fR|\fB-E\fR] [\fB-s\fR] [\fI<address>\fR.\&.\&.\&]
.RS 4
Opens the composer to forward the selected message to another recipient.\&
.PP
\fB-A\fR: Forward the message and all attachments.\&
.PP
\fB-F\fR: Forward the full message as an RFC 2822 attachment.\&
.PP
\fB-T\fR \fI<template-file>\fR
.RS 4
Use the specified template file for creating the initial
message body.\& Unless \fB-F\fR is specified, this defaults to what
is set as \fBforwards\fR in the \fB[templates]\fR section of
\fIaerc.\&conf\fR.\&
.PP
.RE
\fB-x\fR: \fI<account>\fR
.RS 4
Forward with the specified account instead of the current one.\&
.PP
.RE
\fB-e\fR: Forces \fB[compose].\&edit-headers\fR = \fItrue\fR for this message only.\&
.PP
\fB-E\fR: Forces \fB[compose].\&edit-headers\fR = \fIfalse\fR for this message only.\&
.PP
\fB-s\fR: Skips the editor and goes directly to the review screen.\&
.PP
.RE
\fB:move\fR [\fB-p\fR] [\fB-a\fR \fI<account>\fR] [\fB-m\fR \fI<strategy>\fR] \fI<folder>\fR
.br
\fB:mv\fR [\fB-p\fR] [\fB-a\fR \fI<account>\fR] [\fB-m\fR \fI<strategy>\fR] \fI<folder>\fR
.RS 4
Moves the selected message(s) to \fI<folder>\fR.\&
.PP
\fB-p\fR: Create \fI<folder>\fR if it does not exist.\&
.PP
\fB-a\fR: Move to \fI<folder>\fR of \fI<account>\fR.\& If \fI<folder>\fR does
not exist, it will be created whether or not \fB-p\fR is used.\&
.PP
\fB-m\fR: Set the multi-file strategy.\& See \fBaerc-notmuch\fR(5) for more details.\&
.PP
.RE
\fB:patch\fR \fI<args .\&.\&.\&>\fR
.RS 4
Patch management sub-commands.\& See \fBaerc-patch\fR(7) for more details.\&
.PP
.RE
\fB:pipe\fR [\fB-bdmps\fR] \fI<cmd>\fR
.RS 4
Downloads and pipes the selected message into the given shell command
(executed with \fIsh -c "<cmd>"\fR), and opens a new terminal tab to show
the result.\& By default, the selected message part is used in the message
viewer and the full message is used in the message list.\& In the compose
review mode, pipes the composed message that is about to be sent.\&
.PP
Operates on multiple messages when they are marked.\& When piping multiple
messages, aerc will write them with mbox format separators.\&
.PP
\fB-b\fR: Run the command in the background instead of opening a terminal tab
.PP
\fB-d\fR: Pipe the (full) message but decrypt it first.\&
.PP
\fB-m\fR: Pipe the full message
.PP
\fB-p\fR: Pipe just the selected message part, if applicable
.PP
\fB-s\fR: Silently close the terminal tab after the command is completed
.PP
This can be used to apply patch series with git:
.PP
.RS 4
\fB:pipe -m\fR \fIgit am -3\fR
.PP
.RE
When at least one marked message subject matches a patch series (e.\&g.\&
\fI[PATCH X/Y]\fR), all marked messages will be sorted by subject to ensure
that the patches are applied in order.\&
.PP
.RE
\fB:reply\fR [\fB-acfqs\fR] [\fB-T\fR \fI<template-file>\fR] [\fB-A\fR \fI<account>\fR] [\fB-e\fR|\fB-E\fR]
.RS 4
Opens the composer to reply to the selected message.\&
.PP
\fB-a\fR: Reply all
.PP
\fB-c\fR: Close the view tab when replying.\& If the reply is not sent, reopen
the view tab.\&
.PP
\fB-f:\fR Reply to all addresses in From and Reply-To headers.\&
.PP
\fB-q\fR: Insert a quoted version of the selected message into the reply
editor.\& This defaults to what is set as \fBquoted-reply\fR in the \fB[templates]\fR
section of \fIaerc.\&conf\fR.\&
.PP
\fB-s\fR: Skip opening the text editor and go directly to the review screen.\&
.PP
\fB-T\fR \fI<template-file>\fR
.RS 4
Use the specified template file for creating the initial
message body.\&
.PP
.RE
\fB-A\fR \fI<account>\fR
.RS 4
Reply with the specified account instead of the current one.\&
.PP
.RE
\fB-e\fR: Forces \fB[compose].\&edit-headers\fR = \fItrue\fR for this message only.\&
.PP
\fB-E\fR: Forces \fB[compose].\&edit-headers\fR = \fIfalse\fR for this message only.\&
.PP
.RE
\fB:read\fR [\fB-t\fR]
.RS 4
Marks the marked or selected messages as read.\&
.PP
\fB-t\fR: Toggle the messages between read and unread.\&
.PP
.RE
\fB:unread\fR [\fB-t\fR]
.RS 4
Marks the marked or selected messages as unread.\&
.PP
\fB-t\fR: Toggle the messages between read and unread.\&
.PP
.RE
\fB:flag\fR [\fB-t\fR] [\fB-a\fR | \fB-x\fR \fI<flag>\fR]
.RS 4
Sets (enables) a certain flag on the marked or selected messages.\&
.PP
\fB-t\fR: Toggle the flag instead of setting (enabling) it.\&
.PP
\fB-a\fR: Mark message as answered/unanswered.\&
.PP
\fB-x\fR \fI<flag>\fR: Mark message with specific flag.\&
.RS 4
The available flags are (adapted from RFC 3501, section 2.\&3.\&2):
.PP
\fIseen\fR
.RS 4
Message has been read
.RE
\fIanswered\fR
.RS 4
Message has been answered
.RE
\fIforwarded\fR
.RS 4
Message has been forwarded
.RE
\fIflagged\fR
.RS 4
Message is flagged for urgent/special attention
.RE
\fIdraft\fR
.RS 4
Message is a draft
.PP
.RE
.RE
.RE
\fB:unflag\fR [\fB-t\fR] \fI<flag>\fR
.RS 4
Operates exactly like \fB:flag\fR, defaulting to unsetting (disabling) flags.\&
.PP
.RE
\fB:modify-labels\fR [\fI+\fR|\fI-\fR|\fI!\&\fR]\fI<label>\fR.\&.\&.\&
.br
\fB:tag\fR [\fI+\fR|\fI-\fR|\fI!\&\fR]\fI<label>\fR.\&.\&.\&
.RS 4
Modify message labels (e.\&g.\& notmuch tags, GMail or Proton labels).\&
Labels prefixed with a \fB+\fR are added, those prefixed with a \fB-\fR are
removed and those prefixed with a \fB!\&\fR are toggled (toggling is not
supported for GMail nor Proton).\& As a convenience, labels without either
operand add the specified label.\&
.PP
Example: add \fIinbox\fR and \fIunread\fR labels, remove \fIspam\fR label.\&
.PP
.RS 4
\fB:modify-labels\fR \fI+inbox\fR \fI-spam\fR \fIunread\fR
.PP
.RE
.RE
\fB:unsubscribe\fR [\fB-e\fR|\fB-E\fR] [\fB-s\fR]
.RS 4
Attempt to automatically unsubscribe the user from the mailing list through
use of the List-Unsubscribe header.\& If supported, aerc may open a compose
window pre-filled with the unsubscribe information or open the unsubscribe
URL in a web browser.\&
.PP
\fB-e\fR: Forces \fB[compose].\&edit-headers\fR = \fItrue\fR for this message only.\&
.PP
\fB-E\fR: Forces \fB[compose].\&edit-headers\fR = \fIfalse\fR for this message only.\&
.PP
\fB-s\fR: Skips the editor and goes directly to the review screen.\&
.PP
.RE
.SS MESSAGE LIST COMMANDS
.PP
\fB:align\fR \fItop|center|bottom\fR
.RS 4
Aligns the selected message.\& The available positions are:
.PP
\fItop\fR: Top of the message list.\&
.br
	\fIcenter\fR: Center of the message list.\&
.br
	\fIbottom\fR: Bottom of the message list.\&
.PP
.RE
\fB:disconnect\fR
.br
\fB:connect\fR
.RS 4
Disconnect or reconnect the current account.\& This only applies to
certain email sources.\&
.PP
.RE
\fB:clear\fR [\fB-s\fR]
.RS 4
Clears the current search or filter criteria.\&
.PP
By default, the selected message will be kept.\& To clear the selected
message and move cursor to the top of the message list, use the \fB-s\fR flag.\&
.PP
\fB-s\fR: Selects the message at the top of the message list after clearing.\&
.PP
.RE
\fB:cf\fR [\fB-a\fR \fI<account>\fR] \fI<folder>\fR
.RS 4
Change the folder shown in the message list to \fI<folder>\fR.\&
.PP
\fB-a\fR \fI<account>\fR
.RS 4
Change to \fI<folder>\fR of \fI<account>\fR and focus its corresponding
tab.\&
.PP
.RE
.RE
\fB:check-mail\fR
.RS 4
Check for new mail on the selected account.\& Non-imap backends require
check-mail-cmd to be set in order for aerc to initiate a check for new mail.\&
Issuing a manual \fB:check-mail\fR command will reset the timer for automatic checking.\&
.PP
.RE
\fB:compose\fR [\fB-H\fR \fI"<header>: <value>"\fR] [\fB-T\fR \fI<template-file>\fR] [\fB-e\fR|\fB-E\fR] [\fB-s\fR] [\fI<body>\fR]
.RS 4
Open the compose window to send a new email.\& The new email will be sent with
the current account'\&s outgoing transport configuration.\& For details on
configuring outgoing mail delivery consult \fBaerc-accounts\fR(5).\&
.PP
\fB-H\fR \fI"<header>: <value>"\fR
.RS 4
Add the specified header to the message, e.\&g:
.PP
.RS 4
\fB:compose -H\fR \fI"X-Custom: custom value"\fR
.PP
.RE
.RE
\fB-T\fR \fI<template-file>\fR
.RS 4
Use the specified template file for creating the initial
message body.\&
.PP
.RE
\fB-e\fR: Forces \fB[compose].\&edit-headers\fR = \fItrue\fR for this message only.\&
.PP
\fB-E\fR: Forces \fB[compose].\&edit-headers\fR = \fIfalse\fR for this message only.\&
.PP
\fB-s\fR: Skips the editor and goes directly to the review screen.\&
.PP
\fI<body>\fR: The initial message body.\&
.PP
.RE
\fB:bounce\fR [\fB-A\fR \fI<account>\fR] \fI<address>\fR [\fI<address>\fR.\&.\&.\&]
.br
\fB:resend\fR [\fB-A\fR \fI<account>\fR] \fI<address>\fR [\fI<address>\fR.\&.\&.\&]
.RS 4
Bounce the selected message or all marked messages to the specified addresses,
optionally using the specified account.\& This forwards the message while
preserving all the existing headers.\& The new sender (\fBFrom\fR), date (\fBDate\fR),
\fBMessage-ID\fR and recipients (\fBTo\fR) are prepended to the headers with the \fBResent-\fR
prefix.\& For more information please refer to section 3.\&6.\&6 of RFC 2822.\& Note
that the bounced message is not copied over to the \fBsent\fR folder.\&
.PP
Also please note that some providers (notably for instance Microsoft'\&s
O365) do not allow sending messages with the \fBFrom\fR header not matching
any of the account'\&s identities (even if \fBResent-From\fR matches some).\&
.PP
.RE
\fB:recover\fR [\fB-f\fR] [\fB-e\fR|\fB-E\fR] \fI<file>\fR
.RS 4
Resume composing a message that was not sent nor postponed.\& The file may
not contain header data unless \fB[compose].\&edit-headers\fR was enabled when
originally composing the aborted message.\&
.PP
\fB-f\fR: Delete the \fI<file>\fR after opening the composer.\&
.PP
\fB-e\fR: Forces \fB[compose].\&edit-headers\fR = \fItrue\fR for this message only.\&
.PP
\fB-E\fR: Forces \fB[compose].\&edit-headers\fR = \fIfalse\fR for this message only.\&
.PP
.RE
\fB:filter\fR [\fI<options>\fR] \fI<terms>\fR.\&.\&.\&
.RS 4
Similar to \fB:search\fR, but filters the displayed messages to only the search
results.\& The search syntax is dependent on the underlying backend.\&
Refer to \fBaerc-search\fR(1) for details
.PP
.RE
\fB:mkdir\fR \fI<name>\fR
.RS 4
Creates a new folder for this account and changes to that folder.\&
.PP
.RE
\fB:rmdir\fR [\fB-f\fR] [\fI<folder>\fR]
.RS 4
Removes the folder \fI<folder>\fR, or the current folder if not specified.\&
.PP
By default, it will fail if the directory is non-empty (see \fB-f\fR).\&
.PP
\fB-f\fR
.RS 4
Remove the directory even if it contains messages.\&
.PP
.RE
Some programs that sync maildirs may recover deleted directories (e.\&g.\&
\fBofflineimap\fR).\& These can either be specially configured to properly
handle directory deletion, or special commands need to be run to delete
directories (e.\&g.\& \fIofflineimap --delete-folder\fR).\&
.PP
It is possible, with a slow connection and the imap backend, that new
messages arrive in the directory before they show up - using \fB:rmdir\fR at
this moment would delete the directory and such new messages before the
user sees them.\&
.PP
.RE
\fB:next\fR \fI<n>\fR[\fI%\fR]
.br
\fB:next-message\fR \fI<n>\fR[\fI%\fR]
.br
\fB:prev\fR \fI<n>\fR[\fI%\fR]
.br
\fB:prev-message\fR \fI<n>\fR[\fI%\fR]
.RS 4
Selects the next (or previous) message in the message list.\& If specified as
a percentage, the percentage is applied to the number of messages shown on
screen and the cursor advances that far.\&
.PP
.RE
\fB:next-folder\fR [\fB-u\fR] \fI<n>\fR
.br
\fB:prev-folder\fR [\fB-u\fR] \fI<n>\fR
.RS 4
Cycles to the next (or previous) folder shown in the sidebar, repeated
\fI<n>\fR times (default: \fI1\fR).\&
.PP
\fB-u\fR
.RS 4
Cycles to the next (or previous) folder shown in the sidebar with unseen
emails.\&
.PP
.RE
.RE
\fB:expand-folder\fR [\fI<folder>\fR]
.br
\fB:collapse-folder\fR [\fI<folder>\fR]
.RS 4
Expands or collapses a folder when the directory tree is enabled.\& If no
\fI<folder>\fR argument is specified, the currently selected folder is acted
upon.\&
.PP
.RE
\fB:export-mbox\fR \fI<file>\fR
.RS 4
Exports messages in the current folder to an mbox file.\& If there are marked
messages in the folder, only the marked ones are exported.\& Otherwise the
whole folder is exported.\&
.PP
.RE
\fB:import-mbox\fR \fI<path>\fR
.RS 4
Imports all messages from an (gzipped) mbox file to the current folder.\&
\fI<path>\fR can either be a path to a file or an URL.\&
.PP
Examples:
.PP
.nf
.RS 4
:import-mbox ~/messages\&.mbox
:import-mbox https://lists\&.sr\&.ht/~rjarry/aerc-devel/patches/55634/mbox
:import-mbox https://lore\&.kernel\&.org/all/20190807155524\&.5112-1-steve\&.capper@arm\&.com/t\&.mbox\&.gz
.fi
.RE
.PP
.RE
\fB:next-result\fR
.br
\fB:prev-result\fR
.RS 4
Selects the next or previous search result.\&
.PP
.RE
\fB:query\fR [\fB-a\fR \fI<account>\fR] [\fB-n\fR \fIname\fR] [\fB-f\fR] \fI<notmuch query>\fR
.RS 4
Create a virtual folder using the specified top-level notmuch query.\& This
command is exclusive to the notmuch backend.\&
.PP
\fB-a\fR \fI<account>\fR
.RS 4
Change to \fI<folder>\fR of \fI<account>\fR and focus its corresponding
tab.\&
.PP
.RE
\fB-n\fR \fI<name>\fR
.RS 4
Specify the display name for the virtual folder.\& If not provided,
\fI<notmuch query>\fR is used as the display name.\&
.PP
.RE
\fB-f\fR
.RS 4
Load the query results into an already existing folder (messages
in the original folder are not deleted).\&
.PP
.RE
.RE
\fB:search\fR [\fI<options>\fR] \fI<terms>\fR.\&.\&.\&
.RS 4
Searches the current folder for messages matching the given set of
conditions.\&  The search syntax is dependent on the underlying backend.\&
Refer to \fBaerc-search\fR(1) for details.\&
.PP
.RE
\fB:select\fR \fI<n>\fR
.br
\fB:select-message\fR \fI<n>\fR
.RS 4
Selects the \fI<n>\fRth message in the message list (and scrolls it into
view if necessary).\&
.PP
.RE
\fB:hsplit\fR [[\fI+\fR|\fI-\fR]\fI<n>\fR]
\fB:split\fR [[\fI+\fR|\fI-\fR]\fI<n>\fR]
.RS 4
Creates a horizontal split, showing \fI<n>\fR messages and a message view
below the message list.\& If a \fI+\fR or \fI-\fR is prepended, the message list
size will grow or shrink accordingly.\& The split can be cleared by
calling \fB:[h]split\fR \fI0\fR, or just \fB:[h]split\fR.\& The split can be toggled
by calling split with the same (absolute) size repeatedly.\& For example,
\fB:[h]split\fR \fI10\fR will create a split.\& Calling \fB:[h]split\fR \fI10\fR again
will remove the split.\& If not specified, \fI<n>\fR is set to an estimation
based on the user'\&s terminal.\& Also see \fB:vsplit\fR.\&
.PP
.RE
\fB:sort\fR [[\fB-r\fR] \fI<criterion>\fR].\&.\&.\&
.RS 4
Sorts the message list by the given criteria.\& \fB-r\fR sorts the
immediately following criterion in reverse order.\&
.PP
Available criteria:
.PP
.RE
.TS
allbox;l c
l c
l c
l c
l c
l c
l c
l c
l c
l c.
T{
\fBCriterion\fR
T}	T{
\fBDescription\fR
T}
T{
\fIarrival\fR
T}	T{
Date and time of the messages arrival
T}
T{
\fIcc\fR
T}	T{
Addresses in the Cc field
T}
T{
\fIdate\fR
T}	T{
Date and time of the message
T}
T{
\fIfrom\fR
T}	T{
Addresses in the From field
T}
T{
\fIread\fR
T}	T{
Presence of the read flag
T}
T{
\fIflagged\fR
T}	T{
Presence of the flagged flag
T}
T{
\fIsize\fR
T}	T{
Size of the message
T}
T{
\fIsubject\fR
T}	T{
Subject of the message
T}
T{
\fIto\fR
T}	T{
Addresses in the To field
T}
.TE
.sp 1
\fB:toggle-threads\fR
.RS 4
Toggles between message threading and the normal message list.\&
.PP
.RE
\fB:fold\fR [\fB-at\fR]
.br
\fB:unfold\fR [\fB-at\fR]
.RS 4
Collapse or un-collapse the thread children of the selected message.\&
If the toggle flag \fB-t\fR is set, the folded status is changed.\& If the
\fB-a\fR flag is set, all threads in the current view are affected.\& Folded
threads can be identified by \fI{{.\&Thread*}}\fR template attributes
in \fB[ui].\&index-columns\fR.\& See \fBaerc-config\fR(5) and \fBaerc-templates\fR(7)
for more details.\&
.PP
.RE
\fB:toggle-thread-context\fR
.RS 4
Toggles between showing entire thread (when supported) and only showing
messages which match the current query / mailbox.\&
.PP
.RE
\fB:view\fR [\fB-pb\fR]
.br
\fB:view-message\fR [\fB-pb\fR]
.RS 4
Opens the message viewer to display the selected message.\& If the peek
flag \fB-p\fR is set, the message will not be marked as seen and ignores the
\fBauto-mark-read\fR config.\& If the background flag \fB-b\fR is set, the message
will be opened in a background tab.\&
.PP
.RE
\fB:vsplit\fR [[\fI+\fR|\fI-\fR]\fI<n>\fR]
.RS 4
Creates a vertical split of the message list.\& The message list will be
\fI<n>\fR columns wide, and a vertical message view will be shown to the
right of the message list.\& If a \fI+\fR or \fI-\fR is prepended, the message
list size will grow or shrink accordingly.\& The split can be cleared by
calling \fB:vsplit\fR \fI0\fR, or just \fB:vsplit\fR.\& The split can be toggled by
calling split with the same (absolute) size repeatedly.\& For example,
\fB:vsplit\fR \fI10\fR will create a split.\& Calling \fB:vsplit\fR \fI10\fR again will
remove the split.\& If not specified, \fI<n>\fR is set to an estimation based
on the user'\&s terminal.\& Also see \fB:split\fR.\&
.PP
.RE
.SS MESSAGE VIEW COMMANDS
.PP
\fB:close\fR
.RS 4
Closes the message viewer.\&
.PP
.RE
\fB:next\fR \fI<n>\fR[\fI%\fR]
.br
\fB:prev\fR \fI<n>\fR[\fI%\fR]
.RS 4
Selects the next (or previous) message in the message list.\& If specified as
a percentage, the percentage is applied to the number of messages shown on
screen and the cursor advances that far.\&
.PP
.RE
\fB:next-part\fR
.br
\fB:prev-part\fR
.RS 4
Cycles between message parts being shown.\& The list of message parts is shown
at the bottom of the message viewer.\&
.PP
.RE
\fB:open\fR [\fB-d\fR] [\fI<args.\&.\&.\&>\fR]
.RS 4
Saves the current message part to a temporary file, then opens it.\& If no
arguments are provided, it will open the current MIME part with the
matching command in the \fB[openers]\fR section of \fIaerc.\&conf\fR.\& When no match
is found in \fB[openers]\fR, it falls back to the default system handler.\&
.PP
\fB-d\fR: Delete the temporary file after the opener exits
.PP
When arguments are provided:
.PP
.PD 0
.IP \(bu 4
The first argument must be the program to open the message part with.\&
Subsequent args are passed to that program.\&
.IP \(bu 4
\fI{}\fR will be expanded as the temporary filename to be opened.\& If it is
not encountered in the arguments, the temporary filename will be
appended to the end of the command.\&
.PD
.PP
.RE
\fB:copy-link\fR \fI<url>\fR
.RS 4
Copy the specified URL to the system clipboard.\& This uses the OSC52
escape sequence which must be supported by the terminal.\&
.PP
.RE
\fB:open-link\fR \fI<url>\fR [\fI<args.\&.\&.\&>\fR]
.RS 4
Open the specified URL with an external program.\& The opening logic is
the same than for \fB:open\fR but the opener program will be looked up
according to the URL scheme MIME type: \fIx-scheme-handler/<scheme>\fR.\&
.PP
.RE
\fB:save\fR [\fB-fpaA\fR] \fI<path>\fR
.RS 4
Saves the current message part to the given path.\&
If the path is not an absolute path, \fB[general].\&default-save-path\fR from
\fIaerc.\&conf\fR will be prepended to the path given.\&
If path ends in a trailing slash or if a folder exists on disc or if \fB-a\fR
is specified, aerc assumes it to be a directory.\&
When passed a directory \fB:save\fR infers the filename from the mail part if
possible, or if that fails, uses \fIaerc_$DATE\fR.\&
.PP
\fB-f\fR: Overwrite the destination whether or not it exists
.PP
\fB-p\fR: Create any directories in the path that do not exist
.PP
\fB-a\fR: Save all attachments.\& Individual filenames cannot be specified.\&
.PP
\fB-A\fR: Same as \fB-a\fR but saves all the named parts, not just attachments.\&
.PP
.RE
\fB:mark\fR [\fB-atvTsr\fR] \fI<filter>\fR
.RS 4
Marks messages.\& Commands will execute on all marked messages instead of the
highlighted one if applicable.\& The flags below can be combined as
needed.\& The existence of a filter implies \fB-a\fR unless \fB-T\fR has been
specified.\&
.PP
\fB-a\fR: Apply to all messages in the current folder
.PP
\fB-t\fR: toggle the mark state instead of marking a message
.PP
\fB-v\fR: Enter / leave visual mark mode
.PP
\fB-V\fR: Same as \fB-v\fR but does not clear existing selection
.PP
\fB-T\fR: Marks the displayed message thread of the selected message.\&
.PP
\fB-s\fR: apply the filter to the From: header (does not work with \fB-v\fR or \fB-V\fR)
.PP
\fB-r\fR: apply the filter to the To:, Cc:, Bcc: headers (does not work with
\fB-v\fR or \fB-V\fR)
.PP
.RE
\fB:unmark\fR [\fB-atTsr\fR] \fI<filter>\fR
.RS 4
Unmarks messages.\& The flags below can be combined as needed.\& The
existence of a filter implies \fB-a\fR unless \fB-T\fR has been specified.\&
.PP
\fB-a\fR: Apply to all messages in the current folder
.PP
\fB-t\fR: toggle the mark state instead of unmarking a message
.PP
\fB-T\fR: Marks the displayed message thread of the selected message.\&
.PP
\fB-s\fR: apply the filter to the From: header (does not work with \fB-v\fR or \fB-V\fR)
.PP
\fB-r\fR: apply the filter to the To: header (does not work with \fB-v\fR or \fB-V\fR)
.PP
.RE
\fB:remark\fR
.RS 4
Re-select the last set of marked messages.\& Can be used to chain commands
after a selection has been acted upon
.PP
.RE
\fB:toggle-headers\fR
.RS 4
Toggles the visibility of the message headers.\&
.PP
.RE
\fB:toggle-key-passthrough\fR
.RS 4
Enter or exit the \fB[view::passthrough]\fR key bindings context.\& See
\fBaerc-binds\fR(5) for more details.\&
.PP
.RE
.SS MESSAGE COMPOSE COMMANDS
.PP
\fB:abort\fR
.RS 4
Close the composer without sending, discarding the message in progress.\&
.PP
If the text editor exits with an error (e.\&g.\& \fB:cq\fR in \fBvim\fR(1)), the
message is immediately discarded.\&
.PP
.RE
\fB:attach\fR \fI<path>\fR
.br
\fB:attach\fR \fB-m\fR [\fI<arg>\fR]
.br
\fB:attach\fR \fB-r\fR <name> <cmd>
.RS 4
Attaches the file at the given path to the email.\& The path can contain
globbing syntax described at https://godocs.\&io/path/filepath#Match.\&
.PP
\fB-m\fR [\fI<arg>\fR]
.RS 4
Runs the \fBfile-picker-cmd\fR to select files to be attached.\&
Requires an argument when \fBfile-picker-cmd\fR contains the \fI%s\fR verb.\&
.PP
.RE
\fB-r\fR <name> <cmd>
.RS 4
Runs the <cmd>, reads its output and attaches it as <name>.\& The
attachment MIME type is derived from the <name>'\&s extension.\&
.PP
.RE
.RE
\fB:attach-key\fR
.RS 4
Attaches the public key for the configured account to the email.\&
.PP
.RE
\fB:detach\fR [\fI<path>\fR]
.RS 4
Detaches the file with the given path from the composed email.\& If no path is
specified, detaches the first attachment instead.\& The path can contain
globbing syntax described at https://godocs.\&io/path/filepath#Match.\&
.PP
.RE
\fB:cc\fR \fI<addresses>\fR
.br
\fB:bcc\fR \fI<addresses>\fR
.RS 4
Sets the Cc or Bcc header to the given addresses.\& If an editor for the header
is not currently visible in the compose window, a new one will be added.\&
.PP
.RE
\fB:edit\fR [\fB-e\fR|\fB-E\fR]
.RS 4
(Re-)opens your text editor to edit the message in progress.\& This will
also allow editing the message headers.\& Only available from the review
screen.\&
.PP
\fB-e\fR: Forces \fB[compose].\&edit-headers\fR = \fItrue\fR for this message only.\&
.PP
\fB-E\fR: Forces \fB[compose].\&edit-headers\fR = \fIfalse\fR for this message only.\&
.PP
.RE
\fB:multipart\fR [\fB-d\fR] \fI<mime/type>\fR
.RS 4
Makes the message to multipart/alternative and add the specified
\fI<mime/type>\fR part.\& Only the MIME types that are configured in the
\fB[multipart-converters]\fR section of \fIaerc.\&conf\fR are supported and their
related commands will be used to generate the alternate part.\&
.PP
\fB-d\fR:
.RS 4
Remove the specified alternative \fI<mime/type>\fR instead of
adding it.\& If no alternative parts are left, make the message
text/plain (i.\&e.\& not multipart/alternative).\&
.PP
.RE
.RE
\fB:next-field\fR
.br
\fB:prev-field\fR
.RS 4
Cycles between input fields in the compose window.\& Only available when
the text editor is visible and \fB[compose].\&edit-headers\fR = \fIfalse\fR.\&
.PP
.RE
\fB:postpone\fR [\fB-t\fR \fI<folder>\fR]
.RS 4
Saves the current state of the message to the \fBpostpone\fR folder (from
\fIaccounts.\&conf\fR) for the current account by default.\& Only available from
the review screen.\&
.PP
\fB-t\fR: Overrides the target folder for saving the message
.PP
If the message was force-recalled with \fB:recall -f\fR from a different folder,
the \fB:postpone\fR command will save it back to that folder instead of the
default \fBpostpone\fR folder configured in settings.\& Use \fB-t\fR to override that
or use \fB:mv\fR to move the saved message to a different folder.\&
.PP
.RE
\fB:send\fR [\fB-a\fR \fI<scheme>\fR] [\fB-t\fR \fI<folder>\fR]
.RS 4
Sends the message using this accounts default outgoing transport
configuration.\& For details on configuring outgoing mail delivery consult
\fBaerc-accounts\fR(5).\& Only available from the review screen.\&
.PP
\fB-a\fR: Archive the message being replied to.\& See \fB:archive\fR for schemes.\&
.PP
\fB-t\fR: Overrides the Copy-To folder for saving the message.\&
.PP
.RE
\fB:switch-account\fR \fI<account-name>\fR
.br
\fB:switch-account\fR \fB-n\fR
.br
\fB:switch-account\fR \fB-p\fR
.RS 4
Switches the account.\& Can be used to switch to a specific account from
its name or to cycle through accounts using the \fB-p\fR and \fB-n\fR flags.\&
.PP
\fB-p\fR: switch to previous account
.PP
\fB-n\fR: switch to next account
.PP
.RE
\fB:header\fR [\fB-f\fR] \fI<name>\fR [\fI<value>\fR]
\fB:header\fR [\fB-d\fR] \fI<name>\fR
.RS 4
Add a new email header to the compose window.\& If the header is already
set and is not empty, \fB-f\fR must be used to overwrite its value.\&
.PP
\fB-f\fR: Overwrite any existing header.\&
.PP
\fB-d\fR: Remove the header instead of adding it.\&
.PP
.RE
\fB:encrypt\fR
.RS 4
Encrypt the message to all recipients.\& If a key for a recipient cannot
be found the message will not be encrypted.\&
.PP
.RE
\fB:sign\fR
.RS 4
Sign the message using the account'\&s default key.\& If \fBpgp-key-id\fR is set
in \fIaccounts.\&conf\fR (see \fBaerc-accounts\fR(5)), it will be used in
priority.\& Otherwise, the \fBFrom\fR header address will be used to look for
a matching private key in the pgp keyring.\&
.PP
.RE
.SS TERMINAL COMMANDS
.PP
\fB:close\fR
.RS 4
Closes the terminal.\&
.PP
.RE
.SH LOGGING
.PP
Aerc does not log by default, but collecting log output can be useful for
troubleshooting and reporting issues.\& Redirecting stdout when invoking aerc will
write log messages to that file:
.PP
.RS 4
$ aerc > aerc.\&log
.PP
.RE
Persistent logging can be configured via the \fBlog-file\fR and \fBlog-level\fR settings
in \fIaerc.\&conf\fR.\&
.PP
.SH SEE ALSO
.PP
\fBaerc-config\fR(5) \fBaerc-imap\fR(5) \fBaerc-jmap\fR(5) \fBaerc-notmuch\fR(5) \fBaerc-smtp\fR(5)
\fBaerc-maildir\fR(5) \fBaerc-sendmail\fR(5) \fBaerc-search\fR(1) \fBaerc-stylesets\fR(7)
\fBaerc-templates\fR(7) \fBaerc-accounts\fR(5) \fBaerc-binds\fR(5) \fBaerc-tutorial\fR(7)
\fBaerc-patch\fR(7)
.PP
.SH AUTHORS
.PP
Originally created by Drew DeVault and maintained by Robin Jarry who is assisted
by other open source contributors.\& For more information about aerc development,
see \fIhttps://sr.\&ht/~rjarry/aerc/\fR.\&