add shortcut for scheduled and add FAQ

Author: sspaeti

CHANGELOG.md

@@ -1,5 +1,8 @@
 # Changelog
 
+# 2026-04-15
+- **Scheduled folder keybindings** — added `gc` (go to Scheduled, mnemonic: "calendar") and `Mc` (move to Scheduled) shortcuts; Scheduled folder now accessible via dedicated keybindings alongside existing tab navigation (`[]HL`, `space+1-9`); help overlay and generated keybindings documentation updated
+
 # 2026-04-14
 - **Extended link support (99 links)** — link opener now supports up to 99 links per email (previously limited to 10); `space+1-0` opens links 1-10, `space+l11-99` opens links 11-99 using intuitive numeric shortcuts (e.g. `space+l26` for link [26]); status line provides progressive feedback during multi-key input; footer help and `?` overlay updated
 - **Fix: link extraction with brackets in text** — markdown link regex now correctly matches links with brackets inside the link text (e.g. `[[Watch the studio tour here]](url)`); changed from `[^\]]+` (anything except `]`) to non-greedy `.+?` to handle nested brackets; fixes newsletter links from Beehiiv and similar services

docs/content/docs/faq.md

@@ -8,17 +8,30 @@ Questions that came up when people using neomd.
 
 ## Is it possible to create new directories/tabs
 
-You basically create the folder in your web mail and configure it in your `config.toml` and add the new folder under `[folder]` and in the `tab_order` so neomd knows where to place it:
+Currently, no. All folders are hard coded in a struct in a code as this is optimized for the GTD and HEY Screener workflow and keeps things simple.
 
+But, please reach out to me and tell me which folders you need, maybe it's a folder that everyone might use, or otherwise, if I get enough request, I add a way to customize folders as I do with the sort order of folder tabs already.
 
-```toml
-[folders]
-  ...existing folders
-  new = "NewMissingFolder"
-  tab_order = ["inbox", "to_screen", "feed", "papertrail", "waiting", "someday", "scheduled", "sent", "work", "archive", "screened_out", "trash", "new"]
+
+### Advanced: Add custom folders yourself
+
+You can fork neomd and modify the Go source code:
+
+1. **Edit the code** (ask Claude to help with this):
+    - Add a field to `FoldersConfig` struct in `internal/config/config.go`
+    - Add entry to `keyToLabel` map
+    - Optionally add keyboard shortcuts in `internal/ui/model.go`
+ - Run `make build` to compile
+2. **Create the IMAP folder** via webmail (e.g., "NewFolder")
+3. **Configure it** in your `config.toml`:
+ ```toml
+ [folders]
+   # ... existing folders ...
+   new = "NewFolder"
+   tab_order = ["inbox", "to_screen", "feed", "new", "sent", "archive"]
 ```
 
-If you want to move emails to that folder, or just move to it, that's currently not possible. You can always move through the tabs with `[]HL` or `space+1-10`, but you can't move emails to them yet.
+Once added this way, you can navigate to your custom folder with existing `[]HL` and `space+1-9`. If you added keyboard shortcuts in step 1, those will work too (e.g., gn / Mn).
 
 ## Does the signature appear only in new messages, not in replies?
 

docs/content/docs/keybindings.md

@@ -40,6 +40,7 @@ To update both the help overlay and this document at once, edit that file and ru
 | `gk` | go to ToScreen |
 | `go` | go to ScreenedOut |
 | `gw` | go to Waiting |
+| `gc` | go to Scheduled (calendar) |
 | `gb` | go to Work (if configured) |
 | `gm` | go to Someday |
 | `gd` | go to Drafts |
@@ -72,6 +73,7 @@ To update both the help overlay and this document at once, edit that file and ru
 | `Mt` | move to Trash |
 | `Mo` | move to ScreenedOut |
 | `Mw` | move to Waiting |
+| `Mc` | move to Scheduled |
 | `Mb` | move to Work (if configured) |
 | `Mm` | move to Someday |
 | `Mk` | move to ToScreen |

internal/ui/keys.go

@@ -31,6 +31,7 @@ var HelpSections = []HelpSection{
 		{"gk", "go to ToScreen"},
 		{"go", "go to ScreenedOut"},
 		{"gw", "go to Waiting"},
+		{"gc", "go to Scheduled (calendar)"},
 		{"gb", "go to Work (if configured)"},
 		{"gm", "go to Someday"},
 		{"gd", "go to Drafts"},
@@ -55,6 +56,7 @@ var HelpSections = []HelpSection{
 		{"Mt", "move to Trash"},
 		{"Mo", "move to ScreenedOut"},
 		{"Mw", "move to Waiting"},
+		{"Mc", "move to Scheduled"},
 		{"Mb", "move to Work (if configured)"},
 		{"Mm", "move to Someday"},
 		{"Mk", "move to ToScreen"},

internal/ui/model.go

@@ -2194,7 +2194,7 @@ func (m Model) updateInbox(msg tea.KeyMsg) (tea.Model, tea.Cmd) {
 	// ── Chord prefixes ──────────────────────────────────────────────
 	case "g":
 		m.pendingKey = "g"
-		m.status = "go to:  gi inbox  ga archive  gf feed  gp papertrail  gt trash  gs sent  gk toscreen  go screened-out  gw waiting  gm someday  gd drafts  gS spam  ge everything  gg top"
+		m.status = "go to:  gi inbox  ga archive  gf feed  gp papertrail  gt trash  gs sent  gk toscreen  go screened-out  gw waiting  gc scheduled  gm someday  gd drafts  gS spam  ge everything  gg top"
 		return m, nil
 
 	case " ": // leader key — wait for digit or shortcut
@@ -2204,7 +2204,7 @@ func (m Model) updateInbox(msg tea.KeyMsg) (tea.Model, tea.Cmd) {
 
 	case "M":
 		m.pendingKey = "M"
-		m.status = "move to:  Mi inbox  Ma archive  Mf feed  Mp papertrail  Mt trash  Mo screened-out  Mw waiting  Mm someday"
+		m.status = "move to:  Mi inbox  Ma archive  Mf feed  Mp papertrail  Mt trash  Mo screened-out  Mw waiting  Mc scheduled  Mm someday"
 		return m, nil
 
 	case ",":
@@ -2660,6 +2660,7 @@ func (m Model) handleChord(prefix, key string) (tea.Model, tea.Cmd) {
 			"a": "Archive",
 			"w": "Waiting",
 			"b": "Work",
+			"c": "Scheduled",
 			"m": "Someday",
 			"o": "ScreenedOut",
 		}
@@ -2692,6 +2693,7 @@ func (m Model) handleChord(prefix, key string) (tea.Model, tea.Cmd) {
 			"t": m.cfg.Folders.Trash,
 			"o": m.cfg.Folders.ScreenedOut,
 			"w": m.cfg.Folders.Waiting,
+			"c": m.cfg.Folders.Scheduled,
 			"m": m.cfg.Folders.Someday,
 			"k": m.cfg.Folders.ToScreen,
 		}