1NOTMUCH-NEW(1)                      notmuch                     NOTMUCH-NEW(1)
2
3
4

NAME

6       notmuch-new - incorporate new mail into the notmuch database
7

SYNOPSIS

9       notmuch new [options]
10

DESCRIPTION

12       Find and import any new messages to the database.
13
14       The  new  command scans all sub-directories of the database, performing
15       full-text indexing on new messages that are  found.  Each  new  message
16       will automatically be tagged with both the inbox and unread tags.
17
18       You  should  run notmuch new once after first running notmuch to create
19       the initial database. The first run may take a long time if you have  a
20       significant amount of mail (several hundred thousand messages or more).
21       Subsequently, you should run notmuch new whenever new mail is delivered
22       and  you  wish  to  incorporate it into the database.  These subsequent
23       runs will be much quicker than the initial run.
24
25       Invoking notmuch with no command argument will run new if  notmuch  has
26       previously been completed, but notmuch new has not previously been run.
27
28       notmuch  new  updates  tags  according  to  maildir flag changes if the
29       maildir.synchronize_flags  configuration   option   is   enabled.   See
30       notmuch-config for details.
31
32       The  new  command supports hooks. See notmuch-hooks for more details on
33       hooks.
34
35       Supported options for new include
36
37       --no-hooks
38              Prevents hooks from being run.
39
40       --quiet
41              Do not print progress or results.
42
43       --verbose
44              Print file names being processed.  Ignored  when  combined  with
45              --quiet.
46
47       --decrypt=(true|nostash|auto|false)
48              If  true, when encountering an encrypted message, try to decrypt
49              it while indexing, and stash any discovered  session  keys.   If
50              auto, try to use any session key already known to belong to this
51              message, but do not attempt to use the user's secret  keys.   If
52              decryption is successful, index the cleartext of the message.
53
54              Be  aware  that  the index is likely sufficient (and the session
55              key is certainly sufficient) to reconstruct the cleartext of the
56              message  itself, so please ensure that the notmuch message index
57              is adequately protected.  DO NOT  USE  --decrypt=true  or  --de‐
58              crypt=nostash without considering the security of your index.
59
60              See also index.decrypt in notmuch-config.
61
62       --full-scan
63              By   default   notmuch-new  uses  directory  modification  times
64              (mtimes) to optimize the scanning of directories for  new  mail.
65              This option turns that optimization off.
66

CONFIGURATION

68       Indexing  is  influenced  by  the  configuration options index.decrypt,
69       index.header.<prefix>  and  new.ignore.   Tagging  is   controlled   by
70       new.tags  and  maildir.synchronize_flags.   See  notmuch-config for de‐
71       tails.
72

EXIT STATUS

74       This command supports the following special exit status code
75
76       75 (EX_TEMPFAIL)
77              A temporary failure occurred; the user is invited to retry.
78

SEE ALSO

80       notmuch, notmuch-config,  notmuch-count,  notmuch-dump,  notmuch-hooks,
81       notmuch-insert,    notmuch-reply,    notmuch-restore,   notmuch-search,
82       notmuch-search-terms, notmuch-show, notmuch-tag
83

AUTHOR

85       Carl Worth and many others
86
88       2009-2023, Carl Worth and many others
89
90
91
92
930.38                             Sep 12, 2023                   NOTMUCH-NEW(1)
Impressum