1aerc-notmuch(5)               File Formats Manual              aerc-notmuch(5)
2
3
4

NAME

6       aerc-notmuch - notmuch configuration for aerc(1)
7

SYNOPSIS

9       aerc supports using the notmuch email system as a backend, for fast in‐
10       dexing and searching.
11
12       For this to be enabled, aerc needs to be build with notmuch support.
13       Refer to the installation instructions for details.
14

CONFIGURATION

16       Notmuch accounts currently are not supported with the :new-account com‐
17       mand and must be added manually.
18
19       In accounts.conf (see aerc-config(5)), the following notmuch-specific
20       options are available:
21
22       source
23           notmuch://path
24
25           The source indicates the path to the directory containing your not‐
26           much database (usually a .notmuch folder).
27
28           The path portion of the URL following notmuch:// must be either an
29           absolute path prefixed by / or a path relative to your home direc‐
30           tory prefixed with ~. For example:
31
32               source = notmuch:///home/me/mail
33
34               source = notmuch://~/mail
35
36       query-map
37           Path to a file containing a mapping from display name to notmuch
38           query in the form of NAME=QUERY.
39           Multiple entries can be specified, one per line.
40           Lines starting with '#' are ignored and serve as comments.
41
42           e.g. inbox=tag:inbox and not tag:archived
43
44           Default: none
45
46       exclude-tags
47           Comma separated list of tags which will be excluded from query re‐
48           sults, unless explicitly mentioned in the query.
49           This can for example be useful if you use an archive or spam tag.
50
51           Default: none
52

USAGE

54       Notmuch shows slightly different behaviour than for example imap.
55       Some commands are simply unsupported because they have no proper coun‐
56       terpart in notmuch, like :delete and :archive.
57       Others are slightly different in semantics and mentioned below:
58
59       cf <notmuch query>
60           The change folder command allows for arbitrary notmuch queries and
61           should usually be preferred over :filter as it will be much faster
62           if you use the notmuch database to do the filtering
63

SEE ALSO

65       aerc(1) aerc-config(5) aerc-smtp(5) aerc-maildir(5)
66

AUTHORS

68       Originally created by Drew DeVault <sir@cmpwn.com> and maintained by
69       Robin Jarry <robin@jarry.cc> who is assisted by other open source con‐
70       tributors. For more information about aerc development, see
71       https://sr.ht/~rjarry/aerc/.
72
73
74
75                                  2022-06-18                   aerc-notmuch(5)
Impressum