NAME

       notmuch-address - output addresses from matching messages

SYNOPSIS

       notmuch address [option ...] <search-term> ...

DESCRIPTION

       Search  for messages matching the given search terms, and display the addresses from them.
       Duplicate addresses are filtered out.

       See notmuch-search-terms(7) for details of the supported syntax for <search-terms>.

       Supported options for address include

          --format=(json|sexp|text|text0)
                 Presents the results in either JSON, S-Expressions, newline character  separated
                 plain-text  (default),  or  null character separated plain-text (compatible with
                 xargs(1) -0 option where available).

          --format-version=N
                 Use the specified  structured  output  format  version.  This  is  intended  for
                 programs  that  invoke  notmuch(1)  internally. If omitted, the latest supported
                 version will be used.

          --output=(sender|recipients|count|address)
              Controls which information appears in the output. This option can be given multiple
              times   to   combine   different   outputs.    When   neither  --output=sender  nor
              --output=recipients is given, --output=sender is implied.

              sender Output all addresses from the From header.

                     Note: Searching  for  sender  should  be  much  faster  than  searching  for
                     recipients,  because  sender  addresses  are cached directly in the database
                     whereas other addresses need to be fetched from message files.

              recipients
                     Output all addresses from the To, Cc and Bcc headers.

              count  Print the count of how many times was the address encountered during search.

                     Note: With this option, addresses are printed only after the whole search is
                     finished. This may take long time.

              address
                     Output only the email addresses instead of the full mailboxes with names and
                     email addresses. This option has no  effect  on  the  JSON  or  S-Expression
                     output formats.

          --deduplicate=(no|mailbox|address)
              Control the deduplication of results.

              no     Output  all  occurrences  of addresses in the matching messages. This is not
                     applicable with --output=count.

              mailbox
                     Deduplicate addresses based on the  full,  case  sensitive  name  and  email
                     address,   or   mailbox.   This  is  effectively  the  same  as  piping  the
                     --deduplicate=no output to sort | uniq, except for  the  order  of  results.
                     This is the default.

              address
                     Deduplicate  addresses  based  on  the  case insensitive address part of the
                     mailbox. Of all the variants (with different name or case),  print  the  one
                     occurring  most frequently among the matching messages. If --output=count is
                     specified, include all variants in the count.

          --sort=(newest-first|oldest-first)
                 This option can be  used  to  present  results  in  either  chronological  order
                 (oldest-first) or reverse chronological order (newest-first).

                 By  default, results will be displayed in reverse chronological order, (that is,
                 the newest results will be displayed first).

                 However, if either --output=count or --deduplicate=address  is  specified,  this
                 option is ignored and the order of the results is unspecified.

          --exclude=(true|false)
                 A   message   is   called   "excluded"  if  it  matches  at  least  one  tag  in
                 search.tag_exclude that does not appear explicitly in  the  search  terms.  This
                 option specifies whether to omit excluded messages in the search process.

                 The  default  value,  true,  prevents excluded messages from matching the search
                 terms.

                 false allows excluded messages to match search terms  and  appear  in  displayed
                 results.

EXIT STATUS

       This command supports the following special exit status codes

       20     The requested format version is too old.

       21     The requested format version is too new.

SEE ALSO

       notmuch(1),   notmuch-config(1),   notmuch-count(1),   notmuch-dump(1),  notmuch-hooks(5),
       notmuch-insert(1),       notmuch-new(1),       notmuch-reply(1),       notmuch-restore(1),
       notmuch-search-terms(7), notmuch-show(1), notmuch-tag(1), notmuch-search(1)

AUTHOR

       Carl Worth and many others

COPYRIGHT

       2009-2018, Carl Worth and many others