2019-01-14 01:09:07 +00:00
|
|
|
# aerc
|
|
|
|
|
|
2019-05-25 19:58:40 +00:00
|
|
|
aerc is an email client for your terminal.
|
2019-01-14 01:09:07 +00:00
|
|
|
|
2020-04-06 12:29:12 +00:00
|
|
|
A short demonstration can be found on [https://aerc-mail.org/](https://aerc-mail.org/)
|
|
|
|
|
|
2021-08-25 04:14:43 +00:00
|
|
|
Join the IRC channel: [#aerc on irc.libera.chat](http://web.libera.chat/?channels=aerc&uio=d4)
|
|
|
|
|
for end-user support, and [#aerc-dev](http://web.libera.chat/?channels=aerc-dev&uio=d4)
|
2019-07-14 17:53:09 +00:00
|
|
|
for development.
|
2019-05-14 18:47:46 +00:00
|
|
|
|
2020-12-26 14:56:27 +00:00
|
|
|
## Usage
|
|
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
## Installation
|
|
|
|
|
|
|
|
|
|
### Binary Packages
|
|
|
|
|
|
|
|
|
|
Recent versions of aerc are available on:
|
|
|
|
|
- [Alpine](https://pkgs.alpinelinux.org/packages?name=aerc)
|
|
|
|
|
- [Arch](https://archlinux.org/packages/community/x86_64/aerc/)
|
|
|
|
|
- [macOS through Homebrew](https://formulae.brew.sh/formula/aerc)
|
|
|
|
|
|
|
|
|
|
And likely other platforms.
|
|
|
|
|
|
|
|
|
|
### From Source
|
2019-01-14 01:09:07 +00:00
|
|
|
|
2019-05-25 19:55:50 +00:00
|
|
|
Install the dependencies:
|
2019-05-17 22:15:50 +00:00
|
|
|
|
2020-04-06 12:29:12 +00:00
|
|
|
- go (>=1.13)
|
2020-02-02 06:13:59 +00:00
|
|
|
- [scdoc](https://git.sr.ht/~sircmpwn/scdoc)
|
2019-05-17 22:15:50 +00:00
|
|
|
|
2019-05-25 19:55:50 +00:00
|
|
|
Then compile aerc:
|
|
|
|
|
|
2019-05-17 17:45:20 +00:00
|
|
|
$ make
|
|
|
|
|
|
2019-08-05 07:16:10 +00:00
|
|
|
aerc optionally supports notmuch. To enable it, you need to have a recent
|
|
|
|
|
version of [notmuch](https://notmuchmail.org/#index7h2), including the header
|
|
|
|
|
files (notmuch.h). Then compile aerc with the necessary build tags:
|
|
|
|
|
|
|
|
|
|
$ GOFLAGS=-tags=notmuch make
|
|
|
|
|
|
2020-12-26 14:56:27 +00:00
|
|
|
To install aerc locally:
|
2019-05-17 17:45:20 +00:00
|
|
|
|
|
|
|
|
# make install
|
2019-06-12 16:20:49 +00:00
|
|
|
|
2019-05-26 16:00:51 +00:00
|
|
|
## Resources
|
2019-01-14 01:09:07 +00:00
|
|
|
|
2020-12-26 14:56:27 +00:00
|
|
|
Send patches and questions to
|
|
|
|
|
[~sircmpwn/aerc@lists.sr.ht](https://lists.sr.ht/~sircmpwn/aerc)
|
|
|
|
|
|
|
|
|
|
Instructions for preparing a patch are available at
|
|
|
|
|
[git-send-email.io](https://git-send-email.io)
|
2019-05-26 16:00:51 +00:00
|
|
|
|
|
|
|
|
Subscribe to release announcements on
|
|
|
|
|
[~sircmpwn/aerc-announce](https://lists.sr.ht/~sircmpwn/aerc-announce)
|
2019-03-17 21:47:35 +00:00
|
|
|
|
|
|
|
|
Bugs & todo here: [~sircmpwn/aerc2](https://todo.sr.ht/~sircmpwn/aerc2)
|
