Skip to content

Key Bindings

Ö. Efe D. edited this page Sep 16, 2026 · 3 revisions

Key Bindings

Bindings live under [keybindings] in ~/.config/tron/config.toml. Each entry maps a key combination to an action. Your entries override the defaults, and the action none removes a default.

[keybindings]
"ctrl+shift+c" = "none"                 # remove a default
"alt+enter" = "new_window"
"ctrl+shift+k" = "clear_scrollback"
"ctrl+shift+o" = "copy_command_output"
"super+u" = "text:\u0015"         # send Ctrl+U to the application
"alt+h" = "key:home"              # send the Home key to the application

Changes apply while tron runs. An invalid combination or unknown action is reported in the window.

Default bindings

Linux macOS Action
ctrl+shift+c super+c copy
ctrl+shift+v super+v paste
shift+insert shift+insert paste_selection
ctrl+equal, ctrl+plus super+equal, super+plus increase_font_size
ctrl+minus super+minus decrease_font_size
ctrl+0 super+0 reset_font_size
shift+page_up shift+page_up, super+page_up scroll_page_up
shift+page_down shift+page_down, super+page_down scroll_page_down
shift+home super+home scroll_to_top
shift+end super+end scroll_to_bottom
super+k clear_scrollback
ctrl+shift+f super+f search
ctrl+shift+p super+shift+p command_palette
ctrl+shift+z super+up scroll_to_previous_prompt
ctrl+shift+x super+down scroll_to_next_prompt
ctrl+shift+g super+shift+up select_command_output
ctrl+shift+n super+n new_window
ctrl+shift+comma super+comma reload_config
ctrl+shift+backspace super+backspace text:\u0015: delete the line before the cursor
ctrl+shift+left super+left key:home: go to the beginning of the line
ctrl+shift+right super+right key:end: go to the end of the line

Actions

Action Effect
copy Copy the selection to the clipboard
paste Paste the clipboard
paste_selection Paste the primary selection
increase_font_size, decrease_font_size, reset_font_size Change the font size
scroll_line_up, scroll_line_down Scroll one line
scroll_page_up, scroll_page_down Scroll one page
scroll_to_top, scroll_to_bottom Scroll to the oldest line or back to the prompt
clear_scrollback Delete the scrollback
scroll_to_previous_prompt, scroll_to_next_prompt Jump between shell prompts (needs Shell Integration)
select_command_output Select the output of the last command, or of the command at the top of the view
copy_command_output Copy that output to the clipboard
search Open the Find box
command_palette Open the command palette, which lists every command to type and run
new_window Open a new window in the current directory
reload_config Reload config.toml
text:... Send the text after text: to the application
key:... Send a key, such as key:home, to the application as if it was pressed without modifiers
none Remove the binding

Key syntax

A combination is modifiers and one key, joined with +. Case does not matter.

Modifiers: ctrl (or control), shift, alt (or option), super (or cmd, meta, logo).

Keys:

  • Any single character: a, 1, /, ;
  • Names for characters: plus, minus, equal, comma, period (dot), slash, backslash, space
  • Named keys: enter (return), tab, backspace, escape (esc), insert (ins), delete (del), home, end, page_up (pageup, pgup), page_down (pagedown, pgdn), up, down, left, right
  • Function keys f1 to f35

ctrl++ binds the plus key itself.

Sending text

text: sends any string, which is useful for control characters and escape sequences. TOML escapes such as \u0015 (Ctrl+U) and \u001b (Escape) work in the value:

[keybindings]
"alt+backspace" = "text:\u0017"    # delete the word before the cursor
"alt+left" = "text:\u001bb"        # word left in readline

The default Cmd+Backspace (Ctrl+Shift+Backspace on Linux) sends Ctrl+U. Shells, readline and tmux take it as deleting the line before the cursor, and zsh deletes the whole line.

Sending keys

key: sends a key the way tron encodes it when you press it, so the terminal's modes are respected: application cursor keys send ESC O H for Home instead of ESC [ H, and programs using the kitty keyboard protocol get the kitty encoding. The key is a single character or one of enter, tab, backspace, escape, insert, delete, home, end, page_up, page_down, up, down, left and right, with the aliases listed under Key syntax above. Function keys cannot be sent.

The default Cmd+Left and Cmd+Right (Ctrl+Shift+Left and Ctrl+Shift+Right on Linux) send Home and End, which bash, fish, Neovim and most line editors take as the beginning and end of the line. They do not send Ctrl+A and Ctrl+E, which are a common tmux prefix. zsh started without a configuration does not bind Home and End; add them to ~/.zshrc:

bindkey '^[[H' beginning-of-line
bindkey '^[[F' end-of-line

macOS: Option as Alt

By default the Option keys type special characters. Set option_as_alt under [window] to left, right or both to make them act as Alt.

Option composes nothing with Backspace, so Option+Backspace always acts as Alt+Backspace and deletes the word before the cursor in shells, readline and tmux.

Clone this wiki locally