aerc Terminal email client

Version 0.22.0 · source

Start here

j / k
Next / previous message
Enter
Open the message
C
Compose a new message
r r
Reply to all
d
Delete (asks first)
/
Search the folder
Ctrl+n / Ctrl+p
Next / previous tab
?
List keys for this view

Concepts

  1. Message list folders in the sidebar
  2. Viewer one tab per message
  3. Composer editor opens in a tab
  4. Review send, attach, postpone

Moving Around

j / k
Next / previous message
Ctrl+d / Ctrl+u
Half a page down / up
Ctrl+f / Ctrl+b
Full page down / up
g / G
First / last message
J / K
Next / previous folder
Ctrl+n / Ctrl+p
Next / previous tab
Ctrl+PgDn / Ctrl+PgUp
Next / previous tab (alternative)
[ t / ] t
Previous / next tab (vim-style)
:cf <folder>
Jump to a folder by name
H / L
Collapse / expand folder tree node
z z
Centre the selection
.
Repeat the last command
Ctrl+z
Suspend aerc

Reading

Enter
Open message in the viewer
q
Close viewer / quit from the list
In the viewer J / K step to the next / previous message. From the list, q asks first.
Ctrl+Down / Ctrl+Up
Next / previous message part
H
Toggle all headers
o
Open part with its handler
Ctrl+l
Open a link in the message
Ctrl+y
Copy a link
:toggle-sidebar
Hide or show the folder list
:help keys
Open the key reference

Write and Reply

C / m
Compose a new message
r r
Reply to all
R r
Reply to sender only
r q
Reply to all, quoting the message
R q
Reply to sender, quoting the message
f
Forward (in the viewer)
b
Bounce to other addresses
Ctrl+j / Ctrl+k
Next / previous header field
Ctrl+x
Type a : command from the editor
:cc <addr>
Add a Cc recipient
:bcc <addr>
Add a Bcc recipient
Alt+n / Alt+p
Next / previous sending account
Ctrl+o
Complete an address

Review and Send

y
Send the message
Other keys on the review screen
Key Action
n Discard, no confirmation
p Postpone to Drafts
e Edit body and headers
a / d Add / remove attachment
v Preview
s / x Toggle sign / encrypt

Delete and Tag

d
Delete, asking first
D
Delete immediately
a
Archive the message
v
Mark message for a bulk action
Space
Mark and move on
V
Visual mark mode
A
Archive all marked
:read / :unread
Set read state
:flag
Flag a message
:move <folder>
Move to a folder
:copy <folder>
Copy to a folder
:tag +<label>
Add a label or tag
:unmark -a
Clear all marks

Threads

T
Toggle threaded view
z c / z o
Fold / unfold thread
z a
Toggle fold of the thread
z M / z R
Fold / unfold all
:sort -r date
Sort newest first
:sort from
Sort by sender

Search and Filter

/
Search in the folder
n / N
Next / previous result
\
Filter the list
Esc
Clear search or filter
:filter -u
Show unread only
:filter -f <from>
Messages from a sender
:filter -d <range>
By date, e.g. last week
:filter -b <text>
Search message bodies
:filter -x flagged
Flagged messages only
:search -a <text>
Search whole message text

Folders, Saving and Pipes

:mkdir <name>
Create a folder
:check-mail
Fetch new mail now
S
Save attachment to a path
|
Pipe message to a command
$ / !
Run a shell command in a tab
Ctrl+t
Open a terminal tab
:pipe -m <cmd>
Pipe full message
:attach <path>
Attach a file to the draft
:detach
Remove an attachment

Command Line

aerc
Start the client
aerc mailto:<addr>
Open a composer for an address
aerc -a <account>
Start on one account
aerc -C <file>
Use another aerc.conf
aerc -v
Print version
:new-account
Run the account wizard
:quit
Leave aerc

Config Files

Message sources
Scheme Backend
imaps:// IMAP over TLS
maildir:// Local Maildir
notmuch:// Notmuch database
jmap:// JMAP

Recipes

Minimal IMAP account
# accounts.conf[Work]source   = imaps://me@example.com@imap.example.comoutgoing = smtps://me@example.com@smtp.example.comdefault  = INBOXfrom     = Me <me@example.com>
Add vim-style binds
# binds.conf[messages]gg = :select 0<Enter>ga = :flag -a<Enter>[view]x = :close<Enter>
Apply a patch series
# mark the patches with v, then::pipe -m git am -3# or: :patch apply <tag>
Unread from a person this week
:filter -u -f alice -d this week