.\" Generated by scdoc 1.11.5
.\" 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" "2026\-09\-07"
.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\-l\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
\fB\-l\fR: All links extracted from the current message.\&
.PP
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
:menu \-lc fzf :open\-link
.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
Sending the \fBSIGHUP\fR signal to the \fBaerc\fR process will cause \fB:reload\fR
to be performed (with no flags).\&
.PP
.RE
\fB:repeat\fR
.RS 4
Repeats aerc'\&s previously executed command when you last pressed \fB:\fR.\&
.PP
.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\-x\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\-acflqs\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\-l\fR: Reply to the mailing list in \fBList\-Post\fR header.\&
.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\-f\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\-f\fR: Mark message as forwarded/not\-forwarded.\&
.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
(Arbitrary IMAP keyword flags are managed using \fB:modify\-labels\fR / \fB:tag\fR.\&)
.PP
.RE
\fB:unflag\fR [\fB\-t\fR] [\fB\-a\fR] [\fB\-f\fR] [\fB\-x\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.\& IMAP and 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 IMAP, 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]
.br
\fB:toggle\-folder\fR [\fI<folder>\fR]
.RS 4
Expands, collapses, or toggles 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:toggle\-sidebar\fR
.RS 4
Toggles the sidebar on or off.\&
.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 and only showing messages which
match the current query / mailbox.\& Thread context is currently only
supported by the notmuch backend.\&
.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 as 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\-atuUvVTsr\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
\fB\-u\fR: mark unread messages.\& Can be combined with other filters.\&
.PP
\fB\-U\fR: mark read messages.\& Can be combined with other filters.\&
.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:, Cc:, Bcc: headers (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
Converts the message to multipart/alternative and adds 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] [\fB\-r\fR|\fB\-R\fR] [\fB\-\-dsn\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
\fB\-r\fR: Also save the sent message to the folder of the message being
replied to.\&
.PP
\fB\-R\fR: Do not save the sent message to the folder of the message being
replied to (overrides \fBcopy\-to\-replied\fR account setting).\&
.PP
\fB\-\-dsn\fR: Request delivery status notification from the server.\& This
will request notification on successful delivery, delayed delivery,
and delivery failure.\&
.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/\(tirjarry/aerc/\fR.\&