XTerm::Conf - change configuration of a running xterm
use XTerm::Conf; xterm_conf(-fg => "white", -bg => "black", -title => "Hello, world", ...);
XTerm::Conf provides functions to change some aspects of a running xterm and compatible terminal emulators (e.g. rxvt or urxvt).
The xterm_conf function (exported by default) checks first if the current terminal looks like an xterm, rxvt or urxvt (by looking at the TERM environment variable) and prints the escape sequences for the following options:
TERM
-n string
-iconname string
Change name of the associated X11 icon.
-T string
-title string
Change xterm's title name.
-fg color
-foreground color
Change text color. You can use either X11 named colors or the #rrggbb notation.
#rrggbb
-bg color
-background color
Change background color.
-cr color
-textcursor color
Change cursor color.
-ms color
-mousefg color
-mouseforeground color
Change the foreground color of the mouse pointer.
-mousebg color
-mousebackground color
Change the background/border color of the mouse pointer.
-tekfg color
-tekforeground color
Change foreground color of Tek window.
-tekbg color
-tekbackground color
Change background color of Tek window.
-highlightcolor color
Change selection background color.
-bell
Ring the bell (may be visual or audible, depending on configuration).
-cs utf-8|iso-8859-1
Switch charset. Valid values are utf-8 and iso-8859-1.
utf-8
iso-8859-1
-fullreset
Perform a full reset.
-softreset
Perform a soft reset.
-[no]smoothscroll
Turn smooth scrolling on or off (which is probably the opposite of jump scroll, see xterm(1)).
-[no]reverse
-[no]reversevideo
Turn reverse video on or off.
-[no]origin
???
-[no]wraparound
-[no]autorepeat
Turn auto repeat on or off.
-[no]formfeed
-[no]showcursor
Show or hide the cursor.
-[no]showscrollbar
rxvt only?
-[no]tektronix
Show the Tek window and switch to Tek mode (XXX -notektronix does not seem to work).
-notektronix
-[no]marginbell
-[no]reversewraparound
-[no]backsendsdelete
-[no]bottomscrolltty
-[no]bottomscrollkey
-[no]metasendsesc
-[no]metasendsescape
-scrollregion ...
-deiconify
Deiconify an iconified xterm window.
-iconify
Iconify the xterm window.
-geometry geometry
Change the geometry of the xterm window. The geometry is in the usual X11 notation widthxheight+left+top. The numbers are in pixels. The width and height may be suffixed with a c, which means that the numbers are interpreted as characters.
c
-raise
Raise the xterm window.
-lower
Lower the xterm window
-refresh
-x11refresh
Force a X11 refresh.
-maximize
Maximize the xterm window.
-unmaximize
Restore to the state before maximization.
-xproperty ...
-x11property ...
-font number
Change font. Number may be from 0 (default font) to 6 (usually the largest font, but this could be changed using Xdefaults).
-nextfont
Use the next font in list.
-prevfont
Use the previous font in list.
-report what
Report to STDOUT:
STDOUT
status
Return 1.
cursorpos
The cursor position (line column).
windowpos
The XTerm window position (x y).
geometry
The geometry of the window in pixels (width height).
cgeometry
The geometry of the window in characters (widthxheight).
x
cscreengeom
iconname
The icon name. This may only be available if the allowWindowOps resource is set to true (e.g. using
xterm -xrm "*allowWindowOps:true"
). On some operating systems and some terminal emulators (most notable rxvt on Debian/Ubuntu systems) this operation may be forbidden completely.
rxvt
title
The title name. See "iconname" for possible restrictions on availability.
-debugreport
If set together with a -report ... option, then print the returned escape sequence as numbers to STDOUT (as an debugging aid).
-report ...
-resize integer
xterm_conf_string just returns a string with the escape sequences for the given options (same as in xterm_conf). No terminal check will be performed here.
xterm_conf_string may be exported.
Return a true value if the given term, or if missing, the current terminal as given by $ENV{TERM}, is supported.
$ENV{TERM}
This function may be exported.
Slaven Rezić
xterm-conf, xterm(1), rxvt(1), Term::Title.
To install XTerm::Conf, copy and paste the appropriate command in to your terminal.
cpanm
cpanm XTerm::Conf
CPAN shell
perl -MCPAN -e shell install XTerm::Conf
For more information on module installation, please visit the detailed CPAN module installation guide.