.\" 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-07-30"
.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 \fI<header>:[<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 \fI<header>:[<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 \fI<header>:[<value>]\fR:
.RS 4
Search in the headers of the messages for a specific \fI<header>\fR that matches \fI<value>\fR,
\fI<value>\fR can be omitted to only search for a the \fI<header>\fR.\&
If either the \fI<header>\fR or the \fI<value>\fR contain a space then the whole argument needs
to be escaped with quotes, note: spaces around \fI<value>\fR are trimmed.\&
.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.\&