From de2e9d9ea9a7ddda92fb9b34d2215402bb76a0af Mon Sep 17 00:00:00 2001
From: alex <alex@pdp7.net>
Date: Sat, 6 Sep 2025 21:02:02 +0200
Subject: [PATCH] Document Gmail migration

---
 misc/migadu.md | 53 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 53 insertions(+)

diff --git a/misc/migadu.md b/misc/migadu.md
index 68e3794..998ae3a 100644
--- a/misc/migadu.md
+++ b/misc/migadu.md
@@ -44,6 +44,59 @@ TODO: set forwarding from `{id}@vanity.tld` to `{me}.{vanityid}{code}@nonvanity.
 
 Because each vanity email address and entity has a different email address, you can file emails automatically into folders if wanted.
 
+## Migrating email from Gmail
+
+```
+imapsync --user1 xxx@gmail.com -passfile1 gmailpass --user2 a@a.com --host2 imap.a.com --passfile2 pass --gmail1
+```
+
+### Preventing issues with multiple tags
+
+An email message can have multiple "tags" in Gmail that correspond to IMAP folders.
+If you have messages with multiple tags, then the migration will duplicate messages in multiple folders or file mails to one folder at "random".
+
+imapsync has features to control this, and avoid problems with the "all mail" and "sent mail" Gmail folders, but for further control, you can refile emails to have a single tag.
+
+I have an mbsync replica of my Gmail account for backup purposes.
+This replica can be used to find messages with multiple tags:
+
+```
+find . -path './\[Gmail\]/All Mail' -prune -o -not -name index -type f -exec grep -H ^Message-ID: {} \; >index
+```
+
+Produces one file with lines:
+
+```
+/.../cur/f:Message-ID:...
+```
+
+```
+#!/usr/bin/env python3
+
+import pathlib
+ms = pathlib.Path("index").read_text().splitlines()
+
+import collections
+idx = collections.defaultdict(set)
+
+for m in ms:
+    path, _, id = m.rsplit(":", 2)
+    f = "/".join(pathlib.Path(path).parts[:-2])
+    idx[id].add((path, f))
+
+for id, vs in idx.items():
+    fs = sorted(set([f for (_path, f) in vs]))
+    if len(fs) > 1:
+        print(fs)
+```
+
+```
+./idx.py | sort | uniq
+```
+
+Clear up multiple tags in Gmail to prevent duplicates.
+
+
 ## Notes
 
 * Aliases do *not* have plus addressing, use a "pattern rewrite" instead.
-- 
2.47.3