AERC

This is my aerc configuration.

Usage

Clone this repo to ~/.config/aerc/, edit the accounts.conf¹ (and credentials.sh) file, launch aerc and enjoy.

Requirements

It uses keepassxc-cli (comes with keepassxc). See credentials.sh.

credentials.sh

is a helper script to be used in accounts.confs *-cred-cmd.

It is a wrapper around keepassxc-cli and does some password caching in $XDG_RUNTIME_DIR.

Example:

[Example]
source = imaps://mail%40example.com@imap.example.com:993
source-cred-cmd = ~/.config/aerc/credentials.sh "Example/Mail"
outgoing = smtps://mail%40example.com@smtp.example.com:465
outgoing-cred-cmd = ~/.config/aerc/credentials.sh "Example/Mail"

addresses/ and addresses.py

addresses.py is my address book handler, used in accounts.confs address-book-cmd.

It requires at least 2 arguments. The last argument is the query provided by aerc all other arguments will be interpreted as filenames under ~/.config/aerc/addresses/.

addresses/ is a directory containing address books.

Example:

[Example]
address-book-cmd = /home/linluk/.config/aerc/addresses.py "tsn-teachers" "tsn-students" "%s"

tsn-* Address Books

Are generated from vCard v3 Address-Books by tools/tsn.py.

The source Address-Books can be downloaded from mail.tsn.at (requires login).

Address Books

are simple text files.

addresses.py allows the following features:

• Empty lines.
• Comment lines (lines starting with #, possibly spaces before #).
• Unsorted entries (addresses.py sorts them, so that aerc doesn't have to)
• The format is: Max Musterman <max.musterman@example.com>

Signatures

are simple text files. configured by account in accounts.conf.

Note from man aerc-accounts

 signature-file = <path>
 Specifies the file to read in order to obtain the signature to be
 added to emails sent from this account.
 Please note that by convention the Usenet signature style of
 two dashes, followed by a space ("-- ") should be placed at the
 top of the signature to separate content and signature. Aerc will
 add that delimiter if it is not already present.

TODO

• A tool to import (and split by class) the tsn address book (from vCard or CSV to simple flat text files)
• A way to include "unsafe" files (files including personal information) in the repository (gpg --encryp? passphrase in keepass? lfs?)
  • address books
  • signature
• Add GMail account(s)