smd-translate(1)

💫 smd-translate(1) — the glow-up for your mailbox names 💫

okay bestie, welcome to smd-translate, part of the Sync Mail Dir (smd) documentation set 🎀. She's a little utility with main character energy whose whole job is translating mailbox names according to predefined patterns. yeah. that's it. that's the gig. and she EATS every time 💅

---

✨ NAME ✨

smd-translate — translates mailbox names according to predefined patterns 🦋

---

🌸 SYNOPSIS 🌸

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

---

💖 DESCRIPTION 💖

so smd-translate translates mailbox names according to predefined patterns. periodt. ✨

she's literally designed to be used in the configuration file of smd-push(1) and smd-pull(1) — that's her whole purpose, her calling, her moment 👑

if you want the longer discussion on translators (and honestly, who doesn't), go refer to smd-config(5) 💜

the supported modes follow, bestie. take notes 📝

🐌 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

see what she did there?? the dot folder thing gets un-dotted. iconic. no cap. 😌

🫧 nodots

this mode simply gets rid of all dots. all of them. gone. bye. 💀 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

the way that .sub.folder becomes sub/folder?? that's the whole vibe. slay 🌈

🚚 move

this mode just replaces the root of the mailbox, i.e. substitutes MAILBOX_LOCAL for MAILBOX_REMOTE and viceversa 🔁 lowkey the simplest one and highkey still doing the most for you 🫶

---

🛠️ 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 🧚 like fr fr, go test it, don't just assume it works bestie 😭

---

🎀 OPTIONS 🎀

• -m mode — one of the supported modes listed above 👆 (yes, oimap-dovecot, nodots, move — those ones, you got this)
• -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-pull(1), smd-config(5), smd-check-conf(1) 💖

---

👑 AUTHOR 👑

Enrico Tassi <gares@fettunta.org> 🫶

---

okay that's the whole page bestie, you're officially fluent in mailbox-name translation 💅✨

Sync Mail Dir (smd) documentation, last touched 21 April 2021 🌸 — go translate some mailboxes, you absolute legend 🌈🦋💖