gnome-terminal.wrapper(1)

Usage

x-terminal-emulator [-T TITLE] [-e COMMAND [ARGUMENTS ...]]

Overview

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.

Options

Standard x-terminal-emulator options

These options work as specified in Debian Policy §11.8.3.

-T TITLE: Set the title of the terminal to TITLE, as specified in Debian Policy. Equivalent to xterm -T TITLE or gnome-terminal -t TITLE.

-e COMMAND [ARGUMENTS...]

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

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 -c COMMAND. 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 -- COMMAND ARGUMENTS.

Non-standard options

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.

-display X11DISPLAY

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.

-geometry COLSxROWS+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.

-n ICON: Accepted for command-line compatibility with xterm(1), but ignored.

-name NAME: 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.

Exit status

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

Examples

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=

Releases

11 releases since Debian 3.1 (Sarge); the text changed 8 times.

-T since Debian 13 (Trixie); -display since Debian 13 (Trixie); -geometry since Debian 13 (Trixie); -h since Debian 11 (Bullseye); -ls since Debian 13 (Trixie); -n since Debian 13 (Trixie); -name since Debian 13 (Trixie).

--active until Debian 12 (Bookworm); --class until Debian 12 (Bookworm); --command until Debian 12 (Bookworm); --disable-factory until Debian 8 (Jessie); --display until Debian 12 (Bookworm); --execute until Debian 10 (Buster); --fd until Debian 12 (Bookworm); --full-screen until Debian 12 (Bookworm); --g-fatal-warnings until Debian 12 (Bookworm); --gdk-debug until Debian 12 (Bookworm); --gdk-no-debug until Debian 12 (Bookworm); --geometry until Debian 12 (Bookworm); --gtk-debug until Debian 12 (Bookworm); --gtk-module until Debian 12 (Bookworm); --gtk-no-debug until Debian 12 (Bookworm); --help-all until Debian 12 (Bookworm); --help-gtk until Debian 12 (Bookworm); --help-terminal until Debian 12 (Bookworm); --help-terminal-options until Debian 12 (Bookworm); --help-window-options until Debian 12 (Bookworm); --hide-menubar until Debian 12 (Bookworm); --load-config until Debian 12 (Bookworm); --maximize until Debian 12 (Bookworm); --name until Debian 12 (Bookworm); --preferences until Debian 12 (Bookworm); --print-environment until Debian 12 (Bookworm); --profile until Debian 12 (Bookworm); --quiet until Debian 12 (Bookworm); --role until Debian 12 (Bookworm); --show-menubar until Debian 12 (Bookworm); --tab until Debian 12 (Bookworm); --tab-with-profile until Debian 10 (Buster); --tab-with-profile-internal-id until Debian 10 (Buster); --title until Debian 12 (Bookworm); --usage until Debian 8 (Jessie); --verbose until Debian 12 (Bookworm); --wait until Debian 12 (Bookworm); --window until Debian 12 (Bookworm); --window-with-profile until Debian 10 (Buster); --window-with-profile-internal-id until Debian 10 (Buster); --working-directory until Debian 12 (Bookworm); --zoom until Debian 12 (Bookworm); -? until Debian 10 (Buster); -e until Debian 12 (Bookworm); -p until Debian 12 (Bookworm); -q until Debian 12 (Bookworm); -t until Debian 12 (Bookworm); -v until Debian 12 (Bookworm); -x until Debian 10 (Buster).