NOTMUCH-INSERT(1)

NAME

       notmuch-insert - add a message to the maildir and notmuch database

SYNOPSIS

       notmuch insert [option ...] [+<tag>|-<tag> ...]

DESCRIPTION

       notmuch insert reads a message from standard input and delivers it into
       the maildir directory given by configuration option database.path, then
       incorporates  the  message into the notmuch database. It is an alterna‐
       tive to using a separate tool to deliver the message then running  not-
       much new afterwards.

       The  new message will be tagged with the tags specified by the new.tags
       configuration option, then by operations specified on the command-line:
       tags prefixed by '+' are added while those prefixed by '-' are removed.

       If  the  new message is a duplicate of an existing message in the data‐
       base (it has same Message-ID), it will be added to the  maildir  folder
       and notmuch database, but the tags will not be changed.

       Option  arguments must appear before any tag operation arguments.  Sup‐
       ported options for insert include

          --folder=<folder>
                 Deliver the message to the specified folder, relative to  the
                 top-level  directory given by the value of database.path. The
                 default is to deliver to the top-level directory.

          --create-folder
                 Try to create the folder named by the --folder option, if  it
                 does  not  exist. Otherwise the folder must already exist for
                 mail delivery to succeed.

EXIT STATUS

       This command returns exit status 0  if  the  message  was  successfully
       added  to  the mail directory, even if the message could not be indexed
       and added to the notmuch database. In the latter case, a  warning  will
       be printed to standard error but the message file will be left on disk.

       If the message could not be written to disk then a non-zero exit status
       is returned.

SEE ALSO

       notmuch(1), notmuch-config(1), notmuch-count(1), notmuch-dump(1),  not‐
       much-hooks(5), 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

       2014, Carl Worth and many others

0.18.1