1AERC-SEARCH(1)              General Commands Manual             AERC-SEARCH(1)
2
3
4

NAME

6       aerc-search - search and filter patterns and options for aerc(1)
7

MAILDIR & IMAP

9       search [-ruba] [-x <flag>] [-X <flag>] [-H Header: Value] [-f <from>]
10       [-t <to>] [-c <cc>] [-d <start[,end]>] [<terms>...]
11           Searches the current folder for messages matching the given set of
12           conditions.
13
14           Each space separated term of <terms>, if provided, is searched
15           case-insensitively among subject lines unless -b or -a are pro‐
16           vided.
17
18           -r: Search for read messages
19
20           -u: Search for unread messages
21
22           -x <flag>, -X <flag>: Restrict search to messages with or without
23           <flag>
24               Use -x to search for messages with the flag set. Use -X to
25               search for messages without the flag set.
26
27               Possible values are:
28                   Seen
29                       Read messages
30                   Answered
31                       Replied messages
32                   Flagged
33                       Flagged messages
34
35           -H: Search in the headers of the messages, for a specific header
36               Syntax: Header: Value If the space between : and the value is
37               ommited, aerc will not search for the Header.
38
39           -b: Search in the body of the messages
40
41           -a: Search in the entire text of the messages
42
43           -f <from>: Search for messages from <from>
44
45           -t <to>: Search for messages to <to>
46
47           -c <cc>: Search for messages cc'ed to <cc>
48
49           -d <start[..end]>:
50               Search for messages within a particular date range defined as
51               [start, end) where the dates are in the YYYY-MM-DD format.
52
53               Relative dates can be used to specify a date range. Spaces and
54               underscores are allowed to improve readability:
55
56               today, yesterday
57
58               (this|last) (year|month|week)
59
60               Weekdays, Monthnames
61                   Can also be abbreviate, so Monday..Tuesday can written as
62                   Mon..Tue and February..March as Feb..Mar.
63
64               <N> (y[ear]|m[onth]|w[eek]|d[ay])
65                   <N> is a positive integer that represents the number of the
66                   time units in the past. Multiple relative terms can will be
67                   accumulated. The units can also be abbreviated by a single
68                   letter such that yesterday would correspond to 1d (equiva‐
69                   lent to 1 day or 1_day) and 8 days ago would be either 1w1d
70                   or 8d.
71

NOTMUCH

73       search query...
74           You can use the full notmuch query language as described in not‐
75           much-search-terms(7).
76
77           The query will only apply on top of the active folder query.
78
79           Example, jump to next unread:
80
81               :search tag:unread
82

SEE ALSO

84       aerc(1) aerc-config(5)
85

AUTHORS

87       Originally created by Drew DeVault <sir@cmpwn.com> and maintained by
88       Robin Jarry <robin@jarry.cc> who is assisted by other open source con‐
89       tributors. For more information about aerc development, see
90       https://sr.ht/~rjarry/aerc/.
91
92
93
94                                  2023-07-16                    AERC-SEARCH(1)