Mappable actions¶
The actions described below can be mapped to any key press or mouse action
using the map
and mouse_map
directives in kitty.conf
.
Copy/paste¶
copy_and_clear_or_interrupt¶
Copy the selected text from the active window to the clipboard and clear selection, if no selection, send Ctrl-C
copy_or_interrupt¶
Copy the selected text from the active window to the clipboard, if no selection, send Ctrl-C
copy_to_clipboard¶
Copy the selected text from the active window to the clipboard
Default shortcuts using this action:
ctrl+shift+c
pass_selection_to_program¶
Pass the selected text from the active window to the specified program
Default shortcuts using this action:
ctrl+shift+o
paste¶
Paste the specified text into the current window
show_scrollback¶
Show scrollback in a pager like less
Default shortcuts using this action:
ctrl+shift+h
copy_to_buffer¶
Copy the selection from the active window to the specified buffer
See Multiple copy/paste buffers for details.
paste_from_buffer¶
Paste from the specified buffer to the active window
See Multiple copy/paste buffers for details.
paste_from_clipboard¶
Paste from the clipboard to the active window
Default shortcuts using this action:
ctrl+shift+v
paste_from_selection¶
Paste from the clipboard to the active window
Default shortcuts using this action:
ctrl+shift+s
Layouts¶
last_used_layout¶
Go to the previously used layout
layout_action¶
Perform a layout specific action. See Arrange windows for details
toggle_layout¶
Toggle the named layout
Switches to the named layout if another layout is current, otherwise switches to the last used layout. Useful to “zoom” a window temporarily by switching to the stack layout. For example:
map f1 toggle_layout stack
Marks¶
remove_marker¶
Remove a previously created marker
scroll_to_mark¶
Scroll to the next or previous mark of the specified type
toggle_marker¶
Toggle the current marker on/off
create_marker¶
Create a new marker
Miscellaneous¶
send_text¶
Send the specified text to the active window
For details, see ctrl+shift+alt+h
.
Default shortcuts using this action:
ctrl+shift+alt+h
signal_child¶
Send the specified SIGNAL to the foreground process in the active window
For example:
map F1 signal_child SIGTERM
clear_terminal¶
Clear the terminal
See ctrl+shift+delete
for details. For example:
# Reset the terminal
map kitty_mod+f9 clear_terminal reset active
# Clear the terminal screen by erasing all contents
map kitty_mod+f10 clear_terminal clear active
# Clear the terminal scrollback by erasing it
map kitty_mod+f11 clear_terminal scrollback active
# Scroll the contents of the screen into the scrollback
map kitty_mod+f12 clear_terminal scroll active
Default shortcuts using this action:
ctrl+shift+delete
combine¶
Combine multiple actions and map to a single keypress
The syntax is:
map key combine <separator> action1 <separator> action2 <separator> action3 ...
For example:
map kitty_mod+e combine : new_window : next_layout
debug_config¶
Show the effective configuration kitty is running with
Default shortcuts using this action:
ctrl+shift+f6
disable_ligatures_in¶
Turn on/off ligatures in the specified window
See disable_ligatures
for details
discard_event¶
Discard this event completely ignoring it
edit_config_file¶
Edit the kitty.conf config file in your favorite text editor
Default shortcuts using this action:
ctrl+shift+f2
input_unicode_character¶
Input an arbitrary unicode character. See Unicode input for details.
kitten¶
Run the specified kitten. See Custom kittens for details
Default shortcuts using this action:
ctrl+shift+p>n
, ctrl+shift+u
, ctrl+shift+p>h
, ctrl+shift+p>l
, ctrl+shift+p>f
, ctrl+shift+p>w
, ctrl+shift+p>y
, ctrl+shift+p>shift+f
kitty_shell¶
Run the kitty shell to control kitty with commands
Default shortcuts using this action:
ctrl+shift+escape
load_config_file¶
Reload the config file
If mapped without arguments reloads the default config file, otherwise loads the specified config files, in order. Loading a config file replaces all config options. For example:
map f5 load_config_file /path/to/some/kitty.conf
Default shortcuts using this action:
ctrl+shift+f5
open_url_with_hints¶
Click a URL using the keyboard
Default shortcuts using this action:
ctrl+shift+e
remote_control¶
Run a remote control command
For example:
map F1 remote_control set-spacing margin=30
See Mapping key presses to remote control commands for details.
set_colors¶
Change colors in the specified windows
For details, see kitty @ set-colors. For example:
map f5 set_colors --configured /path/to/some/config/file/colors.conf
show_kitty_env_vars¶
Show the environment variables that the kitty process sees
Mouse actions¶
mouse_click_url¶
Click the URL under the mouse
mouse_click_url_or_select¶
Click the URL under the mouse only if the screen has no selection
mouse_selection¶
Manipulate the selection based on the current mouse position
For examples, see Mouse actions
paste_selection¶
Paste the current primary selection
paste_selection_or_clipboard¶
Paste the current primary selection or the clipboard if no selection is present
Scrolling¶
scroll_end¶
Scroll to the bottom of the scrollback buffer
Default shortcuts using this action:
ctrl+shift+end
scroll_home¶
Scroll to the top of the scrollback buffer
Default shortcuts using this action:
ctrl+shift+home
Tab management¶
goto_tab¶
Go to the specified tab, by number, starting with 1
Zero and negative numbers go to previously active tabs
new_tab_with_cwd¶
Create a new tab with working directory for the window in it set to the same as the active window
select_tab¶
Interactively select a tab to switch to
set_tab_title¶
Change the title of the active tab
Default shortcuts using this action:
ctrl+shift+alt+t
Window management¶
close_other_windows_in_tab¶
Close all windows in the tab other than the currently active window
move_window¶
Move the window in the specified direction
For example:
map ctrl+left move_window left
map ctrl+down move_window bottom
move_window_backward¶
Move active window backward (swap it with the previous window)
Default shortcuts using this action:
ctrl+shift+b
move_window_forward¶
Move active window forward (swap it with the next window)
Default shortcuts using this action:
ctrl+shift+f
move_window_to_top¶
Move active window to the top (make it the first window)
Default shortcuts using this action:
ctrl+shift+`
neighboring_window¶
Focus the neighboring window in the current tab
For example:
map ctrl+left neighboring_window left
map ctrl+down neighboring_window bottom
next_window¶
Focus the next window in the current tab
Default shortcuts using this action:
ctrl+shift+]
nth_window¶
Focus the nth window if positive or the previously active windows if negative
For example, to ficus the previously active window:
map ctrl+p nth_window -1
previous_window¶
Focus the previous window in the current tab
Default shortcuts using this action:
ctrl+shift+[
reset_window_sizes¶
Reset window sizes undoing any dynamic resizing of windows
change_font_size¶
Change the font size for the current or all OS Windows
See Font sizes for details.
Default shortcuts using this action:
ctrl+shift+minus
, ctrl+shift+equal
, ctrl+shift+backspace
close_os_window¶
Close the currently active OS Window
Default shortcuts using this action:
shift+cmd+w
detach_window¶
Detach a window, moving it to another tab or OS Window
See detaching windows for details.
new_os_window_with_cwd¶
New OS Window with the same working directory as the currently active window
new_window_with_cwd¶
Create a new window with working directory same as that of the active window
quit¶
Quit, closing all windows
set_background_opacity¶
Set the background opacity for the active OS Window
For example:
map f1 set_background_opacity +0.1
map f2 set_background_opacity -0.1
map f3 set_background_opacity 0.5
Default shortcuts using this action:
ctrl+shift+a>l
, ctrl+shift+a>1
, ctrl+shift+a>m
, ctrl+shift+a>d
start_resizing_window¶
Resize the active window interactively
See Resizing windows for details.
Default shortcuts using this action:
ctrl+shift+r
toggle_fullscreen¶
Toggle the fullscreen status of the active OS Window
Default shortcuts using this action:
ctrl+shift+f11
toggle_maximized¶
Toggle the maximized status of the active OS Window
Default shortcuts using this action:
ctrl+shift+f10