1XFCE4-TERMINAL(1)                    Xfce                    XFCE4-TERMINAL(1)
2
3
4

NAME

6       xfce4-terminal - A Terminal emulator for X
7

SYNOPSIS

9       xfce4-terminal [OPTION...]
10

DESCRIPTION

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

OPTIONS

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
65
66       --color-table
67           Echo the color codes
68
69       --preferences
70           Open the xfce4-terminal preferences window
71
72       --default-display=display
73           Default X display to use.
74
75       --default-working-directory=directory
76           Set directory as the default working directory for the terminal
77
78   Window or Tab Separators
79       --tab
80           Open a new tab in the last specified window. More than one of these
81           options can be provided, each opening an additional tab.
82
83       --window
84           Open a new window containing one tab. More than one of these
85           options can be provided.
86
87       If there is an active window, the last specified window is that window
88       until a --window option is encountered at which point that new window
89       is the last specified window.
90
91       If there is no active window, the last specified window is the window
92       created by xfce4-terminal until a --window option is encountered at
93       which point that new window is the last specified window.
94
95       These options can be combined with --drop-down.
96
97   Tab Options
98       -x, --execute
99           Execute the remainder of the command line inside the terminal
100
101       -e, --command=command
102           Execute command inside the terminal
103
104       -T, --title=title
105           Set title as the window title for the terminal (ignores
106           dynamically-set title)
107
108       --dynamic-title-mode=mode
109           Set mode as the dynamically-set title mode for the terminal, one
110           of: 'replace', 'before', 'after', 'none'
111
112       --initial-title=title
113           Set title as the initial window title for the terminal (respects
114           dynamically-set title)
115
116       --working-directory=directory
117           Set directory as the working directory for the terminal
118
119       -H, --hold
120           Causes the terminal to be kept around after the child command has
121           terminated
122
123       --active-tab
124           Makes the terminal active: useful when a terminal window contains
125           multiple tabs
126
127       --color-text=color
128           Set color as the text color for the terminal per the following
129           specification: https://docs.gtk.org/gdk3/method.RGBA.parse.html
130
131       --color-bg=color
132           Set color as the background color for the terminal per the
133           following specification:
134           https://docs.gtk.org/gdk3/method.RGBA.parse.html
135
136   Window Options
137       --display=display
138           X display to use for the last- specified window.
139
140       --drop-down
141           Will start the window in drop-down mode (also called a Quake-style
142           terminal). This will only apply to the first window started with
143           this option. It is advised to bind this to a shortcut in the
144           keyboard preferences.
145
146       --geometry=geometry
147           Sets the geometry of the last-specified window to geometry. Read
148           X(7) for more information on how to specify window geometries.
149
150       --role=role
151           Sets the window role of the last-specified window to role. Applies
152           to only one window and can be specified once for each window you
153           create from the command line. The role is a unique identifier for
154           the window to be used when restoring a session.
155
156       --startup-id=string
157           Specifies the startup notification id for the last-specified
158           window. Used internally to forward the startup notification id when
159           using the D-BUS service.
160
161       -I, --icon=icon
162           Set the terminal's icon as an icon name or filename.
163
164       --fullscreen
165           Set the last-specified window into fullscreen mode; applies to only
166           one window; can be specified once for each window you create from
167           the command line.
168
169       --maximize
170           Set the last-specified window into maximized mode; applies to only
171           one window; can be specified once for each window you create from
172           the command line.
173
174       --minimize
175           Set the last-specified window into minimized mode; applies to only
176           one window; can be specified once for each window you create from
177           the command line.
178
179       --show-menubar
180           Turn on the menubar for the last-specified window. Can be specified
181           once for each window you create from the command line.
182
183       --hide-menubar
184           Turn off the menubar for the last-specified window. Can be
185           specified once for each window you create from the command line.
186
187       --show-borders
188           Turn on the window decorations for the last-specified window.
189           Applies to only one window. Can be specified once for each window
190           you create from the command line.
191
192       --hide-borders
193           Turn off the window decorations for the last-specified window.
194           Applies to only one window. Can be specified once for each window
195           you create from the command line.
196
197       --show-toolbar
198           Turn on the toolbar for the last-specified window. Applies to only
199           one window. Can be specified once for each window you create from
200           the command line.
201
202       --hide-toolbar
203           Turn off the toolbar for the last-specified window. Applies to only
204           one window. Can be specified once for each window you create from
205           the command line.
206
207       --show-scrollbar
208           Turn on the scrollbar for the last-specified window. Scrollbar
209           position is taken from the settings; if position is None, the
210           default position is Right side. Applies to only one window. Can be
211           specified once for each window you create from the command line.
212
213       --hide-scrollbar
214           Turn off the scrollbar for the last-specified window. Applies to
215           only one window. Can be specified once for each window you create
216           from the command line.
217
218       --font=font
219           Set the terminal font.
220
221       --zoom=zoom
222           Set the zoom level: the font size will be multiplied by this level.
223           The range is from -7 to 7, default is 0. Each step multiplies the
224           size by 1.2, i.e. level 7 is 3.5831808 (1.2^7) times larger than
225           the default size.
226

EXAMPLES

228       xfce4-terminal --geometry 80x40 --command mutt --tab --command mc
229           Opens a new terminal window with a geometry of 80 columns and 40
230           rows and two tabs in it, where the first tab runs mutt and the
231           second tab runs mc.
232

ENVIRONMENT

234       xfce4-terminal uses the Basedir Specification as defined on
235       Freedesktop.org[1] to locate its data and configuration files. This
236       means that file locations will be specified as a path relative to the
237       directories described in the specification.
238
239       ${XDG_CONFIG_HOME}
240           The first base directory to look for configuration files. By
241           default this is set to ~/.config/.
242
243       ${XDG_CONFIG_DIRS}
244           A colon separated list of base directories that contain
245           configuration data. By default the application will look in
246           ${sysconfdir}/xdg/. The value of ${sysconfdir} depends on how the
247           program was build and will often be /etc/ for binary packages.
248
249       ${XDG_DATA_HOME}
250           The root for all user-specific data files. By default this is set
251           to ~/.local/share/.
252
253       ${XDG_DATA_DIRS}
254           A set of preference ordered base directories relative to which data
255           files should be searched in addition to the ${XDG_DATA_HOME} base
256           directory. The directories should be separated with a colon.
257

FILES

259       ${XDG_CONFIG_HOME}/xfce4/terminal/terminalrc
260           This is the location of the configuration file that includes the
261           preferences which control the look and feel of xfce4-terminal.
262           Note: any update made to the configuration file via an external
263           editor will be picked up by xfce4-terminal instances running.
264
265       ${XDG_CONFIG_HOME}/xfce4/terminal/accels.scm
266           This is the location of the keyboard shortcuts configuration file
267           for xfce4-terminal. Editing this file allows one to modify or
268           disable shortcuts for the supported actions.
269

SEE ALSO

271       bash(1), X(7)
272

AUTHORS

274       Sergios - Anestis Kefalidis <sergioskefalidis@gmail.com>
275           Developer
276
277       Igor Zakharov <f2404@yandex.ru>
278           Developer
279
280       Nick Schermer <nick@xfce.org>
281           Developer
282
283       Benedikt Meurer <benny@xfce.org>
284       Software developer, os-cillation, System development,
285           Developer
286

NOTES

288        1. Freedesktop.org
289           http://freedesktop.org/
290
291
292
293xfce4-terminal                    05/22/2022                 XFCE4-TERMINAL(1)
Impressum