lei-import1

Usage

Overview

Import messages into the local storage of lei(1) (aka lei/store). "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=PROTOCOL://HOST[:PORT]

Use the specified proxy (e.g., "socks5h://0:9050").

Consider imap.proxy and nntp.proxy which can be persistently configured on a per-host basis in lei-config(1).

--noisy

Warn on misformatted email headers. Not particularly useful but this was the default prior to public-inbox 2.0.0. New in public-inbox 2.0.0.

See lei-config(1) for various "imap.*" and "nntp.*" options.

Contact

Feedback welcome via plain-text mail to <mailto:[email protected]>

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