aerc status

aerc is an email client for your terminal.

This is a fork of the original aerc
by Drew DeVault.

A short demonstration can be found on

Join the IRC channel: #aerc on
for end-user support, and #aerc-dev
for development.


On its first run, aerc will copy the default config files to ~/.config/aerc
on Linux or ~/Library/Preferences/aerc on MacOS (or $XDG_CONFIG_HOME/aerc if set)
and show the account configuration wizard.

If you redirect stdout to a file, logging output will be written to that file:

$ aerc > log

For instructions and documentation: see man aerc and further specific man
pages on there.

Note that the example HTML filter (off by default), additionally needs w3m and
dante to be installed.


Binary Packages

Recent versions of aerc are available on:

And likely other platforms.

From Source

Install the dependencies:

Then compile aerc:

$ make

aerc optionally supports notmuch. To enable it, you need to have a recent
version of notmuch, including the header
files (notmuch.h). Then compile aerc with the necessary build tags:

$ GOFLAGS=-tags=notmuch make

To install aerc locally:

# make install


Send patches and questions to
~rjarry/[email protected].

Instructions for preparing a patch are available at

Subscribe to release announcements on
~rjarry/[email protected]

Submit bug reports and feature requests on


View Github