NOTMUCH-RESTORE(1)                           notmuch                           NOTMUCH-RESTORE(1)



NAME
       notmuch-restore - restores the tags from the given file (see notmuch dump)

SYNOPSIS
       notmuch restore [--accumulate] [--format=(auto|batch-tag|sup)] [--input=<filename>]

DESCRIPTION
       Restores the tags from the given file (see notmuch dump).

       The input is read from the given filename, if any, or from stdin.

       Supported options for restore include

          --accumulate
                 The  union  of  the  existing and new tags is applied, instead of replacing each
                 message's tags as they are read in from the dump file.

          --format=(sup|batch-tag|auto)
                 Notmuch restore supports two plain text dump formats, with each line  specifying
                 a  message-id  and  a  set  of tags. For details of the actual formats, see not‐
                 much-dump(1).

                 sup    The sup dump file format is specifically chosen to be compatible with the
                        format  of files produced by sup-dump. So if you've previously been using
                        sup for mail, then the notmuch restore command  provides  you  a  way  to
                        import all of your tags (or labels as sup calls them).

                 batch-tag
                        The  batch-tag  dump  format is intended to more robust against malformed
                        message-ids and tags containing whitespace  or  non-ascii(7)  characters.
                        See notmuch-dump(1) for details on this format.

                        notmuch restore updates the maildir flags according to tag changes if the
                        maildir.synchronize_flags  configuration  option  is  enabled.  See  not‐
                        much-config(1) for details.

                 auto   This  option  (the default) tries to guess the format from the input. For
                        correctly formed input in either supported format, this heuristic,  based
                        the  fact  that batch-tag format contains no parentheses, should be accu‐
                        rate.

GZIPPED INPUT
       notmuch restore will detect if the input is compressed in gzip(1) format and automatically
       decompress it while reading. This detection does not depend on file naming and in particu‐
       lar works for standard input.

SEE ALSO
       notmuch(1), notmuch-config(1), notmuch-count(1), notmuch-dump(1),  notmuch-hooks(5),  not‐
       much-insert(1),      notmuch-new(1),     notmuch-reply(1),     notmuch-search(1),     not‐
       much-search-terms(7), notmuch-show(1), notmuch-tag(1)

AUTHOR
       Carl Worth and many others

COPYRIGHT
       2014, Carl Worth and many others




0.18.2                                   October 25, 2014                      NOTMUCH-RESTORE(1)