NAME

       notmuch-hooks - hooks for notmuch

SYNOPSIS

       $DATABASEDIR/.notmuch/hooks/*

DESCRIPTION

       Hooks  are  scripts  (or  arbitrary  executables or symlinks to such) that notmuch invokes
       before and after certain actions. These scripts reside  in  the  .notmuch/hooks  directory
       within the database directory and must have executable permissions.

       The currently available hooks are described below.

          pre-new
                 This  hook  is  invoked  by  the  new  command  before scanning or importing new
                 messages into the database. If this hook exits with a non-zero  status,  notmuch
                 will abort further processing of the new command.

                 Typically  this  hook is used for fetching or delivering new mail to be imported
                 into the database.

          post-new
                 This hook is invoked by the new command after new messages  have  been  imported
                 into  the  database and initial tags have been applied. The hook will not be run
                 if there have been any errors during the scan or import.

                 Typically this hook is used to perform additional  query-based  tagging  on  the
                 imported messages.

          post-insert
              This  hook  is  invoked by the insert command after the message has been delivered,
              added to the database, and initial tags have been applied. The hook will not be run
              if  there  have  been  any  errors during the message delivery; what is regarded as
              successful delivery depends on the --keep option.

              Typically this hook is used  to  perform  additional  query-based  tagging  on  the
              delivered messages.

SEE ALSO

       notmuch(1),   notmuch-config(1),   notmuch-count(1),  notmuch-dump(1),  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)

AUTHOR

       Carl Worth and many others

COPYRIGHT

       2009-2018, Carl Worth and many others