8 **notmuch** **restore** [--accumulate] [--format=(auto|batch-tag|sup)] [--input=<*filename*>]
13 Restores the tags from the given file (see **notmuch dump**).
15 The input is read from the given filename, if any, or from stdin.
17 Supported options for **restore** include
20 The union of the existing and new tags is applied, instead of
21 replacing each message's tags as they are read in from the dump
24 ``--format=(sup|batch-tag|auto)``
25 Notmuch restore supports two plain text dump formats, with each
26 line specifying a message-id and a set of tags. For details of
27 the actual formats, see **notmuch-dump(1)**.
30 The **sup** dump file format is specifically chosen to be
31 compatible with the format of files produced by sup-dump. So
32 if you've previously been using sup for mail, then the
33 **notmuch restore** command provides you a way to import all
34 of your tags (or labels as sup calls them).
37 The **batch-tag** dump format is intended to more robust
38 against malformed message-ids and tags containing whitespace
39 or non-\ **ascii(7)** characters. See **notmuch-dump(1)**
40 for details on this format.
42 **notmuch restore** updates the maildir flags according to
43 tag changes if the **maildir.synchronize\_flags**
44 configuration option is enabled. See **notmuch-config(1)**
48 This option (the default) tries to guess the format from the
49 input. For correctly formed input in either supported
50 format, this heuristic, based the fact that batch-tag format
51 contains no parentheses, should be accurate.
53 ``--include=(config|tags)``
55 Control what kind of metadata is restored.
59 Restore configuration data to the database. Each configuration line starts
60 with "#@ ", followed by a space separated key-value pair.
61 Both key and value are hex encoded if needed.
65 Output per-message metadata, namely tags. See *format* above
68 The default is to restore both tags and configuration
71 ``--input=``\ <filename>
72 Read input from given file instead of stdin.
77 \ **notmuch restore** will detect if the input is compressed in
78 **gzip(1)** format and automatically decompress it while reading. This
79 detection does not depend on file naming and in particular works for
85 **notmuch(1)**, **notmuch-config(1)**, **notmuch-count(1)**,
86 **notmuch-dump(1)**, **notmuch-hooks(5)**, **notmuch-insert(1)**,
87 **notmuch-new(1)**, **notmuch-reply(1)**, **notmuch-search(1)**,
88 **notmuch-search-terms(7)**, **notmuch-show(1)**, **notmuch-tag(1)**