LEI-MAIL-SYNC-OVERVIEW(7)  public-inbox user manual  LEI-MAIL-SYNC-OVERVIEW(7)

NAME
       lei - an overview of lei mail synchronization

DESCRIPTION
       lei(1) provides several plumbing-level commands to synchronize mail and
       keywords (flags) between lei/store and existing IMAP and Maildir
       stores.  Nothing documented in this manpage is required for day-to-day
       use against externals.

       Mail and keyword synchronization is currently a clunky process.  Future
       work will be done to improve it and add IMAP IDLE support.

TYPICAL WORKFLOW
         # import mail from a user's IMAP inbox and give it the "inbox" label:
         lei import +L:inbox imaps://user@example.com/INBOX

         # dump "inbox" labeled files from the past week to a Maildir
         lei q L:inbox rt:last.week.. -o /tmp/results

         # open /tmp/results in your favorite mail agent.  If inotify or kevent
         # works, keyword changes (e.g. marking messages as `seen') are
         # synchronized automatically.

         # If the inotify queue overflows, or if lei-daemon crashes,
         # "lei index" will tell lei about keyword changes:
         lei index /tmp/results

         # Optional: cleanup stale entries from mail_sync.sqlite3
         lei refresh-mail-sync /tmp/results

         # to export keyword changes back to IMAP
         lei export-kw imaps://user@example.com/INBOX

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-import(1), lei-q(1), lei-index(1), lei-refresh-mail-sync(1),
       lei-export-kw(1)

public-inbox.git                  1993-10-02         LEI-MAIL-SYNC-OVERVIEW(7)