terminator_config - the config file for Terminator terminal emulator

This file contains the configuration for terminator(1). Terminator manages its configuration file via the ConfigObj library to combine flexibility with clear, human editable files. Terminator offers a full GUI preferences editor which automatically saves its config file so you don’t need to write a config file by hand.

This is what a Terminator config file should look like: # This is a comment [global_config] focus = system [keybindings] full_screen = <Ctrl><Shift>F11 [profiles] [[default]] font = Fixed 10 background_color = "#000000" # A comment foreground_color = "#FFFFFF" # Note that hex colour values must be quoted scrollback_lines = '500' #More comment. Single quotes are valid too cursor_blink = True custom_command = "echo \"foo#bar\"" #Final comment - this will work as expected. [layouts] [[default]] [[[window0]]] type = Window parent = "" [[[child1]]] type = Terminal parent = window0 [plugins]

Normally the config file will be ~/.config/terminator/config, but it may be overridden with $XDG_CONFIG_HOME (in which case it will be $XDG_CONFIG_HOME/terminator/config).

These are the options Terminator currently supports in the global_config section. WindowBehavior&Appearancewindow_state = string Control how the Terminator window opens. 'normal' to open normally. 'maximise' to open in a maximised state. 'fullscreen' to open in a fullscreen state. 'hidden' to stay hidden. Default value: normalalways_on_top = boolean If set to True, the window will always stay on top of other windows. Default value: Falsesticky = boolean If set to True, the window will be visible on all workspaces. Default value: Falsehide_on_lose_focus = boolean If set to True, the window will be hidden when focus is lost. Default value: Falsehide_from_taskbar = boolean If set to True, the window will be hidden from the taskbar. Default value: Falsegeometry_hinting = boolean If set to True, the window will resize in step with font sizes. Default value: Falseask_before_closing = string Specify when to ask for confirmation before closing a window or a tab. Can be any of: 'always', 'multiple_terminals', 'never'. Default value: multiple_terminalsborderless = boolean If set to True, the window will be started without window borders. Default value: FalseTabBehavior&Appearancetab_position = string Specify where tabs are placed. Can be any of: 'top', 'left', 'right', 'bottom', 'hidden'. If set to 'hidden', the tab bar will not be shown. Hiding the tab is not recommended, as it can be very confusing. Default value: topclose_button_on_tab = boolean If set to True, tabs will have a close button on them. Default value: Truescroll_tabbar = boolean If set to True, the tab bar will not fill the width of the window. The titlebars of the tabs will only take as much space as is necessary for the text they contain. Except, that is, if the tabs no longer fit the width of the window - in that case scroll buttons will appear to move through the tabs. Default value: FalseTerminalBehavior&Appearancefocus = string Specify how focus is given to terminals. 'click' means the focus only moves to a terminal after you click in it. 'sloppy' means the focus will follow the mouse pointer. 'system' means the focus will match that used by a GNOME window manager. Default value: clickalways_split_with_profile = boolean Specify whether splits/tabs will continue to use the profile of their peer terminal. If set to False, they will always use the default profile. Default value: Falselink_single_click = boolean If set to True, clicking a link will open it even if Ctrl is not pressed. Default value: Falseputty_paste_style = boolean If set to True, right-click will paste text, while middle-click will popup the context menu. The source for the pasted text depends on the value of putty_paste_style_source_clipboard. Default value: Falseputty_paste_style_source_clipboard = boolean If set to True, the Clipboard will be used as source for pasting in PuTTY style. Otherwise, the Primary Selection will be used. This option is ignored unless putty_paste_style is set to True. Default value: Falsedisable_mouse_paste = boolean If set to True, mouse pasting will be disabled. Default value: Falsesmart_copy = boolean If set to True, and there is no selection, the shortcut is allowed to pass through. This is useful for overloading Ctrl-C to copy a selection, or send the SIGINT to the current process if there is no selection. If False, the shortcut does not pass through at all, and the SIGINT does not get sent. Default value: Trueclear_select_on_copy = boolean If set to True, text selection will be cleared after copying using the copy keybinding. Default value: Falsehandle_size = integer Specify the width of the separator between terminals. Anything outside the range 0-20 (inclusive) will be ignored and the default theme value will be used instead. Default value: 1inactive_color_offset = float Specify how much to reduce the color values of fonts in terminals that do not have focus. Default value: 0.8inactive_bg_color_offset = float Specify how much to reduce the color values of the background in terminals that do not have focus. Default value: 1.0cell_width = float Specify the horizontal scale of character cells in the terminal. Default value: 1.0cell_height = float Specify the vertical scale of character cells in the terminal. Default value: 1.0title_at_bottom = boolean If set to True, the terminal’s titlebar will be drawn at the bottom instead of the top. Default value: FalseMiscellaneousdbus = boolean Specify whether Terminator will load its DBus server. When this server is loaded, running Terminator multiple times will cause the first Terminator process to open additional windows. If this configuration item is set to False, or the python dbus module is unavailable, running Terminator multiple times will run a separate Terminator process for each invocation. Default value: Trueextra_styling = boolean If set to True, Terminator may load an additional CSS styling file, depending on the theme. Default value: Truebroadcast_default = string Specify the default broadcast behavior. Can be any of: 'all', 'group', 'off'. Default value: groupuse_custom_url_handler = boolean If set to True, URL handling will be given over entirely to the program specified by 'custom_url_handler'. Default value: Falsecustom_url_handler = string Specify the path to a program which accepts a URI as an argument and does something relevant with it. This option is ignored unless use_custom_url_handler is set to True. case_sensitive = boolean If set to True, uppercase and lowercase characters will be considered different when searching text in the terminal. Default value: Trueinvert_search = boolean If set to True, the search direction will be inverted (bottom to top) when searching text in the terminal. Default value: Falseenabled_plugins = listofstrings Specify which plugins will be loaded by default. All other plugin classes will be ignored. Default value: ['LaunchpadBugURLHandler','LaunchpadCodeURLHandler','APTURLHandler']

