Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

gnome-terminal (1)

Name

gnome-terminal - terminal emulator for GNOME

Synopsis

gnome-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]

Description

gnome-terminal(1)                User Commands               gnome-terminal(1)



NAME
       gnome-terminal - terminal emulator for GNOME

SYNOPSIS
       gnome-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]

DESCRIPTION
       gnome-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(7) for more information.

EXTENDED DESCRIPTION
       gnome-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(7) 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 use this setting to determine whether the
                               terminal 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


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+-------------------------+
       |ATTRIBUTE TYPE |    ATTRIBUTE VALUE      |
       +---------------+-------------------------+
       |Availability   | terminal/gnome-terminal |
       +---------------+-------------------------+
       |Stability      | Pass-through volatile   |
       +---------------+-------------------------+
SEE ALSO
       gnome-session(1), xterm(1), vte(1), libvte(3lib), attributes(7),  envi-
       ron(7), gnome-std-options(7)

       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.


       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source  was  downloaded from  https://download.gnome.org/sources/gnome-
       terminal/3.18/gnome-terminal-3.18.2.tar.xz

       Further information about this software can be found on the open source
       community website at https://wiki.gnome.org/Apps/Terminal.



Solaris 11.4                      7 Apr 2017                 gnome-terminal(1)