1XFCE4-TERMINAL(1) Xfce XFCE4-TERMINAL(1)
2
3
4
6 xfce4-terminal - A Terminal emulator for X
7
9 xfce4-terminal [OPTION...]
10
12 xfce4-terminal is what is known as an X terminal emulator, often
13 referred to as terminal or shell. It provides an equivalent to the
14 old-fashioned text screen on your desktop, but one which can easily
15 share the screen with other graphical applications. Windows users may
16 already be familiar with the MS-DOS Prompt utility, which has the
17 analogous function of offering a DOS command-line under Windows, though
18 one should note that the UNIX CLI offer far more power and ease of use
19 than does DOS.
20
21 xfce4-terminal emulates the xterm application developed by the X
22 Consortium. In turn, the xterm application emulates the DEC VT102
23 terminal and also supports the DEC VT220 escape sequences. An escape
24 sequence is a series of characters that start with the Esc character.
25 xfce4-terminal accepts all of the escape sequences that the VT102 and
26 VT220 terminals use for functions such as to position the cursor and to
27 clear the screen.
28
30 Option Summary
31 Here is a summary of all the options, grouped by type. Explanations are
32 in the following sections.
33
34 General Options
35 -h, --help; -V, --version; --disable-server; --color-table;
36 --preferences; --default-display=display;
37 --default-working-directory=directory
38
39 Window or Tab Separators
40 --tab; --window
41
42 Tab Options
43 -x, --execute; -e, --command=command; -T, --title=title;
44 --dynamic-title-mode=mode; --initial-title=title;
45 --working-directory=directory; -H, --hold; --active-tab;
46 --color-text=color; --color-bg=color
47
48 Window Options
49 --display=display; --drop-down; --geometry=geometry; --role=role;
50 --startup-id=string; -I, --icon=icon; --fullscreen; --maximize;
51 --minimize; --show-menubar, --hide-menubar; --show-borders,
52 --hide-borders; --show-toolbar, --hide-toolbar; --show-scrollbar,
53 --hide-scrollbar; --font=font; --zoom=zoom
54
55 General Options
56 -h, --help
57 List the various command line options supported by xfce4-terminal
58 and exit.
59
60 -V, --version
61 Display version information and exit.
62
63 --disable-server
64 Do not register with the D-BUS session message bus. Run this
65 terminal in its own process.
66
67 --color-table
68 Echo the color codes.
69
70 --preferences
71 Open the xfce4-terminal preferences window.
72
73 --default-display=display
74 Default X display to use.
75
76 --default-working-directory=directory
77 Set directory as the default working directory for the terminal.
78
79 Window or Tab Separators
80 --tab
81 Open a new tab in the last specified window. More than one of these
82 options can be provided, each opening an additional tab.
83
84 --window
85 Open a new window containing one tab. More than one of these
86 options can be provided.
87
88 If there is an active window, the last specified window is that window
89 until a --window option is encountered at which point that new window
90 is the last specified window.
91
92 If there is no active window, the last specified window is the window
93 created by xfce4-terminal until a --window option is encountered at
94 which point that new window is the last specified window.
95
96 These options can be combined with --drop-down.
97
98 Tab Options
99 -x, --execute
100 Execute the remainder of the command line inside the terminal.
101
102 -e, --command=command
103 Execute command inside the terminal.
104
105 -T, --title=title
106 Set title as the window title for the terminal (ignores
107 dynamically-set title).
108
109 --dynamic-title-mode=mode
110 Set mode as the dynamically-set title mode for the terminal, one
111 of: 'replace', 'before', 'after', 'none'.
112
113 --initial-title=title
114 Set title as the initial window title for the terminal (respects
115 dynamically-set title).
116
117 --working-directory=directory
118 Set directory as the working directory for the terminal.
119
120 -H, --hold
121 Causes the terminal to be kept around after the child command has
122 terminated.
123
124 --active-tab
125 Makes the terminal active: useful when a terminal window contains
126 multiple tabs.
127
128 --color-text=color
129 Set color as the text color for the terminal per the following
130 specification: https://docs.gtk.org/gdk3/method.RGBA.parse.html
131
132 --color-bg=color
133 Set color as the background color for the terminal per the
134 following specification:
135 https://docs.gtk.org/gdk3/method.RGBA.parse.html
136
137 Window Options
138 --display=display
139 X display to use for the last- specified window.
140
141 --drop-down
142 Will start the window in drop-down mode (also called a Quake-style
143 terminal). This will only apply to the first window started with
144 this option. It is advised to bind this to a shortcut in the
145 keyboard preferences.
146
147 --geometry=geometry
148 Sets the geometry of the last-specified window to geometry. Read
149 X(7) for more information on how to specify window geometries.
150
151 --role=role
152 Sets the window role of the last-specified window to role. Applies
153 to only one window and can be specified once for each window you
154 create from the command line. The role is a unique identifier for
155 the window to be used when restoring a session.
156
157 --startup-id=string
158 Specifies the startup notification id for the last-specified
159 window. Used internally to forward the startup notification id when
160 using the D-BUS service.
161
162 -I, --icon=icon
163 Set the terminal's icon as an icon name or filename.
164
165 --fullscreen
166 Set the last-specified window into fullscreen mode; applies to only
167 one window; can be specified once for each window you create from
168 the command line.
169
170 --maximize
171 Set the last-specified window into maximized mode; applies to only
172 one window; can be specified once for each window you create from
173 the command line.
174
175 --minimize
176 Set the last-specified window into minimized mode; applies to only
177 one window; can be specified once for each window you create from
178 the command line.
179
180 --show-menubar
181 Turn on the menubar for the last-specified window. Can be specified
182 once for each window you create from the command line.
183
184 --hide-menubar
185 Turn off the menubar for the last-specified window. Can be
186 specified once for each window you create from the command line.
187
188 --show-borders
189 Turn on the window decorations for the last-specified window.
190 Applies to only one window. Can be specified once for each window
191 you create from the command line.
192
193 --hide-borders
194 Turn off the window decorations for the last-specified window.
195 Applies to only one window. Can be specified once for each window
196 you create from the command line.
197
198 --show-toolbar
199 Turn on the toolbar for the last-specified window. Applies to only
200 one window. Can be specified once for each window you create from
201 the command line.
202
203 --hide-toolbar
204 Turn off the toolbar for the last-specified window. Applies to only
205 one window. Can be specified once for each window you create from
206 the command line.
207
208 --show-scrollbar
209 Turn on the scrollbar for the last-specified window. Scrollbar
210 position is taken from the settings; if position is None, the
211 default position is Right side. Applies to only one window. Can be
212 specified once for each window you create from the command line.
213
214 --hide-scrollbar
215 Turn off the scrollbar for the last-specified window. Applies to
216 only one window. Can be specified once for each window you create
217 from the command line.
218
219 --font=font
220 Set the terminal font.
221
222 --zoom=zoom
223 Set the zoom level: the font size will be multiplied by this level.
224 The range is from -7 to 7, default is 0. Each step multiplies the
225 size by 1.2, i.e. level 7 is 3.5831808 (1.2^7) times larger than
226 the default size.
227
229 xfce4-terminal --geometry 80x40 --command mutt --tab --command mc
230 Opens a new terminal window with a geometry of 80 columns and 40
231 rows and two tabs in it, where the first tab runs mutt and the
232 second tab runs mc.
233
235 xfce4-terminal uses the Basedir Specification as defined on
236 Freedesktop.org[1] to locate its data and configuration files. This
237 means that file locations will be specified as a path relative to the
238 directories described in the specification.
239
240 ${XDG_CONFIG_HOME}
241 The first base directory to look for configuration files. By
242 default this is set to ~/.config/.
243
244 ${XDG_CONFIG_DIRS}
245 A colon separated list of base directories that contain
246 configuration data. By default the application will look in
247 ${sysconfdir}/xdg/. The value of ${sysconfdir} depends on how the
248 program was build and will often be /etc/ for binary packages.
249
250 ${XDG_DATA_HOME}
251 The root for all user-specific data files. By default this is set
252 to ~/.local/share/.
253
254 ${XDG_DATA_DIRS}
255 A set of preference ordered base directories relative to which data
256 files should be searched in addition to the ${XDG_DATA_HOME} base
257 directory. The directories should be separated with a colon.
258
260 ${XDG_CONFIG_HOME}/xfce4/terminal/accels.scm
261 This is the location of the keyboard shortcuts configuration file
262 for xfce4-terminal. Editing this file allows one to modify or
263 disable shortcuts for the supported actions.
264
266 bash(1), X(7)
267
269 Sergios - Anestis Kefalidis <sergioskefalidis@gmail.com>
270 Developer
271
272 Igor Zakharov <f2404@yandex.ru>
273 Developer
274
275 Nick Schermer <nick@xfce.org>
276 Developer
277
278 Benedikt Meurer <benny@xfce.org>
279 Software developer, os-cillation, System development,
280 Developer
281
283 1. Freedesktop.org
284 http://freedesktop.org/
285
286
287
288xfce4-terminal 10/14/2023 XFCE4-TERMINAL(1)