aboutsummaryrefslogtreecommitdiffstats
path: root/modules/communication/neomutt/keybindings.nix
diff options
context:
space:
mode:
Diffstat (limited to 'modules/communication/neomutt/keybindings.nix')
-rw-r--r--modules/communication/neomutt/keybindings.nix816
1 files changed, 471 insertions, 345 deletions
diff --git a/modules/communication/neomutt/keybindings.nix b/modules/communication/neomutt/keybindings.nix
index 59712fa..e9a3490 100644
--- a/modules/communication/neomutt/keybindings.nix
+++ b/modules/communication/neomutt/keybindings.nix
@@ -1,359 +1,485 @@
-# Keybindings - Vim-style keyboard shortcuts for neomutt
-#
-# Covers the core menus: generic (fallback), index, pager, sidebar,
-# attach, browser, compose. Menus like pgp/smime/mix/postpone/alias/query
-# are intentionally left mostly on defaults - they're rarely touched and
-# not worth risking an incorrect binding for. Press `?` inside neomutt
-# in any menu to see the live, authoritative list of bound functions.
{ config, lib, ... }:
+
{
- config.programs.neomutt.binds = lib.mkIf config.communication.neomutt.enable [
- # --- sidebar navigation (vim: Ctrl-k=up, Ctrl-j=down) ---
- {
- map = [
- "index"
- "pager"
- ];
- key = "\\Ck";
- action = "sidebar-prev";
- }
- {
- map = [
- "index"
- "pager"
- ];
- key = "\\Cj";
- action = "sidebar-next";
- }
- {
- # jump into the highlighted mailbox
- map = [
- "index"
- "pager"
- ];
- key = "\\Co";
- action = "sidebar-open";
- }
- {
- map = [
- "index"
- "pager"
- ];
- key = "\\Cp";
- action = "sidebar-prev-new";
- }
- {
- map = [
- "index"
- "pager"
- ];
- key = "\\Cn";
- action = "sidebar-next-new";
- }
- {
- # show/hide the sidebar column entirely
- map = [
- "index"
- "pager"
- ];
- key = "B";
- action = "sidebar-toggle-visible";
- }
+ config.programs.neomutt.binds = lib.mkIf config.communication.neomutt.enable (
+ lib.mkMerge [
+ # Force noop bindings to the top of neomuttrc
+ (lib.mkBefore [
+ {
+ map = [
+ "generic"
+ "index"
+ "pager"
+ "browser"
+ "attach"
+ "compose"
+ ];
+ key = "z";
+ action = "noop";
+ }
+ {
+ map = [
+ "generic"
+ "index"
+ "pager"
+ "browser"
+ "attach"
+ "compose"
+ ];
+ key = "d";
+ action = "noop";
+ }
+ {
+ map = [
+ "generic"
+ "index"
+ "pager"
+ "browser"
+ "attach"
+ "compose"
+ ];
+ key = "g";
+ action = "noop";
+ }
+ ])
- # --- basic entry navigation (generic = fallback for every list-style menu) ---
- {
- map = [ "generic" ];
- key = "j";
- action = "next-entry";
- }
- {
- map = [ "generic" ];
- key = "k";
- action = "previous-entry";
- }
- {
- map = [ "generic" ];
- key = "gg";
- action = "first-entry";
- }
- {
- map = [
- "index"
- "generic"
- ];
- key = "G";
- action = "last-entry";
- }
+ # Other bindings
+ [
+ # Sidebar navigation
+ {
+ map = [
+ "index"
+ "pager"
+ ];
+ key = "\\Ck";
+ action = "sidebar-prev";
+ }
+ {
+ map = [
+ "index"
+ "pager"
+ ];
+ key = "\\Cj";
+ action = "sidebar-next";
+ }
+ {
+ map = [
+ "index"
+ "pager"
+ ];
+ key = "\\Co";
+ action = "sidebar-open";
+ }
+ {
+ map = [
+ "index"
+ "pager"
+ ];
+ key = "\\Cn";
+ action = "sidebar-toggle-visible";
+ }
- # --- scroll-to-position, straight from vim (zt/zz/zb) ---
- {
- map = [ "generic" ];
- key = "zt";
- action = "current-top";
- }
- {
- map = [ "generic" ];
- key = "zz";
- action = "current-middle";
- }
- {
- map = [ "generic" ];
- key = "zb";
- action = "current-bottom";
- }
+ # Basic movement
+ {
+ map = [ "generic" ];
+ key = "j";
+ action = "next-entry";
+ }
+ {
+ map = [ "generic" ];
+ key = "k";
+ action = "previous-entry";
+ }
+ {
+ map = [ "generic" ];
+ key = "gg";
+ action = "first-entry";
+ }
+ {
+ map = [
+ "index"
+ "generic"
+ ];
+ key = "G";
+ action = "last-entry";
+ }
+ {
+ map = [ "pager" ];
+ key = "h";
+ action = "exit";
+ }
+ {
+ map = [ "pager" ];
+ key = "l";
+ action = "view-attachments";
+ }
+ {
+ map = [ "index" ];
+ key = "l";
+ action = "display-message";
+ }
- # --- pager scrolling ---
- {
- map = [ "pager" ];
- key = "j";
- action = "next-line";
- }
- {
- map = [ "pager" ];
- key = "k";
- action = "previous-line";
- }
- {
- map = [ "pager" ];
- key = "gg";
- action = "top";
- }
- {
- map = [ "pager" ];
- key = "G";
- action = "bottom";
- }
- {
- map = [
- "generic"
- "index"
- "pager"
- ];
- key = "\\Cd";
- action = "half-down";
- }
- {
- map = [
- "generic"
- "index"
- "pager"
- ];
- key = "\\Cu";
- action = "half-up";
- }
- {
- map = [
- "generic"
- "index"
- "pager"
- ];
- key = "\\Cf";
- action = "next-page";
- }
- {
- # NOTE: Ctrl-B is deliberately left unbound in the pager map here -
- # macros.nix claims it there for the chawan browser-view macro.
- map = [ "index" ];
- key = "\\Cb";
- action = "previous-page";
- }
+ # Scrolling
+ {
+ map = [ "generic" ];
+ key = "zt";
+ action = "current-top";
+ }
+ {
+ map = [ "generic" ];
+ key = "zz";
+ action = "current-middle";
+ }
+ {
+ map = [ "generic" ];
+ key = "zb";
+ action = "current-bottom";
+ }
+ {
+ map = [ "pager" ];
+ key = "j";
+ action = "next-line";
+ }
+ {
+ map = [ "pager" ];
+ key = "k";
+ action = "previous-line";
+ }
+ {
+ map = [ "pager" ];
+ key = "gg";
+ action = "top";
+ }
+ {
+ map = [ "pager" ];
+ key = "G";
+ action = "bottom";
+ }
+ {
+ map = [
+ "generic"
+ "index"
+ "pager"
+ ];
+ key = "\\Cd";
+ action = "half-down";
+ }
+ {
+ map = [
+ "generic"
+ "index"
+ "pager"
+ ];
+ key = "\\Cu";
+ action = "half-up";
+ }
+ {
+ map = [
+ "generic"
+ "index"
+ "pager"
+ ];
+ key = "\\Cf";
+ action = "next-page";
+ }
+ {
+ map = [ "index" ];
+ key = "\\Cb";
+ action = "previous-page";
+ }
- # --- h/l as "back / go into", vim left/right ---
- {
- map = [ "pager" ];
- key = "h";
- action = "exit";
- }
- {
- map = [ "pager" ];
- key = "l";
- action = "view-attachments";
- }
- {
- map = [ "index" ];
- key = "l";
- action = "display-message";
- }
+ # Searching and limiting
+ {
+ map = [
+ "generic"
+ "index"
+ "pager"
+ ];
+ key = "/";
+ action = "search";
+ }
+ {
+ map = [
+ "generic"
+ "index"
+ "pager"
+ ];
+ key = "?";
+ action = "search-reverse";
+ }
+ {
+ map = [
+ "generic"
+ "index"
+ "pager"
+ ];
+ key = "n";
+ action = "search-next";
+ }
+ {
+ map = [
+ "generic"
+ "index"
+ "pager"
+ ];
+ key = "N";
+ action = "search-opposite";
+ }
+ {
+ map = [ "index" ];
+ key = "gf";
+ action = "limit";
+ }
- # --- search (mostly default already, restated for a complete reference) ---
- {
- map = [
- "generic"
- "index"
- "pager"
- ];
- key = "/";
- action = "search";
- }
- {
- map = [
- "generic"
- "index"
- "pager"
- ];
- key = "?";
- action = "search-reverse";
- }
- {
- map = [
- "generic"
- "index"
- "pager"
- ];
- key = "n";
- action = "search-next";
- }
- {
- map = [
- "generic"
- "index"
- "pager"
- ];
- key = "N";
- action = "search-opposite";
- }
+ # Message states and threads
+ {
+ map = [ "index" ];
+ key = "]";
+ action = "next-unread";
+ }
+ {
+ map = [ "index" ];
+ key = "[";
+ action = "previous-unread";
+ }
+ {
+ map = [ "index" ];
+ key = "}";
+ action = "next-new";
+ }
+ {
+ map = [ "index" ];
+ key = "{";
+ action = "previous-new";
+ }
+ {
+ map = [ "index" ];
+ key = "za";
+ action = "collapse-thread";
+ }
+ {
+ map = [ "index" ];
+ key = "zA";
+ action = "collapse-all";
+ }
- # --- delete / undelete, vim dd ---
- {
- map = [
- "index"
- "pager"
- ];
- key = "dd";
- action = "delete-message";
- }
- {
- map = [ "index" ];
- key = "dT";
- action = "delete-thread";
- }
- {
- map = [ "index" ];
- key = "u";
- action = "undelete-message";
- }
- {
- map = [ "index" ];
- key = "U";
- action = "undelete-thread";
- }
- {
- map = [ "attach" ];
- key = "dd";
- action = "delete-entry";
- }
- {
- map = [ "attach" ];
- key = "u";
- action = "undelete-entry";
- }
+ # Core email actions
+ {
+ map = [
+ "index"
+ "pager"
+ ];
+ key = "m";
+ action = "mail";
+ }
+ {
+ map = [
+ "index"
+ "pager"
+ ];
+ key = "r";
+ action = "reply";
+ }
+ {
+ map = [
+ "index"
+ "pager"
+ ];
+ key = "R";
+ action = "group-reply";
+ }
+ {
+ map = [
+ "index"
+ "pager"
+ ];
+ key = "f";
+ action = "forward-message";
+ }
+ {
+ map = [
+ "index"
+ "pager"
+ ];
+ key = "c";
+ action = "change-folder";
+ }
+ {
+ map = [
+ "index"
+ "pager"
+ ];
+ key = "s";
+ action = "save-message";
+ }
+ {
+ map = [
+ "index"
+ "pager"
+ ];
+ key = "y";
+ action = "copy-message";
+ }
+ {
+ map = [ "index" ];
+ key = "t";
+ action = "tag-entry";
+ }
+ {
+ map = [ "pager" ];
+ key = "t";
+ action = "tag-message";
+ }
+ {
+ map = [ "index" ];
+ key = "T";
+ action = "tag-thread";
+ }
+ {
+ map = [
+ "index"
+ "pager"
+ ];
+ key = "gh";
+ action = "display-toggle-weed";
+ }
- # --- limit / filter the index, gf = filter, gF = clear filter ---
- {
- # prompts for a limit pattern; macros.nix binds gF to clear it
- map = [ "index" ];
- key = "gf";
- action = "limit";
- }
+ # Deletion and undeletion
+ {
+ map = [
+ "index"
+ "pager"
+ ];
+ key = "dd";
+ action = "delete-message";
+ }
+ {
+ map = [ "index" ];
+ key = "dT";
+ action = "delete-thread";
+ }
+ {
+ map = [
+ "index"
+ "pager"
+ ];
+ key = "u";
+ action = "undelete-message";
+ }
+ {
+ map = [ "index" ];
+ key = "U";
+ action = "undelete-thread";
+ }
+ {
+ map = [ "attach" ];
+ key = "dd";
+ action = "delete-entry";
+ }
+ {
+ map = [ "attach" ];
+ key = "u";
+ action = "undelete-entry";
+ }
- # --- unread / new / flagged navigation ---
- {
- map = [ "index" ];
- key = "]";
- action = "next-unread";
- }
- {
- map = [ "index" ];
- key = "[";
- action = "previous-unread";
- }
- {
- map = [ "index" ];
- key = "}";
- action = "next-new";
- }
- {
- map = [ "index" ];
- key = "{";
- action = "previous-new";
- }
- {
- map = [ "index" ];
- key = "gn";
- action = "next-flagged";
- }
- {
- map = [ "index" ];
- key = "gp";
- action = "previous-flagged";
- }
+ # Menu specific
+ {
+ map = [ "attach" ];
+ key = "l";
+ action = "view-attach";
+ }
+ {
+ map = [ "attach" ];
+ key = "s";
+ action = "save-entry";
+ }
+ {
+ map = [ "attach" ];
+ key = "p";
+ action = "print-entry";
+ }
- # --- attach menu ---
- {
- map = [ "attach" ];
- key = "l";
- action = "view-attach";
- }
- {
- map = [ "attach" ];
- key = "s";
- action = "save-entry";
- }
- {
- map = [ "attach" ];
- key = "p";
- action = "print-entry";
- }
+ {
+ map = [ "browser" ];
+ key = "j";
+ action = "next-entry";
+ }
+ {
+ map = [ "browser" ];
+ key = "k";
+ action = "previous-entry";
+ }
+ {
+ map = [ "browser" ];
+ key = "gg";
+ action = "first-entry";
+ }
+ {
+ map = [ "browser" ];
+ key = "G";
+ action = "last-entry";
+ }
+ {
+ map = [ "browser" ];
+ key = "l";
+ action = "select-entry";
+ }
+ {
+ map = [ "browser" ];
+ key = "\\Cd";
+ action = "half-down";
+ }
+ {
+ map = [ "browser" ];
+ key = "\\Cu";
+ action = "half-up";
+ }
- # --- browser (folder / file picker) ---
- {
- map = [ "browser" ];
- key = "j";
- action = "next-entry";
- }
- {
- map = [ "browser" ];
- key = "k";
- action = "previous-entry";
- }
- {
- map = [ "browser" ];
- key = "gg";
- action = "first-entry";
- }
- {
- map = [ "browser" ];
- key = "G";
- action = "last-entry";
- }
- {
- # neomutt has no dedicated "go up a directory" function - the ".."
- # row is a normal entry, so l/Enter on it goes up just fine
- map = [ "browser" ];
- key = "l";
- action = "select-entry";
- }
- {
- map = [ "browser" ];
- key = "\\Cd";
- action = "half-down";
- }
- {
- map = [ "browser" ];
- key = "\\Cu";
- action = "half-up";
- }
+ {
+ map = [ "compose" ];
+ key = "j";
+ action = "next-entry";
+ }
+ {
+ map = [ "compose" ];
+ key = "k";
+ action = "previous-entry";
+ }
+ {
+ map = [ "compose" ];
+ key = "y";
+ action = "send-message";
+ }
+ {
+ map = [ "compose" ];
+ key = "a";
+ action = "attach-file";
+ }
+ {
+ map = [ "compose" ];
+ key = "e";
+ action = "edit-message";
+ }
+ {
+ map = [ "compose" ];
+ key = "p";
+ action = "postpone-message";
+ }
- # --- compose menu ---
- {
- map = [ "compose" ];
- key = "j";
- action = "next-entry";
- }
- {
- map = [ "compose" ];
- key = "k";
- action = "previous-entry";
- }
- ];
+ # Global exit
+ {
+ map = [
+ "generic"
+ "index"
+ "pager"
+ "browser"
+ "attach"
+ "compose"
+ ];
+ key = "q";
+ action = "exit";
+ }
+ ]
+ ]
+ );
}
generated by cgit v1.2.3 (git 2.39.1) at 2026-10-11 03:04:58 +0000