1 <h1>NOTMUCH-RESTORE(1)</h1>
5 notmuch-restore - restores the tags from the given file (see notmuch
11 <b>notmuch</b> <b>restore</b> [--accumulate] [--format=(auto|batch-tag|sup)]
12 [--input=<<u>filename</u>>]
17 Restores the tags from the given file (see <b>notmuch</b> <b>dump</b>).
19 The input is read from the given filename, if any, or from stdin.
21 Supported options for <b>restore</b> include
25 The union of the existing and new tags is applied, instead
26 of replacing each message's tags as they are read in from
29 <b>--format=(sup|batch-tag|auto)</b>
31 Notmuch restore supports two plain text dump formats, with
32 each line specifying a message-id and a set of tags. For
33 details of the actual formats, see <a href='../notmuch-dump-1/'>notmuch-dump</a>(1).
37 The <b>sup</b> dump file format is specifically chosen to be
38 compatible with the format of files produced by
39 sup-dump. So if you've previously been using sup for
40 mail, then the <b>notmuch</b> <b>restore</b> command provides you a
41 way to import all of your tags (or labels as sup
46 The <b>batch-tag</b> dump format is intended to more robust
47 against malformed message-ids and tags containing
48 whitespace or non-<b>ascii</b>(7) characters. See <a href='../notmuch-dump-1/'>not-</a>
49 <a href='../notmuch-dump-1/'>much-dump</a>(1) for details on this format.
51 <b>notmuch</b> <b>restore</b> updates the maildir flags according
52 to tag changes if the <b>maildir.synchronize</b>_<b>flags</b> con-
53 figuration option is enabled. See <a href='../notmuch-config-1/'>notmuch-config</a>(1)
58 This option (the default) tries to guess the format
59 from the input. For correctly formed input in either
60 supported format, this heuristic, based the fact that
61 batch-tag format contains no parentheses, should be
65 <h2>GZIPPED INPUT</h2>
67 <b>notmuch</b> <b>restore</b> will detect if the input is compressed in <b>gzip</b>(1) for-
68 mat and automatically decompress it while reading. This detection does
69 not depend on file naming and in particular works for standard input.
74 <a href='../notmuch-1/'>notmuch</a>(1), <a href='../notmuch-config-1/'>notmuch-config</a>(1), <a href='../notmuch-count-1/'>notmuch-count</a>(1), <a href='../notmuch-dump-1/'>notmuch-dump</a>(1), <a href='../notmuch-hooks-5/'>not-</a>
75 <a href='../notmuch-hooks-5/'>much-hooks</a>(5), <a href='../notmuch-insert-1/'>notmuch-insert</a>(1), <a href='../notmuch-new-1/'>notmuch-new</a>(1), <a href='../notmuch-reply-1/'>notmuch-reply</a>(1),
76 <a href='../notmuch-search-1/'>notmuch-search</a>(1), <a href='../notmuch-search-terms-7/'>notmuch-search-terms</a>(7), <a href='../notmuch-show-1/'>notmuch-show</a>(1), <a href='../notmuch-tag-1/'>not-</a>
77 <a href='../notmuch-tag-1/'>much-tag</a>(1)
82 Carl Worth and many others
87 2014, Carl Worth and many others