Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
XFCE4-TERMINAL(1)		      Xfce		       XFCE4-TERMINAL(1)

NAME
     xfce4-terminal - A Terminal emulator for X

SYNOPSIS
     xfce4-terminal [OPTION...]

DESCRIPTION
     xfce4-terminal  is  what is known as an X terminal emulator, often referred
     to as terminal or shell. It provides an  equivalent  to  the  old-fashioned
     text screen on your desktop, but one which can easily share the screen with
     other  graphical  applications.  Windows users may already be familiar with
     the MS-DOS Prompt utility, which has the analogous function of  offering  a
     DOS  command-line	under  Windows, though one should note that the UNIX CLI
     offer far more power and ease of use than does DOS.

     xfce4-terminal emulates the xterm application developed by  the  X  Consor-
     tium.  In	turn,  the xterm application emulates the DEC VT102 terminal and
     also supports the DEC VT220 escape sequences. An escape sequence is  a  se-
     ries  of  characters  that start with the Esc character. xfce4-terminal ac-
     cepts all of the escape sequences that the VT102 and  VT220  terminals  use
     for functions such as to position the cursor and to clear the screen.

OPTIONS
   Option Summary
     Here  is a summary of all the options, grouped by type. Explanations are in
     the following sections.

     General Options
	 -h, --help; -V, --version; --disable-server;  --color-table;  --prefer-
	 ences; --default-display=display; --default-working-directory=directory

     Window or Tab Separators
	 --tab; --window

     Tab Options
	 -x,  --execute; -e, --command=command; -T, --title=title; --dynamic-ti-
	 tle-mode=mode;  --initial-title=title;   --working-directory=directory;
	 -H, --hold; --active-tab; --color-text=color; --color-bg=color

     Window Options
	 --display=display;   --drop-down;   --geometry=geometry;   --role=role;
	 --startup-id=string; -I, --icon=icon; --fullscreen; --maximize; --mini-
	 mize; --show-menubar, --hide-menubar;	--show-borders,  --hide-borders;
	 --show-toolbar,   --hide-toolbar;  --show-scrollbar,  --hide-scrollbar;
	 --font=font; --zoom=zoom; --class=class

   General Options
     -h, --help
	 List the various command line options supported by  xfce4-terminal  and
	 exit.

     -V, --version
	 Display version information and exit.

     --disable-server
	 Do  not  register with the D-BUS session message bus. Run this terminal
	 in its own process.

     --color-table
	 Echo the color codes.

     --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.

   Window or Tab Separators
     --tab
	 Open a new tab in the last specified window. More than one of these op-
	 tions 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 un-
     til 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 cre-
     ated 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.

   Tab Options
     -x, --execute
	 Execute the remainder of the command line inside the terminal.

     -e, --command=command
	 Execute command inside the terminal.

     -T, --title=title
	 Set title as the window title for the terminal (ignores dynamically-set
	 title).

     --dynamic-title-mode=mode
	 Set  mode  as	the dynamically-set title mode for the terminal, one of:
	 'replace', 'before', 'after', 'none'.

     --initial-title=title
	 Set title as the initial window title for the terminal (respects dynam-
	 ically-set title).

     --working-directory=directory
	 Set directory as the working directory for the terminal.

     -H, --hold
	 Causes the terminal to be kept around after the child command has  ter-
	 minated.

     --active-tab
	 Makes	the terminal active: useful when a terminal window contains mul-
	 tiple tabs.

     --color-text=color
	 Set color as the text color for the terminal per the following specifi-
	 cation: https://docs.gtk.org/gdk3/method.RGBA.parse.html

     --color-bg=color
	 Set color as the background color for the terminal  per  the  following
	 specification: https://docs.gtk.org/gdk3/method.RGBA.parse.html

   Window Options
     --display=display
	 X display to use for the last- specified window.

     --drop-down
	 Will start the window in drop-down mode (also called a Quake-style ter-
	 minal).  This will only apply to the first window started with this op-
	 tion. It is advised to bind this to a shortcut in the keyboard  prefer-
	 ences.

     --geometry=geometry
	 Sets  the  geometry of the last-specified window to geometry. Read X(7)
	 for more information on how to specify window geometries.

     --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 com-
	 mand 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 com-
	 mand line.

     --minimize
	 Set the last-specified window into minimized mode; applies to only  one
	 window;  can be specified once for each window you create from the com-
	 mand 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 com-
	 mand 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  com-
	 mand line.

     --show-scrollbar
	 Turn on the scrollbar for the last-specified window. Scrollbar position
	 is  taken  from the settings; if position is None, the default position
	 is Right side. Applies to only one window. Can be  specified  once  for
	 each window you create from the command line.

     --hide-scrollbar
	 Turn  off  the scrollbar for the last-specified window. Applies to only
	 one window. Can be specified once for each window you create  from  the
	 command line.

     --font=font
	 Set the terminal font.

     --zoom=zoom
	 Set the zoom level: the font size will be multiplied by this level. The
	 range	is  from -7 to 7, default is 0. Each step multiplies the size by
	 1.2, i.e. level 7 is 3.5831808 (1.2^7) times larger  than  the  default
	 size.

     --class=class
	 Set  the  window manager class of all terminal windows. Controls window
	 grouping in the panel. If a terminal instance is already open, requires
	 --disable-server to be set.

EXAMPLES
     xfce4-terminal --geometry 80x40 --command mutt --tab --command mc
	 Opens a new terminal window with a geometry of 80 columns and	40  rows
	 and  two  tabs  in it, where the first tab runs mutt and the second tab
	 runs mc.

ENVIRONMENT
     xfce4-terminal   uses   the   Basedir   Specification   as    defined    on
     Freedesktop.org[1]  to  locate its data and configuration files. This means
     that file locations will be specified as a path relative to the directories
     described in the specification.

     ${XDG_CONFIG_HOME}
	 The first base directory to look for configuration  files.  By  default
	 this is set to ~/.config/.

     ${XDG_CONFIG_DIRS}
	 A  colon  separated list of base directories that contain configuration
	 data. By default the application will look in	${sysconfdir}/xdg/.  The
	 value	of  ${sysconfdir}  depends on how the program was build and will
	 often be /etc/ for binary packages.

     ${XDG_DATA_HOME}
	 The root for all user-specific data files. By default this  is  set  to
	 ~/.local/share/.

     ${XDG_DATA_DIRS}
	 A  set  of  preference  ordered base directories relative to which data
	 files should be searched in addition to the ${XDG_DATA_HOME}  base  di-
	 rectory. The directories should be separated with a colon.

FILES
     ${XDG_CONFIG_HOME}/xfce4/terminal/accels.scm
	 This  is  the location of the keyboard shortcuts configuration file for
	 xfce4-terminal. Editing this file  allows  one  to  modify  or  disable
	 shortcuts for the supported actions.

BUGS
     Please report any bugs to https://gitlab.xfce.org/apps/xfce4-terminal/-/is-
     sues.

SEE ALSO
     bash(1), X(7)

AUTHORS
     Sergios - Anestis Kefalidis <sergioskefalidis@gmail.com>
	 Developer

     Igor Zakharov <f2404@yandex.ru>
	 Developer

     Nick Schermer <nick@xfce.org>
	 Developer

     Benedikt Meurer <benny@xfce.org>
     Software developer, os-cillation, System development,
	 Developer

NOTES
      1. Freedesktop.org
	 http://freedesktop.org/

xfce4-terminal			   08/27/2026		       XFCE4-TERMINAL(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=xfce4-terminal&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help