logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

gnome-terminal.wrapper - x-terminal-emulator interface for gnome-terminal

Description

gnome-terminal.wrapper wraps gnome-terminal(1) to provide an interface that is compatible with the
       x-terminal-emulator specification in Debian Policy, which is a subset of the xterm(1) command-line
       interface.

       Its behaviour is similar to gnome-terminal--wait, with some command-line options converted from
       x-terminal-emulator syntax to gnome-terminal(1) syntax.

Example

       To run the command "mutt -f=" in a window with title "mutt e-mail client":

           $ x-terminal-emulator -T "mutt e-mail client" -e mutt -f=

Exit Status

       The exit status is the same as for gnome-terminal(1).

Name

       gnome-terminal.wrapper - x-terminal-emulator interface for gnome-terminal

Options

Standardx-terminal-emulatoroptions
       These options work as specified in Debian Policy §11.8.3.

       -TTITLE
           Set  the title of the terminal to TITLE, as specified in Debian Policy.  Equivalent to xterm-TTITLE
           or gnome-terminal-tTITLE.

       -eCOMMAND [ARGUMENTS...]
           Run COMMAND with arguments ARGUMENTS in the terminal, and stop parsing options after -e.   Equivalent
           to xterm-eCOMMANDARGUMENTS.

           If  there  are no ARGUMENTS, gnome-terminal.wrapper will attempt to find the COMMAND in the PATH.  If
           found, it is used as the command to execute, as specified in Debian Policy.   If  not  found,  as  an
           extension, gnome-terminal.wrapper will treat the COMMAND as a shell command instead, running it as if
           via  sh-cCOMMAND.   This  is  similar  to  the behaviour of xterm-e, but is not guaranteed to be
           implemented by all x-terminal-emulator implementations.

           Otherwise equivalent to gnome-terminal--COMMANDARGUMENTS.

   Non-standardoptions
       These options are provided for convenience, increasing command-line compatibility  with  xterm(1)  and/or
       gnome-terminal(1),  but  are not guaranteed to be available in other x-terminal-emulator implementations.
       Using these options is discouraged: to obtain functionality beyond the  standardized  x-terminal-emulator
       interface, invoke a specific terminal such as gnome-terminal(1) or xterm(1) directly.

       -displayX11DISPLAY
           If  using  X11, select X11DISPLAY as the X11 display to use.  If using native Wayland, this option is
           ignored.

           It is preferable to set the DISPLAY and/or WAYLAND_DISPLAY environment variables instead.

       -geometryCOLSxROWS+X+Y
           Set  the  window  size  to  COLS  ×  ROWS  at   position   (X,Y).    Equivalent   to   gnome-terminal--geometry=COLSxROWS+X+Y.

       -ls Using  this  option  is  treated  as  a command-line parsing error.  In xterm(1) it would run a login
           shell, but gnome-terminal(1) does not have that feature.

       +ls Accepted, with a warning, but otherwise ignored.  gnome-terminal(1) never runs a login shell.

       -nICON
           Accepted for command-line compatibility with xterm(1), but ignored.

       -nameNAME
           Select  NAME  as  a  gnome-terminal(1)  profile,  if  it  exists.    Equivalent   to   gnome-terminal--window-with-profile=NAME.

       -h, --help
           Show gnome-terminal's help.

       Any other option
           Passed as-is to gnome-terminal.

See Also

gnome-terminal(1), xterm(1), Debian Policy <https://www.debian.org/doc/debian-policy/>.

gnome-terminal 3.56.0-1ubuntu1                     2025-03-17                          GNOME-TERMINAL.WRAPPER(1)

Standards

       Debian Policy §11.8.3 "Packages providing a terminal emulator".

       For more details please see <https://www.debian.org/doc/debian-policy/ch-customized-programs.html>.

       This  is  a  Debian-specific  interface  and should not be expected to be available on non-Debian-derived
       systems.

Synopsis

x-terminal-emulator [-TTITLE] [-eCOMMAND [ARGUMENTS...]]

See Also