Keybindings

---

title: Keybindings description: Keyboard shortcuts and customization order: 3 category: Getting Started

This file is generated by cargo run -p xtask -- generate-keybindings-doc. Do not edit manually.

Termy keybindings use Ghostty-style trigger overrides via repeated keybind lines in ~/.config/termy/config.txt.

Default Keybinds

macOS Defaults

• secondary-q -> quit
• secondary-, -> open_settings
• secondary-p -> toggle_command_palette
• secondary-t -> new_tab
• secondary-w -> close_tab
• secondary-= -> zoom_in
• secondary-+ -> zoom_in
• secondary-- -> zoom_out
• secondary-0 -> zoom_reset
• secondary-f -> open_search
• secondary-g -> search_next
• secondary-shift-g -> search_previous
• secondary-m -> minimize_window
• secondary-c -> copy
• secondary-v -> paste

Windows Defaults

• secondary-q -> quit
• secondary-, -> open_settings
• secondary-p -> toggle_command_palette
• secondary-t -> new_tab
• secondary-w -> close_tab
• secondary-= -> zoom_in
• secondary-+ -> zoom_in
• secondary-- -> zoom_out
• secondary-0 -> zoom_reset
• secondary-f -> open_search
• secondary-g -> search_next
• secondary-shift-g -> search_previous
• secondary-c -> copy
• secondary-v -> paste

Linux Defaults

• secondary-q -> quit
• secondary-, -> open_settings
• secondary-p -> toggle_command_palette
• secondary-t -> new_tab
• secondary-w -> close_tab
• secondary-= -> zoom_in
• secondary-+ -> zoom_in
• secondary-- -> zoom_out
• secondary-0 -> zoom_reset
• secondary-f -> open_search
• secondary-g -> search_next
• secondary-shift-g -> search_previous
• ctrl-shift-c -> copy
• ctrl-shift-v -> paste

Other Platform Defaults

• secondary-q -> quit
• secondary-, -> open_settings
• secondary-p -> toggle_command_palette
• secondary-t -> new_tab
• secondary-w -> close_tab
• secondary-= -> zoom_in
• secondary-+ -> zoom_in
• secondary-- -> zoom_out
• secondary-0 -> zoom_reset
• secondary-f -> open_search
• secondary-g -> search_next
• secondary-shift-g -> search_previous
• ctrl-shift-c -> copy
• ctrl-shift-v -> paste

secondary maps to cmd on macOS and ctrl on non-macOS platforms.

Config Syntax

Supported forms:

• keybind = clear
• keybind = <trigger>=<action>
• keybind = <trigger>=unbind

Behavior:

• Directives are applied in file order.
• Later lines win for the same trigger.
• clear removes all defaults before later lines are applied.
• unbind removes the current mapping for a trigger.
• Invalid lines are ignored (with warnings).

Related UI option:

• command_palette_show_keybinds = true|false controls whether command palette rows show shortcut badges.

Configurable Actions

• new_tab
• close_tab
• move_tab_left
• move_tab_right
• switch_tab_left
• switch_tab_right
• minimize_window
• rename_tab
• app_info
• restart_app
• open_config
• open_settings
• import_colors
• switch_theme
• zoom_in
• zoom_out
• zoom_reset
• open_search
• check_for_updates
• quit
• toggle_command_palette
• copy
• paste
• close_search
• search_next
• search_previous
• toggle_search_case_sensitive
• toggle_search_regex
• install_cli

Customization Examples

1) Override one default

keybind = cmd-p=toggle_command_palette

2) Remove one default

keybind = cmd-w=unbind

3) Start from scratch

keybind = clear
keybind = cmd-p=toggle_command_palette
keybind = cmd-t=new_tab
keybind = cmd-w=close_tab
keybind = cmd-c=copy
keybind = cmd-v=paste

4) Use secondary for cross-platform configs

keybind = secondary-p=toggle_command_palette
keybind = secondary-t=new_tab