4
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
5
<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
9
<meta name="viewport" content="width=device-width, initial-scale=1.0">
11
<title>Preferences Window — Terminator 1.0 alpha documentation</title>
27
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
33
<link rel="top" title="Terminator 1.0 alpha documentation" href="index.html"/>
34
<link rel="next" title="Layouts and the Layout Launcher" href="layouts.html"/>
35
<link rel="prev" title="Getting Started" href="gettingstarted.html"/>
38
<script src="_static/js/modernizr.min.js"></script>
42
<body class="wy-body-for-nav" role="document">
44
<div class="wy-grid-for-nav">
47
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
48
<div class="wy-side-nav-search">
52
<a href="index.html" class="icon icon-home"> Terminator
60
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
61
<input type="text" name="q" placeholder="Search docs" />
62
<input type="hidden" name="check_keywords" value="yes" />
63
<input type="hidden" name="area" value="default" />
70
<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
74
<p class="caption"><span class="caption-text">Contents:</span></p>
76
<li class="toctree-l1"><a class="reference internal" href="licensing.html">Licensing</a></li>
77
<li class="toctree-l1"><a class="reference internal" href="history.html">Document history</a></li>
78
<li class="toctree-l1"><a class="reference internal" href="gettingstarted.html">Getting Started</a><ul>
79
<li class="toctree-l2"><a class="reference internal" href="gettingstarted.html#the-context-menu">The Context Menu</a></li>
80
<li class="toctree-l2"><a class="reference internal" href="gettingstarted.html#navigating-around">Navigating around</a><ul>
81
<li class="toctree-l3"><a class="reference internal" href="gettingstarted.html#click-able-items">Click-able items</a></li>
84
<li class="toctree-l2"><a class="reference internal" href="gettingstarted.html#changing-the-current-layout">Changing the current layout</a><ul>
85
<li class="toctree-l3"><a class="reference internal" href="gettingstarted.html#using-the-splitters">Using the splitters</a></li>
86
<li class="toctree-l3"><a class="reference internal" href="gettingstarted.html#dragging-and-dropping-a-terminal">Dragging and dropping a terminal</a></li>
87
<li class="toctree-l3"><a class="reference internal" href="gettingstarted.html#using-the-keyboard">Using the keyboard</a></li>
90
<li class="toctree-l2"><a class="reference internal" href="gettingstarted.html#resetting-the-terminal">Resetting the terminal</a></li>
91
<li class="toctree-l2"><a class="reference internal" href="gettingstarted.html#the-scrollbar-and-scrollback-buffer">The scrollbar and scrollback buffer</a></li>
92
<li class="toctree-l2"><a class="reference internal" href="gettingstarted.html#search-the-buffer">Search the buffer</a></li>
93
<li class="toctree-l2"><a class="reference internal" href="gettingstarted.html#zooming-the-terminal">Zooming the terminal</a></li>
94
<li class="toctree-l2"><a class="reference internal" href="gettingstarted.html#setting-titles">Setting Titles</a></li>
95
<li class="toctree-l2"><a class="reference internal" href="gettingstarted.html#insert-terminal-number">Insert terminal number</a></li>
96
<li class="toctree-l2"><a class="reference internal" href="gettingstarted.html#next-prev-profile">Next/Prev profile</a></li>
99
<li class="toctree-l1 current"><a class="current reference internal" href="">Preferences Window</a><ul>
100
<li class="toctree-l2"><a class="reference internal" href="#global">Global</a><ul>
101
<li class="toctree-l3"><a class="reference internal" href="#behaviour">Behaviour</a></li>
102
<li class="toctree-l3"><a class="reference internal" href="#appearance">Appearance</a></li>
103
<li class="toctree-l3"><a class="reference internal" href="#terminal-titlebar">Terminal Titlebar</a></li>
106
<li class="toctree-l2"><a class="reference internal" href="#profiles">Profiles</a><ul>
107
<li class="toctree-l3"><a class="reference internal" href="#general">General</a><ul>
108
<li class="toctree-l4"><a class="reference internal" href="#cursor">Cursor</a></li>
109
<li class="toctree-l4"><a class="reference internal" href="#terminal-bell">Terminal bell</a></li>
110
<li class="toctree-l4"><a class="reference internal" href="#not-in-terminator">Not in Terminator</a></li>
113
<li class="toctree-l3"><a class="reference internal" href="#command">Command</a><ul>
114
<li class="toctree-l4"><a class="reference internal" href="#id1">Not in Terminator</a></li>
117
<li class="toctree-l3"><a class="reference internal" href="#colours">Colours</a><ul>
118
<li class="toctree-l4"><a class="reference internal" href="#foreground-and-background">Foreground and Background</a></li>
119
<li class="toctree-l4"><a class="reference internal" href="#palette">Palette</a></li>
120
<li class="toctree-l4"><a class="reference internal" href="#id2">Not in Terminator</a></li>
123
<li class="toctree-l3"><a class="reference internal" href="#background">Background</a></li>
124
<li class="toctree-l3"><a class="reference internal" href="#scrolling">Scrolling</a></li>
125
<li class="toctree-l3"><a class="reference internal" href="#compatibility">Compatibility</a><ul>
126
<li class="toctree-l4"><a class="reference internal" href="#encoding">Encoding</a></li>
131
<li class="toctree-l2"><a class="reference internal" href="#layouts">Layouts</a></li>
132
<li class="toctree-l2"><a class="reference internal" href="#keybindings">Keybindings</a></li>
133
<li class="toctree-l2"><a class="reference internal" href="#plugins">Plugins</a></li>
134
<li class="toctree-l2"><a class="reference internal" href="#about">About</a></li>
137
<li class="toctree-l1"><a class="reference internal" href="layouts.html">Layouts and the Layout Launcher</a><ul>
138
<li class="toctree-l2"><a class="reference internal" href="layouts.html#the-layout-launcher">The Layout Launcher</a></li>
141
<li class="toctree-l1"><a class="reference internal" href="grouping.html">The Grouping Menu</a><ul>
142
<li class="toctree-l2"><a class="reference internal" href="grouping.html#manipulating-terminal-groups">Manipulating terminal groups</a></li>
143
<li class="toctree-l2"><a class="reference internal" href="grouping.html#broadcasting-input-to-multiple-terminals">Broadcasting input to multiple terminals</a></li>
144
<li class="toctree-l2"><a class="reference internal" href="grouping.html#insert-terminal-number">Insert terminal number</a></li>
147
<li class="toctree-l1"><a class="reference internal" href="plugins.html">Plugins</a><ul>
148
<li class="toctree-l2"><a class="reference internal" href="plugins.html#included-plugins">Included plugins</a><ul>
149
<li class="toctree-l3"><a class="reference internal" href="plugins.html#activity-watch">Activity Watch</a></li>
150
<li class="toctree-l3"><a class="reference internal" href="plugins.html#apt-url-handler">APT URL Handler</a></li>
151
<li class="toctree-l3"><a class="reference internal" href="plugins.html#custom-commands-menu">Custom Commands Menu</a></li>
152
<li class="toctree-l3"><a class="reference internal" href="plugins.html#inactivity-watch">Inactivity Watch</a></li>
153
<li class="toctree-l3"><a class="reference internal" href="plugins.html#launchpad-bug-url-handler">Launchpad Bug URL Handler</a></li>
154
<li class="toctree-l3"><a class="reference internal" href="plugins.html#launchpad-code-url-handler">Launchpad Code URL Handler</a></li>
155
<li class="toctree-l3"><a class="reference internal" href="plugins.html#logger">Logger</a></li>
156
<li class="toctree-l3"><a class="reference internal" href="plugins.html#maven-plugin-url-handler">Maven Plugin URL Handler</a></li>
157
<li class="toctree-l3"><a class="reference internal" href="plugins.html#terminal-shot">Terminal Shot</a></li>
158
<li class="toctree-l3"><a class="reference internal" href="plugins.html#test-plugin">Test Plugin</a></li>
161
<li class="toctree-l2"><a class="reference internal" href="plugins.html#third-party-plugins">Third party plugins</a></li>
162
<li class="toctree-l2"><a class="reference internal" href="plugins.html#installing-a-plugin">Installing a plugin</a></li>
163
<li class="toctree-l2"><a class="reference internal" href="plugins.html#creating-your-own-plugins">Creating your own plugins</a><ul>
164
<li class="toctree-l3"><a class="reference internal" href="plugins.html#the-basics-of-a-plugin">The basics of a plugin</a></li>
165
<li class="toctree-l3"><a class="reference internal" href="plugins.html#url-handlers">URL Handlers</a></li>
166
<li class="toctree-l3"><a class="reference internal" href="plugins.html#context-menu-items">Context menu items</a></li>
167
<li class="toctree-l3"><a class="reference internal" href="plugins.html#wrap-up">Wrap up</a></li>
172
<li class="toctree-l1"><a class="reference internal" href="advancedusage.html">Advanced Usage</a><ul>
173
<li class="toctree-l2"><a class="reference internal" href="advancedusage.html#command-line-options">Command line options</a><ul>
174
<li class="toctree-l3"><a class="reference internal" href="advancedusage.html#general-options">General options</a></li>
175
<li class="toctree-l3"><a class="reference internal" href="advancedusage.html#window-options">Window options</a></li>
176
<li class="toctree-l3"><a class="reference internal" href="advancedusage.html#shell-options">Shell options</a></li>
177
<li class="toctree-l3"><a class="reference internal" href="advancedusage.html#layout-options">Layout options</a></li>
178
<li class="toctree-l3"><a class="reference internal" href="advancedusage.html#custom-window-manager-options">Custom Window Manager options</a></li>
179
<li class="toctree-l3"><a class="reference internal" href="advancedusage.html#debugging-options">Debugging options</a></li>
182
<li class="toctree-l2"><a class="reference internal" href="advancedusage.html#the-config-file">The Config file</a></li>
183
<li class="toctree-l2"><a class="reference internal" href="advancedusage.html#debugging">Debugging</a></li>
184
<li class="toctree-l2"><a class="reference internal" href="advancedusage.html#dbus">DBus</a></li>
185
<li class="toctree-l2"><a class="reference internal" href="advancedusage.html#remotinator">Remotinator</a></li>
188
<li class="toctree-l1"><a class="reference internal" href="faq.html">Frequently Asked Questions</a><ul>
189
<li class="toctree-l2"><a class="reference internal" href="faq.html#why">Why...</a><ul>
190
<li class="toctree-l3"><a class="reference internal" href="faq.html#write-in-python-it-s-slow-bloated-bad">...write in Python? It’s slow/bloated/bad?</a><ul>
191
<li class="toctree-l4"><a class="reference internal" href="faq.html#performance">Performance</a></li>
192
<li class="toctree-l4"><a class="reference internal" href="faq.html#memory-use-the-dumb-way">Memory use - The dumb way</a></li>
193
<li class="toctree-l4"><a class="reference internal" href="faq.html#memory-use-the-sensible-way">Memory use - The sensible way</a></li>
194
<li class="toctree-l4"><a class="reference internal" href="faq.html#python-sucks">“Python sucks!”</a></li>
195
<li class="toctree-l4"><a class="reference internal" href="faq.html#in-summary">In summary</a></li>
200
<li class="toctree-l2"><a class="reference internal" href="faq.html#how-do-i">How do I...</a><ul>
201
<li class="toctree-l3"><a class="reference internal" href="faq.html#make-terminator-work-like-quake-style-terminals">...make Terminator work like Quake style terminals?</a></li>
206
<li class="toctree-l1"><a class="reference internal" href="gettinginvolved.html">Getting involved</a><ul>
207
<li class="toctree-l2"><a class="reference internal" href="gettinginvolved.html#translations">Translations</a></li>
208
<li class="toctree-l2"><a class="reference internal" href="gettinginvolved.html#improve-icons-artwork">Improve icons/artwork</a></li>
209
<li class="toctree-l2"><a class="reference internal" href="gettinginvolved.html#terminator-action-shots">Terminator action shots</a></li>
210
<li class="toctree-l2"><a class="reference internal" href="gettinginvolved.html#manual-updates">Manual updates</a></li>
211
<li class="toctree-l2"><a class="reference internal" href="gettinginvolved.html#testing">Testing</a></li>
212
<li class="toctree-l2"><a class="reference internal" href="gettinginvolved.html#bugs">Bugs</a></li>
213
<li class="toctree-l2"><a class="reference internal" href="gettinginvolved.html#plugins">Plugins</a></li>
214
<li class="toctree-l2"><a class="reference internal" href="gettinginvolved.html#main-application-development">Main Application Development</a></li>
215
<li class="toctree-l2"><a class="reference internal" href="gettinginvolved.html#gtk3-port">GTK3 Port</a></li>
216
<li class="toctree-l2"><a class="reference internal" href="gettinginvolved.html#api-docs">API Docs</a></li>
227
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
230
<nav class="wy-nav-top" role="navigation" aria-label="top navigation">
231
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
232
<a href="index.html">Terminator</a>
237
<div class="wy-nav-content">
238
<div class="rst-content">
239
<div role="navigation" aria-label="breadcrumbs navigation">
240
<ul class="wy-breadcrumbs">
241
<li><a href="index.html">Docs</a> »</li>
243
<li>Preferences Window</li>
244
<li class="wy-breadcrumbs-aside">
247
<a href="_sources/preferences.txt" rel="nofollow"> View page source</a>
254
<div role="main" class="document">
256
<img alt="Because spanners mean settings?!?!?" class="align-right" src="_images/icon_prefs.png" />
257
<div class="section" id="preferences-window">
258
<span id="preferences"></span><h1>Preferences Window<a class="headerlink" href="#preferences-window" title="Permalink to this headline">¶</a></h1>
259
<p>Terminator is <em>highly</em> configurable, and automate-able, so the Preferences
260
dialog is naturally quite extensive. It currently consists of six tabs.
261
Let’s work through them one by one.</p>
262
<div class="section" id="global">
263
<span id="prefs-global"></span><h2>Global<a class="headerlink" href="#global" title="Permalink to this headline">¶</a></h2>
264
<img alt="_images/prefs_global.png" src="_images/prefs_global.png" />
265
<p>These settings are defaults, but some of them can be overridden by a
266
options on the command-line, or within a layout. A number will also
267
require a restart to take effect.</p>
268
<div class="section" id="behaviour">
269
<h3>Behaviour<a class="headerlink" href="#behaviour" title="Permalink to this headline">¶</a></h3>
271
<div><p><strong>Window state</strong> (default: Normal)</p>
273
<div><p>This will determine what happens on startup normally.</p>
275
<li><em>Normal</em> - Window opens as normal.</li>
276
<li><em>Hidden</em> - Window does not open. Useful at login, so it is already
277
available with a shortcut.</li>
278
<li><em>Maximised</em> - Window opens maximised in the standard window manager
280
<li><em>Fullscreen</em> - Window opens fullscreen with no window manager frame.</li>
283
<p><strong>Always on top</strong> (default: off)</p>
285
<div>Window attempts to remain on top.</div></blockquote>
286
<p><strong>Show on all workspaces</strong> (default: off)</p>
288
<div>The focused window will follow if you switch to a different virtual
289
desktop.</div></blockquote>
290
<p><strong>Hide on lose focus</strong> (default: off)</p>
292
<div><p>This is a quake console like feature, where the user want the window to
293
vanish when clicking elsewhere.</p>
294
<p>This is rather buggy at the moment as it is very easy for the main
295
window to lose focus and disappear.</p>
297
<p><strong>Hide from taskbar</strong> (default: off)</p>
299
<div>The first window opened will not be displayed in the taskbar.
300
Subsequent windows will show in the taskbar (bug?).</div></blockquote>
301
<p><strong>Window geometry hints</strong> (default: on)</p>
303
<div><p>If this is checked, then when resizing Terminator will attempt to
304
step the sizing by the current font, and display a small box with the
305
dimension of the window in characters.</p>
306
<div class="admonition warning">
307
<p class="first admonition-title">Warning</p>
308
<p class="last">If you have problems with Terminator windows shrinking
309
in an uncontrollable way, then turning this option
310
<strong>off</strong> will usually fix the issue. It is not clear
311
why, but it seems Terminator and the window manager
312
get into an argument over what size the window should
316
<p><strong>Mouse focus</strong> (default: Click to focus)</p>
318
<div><p>By what method the mouse pointer sets the focus on a terminal.</p>
320
<li><em>GNOME Default</em> - Act as per the system settings.</li>
321
<li><em>Click to focus</em> - You must click with in a terminal to make it the
323
<li><em>Follow mouse pointer</em> - Moving the pointer over a terminal makes
327
<p><strong>Broadcast default</strong> (default: Group)</p>
329
<div><p>Which broadcast mode should be selected at startup:</p>
331
<li><em>All</em> - All terminals receive keystrokes.</li>
332
<li><em>Group</em> - Only terminals in the same group as the current terminal
333
receive keystrokes.</li>
334
<li><em>None</em> - Only the current terminal receives keystrokes.</li>
337
<p><strong>Re-use profiles for new terminals</strong> (default: off)</p>
339
<div>When creating a new terminal with splitting or new tabs, if this is
340
enabled, then the profile from the previously focussed terminal will
341
also be used for the new one.</div></blockquote>
342
<p><strong>Use custom URL handler</strong> (default: off)</p>
344
<div>If this is enabled then Ctrl+left-mouse-click on a URL will try to use
345
the command defined in <em>Custom URL handler</em> to open the link. If not
346
enabled, Terminator will attempt to open the link with its internal
347
logic.</div></blockquote>
348
<p><strong>Custom URL handler</strong> (default: inactive, empty)</p>
350
<div>If active and set, then URL’s will be passed as a command-line parameter
351
to the given command.</div></blockquote>
352
<p><strong>DBus server</strong> (default: on)</p>
354
<div>If a Terminator <a class="reference internal" href="advancedusage.html#dbus"><span>DBus</span></a> server is not already on the session
355
bus, try to start one.</div></blockquote>
358
<div class="section" id="appearance">
359
<h3>Appearance<a class="headerlink" href="#appearance" title="Permalink to this headline">¶</a></h3>
361
<div><p><strong>Terminator seperator size</strong> (default: -1)</p>
363
<div>This is the width in pixels, and can range from -1 to 5. The value
364
of -1 will take the default size from the system theme.</div></blockquote>
365
<p><strong>Unfocused terminal font brightness</strong> (default: 0.8)</p>
367
<div>Terminals that do not currently have the focus will can be dimmed
368
to aid focus. The value can range from 0 (invisible) to 1 (full
369
brightness)</div></blockquote>
370
<p><strong>Window borders</strong> (default: on)</p>
372
<div>The window manager frame can be removed from your windows.</div></blockquote>
373
<p><strong>Tab position</strong> (default: Top)</p>
375
<div><p>Where the tabs will be located within the window</p>
377
<li><em>Top</em></li>
378
<li><em>Bottom</em></li>
379
<li><em>Left</em></li>
380
<li><em>Right</em></li>
381
<li><em>Hidden</em> - Tabs still work, you just can’t see them.</li>
384
<p><strong>Tabs homogeneous</strong> (default: on)</p>
386
<div>Tabs will have equal widths</div></blockquote>
387
<p><strong>Tabs scroll buttons</strong> (default: off)</p>
389
<div>When there are more tabs than can fit within the window buttons will
390
be drawn for moving left and right.</div></blockquote>
393
<div class="section" id="terminal-titlebar">
394
<h3>Terminal Titlebar<a class="headerlink" href="#terminal-titlebar" title="Permalink to this headline">¶</a></h3>
396
<div><p>There is a table of the colours for the titlebars on the left. These
397
are modelled on those used in a utility I used to use called ClusTerm.
398
The three sets (Focused, Inactive and Receiving) will make more sense
399
after reading the section about <a class="reference internal" href="grouping.html#grouping-menu"><span>The Grouping Menu</span></a>.</p>
400
<table border="1" class="docutils">
407
<thead valign="bottom">
408
<tr class="row-odd"><th class="head"> </th>
409
<th class="head">Focused</th>
410
<th class="head">Inactive</th>
411
<th class="head">Receiving</th>
415
<tr class="row-even"><td>Font colour</td>
420
<tr class="row-odd"><td>Background</td>
427
<p><strong>Hide size from title</strong> (default: off)</p>
429
<div>At the end of the label in the titlebar the size of the terminal is
430
given in characters, i.e. (80x24). Enabling this item will disable
431
the size text.</div></blockquote>
432
<p><strong>Use the system font</strong> (default: on)</p>
434
<div>By default the system defined proportional font will be used for the
435
text in the titlebar. Turning this off allows you to use a custom font.</div></blockquote>
436
<p><strong>Font</strong> (default: inactive, system proportional font)</p>
438
<div>If active and set, then the custom font to be used in the titlebar.</div></blockquote>
439
<div class="admonition warning">
440
<p class="first admonition-title">Warning</p>
441
<p class="last">With newer versions of some of the underlying libraries,
442
using a bitmap font can cause the Preference window to
443
crash. If you find this happening, you will need to
444
either remove the configuration from the Terminator
445
<a class="reference internal" href="advancedusage.html#config-file"><span>configuration file</span></a> or you will
446
need to change your system settings. Please see
447
<a class="reference external" href="https://bugs.launchpad.net/bugs/1294699">LP#1294699</a> for more information.</p>
452
<div class="section" id="profiles">
453
<span id="prefs-profiles"></span><h2>Profiles<a class="headerlink" href="#profiles" title="Permalink to this headline">¶</a></h2>
454
<p>You should already be familiar with the sub-tabs from GNOME Terminal,
455
and Terminator’s are modelled on those available in GNOME Terminal where
456
it makes sense, and give much of the same functionality. Bear in mind that
457
some of these differences are due to changes in the underlying VTE
458
widget between GTK2 and GTK3.</p>
459
<p>Below we will go through each pane, and highlight and explain differences
460
between Terminator with GTK2 and GNOME Terminal with GTK3.</p>
461
<div class="section" id="general">
462
<h3>General<a class="headerlink" href="#general" title="Permalink to this headline">¶</a></h3>
463
<img alt="_images/prefs_profiles_general.png" src="_images/prefs_profiles_general.png" />
464
<p>One key difference is that we have a sidebar to the left listing the
465
available Profiles, as opposed to GNOME Terminator, where the list is
466
a separate window launched from the menu bar.</p>
467
<p><strong>Use the system fixed width font</strong> (default: on)</p>
469
<div>By default the system defined proportional font will be used for the
470
text in the terminal. Turning this off allows you to use a custom font.</div></blockquote>
471
<p><strong>Font</strong> (inactive, system fixed width font)</p>
473
<div>If active and set, then the custom font to be used in the terminal.</div></blockquote>
474
<div class="admonition warning">
475
<p class="first admonition-title">Warning</p>
476
<p class="last">With newer versions of some of the underlying libraries,
477
using a bitmap font can cause the Preference window to
478
crash. If you find this happening, you will need to
479
either remove the configuration from the Terminator
480
<a class="reference internal" href="advancedusage.html#config-file"><span>configuration file</span></a> or you will
481
need to change your system settings. Please see
482
<a class="reference external" href="https://bugs.launchpad.net/bugs/1294699">LP#1294699</a> for more information.</p>
484
<p><strong>Allow bold text</strong> (default: on)</p>
486
<div>Allows you to disable the use of bold fonts in the terminal.</div></blockquote>
487
<p><strong>Anti-alias text</strong> (default: on) †<em>Not in GNOME Terminal</em></p>
489
<div>In Terminator you can turn the font smoothing off. This is no
490
longer possible in GNOME Terminator.</div></blockquote>
491
<p><strong>Show titlebar</strong> (default: on)</p>
493
<div>The titlebar strip across the top of each terminal can be turned off.</div></blockquote>
494
<p><strong>Copy on selection</strong> (default: off)</p>
496
<div>This puts the selection into the copy/paste buffer, as well as being
497
available on middle-click.</div></blockquote>
498
<p><strong>Select-by-word characters</strong> (default: <code class="docutils literal"><span class="pre">-A-Za-z0-9,./?%&#:_</span></code>)</p>
500
<div>Using double-click to select text will use this pattern to define
501
what characters are considered part of the word.</div></blockquote>
502
<div class="section" id="cursor">
503
<h4>Cursor<a class="headerlink" href="#cursor" title="Permalink to this headline">¶</a></h4>
505
<div><p><strong>Shape</strong> (default: Block)</p>
507
<div><p>Set the cursor shape</p>
509
<li><em>Block</em> - Solid rectangle.</li>
510
<li><em>Underline</em> - Single pixel tall horizontal line.</li>
511
<li><em>I-Beam</em> - Single pixel wide vertical line.</li>
514
<p><strong>Colour</strong> (default: #AAAAAA)</p>
516
<div>The colour of the cursor.</div></blockquote>
517
<p><strong>Blink</strong> (default: on)</p>
519
<div>Whether the cursor blinks on and off.</div></blockquote>
522
<div class="section" id="terminal-bell">
523
<h4>Terminal bell<a class="headerlink" href="#terminal-bell" title="Permalink to this headline">¶</a></h4>
525
<div><p><strong>Titlebar icon</strong> (default: on)</p>
527
<div>On the right side of the titlebar a small light-bulb icon will
528
be displayed for a few seconds.</div></blockquote>
529
<p><strong>Visual flash</strong> (default: off)</p>
531
<div>The terminal area will briefly flash.</div></blockquote>
532
<p><strong>Audible beep</strong> (default: off)</p>
534
<div>The normal system beep noise as defined in system settings.</div></blockquote>
535
<p><strong>Window list flash</strong> (default: off)</p>
537
<div>This will set the urgent flag on the window in the taskbar. The
538
actual effect will be taskbar dependant.</div></blockquote>
541
<div class="section" id="not-in-terminator">
542
<h4>Not in Terminator<a class="headerlink" href="#not-in-terminator" title="Permalink to this headline">¶</a></h4>
544
<div><p><strong>Profile name</strong></p>
546
<div>Our profiles names are in the sidebar to the left.</div></blockquote>
547
<p><strong>Show menubar by default in new terminals</strong></p>
549
<div>Terminator doesn’t use a traditional menu bar.</div></blockquote>
550
<p><strong>Terminal bell</strong></p>
552
<div>Terminator has more options, so has four separate options in their
553
own grouping. This item in GNOME Terminal is the same as <em>Audible
554
beep</em> defined above.</div></blockquote>
555
<p><strong>Use custom default terminal size</strong></p>
557
<div>Terminator handles window sizes within <a class="reference internal" href="layouts.html#layouts"><span>Layouts</span></a>,
558
or with <a class="reference internal" href="advancedusage.html#command-line-options"><span>Command line options</span></a>.</div></blockquote>
562
<div class="section" id="command">
563
<h3>Command<a class="headerlink" href="#command" title="Permalink to this headline">¶</a></h3>
564
<img alt="_images/prefs_profiles_command.png" src="_images/prefs_profiles_command.png" />
565
<p><strong>Run commands as a login shell</strong> (default: off)</p>
567
<div>Force the command to run as a login shell.</div></blockquote>
568
<p><strong>Update login records when command is launched</strong> (default: on)</p>
570
<div>Updates login records when a new shell is opened.</div></blockquote>
571
<p><strong>Run a custom command instead of my shell</strong> (default: off)</p>
573
<div>Enable the use of a custom command instead of the users default
574
shell.</div></blockquote>
575
<p><strong>Custom command</strong> (default: inactive, empty)</p>
577
<div>If enabled and set, the users default shell will be replaced with
578
the command specified here.</div></blockquote>
579
<p><strong>When command exits</strong> (default: Exit the terminal)</p>
581
<div><p>When the running command exits (default or custom) what action
584
<li><em>Exit the terminal</em> - Terminal closes, causing layout to adjust.</li>
585
<li><em>Restart the command</em> - Original command restarts immediately.</li>
586
<li><em>Hold the terminal open</em> - The terminal and scrollback will remain
587
visible and accessible until the user explicitly closes the
588
terminal, or closes the window.</li>
590
<div class="admonition warning">
591
<p class="first admonition-title">Warning</p>
592
<p class="last">If you are using <em>Restart the command</em> and your command
593
is broken and exits immediately, then you can end up
594
in a resource hungry loop.</p>
597
<div class="section" id="id1">
598
<h4>Not in Terminator<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h4>
600
<div><p><strong>Initial title</strong></p>
602
<div>Terminator handles window title within <a class="reference internal" href="layouts.html#layouts"><span>Layouts</span></a>,
603
or with <a class="reference internal" href="advancedusage.html#command-line-options"><span>Command line options</span></a>.</div></blockquote>
604
<p><strong>When terminal commands set their own titles</strong></p>
606
<div>Terminator doesn’t have this setting.</div></blockquote>
610
<div class="section" id="colours">
611
<h3>Colours<a class="headerlink" href="#colours" title="Permalink to this headline">¶</a></h3>
612
<img alt="_images/prefs_profiles_colors.png" src="_images/prefs_profiles_colors.png" />
613
<p>There seems to be some mild quirks and differences (palettes available
614
or selected from the system theme) between Terminator and GNOME
616
<div class="section" id="foreground-and-background">
617
<h4>Foreground and Background<a class="headerlink" href="#foreground-and-background" title="Permalink to this headline">¶</a></h4>
619
<div><p><strong>Use colours from system theme</strong> (default: off)</p>
621
<div>Use colours as defined in the system theme. Not clear at this time
622
where exactly these come from. Differences in the GTK2, GTK3 and
623
GNOME Terminal.</div></blockquote>
624
<p><strong>Built-in schemes</strong> (default: Grey on black)</p>
626
<div><p>Pick a primary colour combination for foreground and background.
627
Again there are unexplained differences between Terminator and
629
<p>The list seems to be dynamic and vary depending on the system,
630
with the addition of <em>Custom</em> which allows setting the colours
633
<p><strong>Text colour</strong> (default: inactive, #AAAAAA)</p>
635
<div>If the <em>Built-in schemes</em> is set to <em>Custom</em> the text colour can
636
be set here.</div></blockquote>
637
<p><strong>Background colour</strong> (default: inactive, #000000)</p>
639
<div>If the <em>Built-in schemes</em> is set to <em>Custom</em> the background colour
640
can be set here.</div></blockquote>
643
<div class="section" id="palette">
644
<h4>Palette<a class="headerlink" href="#palette" title="Permalink to this headline">¶</a></h4>
646
<div><p><strong>Built-in schemes</strong> (default: Ambience)</p>
648
<div><p>A predefined colour palette can be selected. Again there are
649
unexplained differences between Terminator and GNOME Terminal.</p>
650
<p>The default here may be system dependant, with Ambience being
651
an Ubuntu colour scheme.</p>
653
<p><strong>Colour palette</strong> (default: inactive)</p>
655
<div>If the Palette’s <em>Built-in schemes</em> is set to custom, a set of
656
colour swatches are used to configure the 16 primary colours
657
of the shell palette.</div></blockquote>
660
<div class="section" id="id2">
661
<h4>Not in Terminator<a class="headerlink" href="#id2" title="Permalink to this headline">¶</a></h4>
663
<div><p><strong>Bold colour</strong></p>
665
<div>In theory nothing is stopping us implementing this, it just doesn’t
666
appear to have ever been added.</div></blockquote>
667
<p><strong>Same as text colour</strong></p>
669
<div>In truth, I’m not exactly sure what this does, but at a guess, the
670
user can force bold to be drawn in the same colour as the
671
foreground text.</div></blockquote>
675
<div class="section" id="background">
676
<h3>Background<a class="headerlink" href="#background" title="Permalink to this headline">¶</a></h3>
677
<img alt="_images/prefs_profiles_background.png" src="_images/prefs_profiles_background.png" />
678
<p><strong>Solid colour</strong> (default: active)</p>
680
<div>Background of terminal is set to the solid colour set in previous
681
<em>Colours</em> tab.</div></blockquote>
682
<p><strong>Background image</strong> (default: inactive)</p>
684
<div>Background will be an image. There is no scaling done.</div></blockquote>
685
<p><strong>Image file</strong> (default: inactive, None)</p>
687
<div>If <em>Background image</em> is set, then the image to use can be selected
688
here.</div></blockquote>
689
<p><strong>Background image scrolls</strong> (default: inactive, on)</p>
691
<div>If the <em>Background image</em> is set, then setting this to on will cause
692
the background image to change as the window moves. This is a for of
693
fake transparency.</div></blockquote>
694
<p><strong>Transparent background</strong> (default: inactive)</p>
696
<div><p>This will attempt true transparency where the windows below are
697
partially visible through the terminal.</p>
698
<div class="admonition note">
699
<p class="first admonition-title">Note</p>
700
<p class="last">This option requires a compositing desktop.</p>
703
<p><strong>Shade transparent or image background</strong> (default: 0.5)</p>
705
<div>For <em>Background image</em> and <em>Transparent background</em> this is how
706
much the solid colour should be blended in, giving a tinting effect.</div></blockquote>
708
<div class="section" id="scrolling">
709
<h3>Scrolling<a class="headerlink" href="#scrolling" title="Permalink to this headline">¶</a></h3>
710
<img alt="_images/prefs_profiles_scrolling.png" src="_images/prefs_profiles_scrolling.png" />
711
<p><strong>Scrollbar is</strong> (default: On the right side)</p>
713
<div><p>If and where the scrollbar should appear.</p>
715
<li><em>On the left side</em></li>
716
<li><em>On the right side</em></li>
717
<li><em>Disabled</em></li>
720
<p><strong>Scrollback</strong> (default: 500 lines)</p>
722
<div>How many lines to keep before discarding.</div></blockquote>
723
<p><strong>Infinite Scrollback</strong> (default: off)</p>
725
<div><p>Lines are never discarded, and all lines since the session began
727
<div class="admonition note">
728
<p class="first admonition-title">Note</p>
729
<p class="last">Data is placed onto the disk by the underlying VTE
730
component, so even after a long time, the memory footprint
731
and performance of Terminator should be OK.</p>
734
<p><strong>Scroll on output</strong> (default: on)</p>
736
<div>Moves terminal to end of scrollback buffer when any output occurs.</div></blockquote>
737
<p><strong>Scroll on keystroke</strong> (default: on)</p>
739
<div>Moves terminal to end of scrollback buffer when any keypress occurs.</div></blockquote>
740
<p><strong>Use keystrokes to scroll on alternate screen</strong> (default: on)</p>
742
<div>Ummmm... I don’t know. Alternate screens are a bit of a mystery to me.</div></blockquote>
744
<div class="section" id="compatibility">
745
<h3>Compatibility<a class="headerlink" href="#compatibility" title="Permalink to this headline">¶</a></h3>
746
<img alt="_images/prefs_profiles_compatability.png" src="_images/prefs_profiles_compatability.png" />
747
<p><strong>Backspace key generates</strong> (default: ASCII DEL)</p>
749
<div><p>Change behaviour of the Backspace key.</p>
751
<li><em>Automatic</em></li>
752
<li><em>Control-H</em></li>
753
<li><em>ASCII DEL</em></li>
754
<li><em>Escape sequence</em></li>
757
<p><strong>Delete key generates</strong> (default: Escape sequence)</p>
759
<div><p>Change behaviour of the Delete key.</p>
761
<li><em>Automatic</em></li>
762
<li><em>Control-H</em></li>
763
<li><em>ASCII DEL</em></li>
764
<li><em>Escape sequence</em></li>
767
<p><strong>Reset Compatibility Options to Defaults</strong></p>
769
<div>Sets the two previous items back to their defaults.</div></blockquote>
770
<div class="section" id="encoding">
771
<h4>Encoding<a class="headerlink" href="#encoding" title="Permalink to this headline">¶</a></h4>
772
<p><strong>Default</strong> (default: Unicode UTF-8)</p>
774
<div>Choose the default encoding method used from a long list of
775
available encodings.</div></blockquote>
779
<div class="section" id="layouts">
780
<span id="prefs-layouts"></span><h2>Layouts<a class="headerlink" href="#layouts" title="Permalink to this headline">¶</a></h2>
781
<img alt="_images/prefs_layouts.png" src="_images/prefs_layouts.png" />
782
<p>Layouts are the primary means for saving collections of windows,
783
tabs, and terminals. The use and flexibility of layouts is covered in
784
<a class="reference internal" href="layouts.html#layouts"><span>Layouts and the Layout Launcher</span></a>. Here we will cover the bare minimum to understand the
785
configuration options.</p>
786
<p>In the left list is the saved layouts, with three buttons below:</p>
788
<li><em>Add</em> - Creates a new layout from the current windows, tabs and
789
terminals, and saves them with a new name.</li>
790
<li><em>Remove</em> - Delete the selected layout</li>
791
<li><em>Save</em> - Update the selected layout with the current windows, tabs,
794
<p>Once a layout is highlighted, it’s name can be changed by clicking it
796
<p>In the central list is a tree showing the structure of the selected
797
layout. When highlighting an entry of type Terminal, the controls on
798
the right become enabled, and can be changed.</p>
799
<div class="admonition warning">
800
<p class="first admonition-title">Warning</p>
801
<p>You do not need to use the save button when changing the
802
options in the controls on the right.</p>
803
<p class="last">If you do, you <em>will</em> lose the <em>Custom command</em> and
804
<em>Working directory</em> settings for all terminals in this
807
<p><strong>Profile</strong></p>
809
<div>The profile used by the select terminal as listed in the
810
<a class="reference internal" href="#prefs-profiles"><span>Profiles</span></a> tab.</div></blockquote>
811
<p><strong>Custom command</strong></p>
813
<div>Override the command run in the terminal, same as in a profile,
814
but this one has a higher priority. If empty, it will run the command
815
in the profile, or the default user shell.</div></blockquote>
816
<p><strong>Working directory</strong></p>
818
<div>Whatever command is run (from layout, profile, or user default) it
819
will be executed with this entry as the working path. If empty the
820
default working directory is used, which is either where Terminator
821
was launched from, or the users home directory.</div></blockquote>
823
<div class="section" id="keybindings">
824
<h2>Keybindings<a class="headerlink" href="#keybindings" title="Permalink to this headline">¶</a></h2>
825
<img alt="_images/prefs_keybindings.png" src="_images/prefs_keybindings.png" />
826
<p>This is a list of all available keyboard shortcuts in the application.</p>
827
<p>To change a keybinding, first highlight the entry you wish to change.
828
Next click on the <em>Keybinding</em> column again. The entry should change
829
to <strong>New accelerator...</strong>. Simply perform the shortcut you wish to
830
set. If you change your mind use <code class="docutils literal"><span class="pre">Esc</span></code> (Escape) key to revert back
831
to the existing shortcut. If you wish to delete a shortcut, use the
832
<code class="docutils literal"><span class="pre">BkSp</span></code> key (Backspace, ←, or ⌫ depending on your keyboard).</p>
834
<div class="section" id="plugins">
835
<span id="prefs-plugins"></span><h2>Plugins<a class="headerlink" href="#plugins" title="Permalink to this headline">¶</a></h2>
836
<img alt="_images/prefs_plugins.png" src="_images/prefs_plugins.png" />
837
<p>Here you will find a list of available plugins, and whether they are
838
enabled or not. Plugins are covered in more detail in <a class="reference internal" href="plugins.html#plugins"><span>Plugins</span></a>.</p>
839
<div class="admonition warning">
840
<p class="first admonition-title">Warning</p>
841
<p class="last">For some reason clicking on the text label of a plugin
842
does not just select the item, but actually toggles the
843
active/inactive status. This does not happen in the
844
experimental GTK3 version of Terminator, and is a bit of
848
<div class="section" id="about">
849
<h2>About<a class="headerlink" href="#about" title="Permalink to this headline">¶</a></h2>
850
<img alt="_images/prefs_about.png" src="_images/prefs_about.png" />
851
<p>A simple panel describing a bit about the application, and a set of
852
links that will guide users to some helpful Terminator project
853
resources. There’s also a mysterious button... I wonder what happens
862
<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
864
<a href="layouts.html" class="btn btn-neutral float-right" title="Layouts and the Layout Launcher" accesskey="n">Next <span class="fa fa-arrow-circle-right"></span></a>
867
<a href="gettingstarted.html" class="btn btn-neutral" title="Getting Started" accesskey="p"><span class="fa fa-arrow-circle-left"></span> Previous</a>
874
<div role="contentinfo">
876
© Copyright 2015, Stephen Boddy, licensed under the CC-BY-SA..
879
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>.
894
<script type="text/javascript">
895
var DOCUMENTATION_OPTIONS = {
898
COLLAPSE_INDEX:false,
903
<script type="text/javascript" src="_static/jquery.js"></script>
904
<script type="text/javascript" src="_static/underscore.js"></script>
905
<script type="text/javascript" src="_static/doctools.js"></script>
911
<script type="text/javascript" src="_static/js/theme.js"></script>
916
<script type="text/javascript">
918
SphinxRtdTheme.StickyNav.enable();
b'\\ No newline at end of file'
added
removed
doc/manual/_build/html/preferences.html
