Xfce Wiki

Sub domains
 

xfce4-terminal - Command-line Options


Here is a summary of all the available command-line options for xfce4-terminal, grouped by type. Explanations are in the following sections.

General Options
-h, --help ; -V, --version ; --disable-server ; --color-table ; --preferences; --default-display=display ; --default-working-directory=directory
Window or Tab Separators
--tab ; --window
Tab Options
-x, --execute ; -e, --command=command ; --working-directory=directory ; -T, --title=title ; -H, --hold
Window Options
--display=display ; --geometry=geometry ; --role=role ; --startup-id=string ; -I, --icon=icon ; --fullscreen ; --maximize ; --show-menubar , --hide-menubar ; --show-borders , --hide-borders ; --show-toolbar , --hide-toolbar

General Options

-h, --help
List the various command line options supported by Terminal and exit
-V, --version
Display version information and exit
--disable-server
Do not register with the D-BUS session message bus. This ensures the new window will run in a new process, not trying to open a new window from a running instance.
--color-table
Print a table showing all colors in the color palette.
--preferences
Open the xfce4-terminal preferences window.
--default-display=display
Default X display to use.
--default-working-directory=directory
Set directory as the default working directory for the terminal

Back to Top


Window or Tab Separators

--tab
Open a new tab in the last specified window. More than one of these options can be provided, each opening an additional tab.
--window
Open a new window containing one tab. More than one of these options can be provided.

If there is an active window, the last specified window is that window until a --window option is encountered at which point that new window is the last specified window. If there is no active window, the last specified window is the window created by xfce4-terminal until a --window option is encountered at which point that new window is the last specified window.

These options can be combined with --drop-down.

Examples (no terminal windows open):

  • xfce4-terminal → a window with 1 tab is created
  • xfce4-terminal --tab → a window with 2 tabs is created (since there are no open windows xfce4-terminal creates a new window)
  • xfce4-terminal --tab --window → a window with 2 tabs and a window with 1 tab are created
  • xfce4-terminal --drop-down --tab --window --tab --tab → a dropdown window with 2 tabs and a window with 3 tabs are created

Examples (at least one terminal window is open):

  • xfce4-terminal → a window with 1 tab is created
  • xfce4-terminal --tab → a tab is added to the existing active terminal window (because there is 1 open window which represents the current active window)
  • xfce4-terminal --tab --window → a tab is added to the existing active terminal window and a new window with 1 tab is created

Back to Top


Tab Options

-x, --execute
Execute the remainder of the command line inside the terminal
-e, --command=command
Execute command inside the terminal
--working-directory=directory
Set directory as the working directory for the terminal
-T, --title=title
Set title as the initial window title for the terminal
-H, --hold
Causes the terminal to be kept around after the child command has terminated

Back to Top


Window Options

--display=display
X display to use for the last- specified window.
--geometry=geometry
Sets the geometry of the last-specified window to geometry. You can use this to set the columns and rows with the format COLUMNSxROWS, but also to set a position +XOFF+YOFF or both COLUMNSxROWS+XOFF+YOFF. The offsets can also be negative to define a right or bottom offset. See also X(7).
--role=role
Sets the window role of the last-specified window to role. Applies to only one window and can be specified once for each window you create from the command line. The role is a unique identifier for the window to be used when restoring a session.
--startup-id=string
Specifies the startup notification id for the last-specified window. Used internally to forward the startup notification id when using the D-BUS service.
-I, --icon=icon
Set the terminal's icon as an icon name or filename.
--fullscreen
Set the last-specified window into fullscreen mode; applies to only one window; can be specified once for each window you create from the command line.
--maximize
Set the last-specified window into maximized mode; applies to only one window; can be specified once for each window you create from the command line.
--show-menubar
Turn on the menubar for the last-specified window. Can be specified once for each window you create from the command line.
--hide-menubar
Turn off the menubar for the last-specified window. Can be specified once for each window you create from the command line.
--show-borders
Turn on the window decorations for the last-specified window. Applies to only one window. Can be specified once for each window you create from the command line.
--hide-borders
Turn off the window decorations for the last-specified window. Applies to only one window. Can be specified once for each window you create from the command line.
--show-toolbar
Turn on the toolbar for the last-specified window. Applies to only one window. Can be specified once for each window you create from the command line.
--hide-toolbar
Turn off the toolbar for the last-specified window. Applies to only one window. Can be specified once for each window you create from the command line.

Back to Top


Back to xfce4-terminal main page