Fork of the aerc email client (
Go to file
Robin Jarry 14ceca3200 address-book-cmd: be more lenient with errors
Instead of failing completely when address-book-cmd returns an invalid
line, ignore the line and report a warning in the logs.

Do not wait for 100 "valid" addresses before bailing out as the command
could only output garbage in large quantities. The issue of the command
not printing any new line characters still exists. We could address this
but I think it would be overkill.

Reported-by: Bence Ferdinandy <>
Signed-off-by: Robin Jarry <>
Tested-by: Bence Ferdinandy <>
2022-11-03 10:15:12 +01:00
.builds go: bumped minimum required version 1.16 2022-08-05 21:55:26 +02:00
.github/workflows builds: add gnupg in preparation of gpg integration 2022-04-14 21:51:09 +02:00
commands envelope: display message envelope info 2022-10-26 00:19:49 +02:00
completer address-book-cmd: be more lenient with errors 2022-11-03 10:15:12 +01:00
config threads: reverse thread ordering 2022-10-27 22:44:39 +02:00
contrib strip trailing white space 2022-10-20 22:20:42 +02:00
doc threads: reverse thread ordering 2022-10-27 22:44:39 +02:00
filters colorize: make it compatible with BSD awk 2022-10-23 20:51:02 +02:00
lib threads: reverse thread ordering 2022-10-27 22:44:39 +02:00
logging aerc: add build info to version string 2022-08-22 15:46:33 +02:00
models msgpart: factorize mime type and filename construction 2022-10-16 11:35:24 +02:00
templates compose: add default template for new messages 2022-01-19 21:42:41 +01:00
widgets msglist: display reversed thread ordering 2022-10-27 22:47:30 +02:00
worker notmuch: move new maildir files to cur upon opening a folder 2022-10-27 21:45:31 +02:00
.editorconfig doc: add contribution guidelines including code style 2022-08-05 21:57:12 +02:00
.gitignore gitignore: ignore race.log.* 2022-09-26 17:31:10 +02:00
.golangci.toml lint: add golangci-lint to the linters 2022-08-04 21:58:06 +02:00
.mailmap Add git mailmap 2022-07-23 22:07:04 +02:00 threads: reverse thread ordering 2022-10-27 22:44:39 +02:00 contributing: refine commit message rules 2022-08-23 17:16:55 +02:00
LICENSE LICENSE: add license name 2022-02-06 16:04:15 +01:00
MAINTAINERS Add MAINTAINERS file 2022-10-01 17:34:44 +02:00
Makefile Release version 0.13.0 2022-10-20 22:21:09 +02:00 readme: make contribution section more obvious 2022-08-06 23:12:24 +02:00
aerc.go aercmsg: add AercFuncMsg and QueueFunc 2022-10-18 22:20:44 +02:00
go.mod terminal: bump tcell-term version 2022-10-19 21:01:55 +02:00
go.sum terminal: bump tcell-term version 2022-10-19 21:01:55 +02:00
tools.go restore compatibility with Go 1.16 2022-08-06 23:12:35 +02:00

aerc status GitHub macOS CI 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 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:

User contributions and integration with external tools:


Binary Packages

Recent versions of aerc are available on:

And likely other platforms.

From Source

Install the dependencies:

  • go (>=1.16) (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

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

By default, aerc will install config files to directories under /usr/local/aerc, and will search for templates and stylesets in these locations in order:

  • ${XDG_CONFIG_HOME:-~/.config}/aerc
  • ${XDG_DATA_HOME:-~/.local/share}/aerc
  • /usr/local/share/aerc
  • /usr/share/aerc

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 /custom/location/share/aerc, 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 ~rjarry/

Send patches and development related questions to ~rjarry/

Instructions for preparing a patch are available at

Subscribe to release announcements on ~rjarry/

Submit confirmed bug reports and confirmed feature requests on


Change log.