add feature to download emails as EML with leader+d

Author: sspaeti

CHANGELOG.md

@@ -1,6 +1,7 @@
 # Changelog
 
 # 2026-04-23
+- **Download raw email source (`space+d` in reader)** — saves the full raw MIME source as `.eml` to `~/Downloads/` with filename `neomd-YYYYMMDD-<subject>.eml`; useful for archiving, debugging email headers, or importing into other clients; status bar shows download progress and completion; filenames deduplicated automatically
 - **Listmonk newsletter integration** — send newsletters to subscribers by composing an email to a virtual trigger address (e.g. `listmonk@ssp.sh`); neomd intercepts the send and creates a scheduled campaign in [Listmonk](https://listmonk.app) via its REST API instead of delivering via SMTP; configure multiple trigger addresses in `[[listmonk.triggers]]` to target different subscriber lists (newsletter, book, all); pre-send screen shows "Newsletter via Listmonk" with target list IDs and schedule delay; campaigns are created as draft then set to `scheduled` status with configurable delay (default 30 minutes); authentication via HTTP Basic Auth with environment variable expansion for API token; new self-contained `internal/listmonk/` package with full test coverage (httptest mocks); documented in `docs/integrations/listmonk.md`
 
 # 2026-04-21

docs/content/docs/keybindings.md

@@ -96,6 +96,7 @@ To update both the help overlay and this document at once, edit that file and ru
 |-----|--------|
 | `<space>1 … <space>9` | jump to folder tab by number (Inbox=1, ToScreen=2, …) |
 | `<space>/` | IMAP search ALL emails on server (From + Subject) |
+| `<space>d  (reader)` | download raw email source (.eml) to ~/Downloads |
 | `<space>w` | show welcome screen |
 
 

docs/content/docs/reading.md

@@ -52,6 +52,12 @@ Attach:  [1] report.pdf  [2] photo.png
 
 Press `1`–`9` to download attachment N to `~/Downloads/` and open it with `xdg-open`. Filenames are deduplicated automatically if a file already exists.
 
+## Download Raw Email Source
+
+Press `space` then `d` in the reader to download the full raw email source (`.eml` file) to `~/Downloads/`. The file is named `neomd-YYYYMMDD-<subject>.eml` using the email's date and sanitized subject line.
+
+This is useful for archiving emails, debugging headers, or importing into other email clients. The status bar shows a green confirmation when the download completes.
+
 ## Threaded Inbox
 
 Related emails are automatically grouped together in the inbox list. Threads are detected using a hybrid approach:

internal/imap/client.go

@@ -758,6 +758,39 @@ func (c *Client) FetchBody(ctx context.Context, folder string, uid uint32) (stri
 	return markdown, rawHTML, webURL, attachments, references, err
 }
 
+// FetchRaw fetches the full raw MIME source (EML) for a single message.
+func (c *Client) FetchRaw(ctx context.Context, folder string, uid uint32) ([]byte, error) {
+	if ctx == nil {
+		ctx = context.Background()
+	}
+	var raw []byte
+	err := c.withConn(ctx, func(conn *imapclient.Client) error {
+		if err := c.selectMailbox(folder); err != nil {
+			return err
+		}
+
+		var fetchSet imap.UIDSet
+		fetchSet.AddNum(imap.UID(uid))
+
+		msgs, err := conn.Fetch(fetchSet, &imap.FetchOptions{
+			UID:         true,
+			BodySection: []*imap.FetchItemBodySection{{Peek: true}},
+		}).Collect()
+		if err != nil {
+			return fmt.Errorf("FETCH raw uid=%d: %w", uid, err)
+		}
+		if len(msgs) == 0 {
+			return fmt.Errorf("message uid=%d not found in %s", uid, folder)
+		}
+
+		if len(msgs[0].BodySection) > 0 {
+			raw = msgs[0].BodySection[0].Bytes
+		}
+		return nil
+	})
+	return raw, err
+}
+
 // MoveMessage moves uid from src to dst using the IMAP MOVE command (RFC 6851).
 // Returns the UID assigned at the destination (may differ from src UID on some
 // servers). Falls back to the original uid if the server does not report UIDPLUS

internal/ui/keys.go

@@ -71,6 +71,7 @@ var HelpSections = []HelpSection{
 	{"Leader Key Mappings (space prefix)", [][2]string{
 		{"<space>1 … <space>9", "jump to folder tab by number (Inbox=1, ToScreen=2, …)"},
 		{"<space>/", "IMAP search ALL emails on server (From + Subject)"},
+		{"<space>d  (reader)", "download raw email source (.eml) to ~/Downloads"},
 		{"<space>w", "show welcome screen"},
 	}},
 	{"Sort  (, prefix)", [][2]string{

internal/ui/model.go

@@ -131,6 +131,10 @@ type (
 		path string
 		err  error
 	}
+	emlDownloadedMsg struct {
+		path string
+		err  error
+	}
 	editorDoneMsg struct {
 		to, cc, bcc, from, subject, body string
 		err                              error
@@ -1770,6 +1774,16 @@ func (m Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
 		}
 		return m, nil
 
+	case emlDownloadedMsg:
+		if msg.err != nil {
+			m.status = "Download error: " + msg.err.Error()
+			m.isError = true
+		} else {
+			m.status = "Saved EML to " + msg.path
+			m.isError = false
+		}
+		return m, nil
+
 	case saveDraftDoneMsg:
 		if msg.err != nil {
 			m.status = "Draft error: " + msg.err.Error()
@@ -2948,6 +2962,12 @@ func (m Model) updateReader(msg tea.KeyMsg) (tea.Model, tea.Cmd) {
 				m.status = "link number (11-99): l__"
 				return m, nil
 			}
+			// space + d = download raw EML source
+			if key == "d" {
+				m.status = "Downloading EML…"
+				m.isError = false
+				return m, m.downloadEMLCmd()
+			}
 			// Not a digit or 'l' — fall through
 		case "l": // l + first digit (waiting for second digit)
 			if len(key) == 1 && key >= "0" && key <= "9" {
@@ -3244,6 +3264,61 @@ func (m Model) downloadOpenAttachmentCmd(a imap.Attachment) tea.Cmd {
 	}
 }
 
+// downloadEMLCmd fetches the raw MIME source and saves it as .eml to ~/Downloads.
+func (m Model) downloadEMLCmd() tea.Cmd {
+	e := m.openEmail
+	if e == nil {
+		return nil
+	}
+	cli := m.imapCli()
+	folder := e.Folder
+	uid := e.UID
+	subject := e.Subject
+	emailDate := e.Date
+	return func() tea.Msg {
+		raw, err := cli.FetchRaw(nil, folder, uid)
+		if err != nil {
+			return emlDownloadedMsg{err: err}
+		}
+		home, err := os.UserHomeDir()
+		if err != nil {
+			return emlDownloadedMsg{err: err}
+		}
+		dir := filepath.Join(home, "Downloads")
+		if err := os.MkdirAll(dir, 0755); err != nil {
+			return emlDownloadedMsg{err: fmt.Errorf("create Downloads: %w", err)}
+		}
+		// Sanitize subject for filename
+		safe := strings.Map(func(r rune) rune {
+			if r == '/' || r == '\\' || r == ':' || r == '*' || r == '?' || r == '"' || r == '<' || r == '>' || r == '|' {
+				return '_'
+			}
+			return r
+		}, subject)
+		if len(safe) > 80 {
+			safe = safe[:80]
+		}
+		if safe == "" {
+			safe = "email"
+		}
+		datePart := emailDate.Format("20060102")
+		base := fmt.Sprintf("neomd-%s-%s.eml", datePart, safe)
+		dst := filepath.Join(dir, base)
+		if _, err := os.Stat(dst); err == nil {
+			for i := 1; ; i++ {
+				dst = filepath.Join(dir, fmt.Sprintf("neomd-%s-%s_%d.eml", datePart, safe, i))
+				if _, err := os.Stat(dst); os.IsNotExist(err) {
+					break
+				}
+			}
+		}
+		if err := os.WriteFile(dst, raw, 0644); err != nil {
+			return emlDownloadedMsg{err: fmt.Errorf("save EML: %w", err)}
+		}
+		return emlDownloadedMsg{path: dst}
+	}
+}
+
 // extractWebVersionURL looks for the "view in browser" / "read online" link
 // that newsletter platforms insert near the top of every HTML email.
 // Searches only the first 3000 bytes (the link is always in the preheader).
@@ -4357,7 +4432,11 @@ func (m Model) viewReader() string {
 		b.WriteString(m.reader.View())
 	}
 	isDraft := m.openEmail != nil && m.openEmail.Folder == m.cfg.Folders.Drafts
-	b.WriteString("\n" + readerHelp(isDraft, len(m.openLinks) > 0))
+	if m.status != "" {
+		b.WriteString("\n" + statusBar(m.status, m.isError))
+	} else {
+		b.WriteString("\n" + readerHelp(isDraft, len(m.openLinks) > 0))
+	}
 	return b.String()
 }
 

internal/ui/reader.go

@@ -139,7 +139,7 @@ func readerHelp(isDraft bool, hasLinks bool) string {
 	if isDraft {
 		keys = append(keys, "E draft")
 	}
-	keys = append(keys, "o w3m", "O browser", "ctrl+o web", "1-9 attach")
+	keys = append(keys, "o w3m", "O browser", "ctrl+o web", "1-9 attach", "space+d eml")
 	if hasLinks {
 		keys = append(keys, "space+1-0 links", "space+l11-99 links 11+")
 	}

scripts/sync-readme-to-docs.sh

@@ -68,7 +68,7 @@ END {
   -e 's|docs/screener\.md|screener|g' \
   -e 's|docs/sending\.md|sending|g' \
   -e 's|docs/reading\.md|reading|g' \
-  -e 's|images/|/images/|g' \
+  -e 's|docs/static/images/|/images/|g' \
   >> "$DOCS_OVERVIEW"
 
 echo "✅ Synced README.md → docs/content/docs/_index.md"