LinuxCommandLibrary

aerc

Terminal email client with tabs and embedded terminal

TLDR

Launch aerc
$ aerc
copy
Open with a specific account only
$ aerc -a [account_name]
copy
Compose a new email to an address
$ aerc mailto:[user@example.com]
copy
Open an mbox file
$ aerc mbox:[path/to/file.mbox]
copy
Use a custom configuration file
$ aerc -C [path/to/aerc.conf]
copy

SYNOPSIS

aerc [-h] [-v] [-a name] [-C file] [-A file] [-B file] [-I] [mailto:...|mbox:file|:command]

DESCRIPTION

aerc is a terminal-based email client written in Go, designed for power users and developers. It features a tabbed interface allowing multiple accounts and emails to be open simultaneously, an embedded terminal emulator for running shell commands alongside email tasks, and vim-style keybindings with an ex-command system.
aerc supports IMAP, JMAP, Maildir, Notmuch, and Mbox backends with SMTP and sendmail for sending. It handles email threading, PGP signing and encryption via GnuPG, HTML email rendering through external filters, syntax-highlighted patches and diffs, CardDAV contact lookups, and template-based composition. The UI never locks up due to network issues thanks to asynchronous IMAP and JMAP support.

PARAMETERS

-h, --help

Show usage help and exit
-v, --version
Print the installed version and exit
-a name, --account name
Load only the named account(s); comma-separated or repeated
-C path, --aerc-conf path
Use a custom aerc.conf configuration file
-A path, --accounts-conf path
Use a custom accounts.conf file
-B path, --binds-conf path
Use a custom key bindings configuration file
-I, --no-ipc
Run commands directly instead of over IPC to an existing instance

CONFIGURATION

Configuration files are stored in $XDG_CONFIG_HOME/aerc/ (typically ~/.config/aerc/):
aerc.conf -- Main application configuration (UI, logging, filters)
accounts.conf -- Email account definitions (server, credentials, backend type)
binds.conf -- Key binding customizations

CAVEATS

HTML email rendering requires w3m to be installed. Homebrew builds on macOS do not include notmuch support; compile from source if needed. The project uses a mailing-list-based patch submission workflow via git-send-email rather than pull requests.

HISTORY

aerc was originally created by Drew DeVault (sircmpwn) with the first commit in January 2018 and the 0.1.0 pre-release announced in June 2019. After the original project became unmaintained, Robin Jarry forked and took over active maintenance. The project is hosted on SourceHut and licensed under the MIT license.

SEE ALSO

mutt(1), alpine(1), neomutt(1), notmuch(1)

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard