<!doctypehtml><html class=no-js lang=en><meta charset=utf-8><meta content=width=device-width,initial-scale=1.0 name=viewport><title>
   Preferences Window — Terminator 1.0 alpha documentation
  </title><link href=https://media.readthedocs.org/css/sphinx_rtd_theme.css rel=stylesheet><link href=genindex.html rel=index title=Index><link href=search.html rel=search title=Search><link title="Terminator 1.0 alpha documentation"href=index.html rel=top><link title="Layouts and the Layout Launcher"href=layouts.html rel=next><link title="Getting Started"href=gettingstarted.html rel=prev><script src=_static/js/modernizr.min.js></script><link href=http://terminator-gtk2.readthedocs.io/en/latest/preferences.html rel=canonical><link href=https://media.readthedocs.org/css/readthedocs-doc-embed.css rel=stylesheet><script src=_static/readthedocs-data.js></script><script>READTHEDOCS_DATA['page'] = 'preferences' 		
READTHEDOCS_DATA['source_suffix'] = '.rst'</script><script src=_static/readthedocs-dynamic-include.js></script><body class=wy-body-for-nav role=document><div class=wy-grid-for-nav><nav class=wy-nav-side data-toggle=wy-nav-shift><div class=wy-side-scroll><div class=wy-side-nav-search><a class="icon icon-home"href=index.html> Terminator </a><div class=version>latest</div><div role=search><form action=search.html class=wy-form id=rtd-search-form><input placeholder="Search docs"name=q><input name=check_keywords type=hidden value=yes><input name=area type=hidden value=default></form></div></div><div aria-label="main navigation"class="wy-menu wy-menu-vertical"data-spy=affix role=navigation><p class=caption><span class=caption-text> Contents: </span><ul class=current><li class=toctree-l1><a class="reference internal"href=licensing.html> Licensing </a><li class=toctree-l1><a class="reference internal"href=history.html> Document history </a><li class=toctree-l1><a class="reference internal"href=gettingstarted.html> Getting Started </a><li class="toctree-l1 current"><a class="current reference internal"href=#> Preferences Window </a> <ul><li class=toctree-l2><a class="reference internal"href=#global> Global </a> <ul><li class=toctree-l3><a class="reference internal"href=#behaviour> Behaviour </a><li class=toctree-l3><a class="reference internal"href=#appearance> Appearance </a><li class=toctree-l3><a class="reference internal"href=#terminal-titlebar> Terminal Titlebar </a></ul><li class=toctree-l2><a class="reference internal"href=#profiles> Profiles </a> <ul><li class=toctree-l3><a class="reference internal"href=#general> General </a> <ul><li class=toctree-l4><a class="reference internal"href=#cursor> Cursor </a><li class=toctree-l4><a class="reference internal"href=#terminal-bell> Terminal bell </a><li class=toctree-l4><a class="reference internal"href=#not-in-terminator> Not in Terminator </a></ul><li class=toctree-l3><a class="reference internal"href=#command> Command </a> <ul><li class=toctree-l4><a class="reference internal"href=#id1> Not in Terminator </a></ul><li class=toctree-l3><a class="reference internal"href=#colours> Colours </a> <ul><li class=toctree-l4><a class="reference internal"href=#foreground-and-background> Foreground and Background </a><li class=toctree-l4><a class="reference internal"href=#palette> Palette </a><li class=toctree-l4><a class="reference internal"href=#id2> Not in Terminator </a></ul><li class=toctree-l3><a class="reference internal"href=#background> Background </a><li class=toctree-l3><a class="reference internal"href=#scrolling> Scrolling </a><li class=toctree-l3><a class="reference internal"href=#compatibility> Compatibility </a> <ul><li class=toctree-l4><a class="reference internal"href=#encoding> Encoding </a></ul></ul><li class=toctree-l2><a class="reference internal"href=#layouts> Layouts </a><li class=toctree-l2><a class="reference internal"href=#keybindings> Keybindings </a><li class=toctree-l2><a class="reference internal"href=#plugins> Plugins </a><li class=toctree-l2><a class="reference internal"href=#about> About </a></ul><li class=toctree-l1><a class="reference internal"href=layouts.html> Layouts and the Layout Launcher </a><li class=toctree-l1><a class="reference internal"href=grouping.html> The Grouping Menu </a><li class=toctree-l1><a class="reference internal"href=plugins.html> Plugins </a><li class=toctree-l1><a class="reference internal"href=advancedusage.html> Advanced Usage </a><li class=toctree-l1><a class="reference internal"href=faq.html> Frequently Asked Questions </a><li class=toctree-l1><a class="reference internal"href=gettinginvolved.html> Getting involved </a></ul></div></div></nav><section class=wy-nav-content-wrap data-toggle=wy-nav-shift><nav aria-label="top navigation"class=wy-nav-top role=navigation><i class="fa fa-bars"data-toggle=wy-nav-top> </i><a href=index.html> Terminator </a></nav><div class=wy-nav-content><div class=rst-content><div aria-label="breadcrumbs navigation"role=navigation><ul class=wy-breadcrumbs><li><a href=index.html> Docs </a> »<li>Preferences Window<li class=wy-breadcrumbs-aside><a href=_sources/preferences.rst.txt rel=nofollow> View page source </a></ul><hr></div><div class=document itemscope itemtype=http://schema.org/Article role=main><div itemprop=articleBody><img alt="Because spanners mean settings?!?!?"class=align-right src=_images/icon_prefs.png><div class=section id=preferences-window><span id=preferences> </span><h1>Preferences Window <a title="Permalink to this headline"class=headerlink href=#preferences-window> ¶ </a></h1><p>Terminator is <em> highly </em> configurable, and automate-able, so the Preferences dialog is naturally quite extensive. It currently consists of six tabs. Let’s work through them one by one.<div class=section id=global><span id=prefs-global> </span><h2>Global <a title="Permalink to this headline"class=headerlink href=#global> ¶ </a></h2><img alt=_images/prefs_global.png src=_images/prefs_global.png><p>These settings are defaults, but some of them can be overridden by a options on the command-line, or within a layout. A number will also require a restart to take effect.<div class=section id=behaviour><h3>Behaviour <a title="Permalink to this headline"class=headerlink href=#behaviour> ¶ </a></h3><blockquote><div><p><strong> Window state </strong> (default: Normal)<blockquote><div><p>This will determine what happens on startup normally.<ul class=simple><li><em> Normal </em> - Window opens as normal.<li><em> Hidden </em> - Window does not open. Useful at login, so it is already available with a shortcut.<li><em> Maximised </em> - Window opens maximised in the standard window manager frame.<li><em> Fullscreen </em> - Window opens fullscreen with no window manager frame.</ul></div></blockquote><p><strong> Always on top </strong> (default: off)<blockquote><div>Window attempts to remain on top.</div></blockquote><p><strong> Show on all workspaces </strong> (default: off)<blockquote><div>The focused window will follow if you switch to a different virtual desktop.</div></blockquote><p><strong> Hide on lose focus </strong> (default: off)<blockquote><div><p>This is a quake console like feature, where the user want the window to vanish when clicking elsewhere.<p>This is rather buggy at the moment as it is very easy for the main window to lose focus and disappear.</div></blockquote><p><strong> Hide from taskbar </strong> (default: off)<blockquote><div>The first window opened will not be displayed in the taskbar. Subsequent windows will show in the taskbar (bug?).</div></blockquote><p><strong> Window geometry hints </strong> (default: off)<blockquote><div><p>If this is checked, then when resizing Terminator will attempt to step the sizing by the current font, and display a small box with the dimension of the window in characters.<div class="admonition warning"><p class="first admonition-title">Warning<p class=last>If you have problems with Terminator windows shrinking in an uncontrollable way, then turning this option <strong> off </strong> will usually fix the issue. It is not clear why, but it seems Terminator and the window manager get into an argument over what size the window should be.</div></div></blockquote><p><strong> DBus server </strong> (default: on)<blockquote><div>If a Terminator <a class="reference internal"href=advancedusage.html#dbus> <span class="std std-ref"> DBus </span> </a> server is not already on the session bus, try to start one.</div></blockquote><p><strong> Mouse focus </strong> (default: Click to focus)<blockquote><div><p>By what method the mouse pointer sets the focus on a terminal.<ul class=simple><li><em> GNOME Default </em> - Act as per the system settings.<li><em> Click to focus </em> - You must click with in a terminal to make it the focus.<li><em> Follow mouse pointer </em> - Moving the pointer over a terminal makes it the focus.</ul></div></blockquote><p><strong> Broadcast default </strong> (default: Group)<blockquote><div><p>Which broadcast mode should be selected at startup:<ul class=simple><li><em> All </em> - All terminals receive keystrokes.<li><em> Group </em> - Only terminals in the same group as the current terminal receive keystrokes.<li><em> None </em> - Only the current terminal receives keystrokes.</ul></div></blockquote><p><strong> PuTTY style paste </strong> (default: off)<blockquote><div>Make the right mouse button operate like in PuTTY, so <code class="docutils literal">
                <span class=pre> right-click </span>
               </code> will paste the Primary selection, and <code class="docutils literal">
                <span class=pre> middle-click </span>
               </code> will open the <a class="reference internal"href=gettingstarted.html#context-menu> <span class="std std-ref"> Context Menu </span> </a> . (For ex-PuTTY users).</div></blockquote><p><strong> Smart copy </strong> (default: on)<blockquote><div>If enabled and there is no selection, the shortcut is allowed to pass through. This is useful for overloading <code class="docutils literal">
                <span class=pre> Ctrl </span>
               </code> + <code class="docutils literal">
                <span class=pre> C </span>
               </code> to copy a selection, or send the SIGINT to the current process if there is no selection. If not enabled the shortcut does not pass through at all, and the SIGINT does not get sent.</div></blockquote><p><strong> Re-use profiles for new terminals </strong> (default: off)<blockquote><div>When creating a new terminal with splitting or new tabs, if this is enabled, then the profile from the previously focussed terminal will also be used for the new one.</div></blockquote><p><strong> Use custom URL handler </strong> (default: off)<blockquote><div>If this is enabled then <code class="docutils literal">
                <span class=pre> Ctrl </span>
               </code> + <code class="docutils literal">
                <span class=pre> click </span>
               </code> on a URL will try to use the command defined in <em> Custom URL handler </em> to open the link. If not enabled, Terminator will attempt to open the link with its internal logic.</div></blockquote><p><strong> Custom URL handler </strong> (default: inactive, empty)<blockquote><div>If active and set, then URL’s will be passed as a command-line parameter to the given command.</div></blockquote></div></blockquote></div><div class=section id=appearance><h3>Appearance <a title="Permalink to this headline"class=headerlink href=#appearance> ¶ </a></h3><blockquote><div><p><strong> Terminator seperator size </strong> (default: -1)<blockquote><div>This is the width in pixels, and can range from -1 to 5. The value of -1 will take the default size from the system theme.</div></blockquote><p><strong> Unfocused terminal font brightness </strong> (default: 0.8)<blockquote><div>Terminals that do not currently have the focus will can be dimmed to aid focus. The value can range from 0 (invisible) to 1 (full brightness)</div></blockquote><p><strong> Window borders </strong> (default: on)<blockquote><div>The window manager frame can be removed from your windows.</div></blockquote><p><strong> Tab position </strong> (default: Top)<blockquote><div><p>Where the tabs will be located within the window<ul class=simple><li><em> Top </em><li><em> Bottom </em><li><em> Left </em><li><em> Right </em><li><em> Hidden </em> - Tabs still work, you just can’t see them.</ul></div></blockquote><p><strong> Tabs homogeneous </strong> (default: on)<blockquote><div>Tabs will have equal widths</div></blockquote><p><strong> Tabs scroll buttons </strong> (default: off)<blockquote><div>When there are more tabs than can fit within the window buttons will be drawn for moving left and right.</div></blockquote></div></blockquote></div><div class=section id=terminal-titlebar><h3>Terminal Titlebar <a title="Permalink to this headline"class=headerlink href=#terminal-titlebar> ¶ </a></h3><blockquote><div><p>There is a table of the colours for the titlebars on the left. These are modelled on those used in a utility I used to use called ClusTerm. The three sets (Focused, Inactive and Receiving) will make more sense after reading the section about <a class="reference internal"href=grouping.html#grouping-menu> <span class="std std-ref"> The Grouping Menu </span> </a> .<table border=1 class=docutils><colgroup><col width=30%><col width=21%><col width=23%><col width=26%></colgroup><thead valign=bottom><tr class=row-odd><th class=head> <th class=head>Focused<th class=head>Inactive<th class=head>Receiving<tbody valign=top><tr class=row-even><td>Font colour<td>#FFFFFF<td>#000000<td>#FFFFFF<tr class=row-odd><td>Background<td>#C80003<td>#C0BEBF<td>#0076C9</table><p><strong> Hide size from title </strong> (default: off)<blockquote><div>At the end of the label in the titlebar the size of the terminal is given in characters, i.e. (80x24). Enabling this item will disable the size text.</div></blockquote><p><strong> Use the system font </strong> (default: on)<blockquote><div>By default the system defined proportional font will be used for the text in the titlebar. Turning this off allows you to use a custom font.</div></blockquote><p><strong> Font </strong> (default: inactive, system proportional font)<blockquote><div>If active and set, then the custom font to be used in the titlebar.</div></blockquote><div class="admonition warning"><p class="first admonition-title">Warning<p class=last>With newer versions of some of the underlying libraries, using a bitmap font can cause the Preference window to crash. If you find this happening, you will need to either remove the configuration from the Terminator <a class="reference internal"href=advancedusage.html#config-file> <span class="std std-ref"> configuration file </span> </a> or you will need to change your system settings. Please see <a class="reference external"href=https://bugs.launchpad.net/bugs/1294699> LP#1294699 </a> for more information.</div></div></blockquote></div></div><div class=section id=profiles><span id=prefs-profiles> </span><h2>Profiles <a title="Permalink to this headline"class=headerlink href=#profiles> ¶ </a></h2><p>You should already be familiar with the sub-tabs from GNOME Terminal, and Terminator’s are modelled on those available in GNOME Terminal where it makes sense, and give much of the same functionality. Bear in mind that some of these differences are due to changes in the underlying VTE widget between GTK2 and GTK3.<p>Below we will go through each pane, and highlight and explain differences between Terminator with GTK2 and GNOME Terminal with GTK3.<div class=section id=general><h3>General <a title="Permalink to this headline"class=headerlink href=#general> ¶ </a></h3><img alt=_images/prefs_profiles_general.png src=_images/prefs_profiles_general.png><p>One key difference is that we have a sidebar to the left listing the available Profiles, as opposed to GNOME Terminator, where the list is a separate window launched from the menu bar.<p><strong> Use the system fixed width font </strong> (default: on)<blockquote><div>By default the system defined proportional font will be used for the text in the terminal. Turning this off allows you to use a custom font.</div></blockquote><p><strong> Font </strong> (inactive, system fixed width font)<blockquote><div>If active and set, then the custom font to be used in the terminal.</div></blockquote><div class="admonition warning"><p class="first admonition-title">Warning<p class=last>With newer versions of some of the underlying libraries, using a bitmap font can cause the Preference window to crash. If you find this happening, you will need to either remove the configuration from the Terminator <a class="reference internal"href=advancedusage.html#config-file> <span class="std std-ref"> configuration file </span> </a> or you will need to change your system settings. Please see <a class="reference external"href=https://bugs.launchpad.net/bugs/1294699> LP#1294699 </a> for more information.</div><p><strong> Allow bold text </strong> (default: on)<blockquote><div>Allows you to disable the use of bold fonts in the terminal.</div></blockquote><p><strong> Anti-alias text </strong> (default: on) † <em> Not in GNOME Terminal </em><blockquote><div>In Terminator you can turn the font smoothing off. This is no longer possible in GNOME Terminator.</div></blockquote><p><strong> Show titlebar </strong> (default: on)<blockquote><div>The titlebar strip across the top of each terminal can be turned off.</div></blockquote><p><strong> Copy on selection </strong> (default: off)<blockquote><div>This puts the selection into the copy/paste buffer, as well as being available on middle-click.</div></blockquote><p><strong> Select-by-word characters </strong> (default: <code class="docutils literal">
             <span class=pre> -A-Za-z0-9,./?%&#:_ </span>
            </code> )<blockquote><div>Using <code class="docutils literal">
              <span class=pre> double-click </span>
             </code> to select text will use this pattern to define what characters are considered part of the word.</div></blockquote><div class=section id=cursor><h4>Cursor <a title="Permalink to this headline"class=headerlink href=#cursor> ¶ </a></h4><blockquote><div><p><strong> Shape </strong> (default: Block)<blockquote><div><p>Set the cursor shape<ul class=simple><li><em> Block </em> - Solid rectangle.<li><em> Underline </em> - Single pixel tall horizontal line.<li><em> I-Beam </em> - Single pixel wide vertical line.</ul></div></blockquote><p><strong> Colour </strong> (default: #AAAAAA)<blockquote><div>The colour of the cursor.</div></blockquote><p><strong> Blink </strong> (default: on)<blockquote><div>Whether the cursor blinks on and off.</div></blockquote></div></blockquote></div><div class=section id=terminal-bell><h4>Terminal bell <a title="Permalink to this headline"class=headerlink href=#terminal-bell> ¶ </a></h4><blockquote><div><p><strong> Titlebar icon </strong> (default: on)<blockquote><div>On the right side of the titlebar a small light-bulb icon will be displayed for a few seconds.</div></blockquote><p><strong> Visual flash </strong> (default: off)<blockquote><div>The terminal area will briefly flash.</div></blockquote><p><strong> Audible beep </strong> (default: off)<blockquote><div>The normal system beep noise as defined in system settings.</div></blockquote><p><strong> Window list flash </strong> (default: off)<blockquote><div>This will set the urgent flag on the window in the taskbar. The actual effect will be taskbar dependant.</div></blockquote></div></blockquote></div><div class=section id=not-in-terminator><h4>Not in Terminator <a title="Permalink to this headline"class=headerlink href=#not-in-terminator> ¶ </a></h4><blockquote><div><p><strong> Profile name </strong><blockquote><div>Our profiles names are in the sidebar to the left.</div></blockquote><p><strong> Show menubar by default in new terminals </strong><blockquote><div>Terminator doesn’t use a traditional menu bar.</div></blockquote><p><strong> Terminal bell </strong><blockquote><div>Terminator has more options, so has four separate options in their own grouping. This item in GNOME Terminal is the same as <em> Audible beep </em> defined above.</div></blockquote><p><strong> Use custom default terminal size </strong><blockquote><div>Terminator handles window sizes within <a class="reference internal"href=layouts.html#layouts> <span class="std std-ref"> Layouts </span> </a> , or with <a class="reference internal"href=advancedusage.html#command-line-options> <span class="std std-ref"> Command line options </span> </a> .</div></blockquote></div></blockquote></div></div><div class=section id=command><h3>Command <a title="Permalink to this headline"class=headerlink href=#command> ¶ </a></h3><img alt=_images/prefs_profiles_command.png src=_images/prefs_profiles_command.png><p><strong> Run commands as a login shell </strong> (default: off)<blockquote><div>Force the command to run as a login shell.</div></blockquote><p><strong> Update login records when command is launched </strong> (default: on)<blockquote><div>Updates login records when a new shell is opened.</div></blockquote><p><strong> Run a custom command instead of my shell </strong> (default: off)<blockquote><div>Enable the use of a custom command instead of the users default shell.</div></blockquote><p><strong> Custom command </strong> (default: inactive, empty)<blockquote><div><p>If enabled and set, the users default shell will be replaced with the command specified here.<div class="admonition note"><p class="first admonition-title">Note<p class=last>If you place an entry here note that there is no <code class="docutils literal">
                <span class=pre> bash </span>
               </code> or other shell underneath it. When the command ends, there is no chance to drop to a shell or other program. This can be worked around by using the shell line seperator <code class="docutils literal">
                <span class=pre> ; </span>
               </code> and a following <code class="docutils literal">
                <span class=pre> bash </span>
               </code> command.</div></div></blockquote><p><strong> When command exits </strong> (default: Exit the terminal)<blockquote><div><p>When the running command exits (default or custom) what action should be taken.<ul class=simple><li><em> Exit the terminal </em> - Terminal closes, causing layout to adjust.<li><em> Restart the command </em> - Original command restarts immediately.<li><em> Hold the terminal open </em> - The terminal and scrollback will remain visible and accessible until the user explicitly closes the terminal, or closes the window.</ul><div class="admonition warning"><p class="first admonition-title">Warning<p class=last>If you are using <em> Restart the command </em> and your command is broken and exits immediately, then you can end up in a resource hungry loop.</div></div></blockquote><div class=section id=id1><h4>Not in Terminator <a title="Permalink to this headline"class=headerlink href=#id1> ¶ </a></h4><blockquote><div><p><strong> Initial title </strong><blockquote><div>Terminator handles window title within <a class="reference internal"href=layouts.html#layouts> <span class="std std-ref"> Layouts </span> </a> , or with <a class="reference internal"href=advancedusage.html#command-line-options> <span class="std std-ref"> Command line options </span> </a> .</div></blockquote><p><strong> When terminal commands set their own titles </strong><blockquote><div>Terminator doesn’t have this setting.</div></blockquote></div></blockquote></div></div><div class=section id=colours><h3>Colours <a title="Permalink to this headline"class=headerlink href=#colours> ¶ </a></h3><img alt=_images/prefs_profiles_colors.png src=_images/prefs_profiles_colors.png><p>There seems to be some mild quirks and differences (palettes available or selected from the system theme) between Terminator and GNOME Terminal.<div class=section id=foreground-and-background><h4>Foreground and Background <a title="Permalink to this headline"class=headerlink href=#foreground-and-background> ¶ </a></h4><blockquote><div><p><strong> Use colours from system theme </strong> (default: off)<blockquote><div>Use colours as defined in the system theme. Not clear at this time where exactly these come from. Differences in the GTK2, GTK3 and GNOME Terminal.</div></blockquote><p><strong> Built-in schemes </strong> (default: Grey on black)<blockquote><div><p>Pick a primary colour combination for foreground and background. Again there are unexplained differences between Terminator and GNOME Terminal.<p>The list seems to be dynamic and vary depending on the system, with the addition of <em> Custom </em> which allows setting the colours as desired.</div></blockquote><p><strong> Text colour </strong> (default: inactive, #AAAAAA)<blockquote><div>If the <em> Built-in schemes </em> is set to <em> Custom </em> the text colour can be set here.</div></blockquote><p><strong> Background colour </strong> (default: inactive, #000000)<blockquote><div>If the <em> Built-in schemes </em> is set to <em> Custom </em> the background colour can be set here.</div></blockquote></div></blockquote></div><div class=section id=palette><h4>Palette <a title="Permalink to this headline"class=headerlink href=#palette> ¶ </a></h4><blockquote><div><p><strong> Built-in schemes </strong> (default: Ambience)<blockquote><div><p>A predefined colour palette can be selected. Again there are unexplained differences between Terminator and GNOME Terminal.<p>The default here may be system dependant, with Ambience being an Ubuntu colour scheme.</div></blockquote><p><strong> Colour palette </strong> (default: inactive)<blockquote><div>If the Palette’s <em> Built-in schemes </em> is set to custom, a set of colour swatches are used to configure the 16 primary colours of the shell palette.</div></blockquote></div></blockquote></div><div class=section id=id2><h4>Not in Terminator <a title="Permalink to this headline"class=headerlink href=#id2> ¶ </a></h4><blockquote><div><p><strong> Bold colour </strong><blockquote><div>In theory nothing is stopping us implementing this, it just doesn’t appear to have ever been added.</div></blockquote><p><strong> Same as text colour </strong><blockquote><div>In truth, I’m not exactly sure what this does, but at a guess, the user can force bold to be drawn in the same colour as the foreground text.</div></blockquote></div></blockquote></div></div><div class=section id=background><h3>Background <a title="Permalink to this headline"class=headerlink href=#background> ¶ </a></h3><img alt=_images/prefs_profiles_background.png src=_images/prefs_profiles_background.png><p><strong> Solid colour </strong> (default: active)<blockquote><div>Background of terminal is set to the solid colour set in previous <em> Colours </em> tab.</div></blockquote><p><strong> Background image </strong> (default: inactive)<blockquote><div>Background will be an image. There is no scaling done.</div></blockquote><p><strong> Image file </strong> (default: inactive, None)<blockquote><div>If <em> Background image </em> is set, then the image to use can be selected here.</div></blockquote><p><strong> Background image scrolls </strong> (default: inactive, on)<blockquote><div>If the <em> Background image </em> is set, then setting this to on will cause the background image to change as the window moves. This is a for of fake transparency.</div></blockquote><p><strong> Transparent background </strong> (default: inactive)<blockquote><div><p>This will attempt true transparency where the windows below are partially visible through the terminal.<div class="admonition note"><p class="first admonition-title">Note<p class=last>This option requires a compositing desktop.</div></div></blockquote><p><strong> Shade transparent or image background </strong> (default: 0.5)<blockquote><div>For <em> Background image </em> and <em> Transparent background </em> this is how much the solid colour should be blended in, giving a tinting effect.</div></blockquote></div><div class=section id=scrolling><h3>Scrolling <a title="Permalink to this headline"class=headerlink href=#scrolling> ¶ </a></h3><img alt=_images/prefs_profiles_scrolling.png src=_images/prefs_profiles_scrolling.png><p><strong> Scrollbar is </strong> (default: On the right side)<blockquote><div><p>If and where the scrollbar should appear.<ul class=simple><li><em> On the left side </em><li><em> On the right side </em><li><em> Disabled </em></ul></div></blockquote><p><strong> Scrollback </strong> (default: 500 lines)<blockquote><div>How many lines to keep before discarding.</div></blockquote><p><strong> Infinite Scrollback </strong> (default: off)<blockquote><div><p>Lines are never discarded, and all lines since the session began are available.<div class="admonition note"><p class="first admonition-title">Note<p class=last>Data is placed onto the disk by the underlying VTE component, so even after a long time, the memory footprint and performance of Terminator should be OK.</div></div></blockquote><p><strong> Scroll on output </strong> (default: on)<blockquote><div>Moves terminal to end of scrollback buffer when any output occurs.</div></blockquote><p><strong> Scroll on keystroke </strong> (default: on)<blockquote><div>Moves terminal to end of scrollback buffer when any keypress occurs.</div></blockquote><p><strong> Use keystrokes to scroll on alternate screen </strong> (default: on)<blockquote><div>Ummmm... I don’t know. Alternate screens are a bit of a mystery to me.</div></blockquote></div><div class=section id=compatibility><h3>Compatibility <a title="Permalink to this headline"class=headerlink href=#compatibility> ¶ </a></h3><img alt=_images/prefs_profiles_compatability.png src=_images/prefs_profiles_compatability.png><p><strong> Backspace key generates </strong> (default: ASCII DEL)<blockquote><div><p>Change behaviour of the Backspace key.<ul class=simple><li><em> Automatic </em><li><em> Control-H </em><li><em> ASCII DEL </em><li><em> Escape sequence </em></ul></div></blockquote><p><strong> Delete key generates </strong> (default: Escape sequence)<blockquote><div><p>Change behaviour of the Delete key.<ul class=simple><li><em> Automatic </em><li><em> Control-H </em><li><em> ASCII DEL </em><li><em> Escape sequence </em></ul></div></blockquote><p><strong> Reset Compatibility Options to Defaults </strong><blockquote><div>Sets the two previous items back to their defaults.</div></blockquote><div class=section id=encoding><h4>Encoding <a title="Permalink to this headline"class=headerlink href=#encoding> ¶ </a></h4><p><strong> Default </strong> (default: Unicode UTF-8)<blockquote><div>Choose the default encoding method used from a long list of available encodings.</div></blockquote></div></div></div><div class=section id=layouts><span id=prefs-layouts> </span><h2>Layouts <a title="Permalink to this headline"class=headerlink href=#layouts> ¶ </a></h2><img alt=_images/prefs_layouts.png src=_images/prefs_layouts.png><p>Layouts are the primary means for saving collections of windows, tabs, and terminals. The use and flexibility of layouts is covered in <a class="reference internal"href=layouts.html#layouts> <span class="std std-ref"> Layouts and the Layout Launcher </span> </a> . Here we will cover the bare minimum to understand the configuration options.<p>In the left list is the saved layouts, with three buttons below:<ul class=simple><li><em> Add </em> - Creates a new layout from the current windows, tabs and terminals, and saves them with a new name.<li><em> Remove </em> - Delete the selected layout<li><em> Save </em> - Update the selected layout with the current windows, tabs, and terminals.</ul><p>Once a layout is highlighted, it’s name can be changed by clicking it again.<p>In the central list is a tree showing the structure of the selected layout. When highlighting an entry of type Terminal, the controls on the right become enabled, and can be changed.<div class="admonition warning"><p class="first admonition-title">Warning<p>You do not need to use the save button when changing the options in the controls on the right.<p class=last>If you do, you <em> will </em> lose the <em> Custom command </em> and <em> Working directory </em> settings for all terminals in this layout.</div><p><strong> Profile </strong><blockquote><div>The profile used by the select terminal as listed in the <a class="reference internal"href=#prefs-profiles> <span class="std std-ref"> Profiles </span> </a> tab.</div></blockquote><p><strong> Custom command </strong><blockquote><div><p>Override the command run in the terminal, same as in a profile, but this one has a higher priority. If empty, it will run the command in the profile, or the default user shell.<div class="admonition note"><p class="first admonition-title">Note<p class=last>If you place an entry here note that there is no <code class="docutils literal">
               <span class=pre> bash </span>
              </code> or other shell underneath it. When the command ends, there is no chance to drop to a shell or other program. This can be worked around by using the shell line seperator <code class="docutils literal">
               <span class=pre> ; </span>
              </code> and a following <code class="docutils literal">
               <span class=pre> bash </span>
              </code> command.</div></div></blockquote><p><strong> Working directory </strong><blockquote><div>Whatever command is run (from layout, profile, or user default) it will be executed with this entry as the working path. If empty the default working directory is used, which is either where Terminator was launched from, or the users home directory.</div></blockquote></div><div class=section id=keybindings><h2>Keybindings <a title="Permalink to this headline"class=headerlink href=#keybindings> ¶ </a></h2><img alt=_images/prefs_keybindings.png src=_images/prefs_keybindings.png><p>This is a list of all available keyboard shortcuts in the application.<p>To change a keybinding, first highlight the entry you wish to change. Next <code class="docutils literal">
            <span class=pre> click </span>
           </code> on the <em> Keybinding </em> column again. The entry should change to <strong> New accelerator... </strong> . Simply perform the shortcut you wish to set. If you change your mind use <code class="docutils literal">
            <span class=pre> Esc </span>
           </code> (Escape) key to revert back to the existing shortcut. If you wish to delete a shortcut, use the <code class="docutils literal">
            <span class=pre> BkSp </span>
           </code> key (Backspace, ←, or ⌫ depending on your keyboard).</div><div class=section id=plugins><span id=prefs-plugins> </span><h2>Plugins <a title="Permalink to this headline"class=headerlink href=#plugins> ¶ </a></h2><img alt=_images/prefs_plugins.png src=_images/prefs_plugins.png><p>Here you will find a list of available plugins, and whether they are enabled or not. Plugins are covered in more detail in <a class="reference internal"href=plugins.html#plugins> <span class="std std-ref"> Plugins </span> </a> .<div class="admonition warning"><p class="first admonition-title">Warning<p class=last>For some reason clicking on the text label of a plugin does not just select the item, but actually toggles the active/inactive status. This does not happen in the experimental GTK3 version of Terminator, and is a bit of a mystery.</div></div><div class=section id=about><h2>About <a title="Permalink to this headline"class=headerlink href=#about> ¶ </a></h2><img alt=_images/prefs_about.png src=_images/prefs_about.png><p>A simple panel describing a bit about the application, and a set of links that will guide users to some helpful Terminator project resources. There’s also a mysterious button... I wonder what happens when I press it?</div></div></div><div class=articleComments></div></div><footer><div aria-label="footer navigation"class=rst-footer-buttons role=navigation><a class="btn btn-neutral float-right"title="Layouts and the Layout Launcher"accesskey=n href=layouts.html rel=next> Next <span class="fa fa-arrow-circle-right"> </span> </a><a class="btn btn-neutral"title="Getting Started"accesskey=p href=gettingstarted.html rel=prev> <span class="fa fa-arrow-circle-left"> </span> Previous </a></div><hr><div role=contentinfo><p>© Copyright 2016, Stephen Boddy, licensed under the CC-BY-SA.. <span class=commit> Revision <code>
           6
          </code> . </span></div> Built with <a href=http://sphinx-doc.org/> Sphinx </a> using a <a href=https://github.com/snide/sphinx_rtd_theme> theme </a> provided by <a href=https://readthedocs.org> Read the Docs </a> .</footer></div></div></section></div><div aria-label=versions class=rst-versions data-toggle=rst-versions role=note><span class=rst-current-version data-toggle=rst-current-version> <span class="fa fa-book"> Read the Docs </span> v: latest <span class="fa fa-caret-down"> </span> </span><div class=rst-other-versions><dl><dt>Versions<dd><a href=/en/latest/> latest </a></dl><dl><dt>Downloads<dd><a href=//readthedocs.org/projects/terminator-gtk2/downloads/pdf/latest/> pdf </a><dd><a href=//readthedocs.org/projects/terminator-gtk2/downloads/htmlzip/latest/> htmlzip </a><dd><a href=//readthedocs.org/projects/terminator-gtk2/downloads/epub/latest/> epub </a></dl><dl><dt>On Read the Docs<dd><a href=//readthedocs.org/projects/terminator-gtk2/?fromdocs=terminator-gtk2> Project Home </a><dd><a href=//readthedocs.org/builds/terminator-gtk2/?fromdocs=terminator-gtk2> Builds </a></dl><hr> Free document hosting provided by <a href=http://www.readthedocs.org> Read the Docs </a> .</div></div><script>var DOCUMENTATION_OPTIONS = {
            URL_ROOT:'./',
            VERSION:'1.0 alpha',
            COLLAPSE_INDEX:false,
            FILE_SUFFIX:'.html',
            HAS_SOURCE:  true,
            SOURCELINK_SUFFIX: '.txt'
        };</script><script src=https://media.readthedocs.org/javascript/jquery/jquery-2.0.3.min.js></script><script src=https://media.readthedocs.org/javascript/jquery/jquery-migrate-1.2.1.min.js></script><script src=https://media.readthedocs.org/javascript/underscore.js></script><script src=https://media.readthedocs.org/javascript/doctools.js></script><script src=https://media.readthedocs.org/javascript/readthedocs-doc-embed.js></script><script>jQuery(function () {
          SphinxRtdTheme.StickyNav.enable();
      });</script>