7899d15d60
Allow users to add attachments to emails in the Compose view. Syntax is :attach <path>, where path is a valid file. Attachments will show up in the pre-send review screen.
188 lines
4.8 KiB
Markdown
188 lines
4.8 KiB
Markdown
aerc(1)
|
|
|
|
# NAME
|
|
|
|
aerc - the world's best email client
|
|
|
|
# SYNOPSIS
|
|
|
|
_aerc_ [-v]
|
|
|
|
For a guided tutorial, use *:help tutorial* from aerc, or *man aerc-tutorial*
|
|
from your terminal.
|
|
|
|
# OPTIONS
|
|
|
|
*-v*
|
|
Prints the installed version of aerc and exits.
|
|
|
|
# RUNTIME COMMANDS
|
|
|
|
To execute a command, press ':' to bring up the command interface. Commands may
|
|
also be bound to keys, see *aerc-config*(5) for details. In some contexts, such
|
|
as the terminal emulator, ';' is used to bring up the command interface.
|
|
|
|
Different commands work in different contexts, depending on the kind of tab you
|
|
have selected.
|
|
|
|
## GLOBAL COMMANDS
|
|
|
|
These commands work in any context.
|
|
|
|
*cd* <directory>
|
|
Changes aerc's current working directory.
|
|
|
|
*exec* <command...>
|
|
Executes an arbitrary command in the background.
|
|
|
|
*Note*: commands executed in this way are not executed with the shell.
|
|
|
|
*pwd*
|
|
Displays aerc's current working directory in the status bar.
|
|
|
|
*term* [command...]
|
|
Opens a new terminal tab with a shell running in the current working
|
|
directory, or the specified command.
|
|
|
|
*prev-tab* [n], *next-tab* [n]
|
|
Cycles to the previous or next tab in the list, repeating n times
|
|
(default: 1).
|
|
|
|
*quit*
|
|
Exits aerc.
|
|
|
|
## MESSAGE COMMANDS
|
|
|
|
These commands are valid in any context that has a selected message (e.g. the
|
|
message list, the message in the message viewer, etc).
|
|
|
|
*archive* <scheme>
|
|
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
|
|
|
|
*copy* <target>
|
|
Copies the selected message to the target folder.
|
|
|
|
*delete*
|
|
Deletes the selected message.
|
|
|
|
*forward*
|
|
Opens the composer to forward the selected message to another recipient.
|
|
|
|
*move* <target>
|
|
Moves the selected message to the target folder.
|
|
|
|
*pipe* [-bmp] <cmd>
|
|
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.
|
|
|
|
*-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
|
|
|
|
*reply* [-aq]
|
|
Opens the composer to reply to the selected message.
|
|
|
|
*-a*: Reply all
|
|
|
|
*-q*: Insert a quoted version of the selected message into the reply editor
|
|
|
|
*read*
|
|
Marks the selected message as read.
|
|
|
|
*-t*: Toggle the selected message between read and unread.
|
|
|
|
*unread*
|
|
Marks the selected message as unread.
|
|
|
|
*-t*: Toggle the selected message between read and unread.
|
|
|
|
*unsubscribe*
|
|
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.
|
|
|
|
## MESSAGE LIST COMMANDS
|
|
|
|
*cf* <folder>
|
|
Change the folder shown in the message list.
|
|
|
|
*compose*
|
|
Open the compose window to send a new email. The new email will be sent with
|
|
the current account's outgoing transport configuration, see
|
|
*aerc-config*(5) for details on configuring outgoing emails.
|
|
|
|
*mkdir* <name>
|
|
Creates a new folder for this account and changes to that folder.
|
|
|
|
*next-folder* <n>, *prev-folder* <n>
|
|
Cycles to the next (or previous) folder shown in the sidebar, repeated n
|
|
times (default: 1).
|
|
|
|
*next* <n>[%], *prev-message* <n>[%]
|
|
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.
|
|
|
|
*select* <n>
|
|
Selects the nth message in the message list (and scrolls it into view if
|
|
necessary).
|
|
|
|
*view*
|
|
Opens the message viewer to display the selected message.
|
|
|
|
## MESSAGE VIEW COMMANDS
|
|
|
|
*open*
|
|
Saves the current message part in a temporary file and opens it
|
|
with the system handler.
|
|
|
|
*save* [-p] <path>
|
|
Saves the current message part to the given path.
|
|
|
|
If no path is given but general.default-save-path is set, the
|
|
file will be saved there.
|
|
|
|
*-p*: Make any directories in the path that do not exist
|
|
|
|
*close*
|
|
Closes the message viewer.
|
|
|
|
## MESSAGE COMPOSE COMMANDS
|
|
|
|
*attach* <path>
|
|
Attaches the file at the given path to the email.
|
|
|
|
## TERMINAL COMMANDS
|
|
|
|
*close*
|
|
Closes the terminal.
|
|
|
|
# LOGGING
|
|
|
|
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:
|
|
|
|
$ aerc > log
|
|
|
|
# SEE ALSO
|
|
|
|
*aerc-config*(5) *aerc-imap*(5) *aerc-smtp*(5) *aerc-maildir*(5)
|
|
*aerc-tutorial*(7)
|
|
|
|
# AUTHORS
|
|
|
|
Maintained by Drew DeVault <sir@cmpwn.com>, who is assisted by other open
|
|
source contributors. For more information about aerc development, see
|
|
https://git.sr.ht/~sircmpwn/aerc.
|