AERC-NOTMUCH(5) | File Formats Manual | 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
Basic Notmuch configuration may be done interactively with the :new-account command.
In accounts.conf (see aerc-accounts(5)), the following notmuch-specific options are available:
check-mail-cmd = <command>
Example:
check-mail-timeout = <duration>
Default: 10s
source = notmuch://<path>
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://~/mail
query-map = <file>
Multiple entries can be specified, one per line. Lines starting with # are ignored and serve as comments.
e.g. inbox=tag:inbox and not tag:archived
exclude-tags = <tag1,tag2,tag3...>
This can for example be useful if you use an archive or spam tag.
maildir-store = <path>
N.B.: aerc will still always show messages and not files (under notmuch, a single message can be represented by several files), which makes the semantics of certain commands as move ambiguous. Use multi-file-strategy to tell aerc how to resolve these ambiguities.
maildir-account-path = <path>
This could be used to achieve traditional maildir one tab per account behavior. The note on maildir-store also applies to this option.
multi-file-stategy = <strategy>
- refuse (default): Refuse to act.
- act-all: Act on all files.
- act-one: Act on one of the files, arbitrarily chosen, and ignore the
- act-one-delete-rest: Like act-one, but delete the remaining files.
- act-dir: Act on all files within the current folder and ignore the rest.
- •
- act-dir-delete-rest: Like act-dir, but delete the remaining files.
Note that the strategy has no effect on cross-account operations. Copying a message across accounts will always copy a single file, arbitrarily chosen. Moving a message across accounts will always copy a single file, arbitrarily chosen, and refuse to delete multiple files from the source account.
USAGE
Notmuch shows slightly different behavior than for example imap. Some commands are slightly different in semantics and mentioned below:
cf <notmuch query>
filter <notmuch query>
SEE ALSO
AUTHORS
Originally created by Drew DeVault and maintained by Robin Jarry who is assisted by other open source contributors. For more information about aerc development, see https://sr.ht/~rjarry/aerc/.
2024-07-30 |