1
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Advanced topics</title><link rel="stylesheet" href="../terminal.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="Terminal Emulator"><link rel="up" href="index.html" title="Terminal Emulator"><link rel="prev" href="command-line.html" title="Command line options"><link rel="next" href="faq.html" title="Frequently asked questions"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Advanced topics</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="command-line.html">Natrag</a>�</td><th width="60%" align="center">�</th><td width="20%" align="right">�<a accesskey="n" href="faq.html">Naprijed</a></td></tr></table><hr></div><div class="sect1" title="Advanced topics"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="advanced"></a>Advanced topics</h2></div></div></div><div class="sect2" title="Files and Environment Variables"><div class="titlepage"><div><div><h3 class="title"><a name="files-and-env-vars"></a>Files and Environment Variables</h3></div></div></div><p>
2
Terminal uses the Basedir Specification as defined on
3
<a class="ulink" href="http://freedesktop.org/" target="_top">Freedesktop.org</a> to locate its
4
data and configuration files. This means that file locations will be specified as
5
a path relative to the directories described in the specification.
6
</p><div class="variablelist"><dl><dt><span class="term"><code class="varname">${XDG_CONFIG_HOME}</code></span></dt><dd><p>
7
The first base directory to look for configuration
8
files. By default this is set to <code class="filename">~/.config/</code>.
9
</p></dd><dt><span class="term"><code class="varname">${XDG_CONFIG_DIRS}</code></span></dt><dd><p>
10
A colon separated list of base directories that contain configuration
11
data. By default the application will look in <code class="filename">${sysconfdir}/xdg/</code>.
12
The value of <code class="varname">${sysconfdir}</code> depends on how the program was
13
build and will often be <code class="filename">/etc/</code>
15
</p></dd><dt><span class="term"><code class="varname">${XDG_DATA_HOME}</code></span></dt><dd><p>
16
The root for all user-specific data files. By default this
17
is set to <code class="filename">~/.local/share/</code>.
18
</p></dd><dt><span class="term"><code class="varname">${XDG_DATA_DIRS}</code></span></dt><dd><p>
19
A set of preference ordered base directories relative to which
20
data files should be searched in addition to the
21
<code class="varname">${XDG_DATA_HOME}</code> base directory. The directories
22
should be separated with a colon.
23
</p></dd></dl></div><div class="variablelist"><dl><dt><span class="term"><code class="filename">${XDG_CONFIG_DIRS}/Terminal/terminalrc</code></span></dt><dd><p>
24
This is the location of the configuration file that includes the
25
preferences which control the look and feel of Terminal.
26
</p></dd><dt><span class="term"><code class="filename">${XDG_DATA_DIRS}/Terminal/Terminal-toolbars.ui</code></span></dt><dd><p>
27
This file includes the user interface definition for the toolbars. If
28
you customize the toolbars using the graphical toolbars editor, Terminal
29
will store the new toolbars layout in the file
30
<code class="filename">${XDG_DATA_HOME}/Terminal/Terminal-toolbars.ui</code>.
31
</p></dd></dl></div></div><div class="sect2" title="Hidden options"><div class="titlepage"><div><div><h3 class="title"><a name="hidden-options"></a>Hidden options</h3></div></div></div><p>
32
Terminal offers a few hidden options to allow powerusers to control various advanced settings and
33
to reduce the number of options in the user interface. To set any of these options, you will have
34
to open the file <code class="filename">${XDG_CONFIG_HOME}/Terminal/terminalrc</code> in your favorite
35
text editor and edit the section <code class="varname">[Configuration]</code>; simply create the file if
36
it does not already exist. For example, your <code class="filename">terminalrc</code> could look like
37
</p><pre class="programlisting">
39
MiscAlwaysShowTabs=TRUE
41
MiscConfirmClose=FALSE
43
MiscCursorShape=TERMINAL_CURSOR_SHAPE_BLOCK
45
MiscInheritGeometry=TRUE
46
MiscMouseAutohide=FALSE
47
MiscTabCloseButtons=TRUE
48
MiscTabCloseMiddleClick=TRUE
49
MiscTabPosition=GTK_POS_TOP
50
MiscHighlightUrls=TRUE</pre><p>
51
plus all the options that are controlled through the preferences dialog.
52
</p><div class="variablelist"><dl><dt><span class="term"><code class="varname">MiscAlwaysShowTabs</code></span></dt><dd><p>
53
If <code class="literal">TRUE</code> the tab headers will always be displayed even if only a single
54
terminal tab is open. This option is useful if you do not want the terminal window to
55
resize when you open a second tab. It is disabled by default.
56
</p></dd><dt><span class="term"><code class="varname">MiscBell</code></span></dt><dd><p>
57
Enables (<code class="varname">MiscBell=TRUE</code>) or disables (<code class="varname">MiscBell=FALSE</code>)
58
the audible terminal bell. It is disabled by default.
59
</p></dd><dt><span class="term"><code class="varname">MiscConfirmClose</code></span></dt><dd><p>
60
Controls whether Terminal popups a confirmation dialog when the user tries to close
61
a terminal window with multiple tabs in it. Can be either <code class="literal">TRUE</code>
62
(the default) or <code class="literal">FALSE</code>.
63
</p></dd><dt><span class="term"><code class="varname">MiscCursorBlinks</code></span></dt><dd><p>
64
Enable this option to display a cursor that blinks. Can be either <code class="literal">TRUE</code>
65
or <code class="literal">FALSE</code> (the default).
66
</p></dd><dt><span class="term"><code class="varname">MiscCursorShape</code></span></dt><dd><p>
67
Specifies the shape of the cursor in the terminal. This can be either
68
<code class="literal">TERMINAL_CURSOR_SHAPE_BLOCK</code> (the default),
69
<code class="literal">TERMINAL_CURSOR_SHAPE_IBEAM</code> or
70
<code class="literal">TERMINAL_CURSOR_SHAPE_UNDERLINE</code>. This option is
71
only available when you compile against VTE 0.19.1 or newer.
72
</p></dd><dt><span class="term"><code class="varname">MiscCycleTabs</code></span></dt><dd><p>
73
This option controls whether you can circulate through terminal tabs. That is, whether
74
you are able to go from the last tab to the first tab using the <span class="guimenuitem"><strong>Next
75
Tab</strong></span> button from the <span class="guimenu"><strong>Go</strong></span> menu (or the associated keyboard
76
shortcut), and from the first tab to the last tab using the <span class="guimenuitem"><strong>Previous
77
Tab</strong></span> button from the <span class="guimenu"><strong>Go</strong></span> menu. The option can be either
78
<code class="literal">TRUE</code> (the default) or <code class="literal">FALSE</code>.
79
</p></dd><dt><span class="term"><code class="varname">MiscDefaultGeometry</code></span></dt><dd><p>
80
The default geometry for new Terminal windows if no <a class="xref" href="command-line.html#options-window-geometry">
81
<code class="option">--geometry=<em class="replaceable"><code>geometry</code></em></code>
83
option is specified on the command line (defaults to <code class="literal">80x24</code>).
84
</p></dd><dt><span class="term"><code class="varname">MiscInheritGeometry</code></span></dt><dd><p>
85
This setting controls whether new windows will inherit the geometry (width
86
and height of the active tab) from its parent window (the window from which
87
the new window was opened). Can be either <code class="literal">TRUE</code> or
88
<code class="literal">FALSE</code> (the default).
89
</p></dd><dt><span class="term"><code class="varname">MiscMouseAutohide</code></span></dt><dd><p>
90
This setting controls whether Terminal will hide the mouse cursor
91
while you are typing in a terminal window. Can be either
92
<code class="literal">TRUE</code> or <code class="literal">FALSE</code> (the default).
93
</p></dd><dt><span class="term"><code class="varname">MiscTabCloseButtons</code></span></dt><dd><p>
94
This setting controls whether Terminal provides a close button with the
95
terminal tab title. Can be either <code class="literal">TRUE</code> (the default) or
96
<code class="literal">FALSE</code>.
97
</p></dd><dt><span class="term"><code class="varname">MiscTabCloseMiddleClick</code></span></dt><dd><p>
98
This setting controls whether Terminal will close a terminal tab when
99
the user middle-clicks the tab title. Can be either <code class="literal">TRUE</code>
100
(the default) or <code class="literal">FALSE</code>.
101
</p></dd><dt><span class="term"><code class="varname">MiscTabPosition</code></span></dt><dd><p>
102
Specifies the position where the tab headers should be displayed. This can
103
be either <code class="literal">GTK_POS_TOP</code> (the default), <code class="literal">GTK_POS_LEFT</code>,
104
<code class="literal">GTK_POS_BOTTOM</code> or <code class="literal">GTK_POS_RIGHT</code>. If you
105
specify <code class="literal">GTK_POS_LEFT</code> or <code class="literal">GTK_POS_RIGHT</code>
106
here, the tab header texts will be displayed vertically instead of horizontally.
107
It is highly recommended to disable <code class="varname">MiscTabCloseButtons</code> for
108
<code class="literal">GTK_POS_LEFT</code> and <code class="literal">GTK_POS_RIGHT</code>.
109
</p></dd><dt><span class="term"><code class="varname">MiscHighlightUrls</code></span></dt><dd><p>
110
This setting controls whether URLs - both hyperlinks and email addresses - will
111
be highlighted in the text displayed in a terminal window. If you change this
112
option to <code class="literal">FALSE</code>, URLs won't be highlighted anymore and you
113
will no longer be able to middle-click the URL to open it in the preferred
115
</p></dd></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="command-line.html">Natrag</a>�</td><td width="20%" align="center">�</td><td width="40%" align="right">�<a accesskey="n" href="faq.html">Naprijed</a></td></tr><tr><td width="40%" align="left" valign="top">Command line options�</td><td width="20%" align="center"><a accesskey="h" href="index.html">Početak</a></td><td width="40%" align="right" valign="top">�Frequently asked questions</td></tr></table></div></body></html>