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 https://aerc-mail.org/
Join the IRC channel: #aerc on irc.libera.chat for end-user support, and development.
On its first run, aerc will copy the default config files to
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 > aerc.log
Note that the example HTML filter (off by default), additionally needs
dante to be installed.
Also available as man pages:
User contributions and integration with external tools:
Recent versions of aerc are available on:
And likely other platforms.
Install the dependencies:
makecommands must be replaced by
Then compile aerc:
aerc optionally supports notmuch. To enable it, you need to have a recent
version of notmuch, including the header
files (notmuch.h). The
notmuch build tag should be automatically added. To
check if it is, run the following command:
$ ./aerc -v aerc 0.14.0-108-g31e1cd9af565 +notmuch (go1.19.6 amd64 linux) ^^^^^^^^
If it is not, you can force it before building:
$ make GOFLAGS=-tags=notmuch
If you have notmuch headers available but do not want to build notmuch support in aerc, force GOFLAGS to an empty value:
$ make GOFLAGS=
To install aerc locally:
# make install
By default, aerc will install config files to directories under
and will search for templates and stylesets in these locations in order:
At build time it is possible to add an extra location to this list and to use
that location as the default install location for config files by setting the
PREFIX option like so:
# make PREFIX=/custom/location # make install PREFIX=/custom/location
This will install templates and other config files to
and man pages to
/custom/location/share/man. This extra location will have lower
priority than the XDG locations but higher than the fixed paths.
Anyone can contribute to aerc. Please refer to the contribution guidelines
Ask for support or follow general discussions on ~email@example.com.
Send patches and development related questions to ~firstname.lastname@example.org.
Instructions for preparing a patch are available at git-send-email.io
Subscribe to release announcements on ~email@example.com
Submit confirmed bug reports and confirmed feature requests on https://todo.sr.ht/~rjarry/aerc.