# vim:fileencoding=utf-8:ft=conf # Font family. You can also specify different fonts for the # bold/italic/bold-italic variants. By default they are derived automatically, # by the OSes font system. Setting them manually is useful for font families # that have many weight variants like Book, Medium, Thick, etc. For example: # font_family Operator Mono Book # bold_font Operator Mono Medium # italic_font Operator Mono Book Italic # bold_italic_font Operator Mono Medium Italic # # You can get a list of full family names available on your computer by running # kitty list-fonts font_family monospace italic_font auto bold_font auto bold_italic_font auto # Font size (in pts) font_size 11.0 # The amount the font size is changed by (in pts) when increasing/decreasing # the font size in a running terminal. font_size_delta 2 # Adjust the line height. # You can use either numbers, which are interpreted as pixels or percentages # (number followed by %), which are interpreted as percentages of the # unmodified line height. You can use negative pixels or percentages less than # 100% to reduce line height (but this might cause rendering artifacts). adjust_line_height 0 # Change the sizes of the lines used for the box drawing unicode characters # These values are in pts. They will be scaled by the monitor DPI to arrive at # a pixel value. There must be four values corresponding to thin, normal, thick, # and very thick lines; box_drawing_scale 0.001, 1, 1.5, 2 # The foreground color foreground #dddddd # The background color background #000000 # The opacity of the background. A number between 0 and 1, where 1 is opaque and 0 is fully transparent. # This will only work if supported by the OS (for instance, when using a compositor under X11). Note # that it only sets the default background color's opacity. This is so that # things like the status bar in vim, powerline prompts, etc. still look good. # But it means that if you use a color theme with a background color in your # editor, it will not be rendered as transparent. Instead you should change the # default background color in your kitty config and not use a background color # in the editor color scheme. Or use the escape codes to set the terminals # default colors in a shell script to launch your editor. # Be aware that using a value less than 1.0 is a (possibly significant) performance hit. background_opacity 1.0 # The foreground for selections selection_foreground #000000 # The background for selections selection_background #FFFACD # The color and style for highlighting URLs on mouse-over. url_style can be one of: # none, single, double, curly url_color #0087BD url_style curly # The cursor color cursor #cccccc # The cursor shape can be one of (block, beam, underline) cursor_shape block # The interval (in seconds) at which to blink the cursor. Set to zero to # disable blinking. Note that numbers smaller than repaint_delay will be # limited to repaint_delay. cursor_blink_interval 0.5 # Stop blinking cursor after the specified number of seconds of keyboard inactivity. Set to # zero to never stop blinking. cursor_stop_blinking_after 15.0 # Number of lines of history to keep in memory for scrolling back scrollback_lines 2000 # Program with which to view scrollback in a new window. The scrollback buffer is passed as # STDIN to this program. If you change it, make sure the program you use can # handle ANSI escape sequences for colors and text formatting. scrollback_pager less +G -R # When viewing scrollback in a new window, put it in a new tab as well scrollback_in_new_tab no # Wheel scroll multiplier (modify the amount scrolled by the mouse wheel). Use negative # numbers to change scroll direction. wheel_scroll_multiplier 5.0 # The interval between successive clicks to detect double/triple clicks (in seconds) click_interval 0.5 # Characters considered part of a word when double clicking. In addition to these characters # any character that is marked as an alpha-numeric character in the unicode # database will be matched. select_by_word_characters :@-./_~?&=%+# # Hide mouse cursor after the specified number of seconds of the mouse not being used. Set to # zero to disable mouse cursor hiding. mouse_hide_wait 3.0 # Set the active window to the window under the mouse when moving the mouse around focus_follows_mouse no # The enabled window layouts. A comma separated list of layout names. The special value * means # all layouts. The first listed layout will be used as the startup layout. # For a list of available layouts, see the file layouts.py enabled_layouts * # If enabled, the window size will be remembered so that new instances of kitty will have the same # size as the previous instance. If disabled, the window will initially have size configured # by initial_window_width/height, in pixels. remember_window_size yes initial_window_width 640 initial_window_height 400 # Delay (in milliseconds) between screen updates. Decreasing it, increases # frames-per-second (FPS) at the cost of more CPU usage. The default value # yields ~100 FPS which is more than sufficient for most uses. repaint_delay 10 # Delay (in milliseconds) before input from the program running in the terminal # is processed. Note that decreasing it will increase responsiveness, but also # increase CPU usage and might cause flicker in full screen programs that # redraw the entire screen on each loop, because kitty is so fast that partial # screen updates will be drawn. input_delay 3 # Visual bell duration. Flash the screen when a bell occurs for the specified number of # seconds. Set to zero to disable. visual_bell_duration 0.0 # Enable/disable the audio bell. Useful in environments that require silence. enable_audio_bell yes # The modifier keys to press when clicking with the mouse on URLs to open the URL open_url_modifiers ctrl+shift # The program with which to open URLs that are clicked on. The special value "default" means to # use the operating system's default URL handler. open_url_with default # Choose whether to use the system implementation of wcwidth() (used to # control how many cells a character is rendered in). If you use the system # implementation, then kitty and any programs running in it will agree. The # problem is that system implementations often are based on outdated unicode # standards and get the width of many characters, such as emoji, wrong. So if # you are using kitty with programs that have their own up-to-date wcwidth() # implementation, set this option to no, otherwise set it to yes. use_system_wcwidth no # The value of the TERM environment variable to set term xterm-kitty # The width (in pts) of window borders. Will be rounded to the nearest number of pixels based on screen resolution. # Note that borders are displayed only when more than one window is visible. They are meant to separate multiple windows. window_border_width 1 # The window margin (in pts) (blank area outside the border) window_margin_width 0 # The window padding (in pts) (blank area between the text and the window border) window_padding_width 0 # The color for the border of the active window active_border_color #00ff00 # The color for the border of inactive windows inactive_border_color #cccccc # Tab-bar customization active_tab_foreground #000 active_tab_background #eee active_tab_font_style bold-italic inactive_tab_foreground #444 inactive_tab_background #999 inactive_tab_font_style normal tab_separator " ┇" # The 16 terminal colors. There are 8 basic colors, each color has a dull and # bright version. # black color0 #000000 color8 #4d4d4d # red color1 #cc0403 color9 #f2201f # green color2 #19cb00 color10 #23fd00 # yellow color3 #cecb00 color11 #fffd00 # blue color4 #0d73cc color12 #1a8fff # magenta color5 #cb1ed1 color13 #fd28ff # cyan color6 #0dcdcd color14 #14ffff # white color7 #dddddd color15 #ffffff # Key mapping # For a list of key names, see: http://www.glfw.org/docs/latest/group__keys.html # For a list of modifier names, see: http://www.glfw.org/docs/latest/group__mods.html # # You can use the special action no_op to unmap a keyboard shortcut that is # assigned in the default configuration. # # You can combine multiple actions to be triggered by a single shortcut, using the # syntax below: # map key combine action1 action2 action3 ... # For example: # map ctrl+shift+e combine : new_window : next_layout # this will create a new window and switch to the next available layout # Clipboard map ctrl+shift+v paste_from_clipboard map ctrl+shift+s paste_from_selection map ctrl+shift+c copy_to_clipboard map shift+insert paste_from_selection # You can also pass the contents of the current selection to any program using # pass_selection_to_program. By default, the system's open program is used, but # you can specify your own, for example: # map ctrl+shift+o pass_selection_to_program firefox map ctrl+shift+o pass_selection_to_program # Scrolling map ctrl+shift+up scroll_line_up map ctrl+shift+down scroll_line_down map ctrl+shift+k scroll_line_up map ctrl+shift+j scroll_line_down map ctrl+shift+page_up scroll_page_up map ctrl+shift+page_down scroll_page_down map ctrl+shift+home scroll_home map ctrl+shift+end scroll_end map ctrl+shift+h show_scrollback # Window management map ctrl+shift+enter new_window map ctrl+shift+n new_os_window map ctrl+shift+w close_window map ctrl+shift+] next_window map ctrl+shift+[ previous_window map ctrl+shift+f move_window_forward map ctrl+shift+b move_window_backward map ctrl+shift+` move_window_to_top map ctrl+shift+1 first_window map ctrl+shift+2 second_window map ctrl+shift+3 third_window map ctrl+shift+4 fourth_window map ctrl+shift+5 fifth_window map ctrl+shift+6 sixth_window map ctrl+shift+7 seventh_window map ctrl+shift+8 eighth_window map ctrl+shift+9 ninth_window map ctrl+shift+0 tenth_window # You can also open a new window running an arbitrary program, for example: # map ctrl+shift+y new_window mutt # You can also pass the current selection to the new program by using the @selection placeholder # map ctrl+shift+y new_window less @selection # Finally, you can even send the contents of the current screen + history buffer as stdin using # the placeholders @text (which is the plain text) and @ansi (which includes text styling escape codes) # For example, the following command opens the scrollback buffer in less in a new window. # map ctrl+shift+y new_window @ansi less +G -R # Tab management map ctrl+shift+right next_tab map ctrl+shift+left previous_tab map ctrl+shift+t new_tab map ctrl+shift+q close_tab map ctrl+shift+l next_layout map ctrl+shift+. move_tab_forward map ctrl+shift+, move_tab_backward # You can also create shortcuts to go to specific tabs, with 1 being the first tab # map ctrl+alt+1 goto_tab 1 # map ctrl+alt+2 goto_tab 2 # Just as with new_window above, you can also pass the name of arbitrary # commands to run when using new_tab. # Miscellaneous map ctrl+shift+equal increase_font_size map ctrl+shift+minus decrease_font_size map ctrl+shift+backspace restore_font_size map ctrl+shift+f11 toggle_fullscreen # Sending arbitrary text on shortcut key presses # You can tell kitty to send arbitrary (UTF-8) encoded text to # the client program when pressing specified shortcut keys. For example: # map ctrl+alt+a send_text all Special text # This will send "Special text" when you press the Ctrl+Alt+a key combination. # The text to be sent is a python string literal so you can use escapes like # \x1b to send control codes or \u21fb to send unicode characters (or you can # just input the unicode characters directly as UTF-8 text). The first argument # to send_text is the keyboard modes in which to activate the shortcut. The possible # values are normal or application or kitty or a comma separated combination of them. # The special keyword all means all modes. The modes normal and application refer to # the DECCKM cursor key mode for terminals, and kitty refers to the special kitty # extended keyboard protocol. Another example, that outputs a word and then moves the cursor # to the start of the line (same as pressing the Home key): # map ctrl+alt+a send_text normal Word\x1b[H # map ctrl+alt+a send_text application Word\x1bOH # Symbol mapping (special font for specified unicode code points). Map the # specified unicode codepoints to a particular font. Useful if you need special # rendering for some symbols, such as for Powerline. Avoids the need for # patched fonts. Each unicode code point is specified in the form U+. You can specify multiple code points, separated by commas # and ranges separated by hyphens. symbol_map itself can be specified multiple times. # Syntax is: # # symbol_map codepoints Font Family Name # # For example: # # symbol_map U+E0A0-U+E0A2,U+E0B0-U+E0B3 PowerlineSymbols # OS specific tweaks # Hide the kitty window's title bar on macOS. macos_hide_titlebar no # Use the option key as an alt key. With this set to no, kitty will use # the macOS native Option+Key = unicode character behavior. This will # break any Alt+key keyboard shortcuts in your terminal programs, but you # can use the macOS unicode input technique. macos_option_as_alt yes # The number is a percentage of maximum volume. # See man XBell for details. x11_bell_volume 80 # Prefer color emoji fonts when available. Note that this only works # on systems such as Linux that use fontconfig. On other OSes, the emoji # font used is system dependent. It can be overriden using symbol_map in the kitty # configuration. prefer_color_emoji yes