smd-translate(1) Sync Mail Dir (smd) documentation smd-translate(1)

smd-translate - translates mailbox names according to predefined patterns 

smd-translate [-m mode] [-d direction] endpoint mailbox

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.

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

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

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

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.

One of the supported modes listed above
One of RL or LR
Is the suffix for the name of the configuration file to use
The mailbox name to translate

~/.smd/config.*

smd-push(1), smd-pull(1), smd-config(5), smd-check-conf(1)

Enrico Tassi <gares@fettunta.org>

01 April 2024