NAME

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

MAILDIR & IMAP

       search [-ruba] [-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.

           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
                   Flagged
                       Flagged messages

           -H: Search in the headers of the messages, for a specific header
               Syntax: Header: Value If the space between : and the value is ommited, aerc will
               not search for the Header.

           -b: Search in the body of the messages

           -a: Search in the entire text of the messages

           -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) where
               the dates are in the YYYY-MM-DD format.

               Relative dates can be used to specify a date range. Spaces and underscores are
               allowed to improve readability:

               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.

NOTMUCH

       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 <sir@cmpwn.com> and maintained by Robin Jarry
       <robin@jarry.cc> who is assisted by other open source contributors. For more information
       about aerc development, see https://sr.ht/~rjarry/aerc/.

                                            2024-01-18                             AERC-SEARCH(1)