termuna

Keybindings

Every binding is remappable, and bindings can be two-step chords. Defaults follow the common Linux terminal conventions.

Defaults

KeysAction
Ctrl+Shift+TNew tab
Ctrl+Shift+WClose pane
Ctrl+Shift+DSplit right
Ctrl+Shift+ESplit down
Ctrl+Shift+Right / LeftFocus next / previous pane
Ctrl+Tab / Ctrl+Shift+TabNext / previous tab
Ctrl+Shift+C / VCopy / paste
Shift+PageUp / PageDownScroll a page
Ctrl+Shift+Plus / MinusFont larger / smaller
Ctrl+KCommand palette, including the Save this session as a layout and open layout rows (Saved layouts)
Ctrl+RRecall a command from history; a second Ctrl+R hands the key through to the shell
Ctrl+Shift+FSearch scrollback
Ctrl+Alt+Shift+FSearch every pane: one query across every pane of every session
Ctrl+Shift+J"Go to where I left off" - jump the focused pane to the rule where you stopped reading, when there is one to jump to
Ctrl+Shift+SpacePick mode: label every token on the focused pane's screen. Set by pick_key under [terminal], not [keybindings]
A label's lettersIn pick mode: narrow to that token and act on it with the default action (copy, or pick_default_action); in uppercase, copy and insert
TabIn pick mode: next kind filter (all, url, path, path:line, hash, ip, string, line)
EnterIn pick mode, once a token is picked out: the default action
Shift+EnterIn pick mode: insert the token at the prompt without running it
Ctrl+EnterIn pick mode: open a URL, or a path:line in VS Code when the code command is installed
Ctrl+Shift+SIn pick mode: save the token as a snippet
EscClose a management view, back to the grid; leave pick mode (so does Ctrl+C)

Defining your own

Bindings live under [keybindings] in config.toml, as "modifiers+key" = "action". A user binding overrides the default for the same combo.

[keybindings]
"ctrl+shift+t" = "new_tab"
# Two-step chords use ">": press ctrl+a, then c.
"ctrl+a>c" = "new_tab"
  • Modifiers: ctrl, shift, alt, super (also spelled cmd or win).
  • Keys: single characters (a-z, 0-9, punctuation) plus enter, tab, space, escape, backspace, delete, the arrows, home, end, pageup, pagedown, plus, minus.
  • Actions: new_tab, close_pane, split_right, split_down, focus_next, focus_prev, next_tab, prev_tab, copy, paste, scroll_page_up, scroll_page_down, font_larger, font_smaller.

The quake hotkey

One binding is global: an OS-wide hotkey that shows or hides the Termuna window while any app has focus, the drop-down-console habit. It is off unless set, uses the same grammar (hotkey = "F12" or "ctrl+grave" under [quake]), and is also settable in-app under settings. An invalid spec never blocks startup; it logs a warning and stays unregistered.

Next: Configuration