2019-08-05 07:16:10 +00:00
|
|
|
aerc-notmuch(5)
|
|
|
|
|
|
|
|
|
|
# NAME
|
|
|
|
|
|
|
|
|
|
aerc-notmuch - notmuch configuration for *aerc*(1)
|
|
|
|
|
|
|
|
|
|
# SYNOPSIS
|
|
|
|
|
|
|
|
|
|
aerc supports using the notmuch email system as a backend, for fast indexing
|
|
|
|
|
and searching.
|
|
|
|
|
|
|
|
|
|
For this to be enabled, aerc needs to be build with notmuch support.++
|
|
|
|
|
Refer to the installation instructions for details.
|
|
|
|
|
|
|
|
|
|
# CONFIGURATION
|
|
|
|
|
|
|
|
|
|
Notmuch accounts currently are not supported with the :new-account command and
|
|
|
|
|
must be added manually.
|
|
|
|
|
|
|
|
|
|
In accounts.conf (see *aerc-config*(5)), the following notmuch-specific
|
|
|
|
|
options are available:
|
|
|
|
|
|
2022-05-30 12:34:18 +00:00
|
|
|
*check-mail-cmd*
|
|
|
|
|
Command to run in conjunction with *check-mail* option.
|
|
|
|
|
|
|
|
|
|
Example:
|
|
|
|
|
mbsync -a
|
|
|
|
|
|
|
|
|
|
Default: none
|
|
|
|
|
|
|
|
|
|
*check-mail-timeout*
|
|
|
|
|
Timeout for the *check-mail-cmd*. The command will be stopped if it does
|
|
|
|
|
not complete in this interval and an error will be displayed. Increase from
|
|
|
|
|
the default if repeated errors occur
|
|
|
|
|
|
|
|
|
|
Default: 10s
|
|
|
|
|
|
2019-08-05 07:16:10 +00:00
|
|
|
*source*
|
|
|
|
|
notmuch://path
|
|
|
|
|
|
|
|
|
|
The *source* indicates the path to the directory containing your notmuch
|
|
|
|
|
database (usually a .notmuch folder).
|
|
|
|
|
|
|
|
|
|
The path portion of the URL following _notmuch://_ must be either an absolute
|
|
|
|
|
path prefixed by */* or a path relative to your home directory prefixed with
|
|
|
|
|
*~*. For example:
|
|
|
|
|
|
|
|
|
|
source = notmuch:///home/me/mail
|
|
|
|
|
|
|
|
|
|
source = notmuch://~/mail
|
|
|
|
|
|
|
|
|
|
*query-map*
|
|
|
|
|
Path to a file containing a mapping from display name to notmuch query in
|
|
|
|
|
the form of NAME=QUERY.++
|
2020-10-08 18:40:07 +00:00
|
|
|
Multiple entries can be specified, one per line.++
|
|
|
|
|
Lines starting with '#' are ignored and serve as comments.
|
2019-08-05 07:16:10 +00:00
|
|
|
|
|
|
|
|
e.g. inbox=tag:inbox and not tag:archived
|
|
|
|
|
|
|
|
|
|
Default: none
|
|
|
|
|
|
|
|
|
|
*exclude-tags*
|
|
|
|
|
Comma separated list of tags which will be excluded from query results,
|
|
|
|
|
unless explicitly mentioned in the query.++
|
|
|
|
|
This can for example be useful if you use an archive or spam tag.
|
|
|
|
|
|
|
|
|
|
Default: none
|
|
|
|
|
|
2020-08-08 10:34:34 +00:00
|
|
|
# USAGE
|
|
|
|
|
|
|
|
|
|
Notmuch shows slightly different behaviour than for example imap.++
|
|
|
|
|
Some commands are simply unsupported because they have no proper counterpart
|
|
|
|
|
in notmuch, like :delete and :archive.++
|
|
|
|
|
Others are slightly different in semantics and mentioned below:
|
|
|
|
|
|
|
|
|
|
*cf* <notmuch query>
|
2022-07-05 19:48:40 +00:00
|
|
|
The change folder command allows for arbitrary notmuch queries. Performing a
|
|
|
|
|
cf command will perform a new top-level notmuch query
|
|
|
|
|
|
|
|
|
|
*filter* <notmuch query>
|
|
|
|
|
The filter command for notmuch backends takes in arbitrary notmuch queries.
|
|
|
|
|
It applies the query on the set of messages shown in the message list. This
|
|
|
|
|
can be used to perform successive filters/queries. It is equivalent to
|
|
|
|
|
performing a set of queries concatenated with "and"
|
2020-08-08 10:34:34 +00:00
|
|
|
|
2019-08-05 07:16:10 +00:00
|
|
|
# SEE ALSO
|
|
|
|
|
|
|
|
|
|
*aerc*(1) *aerc-config*(5) *aerc-smtp*(5) *aerc-maildir*(5)
|
|
|
|
|
|
|
|
|
|
# AUTHORS
|
|
|
|
|
|
2022-01-26 10:41:20 +00:00
|
|
|
Originally created by Drew DeVault <sir@cmpwn.com> and maintained by Robin
|
2021-11-09 19:11:42 +00:00
|
|
|
Jarry <robin@jarry.cc> who is assisted by other open source contributors. For
|
|
|
|
|
more information about aerc development, see https://sr.ht/~rjarry/aerc/.
|