These are the options Terminator currently supports in the keybindings section. Creation&Destructionsplit_horiz Split the current terminal horizontally. Default value: <Ctrl><Shift>Osplit_vert Split the current terminal vertically. Default value: <Ctrl><Shift>Esplit_auto Split the current terminal automatically, along the longer side. Default value: <Ctrl><Shift>Anew_tab Open a new tab. Default value: <Ctrl><Shift>Tnew_window Open a new window as part of the existing process. Default value: <Ctrl><Shift>Inew_terminator Spawn a new Terminator process. Default value: <Super>Ilayout_launcher Open the layout launcher. Default value: <Alt>Lclose_term Close the current terminal. Default value: <Ctrl><Shift>Wclose_window Close the current window. Default value: <Ctrl><Shift>QNavigationcycle_next Focus the next terminal. This is an alias for go_next. Default value: <Ctrl>Tabcycle_prev Focus the previous terminal. This is an alias for go_prev. Default value: <Ctrl><Shift>Tabgo_next Focus the next terminal. Default value: <Ctrl><Shift>Ngo_prev Focus the previous terminal. Default value: <Ctrl><Shift>Pgo_up Focus the terminal above the current one. Default value: <Alt>Upgo_down Focus the terminal below the current one. Default value: <Alt>Downgo_left Focus the terminal to the left of the current one. Default value: <Alt>Leftgo_right Focus the terminal to the right of the current one. Default value: <Alt>Rightpage_up Scroll the terminal up one page. page_down Scroll the terminal down one page. page_up_half Scroll the terminal up half a page. page_down_half Scroll the terminal down half a page. line_up Scroll the terminal up one line. line_down Scroll the terminal down one line. next_tab Move to the next tab. Default value: <Ctrl>Page_Downprev_tab Move to the previous tab. Default value: <Ctrl>Page_Upswitch_to_tab_1, switch_to_tab_2, ... switch_to_tab_10 Move to the Nth tab. Note that <Alt><Shift>1 may be provided as <Alt>! or similar, depending on the keyboard layout. Organisationresize_up Move the parent dragbar up. Default value: <Ctrl><Shift>Upresize_down Move the parent dragbar down. Default value: <Ctrl><Shift>Downresize_left Move the parent dragbar left. Default value: <Ctrl><Shift>Leftresize_right Move the parent dragbar right. Default value: <Ctrl><Shift>Rightrotate_cw Rotate terminals clockwise. Default value: <Super>Rrotate_ccw Rotate terminals counter+clockwise. Default value: <Super><Shift>Rmove_tab_right Move the current tab to the right by swapping position with the next tab. Default value: <Ctrl><Shift>Page_Downmove_tab_left Move the current tab to the left by swapping position with the previous tab. Default value: <Ctrl><Shift>Page_UpFocusfull_screen Toggle window to fullscreen. Default value: F11toggle_zoom Toggle maximisation of the current terminal. Default value: <Ctrl><Shift>Xscaled_zoom Toggle maximisation of the current terminal and scale the font when maximised. Default value: <Ctrl><Shift>Zhide_window Hide/Show all Terminator windows. Default value: <Ctrl><Shift><Alt>AGrouping&Broadcastingcreate_group Create a new group. group_all Group all terminals together. Default value: <Super>Gungroup_all Ungroup all terminals. group_all_toggle Toggle grouping of all terminals. group_win Group all terminals in the current window together. ungroup_win Ungroup all terminals in the current window. Default value: <Super><Shift>Wgroup_win_toggle Toggle grouping of all terminals in the current window. group_tab Group all terminals in the current tab together. Default value: <Super>Tungroup_tab Ungroup all terminals in the current tab. Default value: <Super><Shift>Tgroup_tab_toggle Toggle grouping of all terminals in the current tab. broadcast_off Turn broadcasting off. broadcast_group Broadcast to all terminals in the same group as the current terminal. broadcast_all Broadcast to all terminals. Miscellaneoushelp Open the full HTML manual in the browser. Default value: F1preferences Open the Preferences window. preferences_keybindings Open the Preferences window and show the Keybindings tab. Default value: <Ctrl><Shift>Kcopy Copy the selected text to the Clipboard. Default value: <Ctrl><Shift>Cpaste Paste the current contents of the Clipboard. Default value: <Ctrl><Shift>Vpaste_selection Paste the current contents of the Primary Selection. toggle_scrollbar Toggle the scrollbar. Default value: <Ctrl><Shift>Ssearch Search for text in the terminal scrollback history. Default value: <Ctrl><Shift>Freset Reset the terminal state. Default value: <Ctrl><Shift>Rreset_clear Reset the terminal state and clear the terminal window. Default value: <Ctrl><Shift>Gzoom_in Increase the font size by one unit. Default value: <Ctrl>pluszoom_out Decrease the font size by one unit. Default value: <Ctrl>minuszoom_normal Restore the original font size. Default value: <Ctrl>0zoom_in_all Increase the font size by one unit for all terminals. zoom_out_all Decrease the font size by one unit for all terminals. zoom_normal_all Restore the original font size for all terminals. edit_window_title Rename the current window. Default value: <Ctrl><Alt>Wedit_tab_title Rename the current tab. Default value: <Ctrl><Alt>Aedit_terminal_title Rename the current terminal. Default value: <Ctrl><Alt>Xinsert_number Insert the current terminal’s number, i.e. 1 to 12. Default value: <Super>1insert_padded Insert the current terminal’s number, but zero padded, i.e. 01 to 12. Default value: <Super>0next_profile Switch to the next profile. previous_profile Switch to the previous profile.

