smd-translate - translates mailbox names according to predefined patterns

Author

       Enrico Tassi <gares@fettunta.org>

                                                  01 April 2024                                 smd-translate(1)

Description

smd-translate  translates  mailbox  names according to predefined patterns.  It is designed to be used in
       the configuration file of smd-push(1) and smd-pull(1).

       Refer to smd-config(5) for a longer discussion on translators.

       Supported modes follow.

       oimap-dovecot

       This mode is designed to make the transition of offlineimap users  to  smd  simpler.  It  assumes  remote
       mailboxes are named like in the following:

           Maildir/cur
           Maildir/.sub.folder/new

       The corresponding local mailboxes are named like in the following:

           Mail/cur
           Mail/sub.folder/new

       nodots

       This mode simply gets rid of all dots. It assumes remote mailboxes are named like in the following:

           Maildir/cur
           Maildir/.sub.folder/new

       The corresponding local mailboxes are named like in the following:

           Mail/cur
           Mail/sub/folder/new

       move

       This  mode  just  replaces the root of the mailbox, i.e. substitutes MAILBOX_LOCAL for MAILBOX_REMOTE and
       viceversa.

Files

~/.smd/config.*

Name

smd-translate - translates mailbox names according to predefined patterns

Options

-mmode
              One of the supported modes listed above

       -ddirection
              One of RL or LR

       endpoint
              Is the suffix for the name of the configuration file to use

       mailbox
              The mailbox name to translate

Synopsis

smd-translate [-mmode] [-ddirection] endpointmailbox

Usage In Configuration File

       Assuming the MAILBOX_LOCAL configuration variable is set  to  Mail  and  the  MAILBOX_REMOTE  is  set  to
       Maildir, one can use the following configuration file snippet in ~/.smd/config.endpoint:

           TRANSLATOR_RL="smd-translate -m oimap-dovecot -d RL endpoint"
           TRANSLATOR_LR="smd-translate -m oimap-dovecot -d LR endpoint"

       To test your setup use the smd-check-conf(1) utility.