NAME

       notmuch-count - count messages matching the given search terms

SYNOPSIS

       notmuch count [options... ] <search-term>...

DESCRIPTION

       Count messages matching the search terms.

       The number of matching messages (or threads) is output to stdout.

       With no search terms, a count of all messages (or threads) in the database will be displayed.

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

       Supported options for count include

           --output=(messages|threads|files)

               messages

                   Output the number of matching messages. This is the default.

               threads

                   Output the number of matching threads.

               files

                   Output  the  number  of  files associated with matching messages. This may be bigger than the
                   number of matching messages due to duplicates (i.e. multiple files having the  same  message-
                   id).

           --exclude=(true|false)

               Specify whether to omit messages matching search.tag_exclude from the count (the default) or not.

           --batch

               Read  queries  from  a  file  (stdin by default), one per line, and output the number of matching
               messages (or threads) to stdout, one per line. On an empty input line the count of  all  messages
               (or threads) in the database will be output. This option is not compatible with specifying search
               terms on the command line.

           --input=<filename>

               Read input from given file, instead of from stdin. Implies --batch.

SEE ALSO

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