man-pages/man1/xfce4-terminal.1.html
2021-03-31 01:06:50 +01:00

570 lines
14 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of XFCE4-TERMINAL</TITLE>
</HEAD><BODY>
<H1>XFCE4-TERMINAL</H1>
Section: Xfce (1)<BR>Updated: 12/27/2019<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
xfce4-terminal - A Terminal emulator for X
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<DL COMPACT>
<DT id="1">
<B>xfce4-terminal</B> [OPTION...]
</DL>
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<P>
<DD>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.
<P>
xfce4-terminal emulates the
xterm
application developed by the X Consortium. In turn, the
xterm
application emulates the DEC VT102 terminal and also supports the DEC VT220 escape sequences. An escape sequence is a series of characters that start with the
Esc
character. xfce4-terminal accepts 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.
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>
<A NAME="lbAF">&nbsp;</A>
<H3>Option Summary</H3>
<P>
Here is a summary of all the options, grouped by type. Explanations are in the following sections.
<P>
General Options
<DL COMPACT><DT id="2"><DD>
<B>-h</B>, <B>--help</B>;
<B>-V</B>, <B>--version</B>;
<B>--disable-server</B>;
<B>--color-table</B>;
<B>--default-display=</B><B></B><I>display</I>;
<B>--default-working-directory=</B><B></B><I>directory</I>
</DL>
<P>
Window or Tab Separators
<DL COMPACT><DT id="3"><DD>
<B>--tab</B>;
<B>--window</B>
</DL>
<P>
Tab Options
<DL COMPACT><DT id="4"><DD>
<B>-x</B>, <B>--execute</B>;
<B>-e</B>, <B>--command=</B><B></B><I>command</I>;
<B>-T</B>, <B>--title=</B><B></B><I>title</I>;
<B>--dynamic-title-mode=</B><B></B><I>mode</I>;
<B>--initial-title=</B><B></B><I>title</I>;
<B>--working-directory=</B><B></B><I>directory</I>;
<B>-H</B>, <B>--hold</B>;
<B>--active-tab</B>;
<B>--color-text=</B><B></B><I>color</I>;
<B>--color-bg=</B><B></B><I>color</I>
</DL>
<P>
Window Options
<DL COMPACT><DT id="5"><DD>
<B>--display=</B><B></B><I>display</I>;
<B>--drop-down</B>;
<B>--geometry=</B><B></B><I>geometry</I>;
<B>--role=</B><B></B><I>role</I>;
<B>--startup-id=</B><B></B><I>string</I>;
<B>-I, --icon=</B><B></B><I>icon</I>;
<B>--fullscreen</B>;
<B>--maximize</B>;
<B>--minimize</B>;
<B>--show-menubar</B>,
<B>--hide-menubar</B>;
<B>--show-borders</B>,
<B>--hide-borders</B>;
<B>--show-toolbar</B>,
<B>--hide-toolbar</B>;
<B>--show-scrollbar</B>,
<B>--hide-scrollbar</B>;
<B>--font=</B><B></B><I>font</I>;
<B>--zoom=</B><B></B><I>zoom</I>
</DL>
<A NAME="lbAG">&nbsp;</A>
<H3>General Options</H3>
<P>
<B>-h</B>, <B>--help</B>
<DL COMPACT><DT id="6"><DD>
List the various command line options supported by xfce4-terminal and exit
</DL>
<P>
<B>-V</B>, <B>--version</B>
<DL COMPACT><DT id="7"><DD>
Display version information and exit
</DL>
<P>
<B>--disable-server</B>
<DL COMPACT><DT id="8"><DD>
Do not register with the D-BUS session message bus
</DL>
<P>
<B>--color-table</B>
<DL COMPACT><DT id="9"><DD>
Echo the color codes
</DL>
<P>
<B>--default-display=</B><B></B><I>display</I>
<DL COMPACT><DT id="10"><DD>
Default X display to use.
</DL>
<P>
<B>--default-working-directory=</B><B></B><I>directory</I>
<DL COMPACT><DT id="11"><DD>
Set
<I>directory</I>
as the default working directory for the terminal
</DL>
<A NAME="lbAH">&nbsp;</A>
<H3>Window or Tab Separators</H3>
<P>
<B>--tab</B>
<DL COMPACT><DT id="12"><DD>
Open a new tab in the last-specified window; more than one of these options can be provided.
<P>
If you use this as the first option, without --window separators, the last window will be re-used.
</DL>
<P>
<B>--window</B>
<DL COMPACT><DT id="13"><DD>
Open a new window containing one tab; more than one of these options can be provided.
</DL>
<A NAME="lbAI">&nbsp;</A>
<H3>Tab Options</H3>
<P>
<B>-x</B>, <B>--execute</B>
<DL COMPACT><DT id="14"><DD>
Execute the remainder of the command line inside the terminal
</DL>
<P>
<B>-e</B>, <B>--command=</B><B></B><I>command</I>
<DL COMPACT><DT id="15"><DD>
Execute
<I>command</I>
inside the terminal
</DL>
<P>
<B>-T</B>, <B>--title=</B><B></B><I>title</I>
<DL COMPACT><DT id="16"><DD>
Set
<I>title</I>
as the window title for the terminal (ignores dynamically-set title)
</DL>
<P>
<B>--dynamic-title-mode=</B><B></B><I>mode</I>
<DL COMPACT><DT id="17"><DD>
Set
<I>mode</I>
as the dynamically-set title mode for the terminal, one of: 'replace', 'before', 'after', 'none'
</DL>
<P>
<B>--initial-title=</B><B></B><I>title</I>
<DL COMPACT><DT id="18"><DD>
Set
<I>title</I>
as the initial window title for the terminal (respects dynamically-set title)
</DL>
<P>
<B>--working-directory=</B><B></B><I>directory</I>
<DL COMPACT><DT id="19"><DD>
Set
<I>directory</I>
as the working directory for the terminal
</DL>
<P>
<B>-H</B>, <B>--hold</B>
<DL COMPACT><DT id="20"><DD>
Causes the terminal to be kept around after the child command has terminated
</DL>
<P>
<B>--active-tab</B>
<DL COMPACT><DT id="21"><DD>
Makes the terminal active: useful when a terminal window contains multiple tabs
</DL>
<P>
<B>--color-text=</B><B></B><I>color</I>
<DL COMPACT><DT id="22"><DD>
Set
<I>color</I>
as the text color for the terminal per the following specification: <A HREF="https://developer.gnome.org/gdk3/stable/gdk3-RGBA-Colors.html#gdk-rgba-parse">https://developer.gnome.org/gdk3/stable/gdk3-RGBA-Colors.html#gdk-rgba-parse</A>
</DL>
<P>
<B>--color-bg=</B><B></B><I>color</I>
<DL COMPACT><DT id="23"><DD>
Set
<I>color</I>
as the background color for the terminal per the following specification: <A HREF="https://developer.gnome.org/gdk3/stable/gdk3-RGBA-Colors.html#gdk-rgba-parse">https://developer.gnome.org/gdk3/stable/gdk3-RGBA-Colors.html#gdk-rgba-parse</A>
</DL>
<A NAME="lbAJ">&nbsp;</A>
<H3>Window Options</H3>
<P>
<B>--display=</B><B></B><I>display</I>
<DL COMPACT><DT id="24"><DD>
X display to use for the last- specified window.
</DL>
<P>
<B>--drop-down</B>
<DL COMPACT><DT id="25"><DD>
Will start the window in drop-down mode (also called a Quake-style terminal). This will only apply to the first window started with this option. It is advised to bind this to a shortcut in the keyboard preferences.
</DL>
<P>
<B>--geometry=</B><B></B><I>geometry</I>
<DL COMPACT><DT id="26"><DD>
Sets the geometry of the last-specified window to
<I>geometry</I>. Read
<B><A HREF="/cgi-bin/man/man2html?7+X">X</A></B>(7)
for more information on how to specify window geometries.
</DL>
<P>
<B>--role=</B><B></B><I>role</I>
<DL COMPACT><DT id="27"><DD>
Sets the window role of the last-specified window to
<I>role</I>. Applies to only one window and can be specified once for each window you create from the command line. The
<I>role</I>
is a unique identifier for the window to be used when restoring a session.
</DL>
<P>
<B>--startup-id=</B><B></B><I>string</I>
<DL COMPACT><DT id="28"><DD>
Specifies the startup notification id for the last-specified window. Used internally to forward the startup notification id when using the D-BUS service.
</DL>
<P>
<B>-I, --icon=</B><B></B><I>icon</I>
<DL COMPACT><DT id="29"><DD>
Set the terminal's icon as an icon name or filename.
</DL>
<P>
<B>--fullscreen</B>
<DL COMPACT><DT id="30"><DD>
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.
</DL>
<P>
<B>--maximize</B>
<DL COMPACT><DT id="31"><DD>
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.
</DL>
<P>
<B>--minimize</B>
<DL COMPACT><DT id="32"><DD>
Set the last-specified window into minimized mode; applies to only one window; can be specified once for each window you create from the command line.
</DL>
<P>
<B>--show-menubar</B>
<DL COMPACT><DT id="33"><DD>
Turn on the menubar for the last-specified window. Can be specified once for each window you create from the command line.
</DL>
<P>
<B>--hide-menubar</B>
<DL COMPACT><DT id="34"><DD>
Turn off the menubar for the last-specified window. Can be specified once for each window you create from the command line.
</DL>
<P>
<B>--show-borders</B>
<DL COMPACT><DT id="35"><DD>
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.
</DL>
<P>
<B>--hide-borders</B>
<DL COMPACT><DT id="36"><DD>
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.
</DL>
<P>
<B>--show-toolbar</B>
<DL COMPACT><DT id="37"><DD>
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.
</DL>
<P>
<B>--hide-toolbar</B>
<DL COMPACT><DT id="38"><DD>
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.
</DL>
<P>
<B>--show-scrollbar</B>
<DL COMPACT><DT id="39"><DD>
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.
</DL>
<P>
<B>--hide-scrollbar</B>
<DL COMPACT><DT id="40"><DD>
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.
</DL>
<P>
<B>--font=</B><B></B><I>font</I>
<DL COMPACT><DT id="41"><DD>
Set the terminal font.
</DL>
<P>
<B>--zoom=</B><B></B><I>zoom</I>
<DL COMPACT><DT id="42"><DD>
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.
</DL>
<A NAME="lbAK">&nbsp;</A>
<H2>EXAMPLES</H2>
<P>
xfce4-terminal --geometry 80x40 --command mutt --tab --command mc
<DL COMPACT><DT id="43"><DD>
Opens a new terminal window with a geometry of 80 columns and 40 rows and two tabs in it, where the first tab runs
<B>mutt</B>
and the second tab runs
<B>mc</B>.
</DL>
<A NAME="lbAL">&nbsp;</A>
<H2>ENVIRONMENT</H2>
<P>
xfce4-terminal uses the Basedir Specification as defined on
m[blue]<B>Freedesktop.org</B>m[]<FONT SIZE="-2">[1]</FONT>
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.
<P>
<I>${XDG_CONFIG_HOME}</I>
<DL COMPACT><DT id="44"><DD>
The first base directory to look for configuration files. By default this is set to
~/.config/.
</DL>
<P>
<I>${XDG_CONFIG_DIRS}</I>
<DL COMPACT><DT id="45"><DD>
A colon separated list of base directories that contain configuration data. By default the application will look in
${sysconfdir}/xdg/. The value of
<I>${sysconfdir}</I>
depends on how the program was build and will often be
/etc/
for binary packages.
</DL>
<P>
<I>${XDG_DATA_HOME}</I>
<DL COMPACT><DT id="46"><DD>
The root for all user-specific data files. By default this is set to
~/.local/share/.
</DL>
<P>
<I>${XDG_DATA_DIRS}</I>
<DL COMPACT><DT id="47"><DD>
A set of preference ordered base directories relative to which data files should be searched in addition to the
<I>${XDG_DATA_HOME}</I>
base directory. The directories should be separated with a colon.
</DL>
<A NAME="lbAM">&nbsp;</A>
<H2>FILES</H2>
<P>
${XDG_CONFIG_DIRS}/xfce4/terminal/terminalrc
<DL COMPACT><DT id="48"><DD>
This is the location of the configuration file that includes the preferences which control the look and feel of xfce4-terminal. Note: any update made to the configuration file via an external editor will be picked up by xfce4-terminal instances running.
</DL>
<P>
${XDG_CONFIG_DIRS}/xfce4/terminal/accels.scm
<DL COMPACT><DT id="49"><DD>
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.
</DL>
<A NAME="lbAN">&nbsp;</A>
<H2>SEE ALSO</H2>
<P>
<B><A HREF="/cgi-bin/man/man2html?1+bash">bash</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?7+X">X</A></B>(7)
<A NAME="lbAO">&nbsp;</A>
<H2>AUTHORS</H2>
<P>
<B>Igor Zakharov</B> &lt;<A HREF="mailto:f2404@yandex.ru">f2404@yandex.ru</A>&gt;
<DL COMPACT><DT id="50"><DD>
Developer
</DL>
<P>
<B>Nick Schermer</B> &lt;<A HREF="mailto:nick@xfce.org">nick@xfce.org</A>&gt;
<DL COMPACT><DT id="51"><DD>
Developer
</DL>
<P>
<B>Benedikt Meurer</B> &lt;<A HREF="mailto:benny@xfce.org">benny@xfce.org</A>&gt;
<BR>
Software developer, os-cillation, System development,
<DL COMPACT><DT id="52"><DD>
Developer
</DL>
<A NAME="lbAP">&nbsp;</A>
<H2>NOTES</H2>
<DL COMPACT>
<DT id="53"> 1.<DD>
Freedesktop.org
<DL COMPACT><DT id="54"><DD>
<A HREF="http://freedesktop.org/">http://freedesktop.org/</A>
</DL>
<P>
</DL>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="55"><A HREF="#lbAB">NAME</A><DD>
<DT id="56"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="57"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="58"><A HREF="#lbAE">OPTIONS</A><DD>
<DL>
<DT id="59"><A HREF="#lbAF">Option Summary</A><DD>
<DT id="60"><A HREF="#lbAG">General Options</A><DD>
<DT id="61"><A HREF="#lbAH">Window or Tab Separators</A><DD>
<DT id="62"><A HREF="#lbAI">Tab Options</A><DD>
<DT id="63"><A HREF="#lbAJ">Window Options</A><DD>
</DL>
<DT id="64"><A HREF="#lbAK">EXAMPLES</A><DD>
<DT id="65"><A HREF="#lbAL">ENVIRONMENT</A><DD>
<DT id="66"><A HREF="#lbAM">FILES</A><DD>
<DT id="67"><A HREF="#lbAN">SEE ALSO</A><DD>
<DT id="68"><A HREF="#lbAO">AUTHORS</A><DD>
<DT id="69"><A HREF="#lbAP">NOTES</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:30 GMT, March 31, 2021
</BODY>
</HTML>