The layouts section contains all the saved layouts. Each layout should be its own subsection with a header in the format [[name]]. Each object in a layout is a named sub-sub-section with various properties. type = string Can be any of: 'Window', 'Notebook', 'HPaned', 'VPaned', 'Terminal'. parent = string Specify which object is the parent of the component being defined. All objects, except those of type Window, must specify a parent. This is an example of a layouts section containing only the layout named "default". [layouts] [[default]] [[[window0]]] type = Window parent = "" [[[child1]]] type = Terminal parent = window0

terminator_config - the config file for Terminator terminal emulator

Terminator plugins can add their own configuration to the config file, and it will appear as a subsection. Please refer to the documentation of individual plugins for more information.

These are the options Terminator currently supports in the profiles section. Each profile should be its own subsection with a header in the format [[name]]. Generalallow_bold = boolean If set to True, text in the terminal can displayed in bold. Default value: Truecopy_on_selection = boolean If set to True, text selections will be automatically copied to the Clipboard, in addition to being copied to the Primary Selection. Default value: Falsedisable_mousewheel_zoom = boolean If set to True, Ctrl+mouse_wheel will not zoom or unzoom the terminal. Default value: Falseword_chars = string Specify the characters that will be considered part of a single word when selecting text by word. Hyphen and alphanumerics do not need to be specified. Ranges can be given, e.g. "A-Z". For example, if word_chars = "," then "foo,bar" is considered a single word. Default value: -,./?%&#:_mouse_autohide = boolean If set to True, the mouse pointer will be hidden when typing. Default value: Trueterm = string Specify the value Terminator will assign to the 'TERM' environment variable. Default value: xterm-256colorcolorterm = string Specify the value Terminator will assign to the 'COLORTERM' environment variable. Default value: truecolorsplit_to_group = boolean If set to True, the terminal created by splitting will be inserted in the current terminal’s group. Default value: Falseautoclean_groups = boolean If set to True, empty groups will be removed. Default value: Trueuse_system_font = boolean If set to True, the system default font will be used for text in the terminal. Otherwise, the value of font will be used. Default value: Truefont = string Specify which font to use for text in the terminal. This option is ignored unless use_system_font is set to False. Default value: Mono10cursor_blink = boolean If set to True, the cursor will blink when not typing. Default value: Truecursor_shape = string Specify the shape of the cursor. Can be any of: 'block', 'underline', 'ibeam'. Default value: blockcursor_color_default = boolean If set to True, the background and foreground colors of the terminal will be used as foreground and background colors for the cursor, respectively. Default value: Truecursor_fg_color = colorstring Specify the foreground color to use for the cursor. This option is ignored unless cursor_color_default is set to False. cursor_bg_color = colorstring Specify the background color to use for the cursor. This option is ignored unless cursor_color_default is set to False. audible_bell = boolean If set to True, a sound will be played when an application writes the escape sequence for the terminal bell. Default value: Falsevisible_bell = boolean If set to True, the terminal will flash when an application writes the escape sequence for the terminal bell. Default value: Falseurgent_bell = boolean If set to True, the window’s urgency hint will be set when an application writes the escape sequence for the terminal bell. Default value: Falseicon_bell = boolean If set to True, a small icon will be shown on the terminal titlebar when an application writes the escape sequence for the terminal bell. Default value: Trueforce_no_bell = boolean If set to True, the terminal bell will be completely disabled. Default value: FalseCommandlogin_shell = boolean If set to True, the terminal will run the default shell (or the command specified by custom_command) as a login shell. This means the first argument passed to the shell/command will be '-l'. Default value: Falseuse_custom_command = boolean If set to True, the value of custom_command will be used instead of the default shell. Default value: Falsecustom_command = string Specify the command to execute instead of the default shell. This option is ignored unless use_custom_command is set to True. exit_action = string Specify the action to perform when the terminal is closed. 'close' to remove the terminal. 'restart' to restart the shell (or the command specified by custom_command). 'hold' to keep the terminal open, even if the process in it has terminated. Default value: closeColorsuse_theme_colors = boolean If set to True, the theme’s foreground and background colors will be used for the terminal. Otherwise, the values of foreground_color and background_color will be used. Default value: Falseforeground_color = colorstring Specify the foreground color to use for the terminal. This option is ignored unless use_theme_colors is set to False. Default value: #AAAAAAbackground_color = colorstring Specify the background color to use for the terminal. This option is ignored unless use_theme_colors is set to False. Default value: #000000palette = stringlistofcolors Specify the 16-color palette to use for the terminal. The value must be a string containing a colon-separated list of colors in hex format. For example, "#000000:#cd0000:#00cd00: ... ". bold_is_bright = boolean If set to True, bold text will have brighter colors. Default value: FalseBackgroundbackground_darkness = float Specify the transparency of the background color. The value must be between 0.0 and 1.0. This option is ignored unless background_type is set to 'transparent' or 'image'. Default value: 0.5background_type = string Specify what type of background the terminal will have. 'solid' for a solid (opaque) background. 'transparent' for a transparent background. 'image' for a background image. If this is set to 'transparent', the transparency of the background will be the value of background_darkness. If this is set to 'image', the image specified by background_image will be the background; the background color will then be drawn on top of it, with a transparency specified by background_darkness. Default value: solidbackground_image = pathstring Specify the path to an image that will be used as background. This option is ignored unless background_type is set to 'image'. background_image_mode = string Specify how the background image will be drawn. 'stretch_and_fill' to fill the terminal entirely, without necessarily maintaining aspect ratio. 'scale_and_fit' to fit the image inside the terminal, eventually leaving blank bars, while maintaining aspect ratio. 'scale_and_crop' to fill the terminal entirely, eventually cropping the image, while maintaining aspect ratio. 'tiling' to repeat the image as to fill the terminal. This option is ignored unless background_type is set to 'image'. Default value: stretch_and_fillbackground_image_align_horiz = string Specify the horizontal alignment of the background image. Can be any of: 'left', 'center', 'right'. This option is ignored unless background_type is set to 'image'. Default value: centerbackground_image_align_vert = string Specify the vertical alignment of the background image. Can be any of: 'top', 'middle', 'bottom'. This option is ignored unless background_type is set to 'image'. Default value: middleScrollingscrollbar_position = string Specify where the terminal scrollbar is put. Can be any of: 'left', 'right', 'hidden'. Default value: rightscroll_on_output = boolean If set to True, the terminall will scroll to the bottom when an application writes text to it. Default value: Falsescroll_on_keystroke = boolean If set to True, the terminal will scroll to the bottom when typing. Default value: Truescrollback_infinite = boolean If set to True, the terminal will keep the entire scrollback history. Default value: Falsescrollback_lines = integer Specify how many lines of scrollback history will be kept by the terminal. Lines that don’t fit in the scrollback history will be discarted. Note that setting large values can slow down rewrapping and resizing. This option is ignored unless scrollback_infinite is set to False. Default value: 500Compatibilitybackspace_binding = string Specify what code will be generated by the backspace key. The value can be: 'ascii-del' for the ASCII DEL character; 'control-h' for the ASCII BS character (Ctrl+H); 'escape-sequence' for the escape sequence typically bound to backspace or delete; 'automatic' for letting the terminal automatically decide the character sequence to use. Default value: ascii-deldelete_binding = string Specify what code will be generated by the delete key. The value can be: 'ascii-del' for the ASCII DEL character; 'control-h' for the ASCII BS character (Ctrl+H); 'escape-sequence' for the escape sequence typically bound to backspace or delete; 'automatic' for letting the terminal automatically decide the character sequence to use. Default value: escape-sequenceTitlebarshow_titlebar = boolean If set to True, the terminal will have a titlebar showing the current title of that terminal. Default value: Truetitle_hide_sizetext = boolean If set to True, the size of the terminal will not be written on its titlebar. Default value: Falsetitle_use_system_font = boolean If set to True, the system default font will be used for text in the terminal’s titlebar. Otherwise, the value of title_font will be used. Default value: Truetitle_font = string Specify which font to use for text in the terminal’s titlebar. This option is ignored unless title_use_system_font is set to False. Default value: Sans9title_transmit_fg_color = colorstring Specify the foreground color to use for the terminal’s titlebar in case the terminal is focused. Default value: #fffffftitle_transmit_bg_color = colorstring Specify the background color to use for the terminal’s titlebar in case the terminal is focused. Default value: #c80003title_inactive_fg_color = colorstring Specify the foreground color to use for the terminal’s titlebar in case the terminal is unfocused. Default value: #000000title_inactive_bg_color = colorstring Specify the background color to use for the terminal’s titlebar in case the terminal is unfocused. Default value: #c0bebftitle_receive_fg_color = colorstring Specify the foreground color to use for the terminal’s titlebar in case the terminal is in a group and is receiving input while unfocused. Default value: #fffffftitle_receive_bg_color = colorstring Specify the background color to use for the terminal’s titlebar in case the terminal is in a group and is receiving input while unfocused. Default value: #0076c9

terminator(1), https://configobj.readthedocs.io/ Terminator 2023-10-10 TERMINATOR_CONFIG(5)