Repository navigation
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 applicationChanges apply while tron runs. An invalid combination or unknown action is reported in the window.
| 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 |
| 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 |
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
f1tof35
ctrl++ binds the plus key itself.
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 readlineThe 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.
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-lineBy 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.
Using tron
Looks
Features
Reference