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 ~/.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
Note that the example HTML filter (off by default), additionally needs w3m
and
dante
to be installed.
Also available as man pages:
- aerc(1)
- aerc-accounts(5)
- aerc-binds(5)
- aerc-config(5)
- aerc-imap(5)
- aerc-jmap(5)
- aerc-maildir(5)
- aerc-notmuch(5)
- aerc-patch(7)
- aerc-search(1)
- aerc-sendmail(5)
- aerc-smtp(5)
- aerc-stylesets(7)
- aerc-templates(7)
- aerc-tutorial(7)
User contributions and integration with external tools:
Recent versions of aerc are available on:
And likely other platforms.
Install the dependencies:
- go (>=1.21) (Go versions are supported until their end-of-life; support for older versions may be dropped at any time due to incompatibilities or newer required language features.)
- scdoc
- GNU make
Then compile aerc:
$ gmake
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:
$ gmake 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:
$ gmake GOFLAGS=
To install aerc locally:
# gmake instal