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. 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

EXAMPLES

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

ENVIRONMENT

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

FILES

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

SEE ALSO

266       bash(1), X(7)
267

AUTHORS

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

NOTES

283        1. Freedesktop.org
284           http://freedesktop.org/
285
286
287
288xfce4-terminal                    10/14/2023                 XFCE4-TERMINAL(1)
Impressum