---
name: "smd-translate"
section: "1"
platform: "linux"
package: "syncmaildir"
version: "1.3.0-1"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/smd-translate"
---

# smd-translate(1)

translates mailbox names according to predefined patterns

## NAME

**smd-translate** - translates mailbox names according to predefined patterns

## SYNOPSIS

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

## DESCRIPTION

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

**Refer to [smd-config(5)](/smd-config/5.md) 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.**

## 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)](/smd-check-conf/1.md) utility.**

## OPTIONS

- **-m *mode***

  **One of the supported modes listed above**

- **-d *direction***

  **One of RL or LR**

- ***endpoint***

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

- ***mailbox***

  **The** *mailbox* **name to translate**

## FILES

**~/.smd/config.\***

## SEE ALSO

**[smd-push(1)](/smd-push/1.md), [smd-pull(1)](/smd-pull/1.md), [smd-config(5)](/smd-config/5.md), [smd-check-conf(1)](/smd-check-conf/1.md)**

## AUTHOR

**Enrico Tassi \<gares@fettunta.org\>**