Standards, Environments, and Macros TERMINATORCONFIG(5)
NAME
${XDGCONFIGHOME}/terminator/config (usually
~/.config/terminator/config) - the config file for Termina-
tor terminal emulator.
DESCRIPTION
This manual page documents briefly the Terminator config
file.
terminator/config is an optional file to configure the ter-
minator terminal emulator. It is used to control options not
in gnome-terminal gconf profiles, or override gconf set-
tings.
The options can be defined one per line in the form: OPTION
= VALUE.
OPTIONS
allowbold (boolean)
If true, allow applications in the terminal to make
text boldface. Default value: True
enablerealtransparency (boolean)
If true, Terminator will try to use real transparency
if possible. Default value: False
silentbell (boolean)
If true, don't make a noise when applications send the
escape sequence for the terminal bell. Flash the termi-
nal instead. Default value: True
forcenobell (boolean)
If true, don't make a noise or flash. All terminal
bells will be ignored. Default value: False
usethemecolors
If true, ignore the configured colours and use values
from the theme instead. Default value: False
backgroundcolor
Default colour of terminal background, as a colour
specification (can be HTML-style hex digits, or a
colour name such as "red"). Note: You may need to set
usethemecolors=False to force this setting to take
effect. Default value: #000000
backgrounddarkness
A value between 0.0 and 1.0 indicating how much to
darken the background image. 0.0 means no darkness, 1.0
means fully dark. If the terminal is set to tran-
sparent, this setting controls how transparent it is.
0.0 means fully transparent, 1.0 means fully opaque.
Nicolas Valcarcel 2008 1
Standards, Environments, and Macros TERMINATORCONFIG(5)
Default value: 0.5
backgroundtype
Type of terminal background. May be "solid" for a solid
colour, "image" for an image, or "transparent" for full
transparency in compositing window managers, otherwise
pseudo transparency. Default value: solid
backgroundimage
Path to an image file to be used for the background of
terminals. Default value: Nothing
backspacebinding
Sets what code the backspace key generates. Possible
values are "ascii-del" for the ASCI DEL character,
"control-h" for Control-H (AKA the ASCI BS character),
"escape-sequence" for the escape sequence typically
bound to backspace or delete. "ascii-del" is normally
considered the correct setting for the Backspace key.
Default value: ascii-del
deletebinding
Sets what code the delete key generates. Possible
values are "ascii-del" for the ASCI DEL character,
"control-h" for Control-H (AKA the ASCI BS character),
"escape-sequence" for the escape sequence typically
bound to backspace or delete. "escape-sequence" is nor-
mally considered the correct setting for the Delete
key. Default value: delete-sequence
cursorblink (boolean)
Controls if the cursor blinks. Default value: True
emulation
Sets what type of terminal should be emulated. Default
value: xterm
font An Pango font name. Examples are "Sans 12" or
"Monospace Bold 14". Default value: Mono 8
foregroundcolor
Default colour of text in the terminal, as a colour
specification (can be HTML-style hex digits, or a
colour name such as "red"). Note: You may need to set
usethemecolors=False to force this setting to take
effect. Default value: #A
scrollbarposition
Where to put the terminal scrollbar. Possibilities are
"left", "right", and "disabled". Default value: right
titlebars
Nicolas Valcarcel 2008 2
Standards, Environments, and Macros TERMINATORCONFIG(5)
If true, a titlebar will be drawn for each terminal
which shows the current title of that terminal.
Default value: True
titletips
If true, a tooltip will be available for each terminal
which shows the current title of that terminal.
Default value: False
scrollbackground (boolean)
If true, scroll the background image with the fore-
ground text; if false, keep the image in a fixed posi-
tion and scroll the text above it. Default value: True
scrollonkeystroke (boolean)
If true, pressing a key jumps the scrollbar to the bot-
tom. Default value: True
scrollonoutput (boolean)
If true, whenever there's new output the terminal will
scroll to the bottom. Default value: True
scrollbacklines
Number of scrollback lines to keep around. You can
scroll back in the terminal by this number of lines;
lines that don't fit in the scrollback are discarded.
Be careful with this setting; it's the primary factor
in determining how much memory the terminal will use.
Default value: 500
focus
Sets what type of mouse events should determine termi-
nal focus. Can be "sloppy" or "click". "mouse" is also
interpreted as "sloppy". Default value: click
focusonclose
Sets which terminal should get the focus when another
terminal is closed. Values can be "prev", "next" or
"auto". Using "auto", if the closed terminal is within
a splitted window, the focus will be on the sibling
terminal rather than another tab. Default value: auto
exitaction
Possible values are "close" to close the terminal, and
"restart" to restart the command. Default value: close
palette
Terminals have a 16-colour palette that applications
inside the terminal can use. This is that palette, in
the form of a colon-separated list of colour names.
Colour names should be in hex format e.g. "#F00F".
Default value:
Nicolas Valcarcel 2008 3
Standards, Environments, and Macros TERMINATORCONFIG(5)
#000000000000:#CDCD00000000:#0000CDCD0000:#CDCDCDCD0000:#30BF30BFA38E:#A53C212FA53C:#0000CDCDCDCD:#FAFAEBEBD7D7:#404040404040:#F00000000:#0000F0000:#F0000:#00000000F:#F0000F:#0000F:#F
wordchars
When selecting text by word, sequences of these charac-
ters are considered single words. Ranges can be given
as "A-Z". Literal hyphen (not expressing a range)
should be the first character given. Default value:
-A-Za-z0-9,./?%&#:
mouseautohide (boolean)
Controls whether the mouse cursor should be hidden
while typing. Default value: True
usecustomcommand (boolean)
If True, the value of customcommand will be used
instead of the default shell. Default value: False
customcommand
Command to execute instead of the default shell, if
usecustomcommand is set to True. Default value:
Nothing
httpproxy
URL of an HTP proxy to use, e.g.
http:/proxy.lan:3128/ Default value: Nothing
encoding
Character set to use for the terminal. Default value:
UTF-8
fullscreen (boolean)
Controls whether the Terminator window will be started
in fullscreen mode Default value: False
maximise (boolean)
Controls whether the Terminator window will be started
maximised Default value: False
borderless (boolean)
Controls whether the Terminator window will be started
without window borders Default value: False
handlesize
Controls the width of the separator between terminals.
Anything outside the range 0-5 (inclusive) will be
ignored and use your default theme value. Default
value: -1
f11modifier (boolean)
If this is set to True, the fullscreen keyboard
shortcut changes from F11 (like many GNOME apps) to
Ctrl-Shift-F11 (useful if you use terminal applications
Nicolas Valcarcel 2008 4
Standards, Environments, and Macros TERMINATORCONFIG(5)
which expect to receive F11. Default value: False
cycletermtab (boolean)
If this is set to True, when switching to the
next/previous term, Terminator will cycle within the
same tab. Ctrl-PageUp/PageDown can then be used to move
from one tab to the other one. Default value: True
closebuttonontab (boolean)
If set to True, tabs will have a close button on them.
Default value: True
copyonselection (boolean)
If set to True, text selections will be automatically
copied to the clipboard, in addition to being made the
Primary selection. Default value: False
extremetabs (boolean)
If set to True, tabs can be created within other tabs.
Be warned that this can be very confusing and hard to
use. Default value: False
SEE ALSO
gnome-terminal(1)
Nicolas Valcarcel 2008 5
|
