1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
|
AERC-SEARCH(1)
# NAME
aerc-search - search and filter patterns and options for *aerc*(1)
# SYNTAX
This syntax is common to all backends.
*:filter* [*-rubae*] [*-x* _<flag>_] [*-X* _<flag>_] [*-H* _<header>:[<value>]_] [*-f* _<from>_] [*-t* _<to>_] [*-c* _<cc>_] [*-d* _<start[..end]>_] [_<terms>_...]++
*:search* [*-rubae*] [*-x* _<flag>_] [*-X* _<flag>_] [*-H* _<header>:[<value>]_] [*-f* _<from>_] [*-t* _<to>_] [*-c* _<cc>_] [*-d* _<start[..end]>_] [_<terms>_...]
Searches the current folder for messages matching the given set of
conditions.
*:filter* restricts the displayed messages to only the search results.
Each space separated term of _<terms>_, if provided, is searched
case-insensitively among subject lines unless *-b* or *-a* are
provided.
*-r*: Search for read messages
*-u*: Search for unread messages
*-x* _<flag>_, *-X* _<flag>_: Restrict search to messages with or without _<flag>_
Use *-x* to search for messages with the flag set.
Use *-X* to search for messages without the flag set.
Possible values are:
_Seen_
Read messages
_Answered_
Replied messages
_Forwarded_
Forwarded messages
_Flagged_
Flagged messages
_Draft_
Draft messages
*-H* _<header>:[<value>]_:
Search in the headers of the messages for a specific _<header>_ that matches _<value>_,
_<value>_ can be omitted to only search for a the _<header>_.
If either the _<header>_ or the _<value>_ contain a space then the whole argument needs
to be escaped with quotes, note: spaces around _<value>_ are trimmed.
*-b*: Search in the body of the messages
*-a*: Search in the entire text of the messages
*-e*: Instruct the backend to use a custom search extension
(such as the X-GM-EXT if available). Search terms are expected
in _<terms>_; other flags will be ignored.
*-f* _<from>_: Search for messages from _<from>_
*-t* _<to>_: Search for messages to _<to>_
*-c* _<cc>_: Search for messages cc'ed to _<cc>_
*-d* _<start[..end]>_:
Search for messages within a particular date range defined as
\[start, end).
Spaces and underscores are allowed in relative dates to improve
readability.
_YYYY-MM-DD_
*today*, *yesterday*
*(this|last) (year|month|week)*
*Weekdays*, *Monthnames*
Can also be abbreviate, so Monday..Tuesday can written
as Mon..Tue and February..March as Feb..Mar.
_<N>_ *(y[ear]|m[onth]|w[eek]|d[ay])*
_<N>_ is a positive integer that represents the number
of the time units in the past. Multiple relative terms
can will be accumulated. The units can also be
abbreviated by a single letter such that yesterday would
correspond to _1d_ (equivalent to _1 day_ or _1_day_)
and _8 days ago_ would be either _1w1d_ or _8d_.
# CUSTOM IMAP EXTENSIONS
The Gmail IMAP extension (X-GM-EXT-1) can be used for searching and filtering.
To use this custom extension, make sure it is activated (see *aerc-imap*(5))
and use the extension *-e* flag in your *:filter* or *:search* commands.
Example:
:filter -e filename:pdf from:bob
:filter -e has:attachment newer_than:2d
:search -e is:read is:starred
:search -e list:~rjarry/aerc-devel@lists.sr.ht
# NOTMUCH
For notmuch, it is possible to avoid using the above flags and only rely on
notmuch search syntax.
*:filter* _query_...++
*:search* _query_...
You can use the full notmuch query language as described in
*notmuch-search-terms*(7).
The query will only apply on top of the active folder query.
Example, jump to next unread:
:search tag:unread
# SEE ALSO
*aerc*(1) *aerc-config*(5)
# 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/_.
|
