~~NOTOC~~
{{ :apps:xfce4-terminal.png?nolink|}}
====== xfce4-terminal - Command-line Options ======

  * **[[#General Options|General Options]]**
  * **[[#Window or Tab Separators|Window or Tab Separators]]**
  * **[[#Tab Options|Tab Options]]**
  * **[[#Window Options|Window 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
! <nowiki>-h, --help ; -V, --version ; --disable-server ; --color-table ; --preferences; --default-display=display ; --default-working-directory=directory</nowiki>
? Window or Tab Separators
! <nowiki>--tab ; --window</nowiki>
? Tab Options
! <nowiki>-x, --execute ; -e, --command=command ; --working-directory=directory ; -T, --title=title ; -H, --hold</nowiki>
? Window Options
! <nowiki>--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</nowiki>

----
===== 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 ''<nowiki>--window</nowiki>'' 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 ''<nowiki>--window</nowiki>'' option is encountered at which point that new window is the //last specified window//.

These options can be combined with ''[[dropdown|--drop-down]]''.

Examples (no terminal windows open):
  * ''xfce4-terminal'' -> a window with 1 tab is created
  * ''xfce4-terminal <nowiki>--tab</nowiki>'' -> a window with 2 tabs is created (since there are no open windows xfce4-terminal creates a new window)
  * ''xfce4-terminal <nowiki>--tab --window</nowiki>'' -> a window with 2 tabs and a window with 1 tab are created
  * ''xfce4-terminal <nowiki>--drop-down --tab --window --tab --tab</nowiki>'' -> 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 <nowiki>--tab</nowiki>'' -> a tab is added to the existing active terminal window (because there is 1 open window which represents the current active window)
  * ''xfce4-terminal <nowiki>--tab --window</nowiki>'' -> 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 [[http://www.xfree86.org/current/X.7.html#sect6|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]]
----
[[:apps:xfce4-terminal:start:|Return to xfce4-terminal Main Documentation Page]]