.\" Generated by scdoc 1.11.3
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "AERC-SEARCH" "1" "2024-04-07"
.PP
.SH NAME
.PP
aerc-search - search and filter patterns and options for \fBaerc\fR(1)
.PP
.SH SYNTAX
.PP
This syntax is common to all backends.\&
.PP
\fB:filter\fR [\fB-ruba\fR] [\fB-x\fR \fI<flag>\fR] [\fB-X\fR \fI<flag>\fR] [\fB-H\fR \fIHeader: Value\fR] [\fB-f\fR \fI<from>\fR] [\fB-t\fR \fI<to>\fR] [\fB-c\fR \fI<cc>\fR] [\fB-d\fR \fI<start[,end]>\fR] [\fI<terms>\fR.\&.\&.\&]
.br
\fB:search\fR [\fB-ruba\fR] [\fB-x\fR \fI<flag>\fR] [\fB-X\fR \fI<flag>\fR] [\fB-H\fR \fIHeader: Value\fR] [\fB-f\fR \fI<from>\fR] [\fB-t\fR \fI<to>\fR] [\fB-c\fR \fI<cc>\fR] [\fB-d\fR \fI<start[,end]>\fR] [\fI<terms>\fR.\&.\&.\&]
.RS 4
Searches the current folder for messages matching the given set of
conditions.\&
.PP
\fB:filter\fR restricts the displayed messages to only the search results.\&
.PP
Each space separated term of \fI<terms>\fR, if provided, is searched
case-insensitively among subject lines unless \fB-b\fR or \fB-a\fR are
provided.\&
.PP
\fB-r\fR: Search for read messages
.PP
\fB-u\fR: Search for unread messages
.PP
\fB-x\fR \fI<flag>\fR, \fB-X\fR \fI<flag>\fR: Restrict search to messages with or without \fI<flag>\fR
.RS 4
Use \fB-x\fR to search for messages with the flag set.\&
Use \fB-X\fR to search for messages without the flag set.\&
.PP
Possible values are:
.RS 4
\fISeen\fR
.RS 4
Read messages
.RE
\fIAnswered\fR
.RS 4
Replied messages
.RE
\fIFlagged\fR
.RS 4
Flagged messages
.RE
\fIDraft\fR
.RS 4
Draft messages
.PP
.RE
.RE
.RE
\fB-H\fR: Search in the headers of the messages, for a specific header
.RS 4
Syntax: \fIHeader: Value\fR
If the space between \fI:\fR and the value is omitted, aerc will not
search for the Header.\&
.PP
.RE
\fB-b\fR: Search in the body of the messages
.PP
\fB-a\fR: Search in the entire text of the messages
.PP
\fB-f\fR \fI<from>\fR: Search for messages from \fI<from>\fR
.PP
\fB-t\fR \fI<to>\fR: Search for messages to \fI<to>\fR
.PP
\fB-c\fR \fI<cc>\fR: Search for messages cc'\&ed to \fI<cc>\fR
.PP
\fB-d\fR \fI<start[.\&.\&end]>\fR:
.RS 4
Search for messages within a particular date range defined as
[start, end).\&
.PP
Spaces and underscores are allowed in relative dates to improve
readability.\&
.PP
\fIYYYY-MM-DD\fR
.PP
\fBtoday\fR, \fByesterday\fR
.PP
\fB(this|last) (year|month|week)\fR
.PP
\fBWeekdays\fR, \fBMonthnames\fR
.RS 4
Can also be abbreviate, so Monday.\&.\&Tuesday can written
as Mon.\&.\&Tue and February.\&.\&March as Feb.\&.\&Mar.\&
.PP
.RE
\fI<N>\fR \fB(y[ear]|m[onth]|w[eek]|d[ay])\fR
.RS 4
\fI<N>\fR 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 \fI1d\fR (equivalent to \fI1 day\fR or \fI1_day\fR)
and \fI8 days ago\fR would be either \fI1w1d\fR or \fI8d\fR.\&
.PP
.RE
.RE
.RE
.SH NOTMUCH
.PP
For notmuch, it is possible to avoid using the above flags and only rely on
notmuch search syntax.\&
.PP
\fB:filter\fR \fIquery\fR.\&.\&.\&
.br
\fB:search\fR \fIquery\fR.\&.\&.\&
.RS 4
You can use the full notmuch query language as described in
\fBnotmuch-search-terms\fR(7).\&
.PP
The query will only apply on top of the active folder query.\&
.PP
Example, jump to next unread:
.PP
.RS 4
:search tag:unread
.PP
.RE
.RE
.SH SEE ALSO
.PP
\fBaerc\fR(1) \fBaerc-config\fR(5)
.PP
.SH AUTHORS
.PP
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 \fIhttps://sr.\&ht/~rjarry/aerc/\fR.\&