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