.\" {{{1 Macros...de Vb \" Begin verbatim text (stolen from man files generated by pod2man). Bd -literal -offset 4n...de Ve \" End verbatim text. Ed. Pp...\" Boolean options.de BO.It Fl \\$1 Ns | Ns Cm +\\$1...\" Resource list.de RL. It Cm \\$1. Ar \\$2.....\" {{{1 manpage header...Dd January 10, 2006.Os X "Version 11".Dt mrxvt 1...Sh NAME \"{{{1...Nm mrxvt.Nd A tabbed VT102 terminal emulator for X Window System...Sh SYNOPSIS \"{{{1...Nm.Op options.Op Fl e Ar cmd...Sh DESCRIPTION \"{{{1...Bd -filledThe.Nmprogram is a terminal emulator for X Window System. It provides.Tn DEC VT102compatible terminals for programs that cannot use the window system directly..Pp.Nmis based on.Xr rxvt 1version 2.7.11 CVS, and features most of functionalityof rxvt, with a few major enhancements (namely multiple tabs, and transparency). Like rxvt,.Nmaims to be light, fast, flexible and desktop independent, thus KDE or GNOME are not required..PpThe primary features of.Nminclude (but are not limited to) multiple tabs, dynamically changeable tab titles, customisable command for each tab, input broadcasting, true translucent window, fast pseudo transparency with tinting, user supplied background images (XPM, JPEG, PNG), off-focus fading, text shadow, multiple style (NeXT, Rxvt, Xterm, SGI, Plain) scrollbars, XIM, multi-language support (Chinese, Korean, Japanese), freetype font and logging..Pp.The default.Nmbehaviour can be set using the resource configuration file.Pa ~/.mrxvtrc .For backward compatibility, if.Pa ~/.mrxvtrcis not found,.Nmtries to load configuration settings from the files.Pa ~/.Xdefaultsor.Pa ~/.Xresources .Alternately, you can specify which config file to load using the.Fl cfcommand line option..Ed...Sh OPTIONS \"{{{1...Bd -filledThis section describes the commandline options.Nmaccepts. To disable an option, prefix it with an.Sq Em +instead of a.Sq Em -Most options can be set from your.Pa ~/.mrxvtrcfile using the option name listed in brackets as.Op Cm option_name .The option name can also be used as a "long option" from the command line (i.e. by prefixing it with .Sq Em --or.Sq Em ++as appropriate. For example.Vbmrxvt -tr -shade 85 +trt.Veis the same as.Vbmrxvt --transparent --shading 85 ++transparentTabbar.Vewhich is the same as putting the lines.VbMrxvt.transparent:		TrueMrxvt.shading:			85Mrxvt.transaprentTabbar:	False.Vein your.Pa ~/.mrxvtrc ..Pp.All options are case sensitive. Some options are similar to those of other terminals, so if you find the explanation given here insufficient, we strongly recommend you look in the.Xr rxvt 1and.Xr xterm 1manpages..Ed.\" {{{2 terminal name and display options.Ss Terminal name and display options.Bd -filled.Bl -tag -width 4n..It Fl display Ns | Ns Fl d Ar displaynameX display name, the X server to contact..It Fl geometry Ns | Ns Fl g Ar geometrygeometry at startup.Op Cm geometry..It Fl ic Ar file Ns Op Ns ; Ns Ar geometryapplication icon file..Op appIcon..BO iconicstart iconic.Op Cm iconic..It Fl in Ar nameIcon name for window.Op Cm iconName..It Fl name Ar nameClient instance, icon, and title strings.Op Cm clientName ...It Fl title Ar stringtitle name of the window.Op Cm title..It Fl tn Ar termnameThe type of terminal.Nmshould emulate. The value of the TERM environment variable is set to this value for all child processes launched by.Nm .Note that rxvt and most rxvt clones including .Nm Ns ,have slightly different terminal capabilities than those of xterm(1). Thus.Nmwill not always work properly with the terminal set to.Ar xterm ,and we recommend setting this value to.Ar rxvtinstead. However some systems have incorrect (or even missing) terminfo(1) or termcap(1) entries for the terminal.Ar rxvt .If you experience problems with this, the ideal solution would be to correct your systems termcap and terminfo entries. If you are unable to do that, then you can try setting your terminal to.Ar xtermand hope everything works properly..Op Cm termName..El.Ed.\" {{{2 transparency.Ss Transparency related options.Bd -filled.Bl -tag -width 4n..It Fl o Ar %dTranslucent window (true transparent) background opacity degree..Ar %dis an integer between 0 and 100. This option needs translucent support by the X server, e.g., Xorg 6.8, and overrides the pseudo-transparency..Op Cm opacity..It Fl od %dTranslucent window opacity degree increase/decrease interval..Ar %dis an integer between 0 and 100.Op Cm opacityDegree..BO trEnable / disable background pseudo-transparency. To use this feature you must set your desktop wallpaper using an Esetroot compatible program ( i.e. a program that publishes the wallpaper using the.Tn _XROOTPMAP_IDatom). Some programs that will do this are.Xr Esetroot 1 ,.Xr feh 1 ,.Xr fvwm-root 1with the.Sq Cm --retain-pixmapoption, or KDE. Note: To use your precious.Cm backgroundFade , tintingor.Cm shadingoptions, you MUST set the desktop wallpaper in an Esetroot way..Op Cm transparent..BO trfIf you choose NOT to set the background in an Esetroot compatible way, then you can still have transparency using this option. (You must also enable the.Cm transparentoption). Background changes made by FvwmBacker, xsetbg (xli) or Esetroot compatible programs, will be automatically detected. However changes made by.Xr xv 1 ,.Xr xsetroot 1or other non-Esetroot compatible programs will not be detected. If you're hell bent on non-Esetroot compatible programs to set your background, then do something like.Vbxsetroot -solid "#202040" && fvwm-root -d.VeNote: To use your precious.Cm backgroundFade , tintingor.Cm shadingoptions, you MUST set the desktop wallpaper in an Esetroot way..Op Cm transparentForce..BO trmEnable / disable pseudo-transparent menubar. Pseudo-transparency must be turned on..Op Cm transparentMenubar..BO trsEnable / disable pseudo-transparent scrollbar. Pseudo-transparency must be turned on..Op Cm transparentScrollbar..BO trtEnable / disable pseudo-transparent tabbar. Pseudo-transparency must be turned on..Op Cm transparentTabbar..El.Ed.\" {{{2 background.Ss Background image related options.Bd -filled.Bl -tag -width 4n..It Fl mbpixmap Ar file Ns Op Ns ; Ns Ar geometryMenubar background image. Pseudo-transparency must be turned off..Op Cm menubarPixmap..It Fl pixmap Ar file Ns Op Ns ; Ns Ar geometryBackground image for all terminals if not set individually. Pseudo-transparency must be turned off..Op Cm Pixmap..It Fl sbpixmap Ar file Ns Op Ns ; Ns Ar geometryScrollbar background image. Pseudo transparency must be turned off..Op Cm scrollbarPixmap..It Fl tbpixmap Ar file Ns Op Ns ; Ns Ar geometryTabbar background image. Pseudo transparency must be turned off..Op Cm tabbarPixmap..BO tupixmapApply tabbar background image to tabs..Op Cm tabUsePixmap..It pixmap Ar file Ns Op Ns ; Ns Ar geometryBackground image for the terminal window. Pseudo-transparency must be turned off..Op Cm Pixmap..El.Ed.\" {{{2 scrolling.Ss Scrolling related options.Bd -filled.Bl -tag -width 4n..BO jEnable / disable jump scrolling. Normally, text is scrolled one line at a time; this option allows.Nmto move multiple lines at a time so that it does not fall as far behind. Its use is strongly recommended since it makes.Nmmuch faster when scanning through large amounts of text..Op Cm jumpScroll..BO mpscroll one page when press mouse wheel button.Op Cm mouseWheelScrollPage..It Fl sa Ar modeScrollbar alignment (.Ar top | bottom ).Op Cm scrollbarAlign..BO sbHide / show scrollbar.Op Cm scrollBar..It Fl sbt Ar widthScrollbar thickness/width.Op Cm scrollbarThickness..BO siInhibit scrolling on tty output..Op Cm scrollTtyOutputInhibit..BO skscroll-on-keypress.Op Cm scrollTtyKeypress..It Fl sl Ar nThe number of scrolled lines to save (for all tabs) if not set individually. The maximal number of saved lines is 65535..Op Cm saveLines..BO srScrollbar on right.Op Cm scrollbarRight..It Fl ss Ar modeScrollbar style..Ar modeshould be one of.Ar plain , xterm , rxvt , nextor.Ar sgi ..Op Cm scrollbarStyle..BO stDraw floating scrollbar (i.e. without a trough)..Op Cm scrollbarFloating..BO swScroll synchronusly with buffer. Normally.Nmdoes not keep the screen completely up to date while scrolling. This allows.Nmto run faster when network latencies are very high and is typically useful when running across a very large internet or many gateways..Op Cm scrollWithBuffer..It sl Ar nNumber of lines to save in the scroll back buffer. Max 65535..Op saveLines..El.Ed.\" {{{2 color.Ss Color related options.Bd -filled.Bl -tag -width 4n..It Fl bg Ar colorBackground color.Op Cm background..It Fl bd Ar colorBorder color.Op Cm borderColor..It Fl bgfade Ar %d(Obsolete) Make colors.Ar %ddarker for background image or pseudo-transparent background..Ar %dis an integer between 0 and 100. This is like tinting the background with black. This option is obsolete, and you should use the.Cm tintand.Cm shadeoptions instead..Op Cm backgroundFade..It Fl bgtype Ar typeTransformation type for background pixmap (not implemented yet)..It Fl cr Ar colorcolor of cursor.Op Cm cursorColor..It Fl fade Ar %dMake colors.Ar %ddarker when mrxvt looses focus..Ar %dis an integer between 0 and 100.Op Cm fading..It Fl fg Ar colorForeground color..Op Cm foreground..It Fl itabbg Ar colorBackground color of inactive tabs and tabbar..Op Cm itabBackground..It Fl itabfg Ar colorForeground color of inactive tabs..Op Cm itabForeground..It Fl pr Ar colorcolor of pointer.Op Cm pointerColor..It Fl shade Ar %dShade background to.Ar %ddegree when tinting the background..Ar %dis an integer between 0 and 100. You must also define a color using the.Cm tintoption. When compiled with XRender support, the tabbar, menubar and scroll bar are tinted with their respective background colors for pseudo-transparent terminals..Op Cm shading..It Fl tabbg Ar colorbackground color of active tab..Op Cm tabBackground..It Fl tabfg Ar colorForeground color of tabbar.Op Cm tabForeground..It Fl tint Ar colorColor tinted on background image or pseudo-transparent background. This works differently depending on the tint type: With XRender (when compiled with --enable-xrender),.Ar coloris the color you want to tint your background to. The brighter the color, the less transparent it will be (regardless of the shade degree specified by.Fl shade ) .For example, if you want your background tinted black, set.Ar colorto.Sq #000000 ,however if you want a white tinted transparent background, set.Ar colorto some level of grey (e.g..Sq #808080 )but NOT to