Display one of aerc's man pages in the embedded terminal.

Display the active key bindings in the current context.

Start the new account wizard.

-t: Create a temporary account. Do not modify accounts.conf.

Changes aerc's current working directory.

Changes aerc's current working directory using zoxide. If zoxide is not on $PATH., the command will not be registered.

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 + or -, the number is interpreted as a delta from the selected tab. If only a - is given, changes the focus to the previously selected tab.

Executes an arbitrary command in the background. Aerc will set the environment variables $account and $folder when the command is executed from an Account tab or an opened message.

Note: commands executed in this way are not executed with the shell.

Opens an eml file and displays the message in the message viewer.

Can also be used in the message viewer to open an rfc822 attachment or in the composer to preview the message.

Displays aerc's current working directory in the status bar.

Opens a new terminal tab with a shell running in the current working directory, or the specified command.

Moves the selected tab to the given index. If + or - is specified, the number is interpreted as a delta from the selected tab.

Cycles to the previous or next tab in the list, repeating <n> times (default: 1).

Moves the current tab to the left of all non-pinned tabs and displays the pinned-tab-marker (default: `) to the left of the tab title.

Removes the pinned-tab-marker from the current tab and returns the tab to its previous location.

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.

Prompts the user to choose from various options.

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 -f option.

Moves the selected message to the archive. The available schemes are:

flat: No special structure, all messages in the archive directory

year: Messages are stored in folders per year

month: Messages are stored in folders per year and subfolders per month

Accepts an iCalendar meeting invitation.

-e: Forces [compose].edit-headers = true for this message only.

-E: Forces [compose].edit-headers = false for this message only.

Accepts an iCalendar meeting invitation tentatively.

-e: Forces [compose].edit-headers = true for this message only.

-E: Forces [compose].edit-headers = false for this message only.

Copies the selected message to the target folder.

Declines an iCalendar meeting invitation.

-e: Forces [compose].edit-headers = true for this message only.

-E: Forces [compose].edit-headers = false for this message only.

Deletes the selected message.

Opens the message envelope in a dialog popup.

-h: Show all header fields

-s <format-specifier>

Opens the selected message for re-editing. Messages can only be recalled from the postpone directory.

-f: Open the message for re-editing even if it is not in the postpone directory. Aerc remembers the folder, so the further :postpone call will save the message back there.

-e: Forces [compose].edit-headers = true for this message only.

-E: Forces [compose].edit-headers = false for this message only.

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 :rm if it is not needed.

Opens the composer to forward the selected message to another recipient.

-A: Forward the message and all attachments.

-F: Forward the full message as an RFC 2822 attachment.

-T <template-file>

-e: Forces [compose].edit-headers = true for this message only.

-E: Forces [compose].edit-headers = false for this message only.

Moves the selected message to the target folder.

Downloads and pipes the selected message into the given shell command, 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.

Operates on multiple messages when they are marked. When piping multiple messages, aerc will write them with mbox format separators.

-b: Run the command in the background instead of opening a terminal tab

-m: Pipe the full message

-p: Pipe just the selected message part, if applicable

This can be used to apply patch series with git:

When at least one marked message subject matches a patch series (e.g. [PATCH X/Y]), all marked messages will be sorted by subject to ensure that the patches are applied in order.

Opens the composer to reply to the selected message.

-a: Reply all

-c: Close the view tab when replying. If the reply is not sent, reopen the view tab.

-q: Insert a quoted version of the selected message into the reply editor

-T <template-file>

-e: Forces [compose].edit-headers = true for this message only.

-E: Forces [compose].edit-headers = false for this message only.

Marks the marked or selected messages as read.

-t: Toggle the messages between read and unread.

Marks the marked or selected messages as unread.

-t: Toggle the messages between read and unread.

Sets (enables) a certain flag on the marked or selected messages.

-t: Toggle the flag instead of setting (enabling) it.

-a: Mark message as answered/unanswered.

-x <flag>: Mark message with specific flag.

Operates exactly like :flag, defaulting to unsetting (disabling) flags.

Modify message labels (e.g. notmuch tags). Labels prefixed with a + are added, those prefixed with a - removed. As a convenience, labels without either operand add the specified label.

Example: add inbox and unread labels, remove spam label.

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.

-e: Forces [compose].edit-headers = true for this message only.

-E: Forces [compose].edit-headers = false for this message only.

Disconnect or reconnect the current account. This only applies to certain email sources.

Clears the current search or filter criteria.

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 -s flag.

-s: Selects the message at the top of the message list after clearing.

Change the folder shown in the message list.

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 :check-mail command will reset the timer for automatic checking.

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 aerc-accounts(5).

-H "<header>: <value>"

-T <template-file>

-e: Forces [compose].edit-headers = true for this message only.

-E: Forces [compose].edit-headers = false for this message only.

<body>: The initial message body.

Resume composing a message that was not sent nor postponed. The file may not contain header data unless [compose].edit-headers was enabled when originally composing the aborted message.

-f: Delete the <file> after opening the composer.

-e: Forces [compose].edit-headers = true for this message only.

-E: Forces [compose].edit-headers = false for this message only.

Similar to :search, but filters the displayed messages to only the search results. The search syntax is dependent on the underlying backend. Refer to aerc-search(1) for details

Creates a new folder for this account and changes to that folder.

Removes the current folder.

By default, it will fail if the directory is non-empty (see -f).

-f

Some programs that sync maildirs may recover deleted directories (e.g. offlineimap). These can either be specially configured to properly handle directory deletion, or special commands need to be run to delete directories (e.g. offlineimap --delete-folder).

It is possible, with a slow connection and the imap backend, that new messages arrive in the directory before they show up - using :rmdir at this moment would delete the directory and such new messages before the user sees them.

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.

Cycles to the next (or previous) folder shown in the sidebar, repeated <n> times (default: 1).

Expands or collapses the current folder when the directory tree is enabled.

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.

Imports all messages from an mbox file to the current folder.

Selects the next or previous search result.

Searches the current folder for messages matching the given set of conditions. The search syntax is dependent on the underlying backend. Refer to aerc-search(1) for details.

Selects the <n>th message in the message list (and scrolls it into view if necessary).

Creates a horizontal split, showing <n> messages and a message view below the message list. If a + or - is prepended, the message list size will grow or shrink accordingly. The split can be cleared by calling :split 0, or just :split. The split can be toggled by calling split with the same (absolute) size repeatedly. For example, :split 10 will create a split. Calling :split 10 again will remove the split. If not specified, <n> is set to an estimation based on the user's terminal. Also see :vsplit.

Sorts the message list by the given criteria. -r sorts the immediately following criterion in reverse order.

Available criteria:

Toggles between message threading and the normal message list.

Collapse or un-collapse the thread children of the selected message. Folded threads can be identified by {{.Thread*}} template attributes in [ui].index-columns. See aerc-config(5) and aerc-templates(7) for more details.

Toggles between showing entire thread (when supported) and only showing messages which match the current query / mailbox.

Opens the message viewer to display the selected message. If the peek flag -p is set, the message will not be marked as seen and ignores the auto-mark-read config.

Creates a vertical split of the message list. The message list will be <n> columns wide, and a vertical message view will be shown to the right of the message list. If a + or - is prepended, the message list size will grow or shrink accordingly. The split can be cleared by calling :vsplit 0, or just :vsplit. The split can be toggled by calling split with the same (absolute) size repeatedly. For example, :vsplit 10 will create a split. Calling :vsplit 10 again will remove the split. If not specified, <n> is set to an estimation based on the user's terminal. Also see :split.

Closes the message viewer.

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.

Cycles between message parts being shown. The list of message parts is shown at the bottom of the message viewer.

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 [openers] section of aerc.conf. When no match is found in [openers], it falls back to the default system handler.

-d: Delete the temporary file after the opener exits

When arguments are provided:

Open the specified URL with an external program. The opening logic is the same than for :open but the opener program will be looked up according to the URL scheme MIME type: x-scheme-handler/<scheme>.

Saves the current message part to the given path. If the path is not an absolute path, [general].default-save-path from aerc.conf will be prepended to the path given. If path ends in a trailing slash or if a folder exists on disc or if -a is specified, aerc assumes it to be a directory. When passed a directory :save infers the filename from the mail part if possible, or if that fails, uses aerc_$DATE.

-f: Overwrite the destination whether or not it exists

-p: Create any directories in the path that do not exist

-a: Save all attachments. Individual filenames cannot be specified.

-A: Same as -a but saves all the named parts, not just attachments.

Marks messages. Commands will execute on all marked messages instead of the highlighted one if applicable. The flags below can be combined as needed.

-a: Apply to all messages in the current folder

-t: toggle the mark state instead of marking a message

-v: Enter / leave visual mark mode

-V: Same as -v but does not clear existing selection

-T: Marks the displayed message thread of the selected message.

Unmarks messages. The flags below can be combined as needed.

-a: Apply to all messages in the current folder

-t: toggle the mark state instead of unmarking a message

Re-select the last set of marked messages. Can be used to chain commands after a selection has been acted upon

Toggles the visibility of the message headers.

Enter or exit the [view::passthrough] key bindings context. See aerc-binds(5) for more details.

Close the composer without sending, discarding the message in progress.

If the text editor exits with an error (e.g. :cq in vim(1)), the message is immediately discarded.

Attaches the file at the given path to the email. The path can contain globbing syntax described at https://godocs.io/path/filepath#Match.

-m [<arg>]

-r <name> <cmd>

Attaches the public key for the configured account to the email.

Detaches the file with the given path from the composed email. If no path is specified, detaches the first attachment instead.

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.

(Re-)opens your text editor to edit the message in progress.

-e: Forces [compose].edit-headers = true for this message only.

-E: Forces [compose].edit-headers = false for this message only.

Makes the message to multipart/alternative and add the specified <mime/type> part. Only the MIME types that are configured in the [multipart-converters] section of aerc.conf are supported and their related commands will be used to generate the alternate part.

-d:

Cycles between input fields in the compose window.

Saves the current state of the message to the postpone folder (from accounts.conf) for the current account by default.

-t: Overrides the target folder for saving the message

If the message was force-recalled with :recall -f from a different folder, the :postpone command will save it back to that folder instead of the default postpone folder configured in settings. Use -t to override that or use :mv to move the saved message to a different folder.

Saves the selected message part to the specified path. If -p is selected, aerc will create any missing directories in the specified path. If the path specified is a directory or ends in /, aerc will use the attachment filename if available or a generated name if not.

Sends the message using this accounts default outgoing transport configuration. For details on configuring outgoing mail delivery consult aerc-accounts(5).

-a: Archive the message being replied to. See :archive for schemes.

Switches the account. Can be used to switch to a specific account from its name or to cycle through accounts using the -p and -n flags.

-p: switch to previous account

-n: switch to next account

Add a new email header to the compose window. If the header is already set and is not empty, -f must be used to overwrite its value.

-f: Overwrite any existing header.

-d: Remove the header instead of adding it.

Encrypt the message to all recipients. If a key for a recipient cannot be found the message will not be encrypted.

Sign the message using the account's default key. If pgp-key-id is set in accounts.conf (see aerc-accounts(5)), it will be used in priority. Otherwise, the From header address will be used to look for a matching private key in the pgp keyring.

Closes the terminal.