Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages

Manual Reference Pages  -  XTERM::CONF (3)

.ds Aq ’


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

xterm_conf(options ...)

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:
-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.
-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.
-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]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).
-[no]marginbell ???
-[no]reversewraparound ???
-[no]backsendsdelete ???
-[no]bottomscrolltty rxvt only?
-[no]bottomscrollkey rxvt only?
-[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.
-raise Raise the xterm window.
-lower Lower the xterm window
-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:
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).
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.

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).
-resize integer ???

xterm_conf_string(options ...)

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.

This function may be exported.


Slaven ReziX


xterm-conf, xterm(1), rxvt(1), Term::Title.
Search for    or go to Top of page |  Section 3 |  Main Index

perl v5.20.3 XTERM::CONF (3) 2015-01-12

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.