NAME

       lei-import - one-time import of messages into local store

SYNOPSIS

       lei import [OPTIONS] LOCATION [LOCATION...] [+L:LABEL]

       lei import [OPTIONS] (--stdin|-)

DESCRIPTION

       Import messages into the local storage of lei(1).  "LOCATION" is a source of messages: a
       directory (Maildir), a file, or a URL ("imap://", "imaps://", "nntp://", or "nntps://").
       URLs requiring authentication use git-credential(1) to fill in the username and password.

       For a regular file, the "LOCATION" must have a "<format>:" prefix specifying one of the
       following formats: "mboxrd", "mboxcl2", "mboxcl", or "mboxo".

OPTIONS

       -F MAIL_FORMAT
       --in-format=MAIL_FORMAT
           Message input format.  Unless messages are given on stdin, using a format prefix with
           "LOCATION" is preferred.

       --stdin
           Read messages from stdin.

       --lock
           mbox(5) locking method(s) to use: "dotlock", "fcntl", "flock" or "none".

           Default: fcntl,dotlock

       +L:LABEL
           Add the given "LABEL" to all messages imported, where "LABEL" is an arbitrary user-
           defined value consisting of lowercase and digits.  See lei-tag(1) for more info on
           labels.

           For example, specifying "+L:inbox" applies the "inbox" label to all messages being
           imported.

           May be specified multiple times to apply multiple labels.

           Default: none

       +kw:KEYWORD
           Apply "KEYWORD" to all messages being imported in addition to any per-message keywords
           from the store (unless "--no-kw" is specified).  See lei-tag(1) for more info on
           keywords.

           May be specified multiple times to apply multiple keywords.

           Default: none

       --no-kw
           Don't import message keywords (or "flags" in IMAP terminology).

       --no-incremental
           Import already seen IMAP and NNTP articles.

       --torsocks=auto|no|yes
       --no-torsocks
           Whether to wrap git(1) and curl(1) commands with torsocks(1).

           Default: "auto"

       --proxy=PROTO://HOST[:PORT]
           Use the specified proxy (e.g., "socks5h://0:9050").

CONTACT

       Feedback welcome via plain-text mail to <mailto:meta@public-inbox.org>

       The mail archives are hosted at <https://public-inbox.org/meta/> and
       <http://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/meta/>

COPYRIGHT

       Copyright all contributors <mailto:meta@public-inbox.org>

       License: AGPL-3.0+ <https://www.gnu.org/licenses/agpl-3.0.txt>

SEE ALSO

       lei-index(1)