gnome-terminal(1) User Commands gnome-terminal(1)NAMEgnome-terminal - terminal emulator for GNOME
SYNOPSISgnome-terminal [--tab] [--window] [--tab-with-profile=profilename]
[--window-with-profile=profilename] [--active] [--command=command]
[--execute=command] [--full-screen] [--maximize] [--role=role] [--show-
menubar | --hide-menubar] [--startup-id=id] [--title=title] [--use-
factory | --disable-factory] [--working-directory=dirname]
[--zoom=zoomfactor] [gnome-std-options]
DESCRIPTIONgnome-terminal is the GNOME terminal emulation program. It provides
access to the UNIX shell on the GNOME environment. gnome-terminal sup‐
ports multiple profiles to allow easy switching between preferences,
and supports tabbing so that multiple terminals can be managed from a
single window. By default, all GNOME terminals share a single process,
reducing memory usage. This can be disabled by starting gnome-terminal
with the --disable-factory option.
OPTIONS
The following options are supported:
--active
Set the last specified tab as the active one in its window.
-e, --command command
Executes the command command instead of the shell. This saves some
memory if you just plan to run a dedicated application on that win‐
dow.
--disable-factory
Do not register with the activation name server, and do not reuse
an already running GNOME terminal process.
-x, --execute command
This option is provided for compatibility reasons. It is the same
as the --command option.
--full-screen
Set the last-specified window into fullscreen mode. Applies to
only one window. Can be specified one for each wwindow you create
from the command line.
--maximize
Set the last-specified window into maximized mode; a pplies to only
one window; can be specified once for each window you create from
the command line.
--hide-menubar
Hide the menubar. This applies only to one window. When used with
multiple --window-with-profile options, it applies to the --window-
with-profile option immediately to the left. Can be specified mul‐
tiple times, once for each --window-with-profile option.
--role=role
The GNOME session manager follows the ICCCM convention of using the
window title and the window role to identify specific windows. The
session manager uses this information to put windows back in the
same place when the user restarts their session. If all windows
have a unique title, there is no need to set the role. However, as
it is common for multiple GNOME terminals to have the same title,
the user can also specify the role on the command line with the
--role option. This helps the session manager to properly identify
and restart each GNOME terminal (in the same location, and so
on). When used with multiple --window-with-profile options, it
applies to the --window-with-profile option immediately to the
left. Can be specified multiple times, once for each --window-with-
profile option.
--show-menubar
Show the menubar. This applies only to one window. When used with
multiple --window-with-profile options, it applies to the --window-
with-profile option immediately to the left. Can be specified mul‐
tiple times, once for each --window-with-profile option.
--startup-id=id
Set the id for startup notification protocol.
--tab
Open a new tab in the last-opened window with the default profile.
More than one of these options can be provided.
--tab-with-profile=profilename
Creates a tab that uses the specified profile. This argument may be
specified multiple times to create multiple tabs in a terminal. If
this is used with multiple --window-with-profile options, the tab
is created for the window that corresponds to the --window-with-
profile option immediately to the left.
-t, --title=title
Set the title for the GNOME terminal to be title.
--use-factory
Register with the activation name server, and reuse an already run‐
ning GNOME terminal process.
--window
Open a new window contianing a tab with the default profile. More
than one of these options can be provided.
--window-with-profile=profilename
Creates a GNOME terminal and a tab that uses the specified profile.
This may be used with the --tab-with-profile option to create addi‐
tional tabs. Multiple --window-with-profile options can be speci‐
fied to create multiple GNOME terminal windows. All options speci‐
fied after an --window-with-profile option apply to that --window-
with-profile option only.
--working-directory=dirname
Set the working directory for the GNOME terminal to be dirname.
--zoom=zoomfactor
Set the terminal's zoom factor (1.0 = normal size).
gnome-std-options
Standard options available for use with most GNOME applications.
See gnome-std-options(5) for more information.
EXTENDED DESCRIPTIONgnome-terminal is designed to emulate the xterm program provided by the
X Consortium. The xterm(1) program in turn is an almost-complete emu‐
lation of the DEC VT102 terminal. gnome-terminal supports the same
extensions to the VT102 as those provided by the xterm program, through
special escape sequences. The xterm program is an evolving program.
Recent changes to xterm have been been incorporated into gnome-termi‐
nal. This includes emulation of the newer DEC VT220 escape sequences.
EXAMPLES
Example 1: Running the `minicom' terminal emulator on the window
example% gnome-terminal--command minicom
Example 2: Monitoring the system
example% gnome-terminal--command top
Example 3: Starting two windows with different profiles
example% gnome-terminal --window-with-profile=FirstProfile
--tab-with-profile=SecondProfile --window-with-profile=SecondProfile
In this example, the first window will have two tabs (FirstProfile and
SecondProfile) and the second window will have one tab (SecondProfile).
ENVIRONMENT VARIABLES
See environ(5) for descriptions of the following environment variables,
set by gnome-terminal:
TERM This variable is set to xterm by default. Some
implementations of curses, and applications
based on curses, may prefer the value to be
xterm-color, color-xterm, or xterm-debian to
support color. Users might need to change this
setting to one of these values to enable color
for such applications.
COLORTERM This variable is set to xterm. Various applica‐
tions (especially the Slang-based applications)
use this setting to determine whether the ter‐
minal supports color.
WINDOWID This variable contains the X11 Window identi‐
fier. This is sometimes used by applications to
modify the contents of this window or provide
special effects.
EXIT STATUS
The following exit values are returned:
0 Application exited successfully
>0 Application exited with failure
FILES
The following files are used by this application:
/usr/bin/gnome-terminal Executable for GNOME terminal emulator
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │terminal/gnome-terminal │
├─────────────────────────────┼─────────────────────────────┤
│Interface stability │Volatile │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOgnome-session(1), xterm(1), vte(1), libvte(3), attributes(5), envi‐
ron(5)gnome-std-options(5)
Latest version of the GNOME Desktop User Guide for your platform.
NOTES
Written by Michael Zucchi, Miguel de Icaza, Erik Troan.
Updated by Brian Cameron, Sun Microsystems Inc., 2003, 2004, 2006.
SunOS 5.11 31 Aug 2004 gnome-terminal(1)