Aerc: Difference between revisions

From Alpine Linux
(Add first draft of the aerc wiki page)
 
(Point to aerc-tutorial)
 
(3 intermediate revisions by one other user not shown)
Line 1: Line 1:
{{Draft|work in progress}}
[https://aerc-mail.org/ aerc] is a terminal email client (MUA) originally written by [https://sr.ht/~sircmpwn/ ~sircmpwn] and now maintained by [https://sr.ht/~rjarry/ ~rjarry]. It supports multiple accounts, mail synchronisation, GPG integration and more.
[https://aerc-mail.org/ aerc] is a terminal email client (MUA) originally written by [https://sr.ht/~sircmpwn/ ~sircmpwn] and now maintained by [https://sr.ht/~rjarry/ ~rjarry]. It supports multiple accounts, mail synchronisation, GPG integration and more.


Line 12: Line 14:
Settings specific to accounts (e.g. IMAP configuration) are stored in {{Path|$XDG_CONFIG_HOME/aerc/accounts.conf}} which should only be readable and writable by the owning user (permissions <code>600</code>) as it may store sensitive data like passwords in clear text.
Settings specific to accounts (e.g. IMAP configuration) are stored in {{Path|$XDG_CONFIG_HOME/aerc/accounts.conf}} which should only be readable and writable by the owning user (permissions <code>600</code>) as it may store sensitive data like passwords in clear text.


An example account configration using [[Msmtp|msmtp]] for sending email and [[Mbsync|mbsync]] could look like this:
An example account configration using [[Msmtp|msmtp]] for sending email and [[Mbsync|mbsync]] for fetching email to a local maildirpp store could look like this:


{{Cat|$XDG_CONFIG_HOME/aerc/accounts.conf|<nowiki>[primary]
{{Cat|$XDG_CONFIG_HOME/aerc/accounts.conf|<nowiki>[primary]
Line 22: Line 24:


The full configuration file format reference can be found in <code>aerc-accounts(5)</code>.
The full configuration file format reference can be found in <code>aerc-accounts(5)</code>.
== Documentation ==
aerc is extensively documented in its man pages. Consult <code>aerc-tutorial(7)</code> as a starting point.


== See also ==
== See also ==
Line 29: Line 35:
* [https://wiki.archlinux.org/title/Aerc aerc on the ArchWiki]
* [https://wiki.archlinux.org/title/Aerc aerc on the ArchWiki]


[[Category:Desktop]]
[[Category:Mail]]
[[Category:Mail]]
[[Category:Software]]
[[Category:Software]]

Latest revision as of 08:59, 7 July 2024

This material is work-in-progress ...

work in progress
(Last edited by WhyNotHugo on 7 Jul 2024.)

aerc is a terminal email client (MUA) originally written by ~sircmpwn and now maintained by ~rjarry. It supports multiple accounts, mail synchronisation, GPG integration and more.

Installation

aerc is available in the Community repository.

# apk add aerc

Configuration

Configuration for aerc is stored in $XDG_CONFIG_HOME/aerc, with $XDG_CONFIG_HOME falling back to ~/.config if it is unset. Settings specific to accounts (e.g. IMAP configuration) are stored in $XDG_CONFIG_HOME/aerc/accounts.conf which should only be readable and writable by the owning user (permissions 600) as it may store sensitive data like passwords in clear text.

An example account configration using msmtp for sending email and mbsync for fetching email to a local maildirpp store could look like this:

Contents of $XDG_CONFIG_HOME/aerc/accounts.conf

[primary] check-mail-cmd = mbsync primary copy-to = Sent from = Full Name <name@example.com> outgoing = msmtp -a primary source = maildirpp://~/mail/primary

The full configuration file format reference can be found in aerc-accounts(5).

Documentation

aerc is extensively documented in its man pages. Consult aerc-tutorial(7) as a starting point.

See also