1mrxvt(1)                  BSD General Commands Manual                 mrxvt(1)
2

NAME

4     mrxvt — A tabbed VT102 terminal emulator for X Window System
5

SYNOPSIS

7     mrxvt [options] [-e cmd]
8

DESCRIPTION

10     The mrxvt program is a terminal emulator for X Window System. It provides
11     DEC VT102 compatible terminals for programs that cannot  use  the  window
12     system directly.
13
14     mrxvt  is based on rxvt(1) version 2.7.11 CVS, and features most of func‐
15     tionality of rxvt, with a few major enhancements (namely  multiple  tabs,
16     and  transparency). Like rxvt, mrxvt aims to be light, fast, flexible and
17     desktop independent, thus KDE or GNOME are not required.
18
19     The primary features of mrxvt include (but are not limited  to)  multiple
20     tabs,  dynamically  changeable  tab titles, customisable command for each
21     tab, input broadcasting, true  translucent  window,  fast  pseudo  trans‐
22     parency  with  tinting, user supplied background images (XPM, JPEG, PNG),
23     off-focus fading, text shadow, multiple style (NeXT,  Rxvt,  Xterm,  SGI,
24     Plain)  scrollbars,  XIM,  multi-language support (Chinese, Korean, Japa‐
25     nese), freetype font and logging.
26
27     The default mrxvt behaviour can be set using the  resource  configuration
28     file ~/.mrxvtrc.  For backward compatibility, if ~/.mrxvtrc is not found,
29     mrxvt tries to load configuration settings from the files ~/.Xdefaults or
30     ~/.Xresources.   Alternately,  you  can specify which config file to load
31     using the -cf command line option.
32

OPTIONS

34     This section describes the commandline options mrxvt accepts. To  disable
35     an option, prefix it with an ‘+’ instead of a ‘-’ Most options can be set
36     from your ~/.mrxvtrc file using the option name  listed  in  brackets  as
37     [option_name].   The option name can also be used as a "long option" from
38     the command line (i.e. by prefixing it with ‘--’ or ‘++’ as  appropriate.
39     For example
40
41         mrxvt -tr -shade 85 +trt
42
43     is the same as
44
45         mrxvt --transparent --shading 85 ++transparentTabbar
46
47     which is the same as putting the lines
48
49         Mrxvt.transparent:              True
50         Mrxvt.shading:                  85
51         Mrxvt.transparentTabbar:        False
52
53     in your ~/.mrxvtrc.
54
55     All  options  are  case  sensitive.  Some options are similar to those of
56     other terminals, so if you find the explanation given here  insufficient,
57     we strongly recommend you look in the rxvt(1) and xterm(1) manpages.
58
59   Terminal name and display options
60     -display|-d displayname
61           X display name, the X server to contact
62
63     -geometry|-g geometry
64           geometry at startup [geometry]
65
66     -ic file[;geometry]
67           application icon file.  [appIcon]
68
69     -iconic|+iconic
70           start iconic [iconic]
71
72     -in name
73           Icon name for window [iconName]
74
75     -into WinID
76           If  given an X window identifier, mrxvt will reparent its top-level
77           shell widget to that window.  This is used to  embed  mrxvt  within
78           other applications.
79
80     -name name
81           Client instance, icon, and title strings [clientName].
82
83     -title string
84           title name of the window [title]
85
86     -tn termname
87           The  type  of  terminal mrxvt should emulate. The value of the TERM
88           environment variable is set to this value for all  child  processes
89           launched  by  mrxvt.  Note that rxvt and most rxvt clones including
90           mrxvt, have slightly different terminal capabilities than those  of
91           xterm(1).  Thus mrxvt will not always work properly with the termi‐
92           nal set to xterm, and we  recommend  setting  this  value  to  rxvt
93           instead. However some systems have incorrect (or even missing) ter‐
94           minfo(1) or termcap(1) entries for the terminal rxvt.  If you expe‐
95           rience  problems  with this, the ideal solution would be to correct
96           your systems termcap and terminfo entries. If you are unable to  do
97           that,  then  you  can  try  setting your terminal to xterm and hope
98           everything works properly.  [termName]
99
100   Transparency related options
101     -o %d
102           Translucent window (true transparent)  background  opacity  degree.
103           %d  is  an integer between 0 and 100. This option needs translucent
104           support by the X server, e.g., Xorg 6.8, and overrides the  pseudo-
105           transparency.  [opacity]
106
107     -od -%d
108           Translucent  window  opacity degree increase/decrease interval.  %d
109           is an integer between 0 and 100 [opacityDegree]
110
111     -tr|+tr
112           Enable / disable background pseudo-transparency. To use  this  fea‐
113           ture you must set your desktop wallpaper using an Esetroot compati‐
114           ble program ( i.e. a program that publishes the wallpaper using the
115           _XROOTPMAP_ID   atom).   Some   programs  that  will  do  this  are
116           Esetroot(1),  feh(1),  fvwm-root(1)  with   the   ‘--retain-pixmap
117           option,  or KDE. Note: To use your precious backgroundFade, tinting
118           or shading options, you MUST set the desktop wallpaper in an  Eset‐
119           root way.  [transparent]
120
121     -trf|+trf
122           If  you  choose NOT to set the background in an Esetroot compatible
123           way, then you can still have transparency using this  option.  (You
124           must  also  enable the transparent option). Background changes made
125           by FvwmBacker, xsetbg (xli) or Esetroot compatible  programs,  will
126           be   automatically   detected.   However  changes  made  by  xv(1),
127           xsetroot(1) or other non-Esetroot compatible programs will  not  be
128           detected.  If  you're hell bent on non-Esetroot compatible programs
129           to set your background, then do something like
130
131               xsetroot -solid "#202040" && fvwm-root -d
132
133           Note: To use  your  precious  backgroundFade,  tinting  or  shading
134           options,  you  MUST  set  the desktop wallpaper in an Esetroot way.
135           [transparentForce]
136
137     -trm|+trm
138           Enable / disable  pseudo-transparent  menubar.  Pseudo-transparency
139           must be turned on.  [transparentMenubar]
140
141     -trs|+trs
142           Enable  / disable pseudo-transparent scrollbar. Pseudo-transparency
143           must be turned on.  [transparentScrollbar]
144
145     -trt|+trt
146           Enable /  disable  pseudo-transparent  tabbar.  Pseudo-transparency
147           must be turned on.  [transparentTabbar]
148
149   Background image related options
150     -mbpixmap file[;geometry]
151           Menubar  background  image. Pseudo-transparency must be turned off.
152           [menubarPixmap]
153
154     -pixmap file[;geometry]
155           Background image for all terminals if not set individually. Pseudo-
156           transparency must be turned off.  [Pixmap]
157
158     -sbpixmap file[;geometry]
159           Scrollbar background image. Pseudo transparency must be turned off.
160           [scrollbarPixmap]
161
162     -tbpixmap file[;geometry]
163           Tabbar background image. Pseudo transparency must  be  turned  off.
164           [tabbarPixmap]
165
166     -tupixmap|+tupixmap
167           Apply tabbar background image to tabs.  [tabUsePixmap]
168
169   Scrolling related options
170     -mp|+mp
171           scroll     one    page    when    press    mouse    wheel    button
172           [mouseWheelScrollPage]
173
174     -sa mode
175           Scrollbar alignment ( top | bottom) [scrollbarAlign]
176
177     -sb|+sb
178           Hide / show scrollbar [scrollBar]
179
180     -sbt width
181           Scrollbar thickness/width [scrollbarThickness]
182
183     -si|+si
184           Inhibit scrolling on tty output.  [scrollTtyOutputInhibit]
185
186     -sk|+sk
187           scroll-on-keypress [scrollTtyKeypress]
188
189     -sl n
190           The number of scrolled lines to save (for  all  tabs)  if  not  set
191           individually.   The   maximal  number  of  saved  lines  is  65535.
192           [saveLines]
193
194     -sr|+sr
195           Scrollbar on right [scrollbarRight]
196
197     -ss mode
198           Scrollbar style.  mode should be one of plain, xterm, rxvt, next or
199           sgi.  [scrollbarStyle]
200
201     -st|+st
202           Draw     floating    scrollbar    (i.e.    without    a    trough).
203           [scrollbarFloating]
204
205   Color related options
206     -bg color
207           Background color [background]
208
209     -bd color
210           Border color [borderColor]
211
212     -bgfade %d
213           (Obsolete) Make colors %d darker for background  image  or  pseudo-
214           transparent  background.   %d is an integer between 0 and 100. This
215           is like tinting the background with black. This option is obsolete,
216           and   you   should   use   the  tint  and  shade  options  instead.
217           [backgroundFade]
218
219     -bgtype type
220           Transformation type for background pixmap (not implemented yet)
221
222     -cr color
223           color of cursor [cursorColor]
224
225     -fade %d
226           Make colors %d darker when mrxvt looses focus.  %d  is  an  integer
227           between 0 and 100 [fading]
228
229     -fg color
230           Foreground color.  [foreground]
231
232     -itabbg color
233           Background color of inactive tabs and tabbar.  [itabBackground]
234
235     -itabfg color
236           Foreground color of inactive tabs.  [itabForeground]
237
238     -pr color
239           color of pointer [pointerColor]
240
241     -shade %d
242           Shade  background  to %d degree when tinting the background.  %d is
243           an integer between 0 and 100. You must also define  a  color  using
244           the  tint  option.  When compiled with XRender support, the tabbar,
245           menubar and scroll bar are tinted with their respective  background
246           colors for pseudo-transparent terminals.  [shading]
247
248     -tabbg color
249           background color of active tab.  [tabBackground]
250
251     -tabfg color
252           Foreground color of tabbar [tabForeground]
253
254     -tint color
255           Color  tinted on background image or pseudo-transparent background.
256           This works differently depending on the  tint  type:  With  XRender
257           (when  compiled with --enable-xrender), color is the color you want
258           to tint your background to. The brighter the color, the less trans‐
259           parent  it  will  be  (regardless  of the shade degree specified by
260           -shade).  For example, if you want your  background  tinted  black,
261           set  color  to ‘#000000’, however if you want a white tinted trans‐
262           parent  background,  set  color  to  some  level  of   grey   (e.g.
263           ‘#808080’) but NOT to ‘#ffffff’.
264
265           When  compiled  without  XRender  support, color works like a color
266           mask. Thus if you want a black  tinted  background,  set  color  to
267           ‘#ffffff’.
268
269           The   shade   degree  (using  -shade)  must  be  defined  as  well.
270           [tintColor]
271
272     -tinttype type
273           Function applied for background tinting (not implemented yet).
274
275     -ts color
276           color of text shadow [textShadow]
277
278     -tsm mode
279           Text shadow mode, specify shadow position of text: left |  right  |
280           top  |  bottom  |  topleft  | topright | botleft | botright | none.
281           [textShadowMode]
282
283     -txttype -type
284           Function applied for text drawing (not implemented yet)
285
286     -ufbg color
287           Default background color when the  terminal  window  looses  focus.
288           [ufBackground]
289
290   Font related options
291     -fb fontname
292           bold text X11 font name [boldFont]
293
294     -fm fontname
295           multichar text X11 font name [mfont]
296
297     -fn fontname
298           normal text X11 font name [font]
299
300     -xft|+xft
301           Use  freetype  font  instead  of X11 font. This option controls all
302           other freetype font related options.  [xft]
303
304     -xftaa|+xftaa
305           Enable / disable antialiasing of freetype  font.  This  makes  font
306           look  much nicer, but significantly slows down the rendering speed.
307           The -xft option must be enabled.  [xftAntialias]
308
309     -xftah|+xftah
310           Enable / disable autohint of freetype font. The -xft option must be
311           enabled [xftAutoHint]
312
313     -xftfm fontname
314           Multichar  text  freetype  font  family.  The  -xft  option must be
315           enabled [xftmFont]
316
317     -xftfn fontname
318           Normal text freetype font family. The -xft option must  be  enabled
319           [xftFont]
320
321     -xftga|+xftga
322           Enable  /  disable global advance of freetype font. The -xft option
323           must be enabled [xftGlobalAdvance]
324
325     -xftht|+xftht
326           Enable / disable hinting of freetype font. The -xft option must  be
327           enabled [xftHinting]
328
329     -xftmsz size
330           Freetype  multichar  font  size  in pixels. The -xft option must be
331           enabled.  [xftmSize]
332
333     -xftnfm|+xftnfm
334           Do not load freetype mfont, but use freetype font instead. This can
335           avoid  a  large  line  space if the size of font and mfont are very
336           different. The -xft option must be enabled [xftNomFont]
337
338     -xftpfn font
339           Specify a proportionally spaced font to use for drawing tab-titles.
340           If  set,  the tab bar behaves like Firefox's tab-bar: All tabs have
341           the same width, and the widths are shrunk / expanded  to  keep  the
342           number  of tabs specified by minVisibleTabs visible. The active tab
343           title is drawn in a  bold  font.  (Your  colors  are  still  used).
344           [xftPFont]
345
346     -xftrgb style
347           Freetype font sub-pixel order: rgb | bgr | vrgb | vbgr | none.  The
348           -xft option must be enabled.  [xftRGBA]
349
350     -xftslow|+xftslow
351           Display freetype multichar string in slow mode for  better  display
352           effect. The xft option must be enabled.  [xftSlowOutput]
353
354     -xftst style
355           Freetype  font  slant:  roman  | italic | oblique.  The -xft option
356           must be enabled.  [xftSlant]
357
358     -xftsz number
359           Freetype font size in  pixel.  The  -xft  option  must  be  enabled
360           [xftSize]
361
362     -xftbwt style
363           Freetype  bold  font  weight:  light  |  medium | demibold | bold |
364           black.  The -xft option must be enabled.  [xftBoldWeight]
365
366     -xftwd style
367           Freetype font width: ultracondensed | condensed | normal | expanded
368           | ultraexpanded.  The -xft option must be enabled.  [xftWidth]
369
370     -xftwt style
371           Freetype  font  weight:  light  | medium | demibold | bold | black.
372           The -xft option must be enabled.  [xftWeight]
373
374   Tabs and command related options
375     -aht  Automatically hide or show the tab bar depending on the  number  of
376           tabs.  On  startup, the tabbar is shown only if there are more than
377           one tabs present. If there is only one tab, and a new one  is  cre‐
378           ated,  then  the  tabbar is shown. If there are two tabs and one is
379           closed, then the tabbar is hidden. A keyboard shortcut used at  any
380           time to hide / show the tabbar.  [autohideTabbar]
381
382     -at|+at
383           Run  command  specified with -e on all tabs (by default the command
384           specified by -e is only used for the first tab opened). This causes
385           the  profile option command to be ignored. However a command speci‐
386           fied via the NewTab macro is honored.  [cmdAllTabs]
387
388     -bt|+bt
389           Show tabbar at bottom.  [bottomTabbar]
390
391     -e [arguments ...]
392           Specifies the program (and its command line arguments) to be run in
393           the  mrxvt  window.  By default this command is only run initially,
394           and all tabs created after startup will run the default  shell  (or
395           program  supplied  by -profile%d). This behaviour can be overridden
396           with the -at option.  [command]
397
398     -hb|+hb
399           Hide buttons in the tabbar.  [hideButtons]
400
401     -het string
402           Message to display in tabs after the  child  process  exits.  (This
403           string is escape and percent interpolated).  [holdExitText]
404
405     -heT string
406           Set the title of tabs to string after the process in the tab exits.
407           (This string is escape and percent interpolated).  [holdExitTitle]
408
409     -hold mask
410           Hold the tab open after the child process in it exits.  mask is the
411           mask of flags which control weather the tab will be held open based
412           on the exit status of the child process. If the lowest  bit  (0x01)
413           of  mask  is  set,  then the tab will always be held open after the
414           child exits. If the next bit (0x02) is set, then the tab will  only
415           be held open if the child exits abnormally (e.g. via abort(1)).  If
416           the third bit (0x04) is set, then the tab will be held open if  the
417           child exits with non-zero status.
418
419           NOTE:  In previous versions of mrxvt this was a boolean option. For
420           backward compatibility, the value of True, On, Yes will be  treated
421           as  1  and  anything  illegal will be treated as 0.  The default is
422           0x06.  [holdExit]
423
424     -ht|+ht
425           Hide tabbar on initialization [hideTabbar]
426
427     -htb|+htb
428           Highlight inactive tabs only when bell sounds. Default is to  high‐
429           light    inactive    tabs    whenever    they    produce    output.
430           [highlightTabOnBell]
431
432     -ip profiles
433           profiles is a comma separated list of profiles numbers. On  startup
434           mrxvt opens each of these profiles in a tab.  [initProfileList]
435
436     -ls|+ls
437           Indicates  that  the shell that is started in the mrxvt window will
438           be a login shell (i.e., the first character of argv[0]  will  be  a
439           dash, indicating to the shell that it should read the user's .login
440           or .profile). [loginShell]
441
442     -mtw width
443           The maximum width (in characters) of the displayed tabs.  This  can
444           not  be  larger than 40. If you use Xft, then you might want to use
445           the minVisibleTabs option instead.  [maxTabWidth]
446
447     -mvt n
448           When using xftPFont to display tabs, keep at least n tabs  visible.
449           [minVisibleTabs]
450
451     -profileN.option value
452           Set  option  to value in profile N.  When a new tab is created with
453           profile N it uses all options that are set for this  profile.  Cur‐
454           rently  the  only  options  that can be set per profile are Pixmap,
455           background, command, foreground, saveLines, holdExit, holdExitText,
456           holdExitTitle,    tabTitle,    titleFormat,    winTitleFormat   and
457           workingDirectory.  Then all the settings from that  profile  number
458           are used.
459
460           N can be any integer between 0 and the compiled in maximum (default
461           5). The profile number 0 is special, and contains default  settings
462           which  are used for all profiles where this option is not set (e.g.
463           -profile0.tt mrxvt sets the tab title to  mrxvt  for  all  profiles
464           where  the tab title has not been set). In this case the -profile0.
465           can be omitted entirely (i.e.  -profile0.tt is equivalent to -tt).
466
467           This option is intended to replace the -vt%d.xx options from  mrxvt
468           version 0.5.0. The old -vt%d.xx would set options for the %dth tab.
469           This causes inconsistent behaviour when the  user  moves  /  closes
470           tabs.  The behaviour of the -profile option is to set options for a
471           particular profile, and then these settings can be  associated  (on
472           demand) to newly created tabs.  [profileN.option]
473
474     -ps|+ps
475           Protect  tab from being closed if it is using the secondary screen,
476           for example, when the user is running vim(1) or mutt(1),  this  can
477           prevent    the    terminal    from   being   accidentally   closed.
478           [protectSecondary]
479
480     -sti|+sti
481           Synchronize icon name with tab title when switch to a  new  tab  or
482           the title of the active tab changes.  [syncTabIcon]
483
484     -stt|+stt
485           Synchronize  terminal title with tab title when switch to a new tab
486           or the title of the active tab changes. (See also the -wtf option).
487           [syncTabTitle]
488
489     -tnum N
490           OBSOLETE.  Opens N tabs on startup. For backward compatibility, the
491           tabs are opened with profile 0, 1, ...  N-1.  [initTermNumber]
492
493     -tt string
494           Title of the tab [tabTitle]
495
496     -tf format
497           If set, this controls the displayed title of each tab.  format is %
498           interpolated, and the result is displayed as the tab title.
499
500           NOTE:  Currently  this  option  requires the tab titles to be drawn
501           with a proportionally spaced font (which is currently only possible
502           with  Xft). Also, this option only affects the displayed tab title,
503           and thus %t will still expand to the actual tab title, as  set  via
504           an  escape  sequence, or macro. For example, setting this option to
505%n. %t’ will cause all the tabs to be numbered.  [titleFormat]
506
507     -ut|+ut
508           Utmp inhibit.  [utmpInhibit]
509
510     -vbf|+vbf
511           If unset, colored bold text will not be rendered using overstrike /
512           bold font. See also boldColors and veryBright.  [veryBoldFont]
513
514     -wd   Working  directory  of  the  child  process. If non-empty, then the
515           child process is started in this directory. If set to ‘.’ then  the
516           child process is run in the working directory of the current tab if
517           possible. On Linux, this is the default. (NOTE: It  is  not  always
518           possible  to  find  the  working directory of the current tab. This
519           works fine on Linux, but causes problems  on  other  systems  [e.g.
520           OpenBSD],  which  is  why  it is only enabled by default on Linux).
521           [workingDirectory]
522
523     -wtf format
524           Controls the format of the window title. If  set,  and  the  option
525           -stt  is  used,  then  the  window  title is set to format (after %
526           interpolation), instead of the tab title.  [winTitleFormat]
527
528   Multichar and multi-language support
529     -mcc|+mcc
530           Multichar cursor movement [multibyte_cursor]
531
532     -km mode
533           multichar encoding mode [multichar_encoding]
534
535     -im name
536           name of X Input Method (XIM) [inputMethod]
537
538     -pt mode
539           XIM input style: OverTheSpot|OffTheSpot|Root [preeditType]
540
541     -thai|+thai
542           Thai support [thai]
543
544     -grk mode
545           Greek keyboard mapping: iso|ibm [greek_keyboard]
546
547   Menu related options
548     -menu filename[;tag]
549           Menubar definition file.  [menu]
550
551     -showmenu|+showmenu
552           show menubar [showMenu]
553
554   Keyboard and window related options
555     -b number
556           internal border width [internalBorder]
557
558     -bc|+bc
559           Display a blinking cursor.  [cursorBlink]
560
561     -bcst|+bcst
562           Enable / disable broadcasting input to all terminals [broadcast]
563
564     -bci number
565           Cursor blink interval (ms) [cursorBlinkInterval]
566
567     -bl|+bl
568           Use a borderless window.  [borderLess]
569
570     -blc cmd
571           Bell command instead of beeping. If cmd begins with ‘!’ then it  is
572           passed  to  /bin/sh  -c  for  execution. Otherwise it is split into
573           words at spaces or tabs only, and executed via execvp(3).   If  you
574           don't  want a space or tab to cause word splitting, then precede it
575           with a ‘\’.  If you want to pass ‘\ ’ as an  argument,  double  the
576           ‘\’.
577
578           Note:  Only  backslashes  (or chains of backslashes) that precede a
579           space or tab character are treated specially. That is ‘\\a’ will be
580           left untouched, however ‘\\ ’ will expand to a ‘\’ and the ‘ ’ will
581           cause a word break, and ‘\ ’ will expand to a ‘ ’  which  does  not
582           cause a word break.  [bellCommand]
583
584     -bw|-w number
585           external border width [externalBorder]
586
587     -desktop number
588           Desktop  to place the window (for gnome compatible window manager).
589           The number starts from 0, NOT 1!  [desktop]
590
591     -dm|+dm
592           Enable / disable all keyboard macros.  This  functionality  can  be
593           toggled  at runtime via a pop-up menu, or the ToggleMacros keyboard
594           shortcut. NOTE: When keyboard macros are disabled, the ToggleMacros
595           keyboard  macro  will  still work. Thus you can re-enable your key‐
596           board macros via the keyboard using this function.  [disableMacros]
597
598     -fs|+fs
599           Startup fullscreen.  Use  in  conjunction  with  [smoothResize]  to
600           really make it full screen. Requires an EWMH compatible window man‐
601           ager.  [fullscreen]
602
603     -lk|+lk
604           Enable Linux console style Home/End keys [linuxHomeEndKey]
605
606     -mod mode
607           Meta modifier: alt|meta|hyper|super|mod1|...|mod5.  [modifier]
608
609     -lsp number
610           Line space between rows [lineSpace]
611
612     -m|+m
613           Start maximized  (requires  an  EWMH  compatible  window  manager).
614           [maximized]
615
616     -m8|+m8
617           Enable / disable meta8 [meta8]
618
619     -nsc|+nsc
620           Enable  /  disable reading the system wide configuration file. Only
621           the default keyboard macros are  defined  in  this  file,  so  this
622           option  can  effectively  disable  all  default keyboard shortcuts.
623           [noSysConfig]
624
625     -or|+or
626           Override redirect [overrideRedirect]
627
628     -pb|+pb
629           Pointer blank (see also pointerBlankDelay).  [pointerBlank]
630
631     -rv|+rv
632           reverse video [reverseVideo]
633
634     -tcw|+tcw
635           Triple click word selection [tripleclickwords]
636
637     -vb|+vb
638           Visual bell [visualBell]
639
640   Miscellaneous options
641     -C    Intercept console messages
642
643     -dmask namelist
644           Print out debug message defined by  a  coma  separated  name  list.
645           Available  names include: command, screen, ptytty, init, main, log‐
646           ging, macros, menubar, tabbar, scrollbar, images, pixmap, transpar‐
647           ent,  encoding, gkrelot, memory, session, string, resource, xftacs,
648           misc, and all.
649
650     -dlevel verboselevel
651           Print out debug message defined by verboselevel. Available verbose‐
652           level  are:  fatal, error, warn, info, verbose, and debug. The lat‐
653           ter, the more information is printed
654
655     -cf filename
656           X resource configuration file
657
658     -cfs filename
659           X resource configuration file to  save  the  current  configuration
660           [confFileSave]
661
662     -path path
663           Colon delimited list of directories to search for background images
664           and menu files.  mrxvt first searches for the file in  the  current
665           directory,  then  in the directories specified by path, then in the
666           directories specified by  the  environment  variable  PATH_ENV  and
667           finally  tries in the user configuration directory ~/.mrxvt and the
668           (compiled  in)  system  wide  configuration  directory  /etc/mrxvt.
669           [path]
670
671     -sid string
672           Client identity of mrxvt for X session management [smClientID]
673
674     -sm|+sm
675           enable X session management [sessionMgt]
676
677   Long options
678     The following options do not have a “short” form. If these options are to
679     be used on the command line, they must be prefixed with a ‘--’  (or  ‘++
680     for  boolean options). They can of course be used in the mrxvt configura‐
681     tion file.
682
683     answerBackString string
684           Specify the reply mrxvt sends to the shell when an ENQ  (control-E)
685           character  is  passed  through.  It  may  contain  escape values as
686           described in the entry on keysym following.
687
688     backspaceKey string
689           The string to send when the backspace key is pressed. If set to DEC
690           or  unset  it will send Delete (code 127) or, if shifted, Backspace
691           (code 8) - which can be reversed with the appropriate  DEC  private
692           mode escape sequence.
693
694     bgRefreshInterval delay
695           Specify  the delay (ms) to wait before refreshing the background in
696           pseudo-transparency. Generally tinting  and  refreshing  the  back‐
697           ground  is  slow  (especially  with XRender), and causes lags while
698           dragging the window. This delay causes enables  the  window  to  be
699           dragged smoothly. If you have a fast system, you can reduce or dis‐
700           able this (by setting it to 0). The default value is 100ms.
701
702     boldFontN font
703           Specifies bold font to use along with fontset N.
704
705     boldColors True|False
706           If false, the bold primary colors (0 -- 7) will be  rendered  using
707           the  brighter  analogues  (8--15) in a regular font. If true a bold
708           font will be used. See also veryBright.
709
710     colorN color
711           Use the specified colour for the colour value N, where  0-7  corre‐
712           sponds  to  low-intensity  (normal) colours and 8-15 corresponds to
713           high-intensity colours.
714
715     colorBD color
716           Color to use to display bold text. If unspecified, the text will be
717           displayed using a bold font / overstrike.
718
719     colorRV color
720           Color  to  use  to  display reverse video text. If unspecified, the
721           text will be displayed as reverse video.
722
723     colorUL color
724           Color to use to display underlined text. If unspecified,  the  text
725           will be displayed as underlined.
726
727     cursorColor2 color
728           Second color of cursor.
729
730     cutChars string
731           String containing all characters to be treated as one word for dou‐
732           ble click selection. If you want double  clicks  to  select  URL's,
733           then  set  this  to a string containing all letters (both upper and
734           lower case), digits and punctuation you find in urls.
735
736     deleteKey string
737           The string to send when the delete key (not the keypad delete  key)
738           is  pressed. If unset it will send the sequence traditionally asso‐
739           ciated with the Execute key.
740
741     focusDelay msec
742           The time interval (in mili-seconds) to wait after getting /  losing
743           focus,  before  fading the colors and changing the background color
744           as specified by the -fade and -ufbg options. Set it  to  0  if  you
745           want your colors faded immediately on focus change events.
746
747           This  option  is  there  mainly to work around a bug in some window
748           managers which send focus in  immediately  followed  by  focus  out
749           events when moving windows, or pressing Alt+Tab (e.g. fvwm-2.5.16).
750
751     fontN font
752           Specify the alternative font n. n can be 1, 2, 3, 4 or 5.
753
754     greektoggle_key keysym
755           Key  to  toggle  into  greek keyboard mapping. See README.greek for
756           details.
757
758     highlightColor color
759           Color to use for selection. If  not  specified,  reverse  video  is
760           used. (Note blinking text is also displayed with this color).
761
762     mapAlert True|False
763           If true, de-iconifies the window when a bell is received.
764
765     mfontn font
766           Specify alternative multiple character font n.
767
768     pointerBlankDelay delay
769           Delay (ms) to blank pointer after.
770
771     printPipe cmd
772           Specify a command pipe for vt100 printer.
773
774     refreshLimit N
775           This  option  and  skipPages  are  to  be used to replace the ‘jump
776           scroll’ behaviour of other terminal emulators (and previous version
777           of  mrxvt).   Generally  when  data  is available from a tab, mrxvt
778           reads as much of it as is available (up to our  buffer  size),  and
779           process  it.  After  we  are  done processing it (generally takes a
780           fraction of a mili-second), we look for more data from the tab.  If
781           we  obtain  not  more  than  N characters, then we request a screen
782           refresh (which takes a while, especially if you use Xft  with  anti
783           aliasing).  If  we obtain more than N characters from the tab, then
784           we delay the screen refresh until the tab eventually has  either  N
785           or  fewer  characters of output, or the tab has (cumulatively) pro‐
786           duced at least skipPages of data.
787
788           The default value is 0. On new fast machines, this is probably  the
789           best. If you find screen refreshes laggy on on slow older machines,
790           then increase this value a little (say to 10). Setting it to  some‐
791           thing  enormous  (say  BUFSIZ)  will  cause mrxvt to request screen
792           refreshes every time the active tab has data, and effectively  dis‐
793           able the so called ‘jump scrolling’.
794
795     scrollColor color
796           Color of scrollbar (see also troughColor).
797
798     selectStyle mode
799           Set  mouse  selection  style to old which is 2.20, oldword which is
800           xterm style with 2.20 old word selection, or  anything  else  which
801           gives xterm style selection.
802
803     skipPages N
804           This  option  and  refreshLimit are to be used to replace the ‘jump
805           scroll’ behaviour of other terminal emulators (and previous version
806           of  mrxvt).   If  the  screen  refresh  is  delayed  because of the
807           refreshLimit option, then mrxvt will refresh  the  screen  every  N
808           pages  of  output. The default is 25. If you set it to a very large
809           value (say INT_MAX), then mrxvt will refresh the screen only  after
810           the tab has stopped ‘flat out’ scrolling.
811
812     smartResize True|False
813           Enable  /  disable  smart resize. When the tabbar is shown, or font
814           size is increased, the resize terminal window  could  be  partially
815           off screen. If smartResize is enabled, then mrxvt tries to move the
816           terminal window to stay on screen.
817
818     smoothResize True|False
819           Enable / disable smooth resize. If enabled, then the  mrxvt  window
820           is  resized  in pixel increments (instead of character increments).
821           This is useful if you want a full screen / maximized  mrxvt  window
822           that  covers  the  entire  screen  (without leaving an annoying few
823           pixel wide strip uncovered).
824
825     troughColor
826           Color of scrollbar trough (see also scrollColor).
827
828     useFifo True|False
829           If enabled, then mrxvt will create a fifo(7)  /tmp/.mrxvt-%pid  and
830           listen for macros on it. To execute macros, just write them to this
831           fifo. For example
832
833               /bin/echo -e "NewTab\nRaise" >> /tmp/.mrxvt-%pid
834
835           creates a new tab and raises the mrxvt window with process ID %pid.
836           NOTE:  The meaning and syntax of this option might change in future
837           versions.
838
839     veryBright True|False
840           If true, and if boldColors is false, then bold primary  colors  are
841           rendered  as  bright  colors with a bold font (this was the default
842           behaviour in 0.5.2 and earlier versions).
843

CONFIGURATION FILE SYNTAX

845     A line in the config file generally looks like this
846
847         ClassName.OptionName:   Value
848
849     Blank lines, and lines beginning with ‘#’ are ignored (comments).
850
851     The ClassName is the name specified via  the  -name  option  (by  default
852mrxvt’).   When  mrxvt  starts  up, it ONLY reads options with ClassName
853Mrxvt’, ‘XTerm’, or the  class  specified  via  the  -name  option.  See
854     /etc/mrxvt/mrxvtrc.sample for how this feature can be used.
855
856     The  OptionName is the long name of the option you want to set. It can be
857     any long option (listed under the Long Options sub section), or is speci‐
858     fied  in  brackets as [option_name] alongside regular options in this man
859     page. Finally Value is the value of this option.
860
861   Example
862     The following is an example ~/.mrxvtrc file, or in a  configuration  file
863     you   will  load  with  -cf  option  at  startup.  You  can  consult  the
864     doc/mrxvtrc.sample in the directory for more details.
865
866         Mrxvt.profile0.tabTitle:        term1
867         Mrxvt.profile1.tabTitle:        term2
868         Mrxvt.profile2.tabTitle:        term3
869         Mrxvt.profile0.saveLines:       600
870         Mrxvt.profile1.saveLines:       600
871         Mrxvt.profile2.saveLines:       600
872         # Mrxvt.profile0.Pixmap:        /home/images/vt0bg.xpm
873         # Mrxvt.profile1.Pixmap:        /home/images/vt1bg.xpm
874         # Mrxvt.profile2.Pixmap:        /home/images/vt2bg.xpm
875         Mrxvt.scrollbarStyle:           next
876         Mrxvt.initTermNumber:           3
877         Mrxvt.transparent:              True
878         Mrxvt.transparentScrollbar:     True
879         Mrxvt.transparentTabbar:        False
880         Mrxvt.transparentMenubar:       False
881         Mrxvt.tintColor:                #ffffff
882         Mrxvt.shading:                  85
883         Mrxvt.foreground:               white
884         Mrxvt.background:               black
885
887     The menu system is  similar  to  rxvt's  menus  (see  the  included  file
888     rxvtRef.txt) with a few enhancements, and a few notable exceptions:
889
890     -  The  menus  can  use a proportionally spaced font under Xft ( -xftpfn)
891       which is significantly less ugly than a mono-spaced font.
892
893     - mrxvt supports pop-up menus. If you create a  menu  named  PopupButtonN
894       (where  N  is  1, 2, or 3) then that menu is popped up when you control
895       click (with the appropriate  mouse  button)  on  the  terminal  window.
896       Additionally  if  you  right  click  on  the  Tab  bar,  then  the menu
897       PopupButton1 is popped up.
898
899     - To create a menu containing a list of all open tabs,  create  an  empty
900       menu  called  PopupButtonN  (which will be popped on control click's as
901       described above). To include a list of all open tabs  as  a  sub  menu,
902       create a sub-menu called ‘Switch to tab’.
903
904     - Menu actions are completely different in mrxvt than the original imple‐
905       mentation in rxvt(1).  The menu actions are exactly the same  as  macro
906       actions, and are described in the section Defining custom shortcuts.
907
908     - On startup mrxvt reads the file default.menu which contains the default
909       menu definitions. The file is searched for in your search path  (speci‐
910       fied by option -path).
911

KEYBOARD AND MOUSE SHORTCUTS

913     You have several default keyboard shortcuts to ease the use of mrxvt. The
914     default gnome-terminal, Konsole, rxvt shortcuts are predefined  for  you.
915     You  can  also  define your own shortcuts as described in Defining custom
916     shortcuts.
917
918   Default keyboard shortcuts
919     The following key combinations are defined by default. These are  defined
920     in  the system configuration file /etc/mrxvt/mrxvtrc, and can be disabled
921     using the option -nsc.  See the next section for instructions on defining
922     your own custom keyboard shortcuts.
923
924     Gnome-terminal style shortcuts:
925         Ctrl+Shift+t        create a new tab
926         Ctrl+Shift+q        Close all tabs and exit
927         Ctrl+Shift+w        Close  active  tab, and do not hold it open if it
928                             exits abnormally.
929         Ctrl+PgUp           activate left tab
930         Ctrl+PgDn           activate right tab
931         Meta+1              activate 1st tab
932         ...
933         Meta+0              activate 10th tab
934         Ctrl+equal          increase font size (next font)
935         Ctrl+Shift+plus     increase font size by 2
936         Ctrl+minus          decrease font size (previous font)
937         Ctrl+Shift+underscore
938                             decrease font size by 2
939
940     Konsole style default shortcuts:
941         Ctrl+Shift+Left     move active tab to left
942         Ctrl+Shift+Right:   active tab to right
943         Shift+Left          Activate left tab (Primary only)
944         Shift+Right         Activate right tab (Primary only)
945         Ctrl+Shift+n        Create a new tab with the  same  profile  as  the
946                             current tab.
947
948     Vi style default shortcuts:
949         Ctrl+Shift+h        activate left tab
950         Ctrl+Shift+l        activate right tab
951
952     Screen style default shortcuts:
953         Ctrl+Shift+p        activate previous active tab
954
955     Mrxvt default shortcuts:
956         Ctrl+Shift+1        Move tab to 1st position
957         ...
958         Ctrl+Shift+0        Move tab to 10th position
959         Ctrl+Tab            activate previous active tab
960         Ctrl+Shift+less_than
961                             Move active tab left
962         Ctrl+Shift+greater_than
963                             Move active tab right
964         Ctrl+Shift+o        Change opacity of terminal to make it more trans‐
965                             parent.
966         Ctrl+Shift+u        Change opacity of terminal to make it less trans‐
967                             parent.
968         Ctrl+Shift+j        Change shading of terminal to make it more trans‐
969                             parent.
970         Ctrl+Shift+k        Change shading of terminal to make it less trans‐
971                             parent.
972         Ctrl+Shift+r        Toggle psdudo-transparency
973         Ctrl+Shift+i        Hide/show tabbar
974         Ctrl+Shift+s        Hide/show scrollbar
975         Ctrl+Shift+m        Hide/show menubar
976         Ctrl+Shift+a        Hide/show tabbar buttons
977         Ctrl+Shift+b        Toggle very bold font
978         Ctrl+Shift+c        Open a mrxvt console in a new tab, and enable the
979                             useFifo option if necessary.  Anything  typed  in
980                             this  console  will  be  executed  as a macro. On
981                             clean exit the useFifo option will be disabled.
982         Ctrl+Shift+d        Toggle input broadcasting (unbound by default)
983         Ctrl+Shift+e        Toggle holding exited tab
984         Ctrl+Shift+f        Toggle full screen mode
985         Ctrl+Shift+x        Save current configuration
986         Shift+Del           Set title of active tab to selection.
987         Shift+Insert        Paste X selection into active tab.
988         Ctrl+Shift+v        Paste X selection into active tab.
989         Shift+Up            Scroll up one line (Primary screen only)
990         Shift+Dn            scroll down one line (Primary screen only)
991         Shift+PgUp          scroll up one page (Primary screen only)
992         Shift+PgDn          scroll down one page (Primary screen only)
993         Shift+Home          Scroll to beginning of scroll-back  buffer  (Pri‐
994                             mary screen only)
995         Shift+End           Scroll  to  end  of  scroll-back  buffer (Primary
996                             screen only)
997         Shift+KeypadPlus    Increase font size
998         Shift+KeypadMinus   Decrease font size
999         Ctrl+Shift+F1       Open mrxvt man page in a new tab.
1000         Ctrl+Shift+F12      Enable / disable all keyboard macros (except this
1001                             one of course).
1002
1003   Defining custom shortcuts
1004     NOTE:  The  ‘hotkey’  mechanism used in versions 0.4.2 and earlier is now
1005     obsolete. It has been replaced by the  ‘macro’  functionality  (described
1006     below) as of version 0.5.0.
1007
1008     You  can define your own keyboard shortcuts in your configuration file by
1009     using the following syntax:
1010
1011         Mrxvt.macro.[modifiers+]keyname:         action
1012
1013     Here ‘modifiers’ is a ‘+’ separated  list  of  modifiers  ‘Ctrl’,  ‘Alt’,
1014Meta’,  ‘Shift’.   ‘Primary’.   and  ‘Add’.  The first four refer to the
1015     respective modifier keys.  ‘Primary’ tells mrxvt to make the macro avail‐
1016     able  ONLY  when  the primary screen is displayed (e.g.  ‘Primary’ macros
1017     will not be effective when you are running vim(1), but will be  effective
1018     when  you  are at the shell prompt). Finally ‘Add’ tells mrxvt to add the
1019     macro action to any previous action associated to  that  particular  key.
1020     For instance
1021
1022         Mrxvt.macro.Primary+Shift+Return:       Esc \ec
1023         Mrxvt.macro.Primary+Add+Shift+Return:   Str ^M
1024
1025     will  define  the  macro ‘Shift+Return’ to first send the escape sequence
1026     ‘\ec’ to mrxvt (which has the effect of clearing the scroll back  buffer)
1027     and  then  send  ‘Ctrl-M’  to  the child process, but ONLY in the primary
1028     screen. If you're running a  shell,  then  this  effectively  clears  the
1029     scroll back buffer and executes the command.
1030
1031     If  the  ‘Add’  modifier is not specified, then the macro action replaces
1032     any previous action (if any) associated to the specified key.  It  is  an
1033     error  to add a macro to a non-existing macro. Currently one key can have
1034     at most 16 actions associated to it  (this  might  be  reduced  to  8  in
1035     future).
1036
1037     ‘keyname’ is the name of the key you want to bind to the specified macro.
1038     Non alpha numeric keys (e.g.  punctuation,  or  cursor/keypad  keys)  are
1039     specified  by using their keyname, which you can find by xev(1), or look‐
1040     ing directly in the system header file /usr/include/X11/keysymdef.h.
1041
1042     In case you want to unbind a default keyboard macro, just bind the appro‐
1043     priate key to the function ‘Dummy’.  For example
1044
1045         Mrxvt.macro.Ctrl+Shift+t:       Dummy
1046
1047     will  disable  the default keyboard shortcut ‘Ctrl+Shift+t’.  If you want
1048     to disable all keyboard macros, use the option ‘-dm’ (which can  also  be
1049     accessed  via  a pop-up menu). The default keyboard macros are defined in
1050     the system configuration file /etc/mrxvt/mrxvtrc so if you only  want  to
1051     disable  all  default shortcuts keys, don't read the system configuration
1052     file by using the -nsc option.
1053
1054     Notice that keyboard shortcuts definitions are incompatible with  X  Win‐
1055     dows own resource parsing API, i.e., XGetDefaults. So, to enable the key‐
1056     board shortcuts, you will need to enable resources  but  disable  xgetde‐
1057     fault when you configure mrxvt.
1058
1059     Finally ‘action’ is the action you want bound to the specified macro key.
1060     The available actions you can bind to macros are:
1061
1062         Dummy
1063               Clear an existing keyboard shortcut
1064
1065         Esc str
1066               Send the escape sequence str to mrxvt.
1067
1068         Str str
1069               Send the string str to the child process.
1070
1071         Exec command
1072               Executes command asynchronously. The command  run  without  any
1073               controlling  shell or TTY. This is generally used to launch X11
1074               programs (e.g. open the selected text in firefox). If you  want
1075               a command run in a new tab, see the NewTab macro).
1076
1077               The  argument command is word split exactly as described in the
1078               -blc option (thus for instance beginning it with ‘!’ will  pass
1079               it  to  /bin/sh  -c  for word splitting and execution). However
1080               keep in mind that like all macro arguments,  command  is  first
1081\’ interpolated. Thus if on the rare occasion you want ‘\ ’ to
1082               be part of command, then you will have  to  do  something  like
1083               ‘\\\\\\ ’  and  not  ‘\\\ ’  as  you would with the argument of
1084               -blc.
1085
1086         NewTab [-N] ["title"] [[!]command]
1087               Open a new tab.  N specifies the profile  number.  If  omitted,
1088               profile  0  is used. If only ‘-’ (with no number) is specified,
1089               then the profile of the current active tab is used  (i.e.  this
1090               can  be used to duplicate the current tab).  title is specified
1091               (needs to be double quoted), use that for  the  tab  title.  If
1092               command  is  specified,  execute  that  command  in the new tab
1093               (instead of the one specified by  the  resource  file,  or  the
1094               shell).
1095
1096               command  is  word split as described in the Exec macro. However
1097               if command begins with an ‘!’ then run a shell first, and  exe‐
1098               cute  the command in the shell as if the user had typed command
1099               at the shell prompt. If instead you want command to  be  passed
1100               to  /bin/sh  -c  for  word  splitting and execution, then begin
1101               command with ‘\!’.
1102
1103         Close [N]
1104               Close a tab. If no argument is specified, close  all  tabs  and
1105               exit.  If N is 0, close the active tab. Otherwise close the Nth
1106               tab.
1107
1108         GotoTab [N]
1109               Goto tab. If N is ommited or 0, then goto the  previous  active
1110               tab.  Otherwise goto the Nth tab. If N begins with a ‘+’ or ‘-’
1111               then N is relative to the current tab.
1112
1113         MoveTab N
1114               Move active tab to position N.  If N begins with a ‘+’  or  ‘-’
1115               then N is relative to the current tab.
1116
1117         Scroll amount
1118               Scroll  the  active  tab  by amount lines (negative values mean
1119               scroll backward). If amount ends with ‘p’  then  scroll  amount
1120               pages instead of lines.
1121
1122         Copy  Copy selection into clipboard (not implemented).
1123
1124         Paste
1125               Pasete selection into active tab.
1126
1127         ToggleSubwin [[+|-][b|m|s|t]]
1128               Toggle visibility of sub-windows. If the argument begins with a
1129               ‘+’ the subwindow is shown. If it begins with a ‘-’ the subwin‐
1130               dow  is  hidden. Otherwise it is toggled. The letters ‘b’, ‘m’,
1131s’ and ‘t’ represent the tabbar  buttons,  menubar,  scrollbar
1132               and  tabbar  respectively.  NOTE: Currently you can only toggle
1133               one subwindow at a time.
1134
1135         ResizeFont [+|-]N
1136               Resize the font. With Xft, N represents the size  increment  of
1137               the  xft  font.  Without Xft, N represents the index of the X11
1138               fonts specified by the fontN resources.
1139
1140         ToggleVeryBold
1141               Toggle use of bold font for colored text.
1142
1143         ToggleTransparency
1144               Toggle pseudo transparency.
1145
1146         ToggleBroadcast
1147               Toggle broadcasting of input to all tabs.
1148
1149         ToggleHold [mask]
1150               If mask is not specified, then just close all tabs who's  child
1151               processes  have exited. (This is almost compatible with the be‐
1152               haviour of mrxvt 0.5.1 and earlier). If mask is specified, then
1153               change  the  hold  status  of the current tab.  mask must begin
1154               with ‘+’, ‘-’, or ‘!’ and be followed by a bit mask (as in  the
1155               holdExit option).  ‘+’ will add bits to the holdExit option for
1156               this tab, ‘-’ will subtract, and ‘!’ will toggle. Remember that
1157               if  the  lowest bit of the current tabs holdExit option is set,
1158               then the tab will always be held open and everything else  will
1159               be ignored.
1160
1161         ToggleFullscreen
1162               Toggle  between  full  screen  and  regular  mode.  Also enable
1163               --smoothResize to get true full screen. This will only work  if
1164               you  are running an EWMH compatible window manager (e.g. Fvwm /
1165               OpenBox / KDE / Gnome).
1166
1167         Raise
1168               Raise the mrxvt window.
1169
1170         SetTitle
1171               Set title of active tab to selection. (The  selection  must  be
1172               owned by mrxvt)
1173
1174         UseFifo status
1175               Enable  or disable using a fifo(1) to listen for macros on (see
1176               the useFifo option). The argument status should be 0, 1, -1  to
1177               disable, enable or toggle respectively.
1178
1179         PrintScreen [-psn] [command]
1180               Dump  screen to printer (or command).  If -p is specified, then
1181               the output is pretty printed (i.e. escape sequences are used to
1182               get  the  same color in the output as on your screen). If -s is
1183               specified, then the entire scroll back is printed  (instead  of
1184               just the current screen). If -n is specified, then every screen
1185               line is terminated with a newline char (by default screen lines
1186               that  wrap to the next line are not terminated with a newline).
1187               Finally, if command is specified it is used as the printer pipe
1188               (if  not  the  value of printPipe or the compiled in default is
1189               used).
1190
1191         SaveConfig [filename]
1192               Save config to file. If  no  filename  is  specified,  save  to
1193               ~/.mrxvtrc.save.
1194
1195         ToggleMacros
1196               Toggle  the use of keyboard shortcuts. When macros are disabled
1197               (either by using this macro, or by the -dm option),  then  this
1198               is  the only keyboard shortcut that will work. Thus you can re-
1199               enable your keyboard shortcuts  via  the  keyboard  using  this
1200               function.
1201
1202     Additionally,  the  argument  to  any of the above macros are ‘\’ and ‘%
1203     interpolated as follows:
1204
1205         \a        Bell
1206         \b        Backspace
1207         \E, \e    Escape
1208         \n        Newline
1209         \r        Carriage return
1210         \t        Tab
1211         \ddd      Char with octal ASCII code ddd.
1212         ^@, ^A .. ^Z .. ^_, ^?
1213                   Control-@, Control-A ...
1214
1215         %G        Global (static) tab number.
1216         %p        PID of child process in current tab.
1217         %P        PID of mrxvt
1218         %n        Tab number.
1219         %N        Expands to ‘normally’ if the process exited normally  (e.g.
1220                   by  calling  exit(1)) or ‘abnormally’ otherwise. (Note this
1221                   is independent of the exit status).
1222         %s        Text selected in the mrxvt window.
1223         %S        If the process in this tab is dead, then it expands to  the
1224                   exit status of the child process. Otherwise left unchanged.
1225         %t        Tab title.
1226         %T        Total number of tabs created in mrxvt lifetime.
1227
1228   Mouse shortcuts
1229     Changing tab titles
1230           This mouse shortcut can be used to dynamically change the tab title
1231           as follows: Select text in the terminal window. Then  middle  click
1232           on a tab to change the tab's title. If you middle click on the tab‐
1233           bar background, then the title of the active tab is changed.
1234
1235     Tab list menu
1236           By default, if you right click on the  tab  bar,  or  control-left-
1237           click on the terminal window, a popup menu with a list of currently
1238           open tabs pops up. The actual menu popped up can be  customized  as
1239           described under the section MENUS.
1240
1241     Popup menus
1242           If  you  Control-click  on the terminal window (with any mouse but‐
1243           ton), it pops up a menu. The actual menu popped up can  be  custom‐
1244           ized as described under the section MENUS.
1245
1246     Moving tabs
1247           Click  and drag a tab to some other location on the tab-bar to move
1248           it.
1249

ESCAPE SEQUENCES

1251     You have several escape sequences to control mrxvt.  All default  rxvt(1)
1252     escape  sequences  are  supported by mrxvt.  A few extra escape sequences
1253     have been added to improve DEC compatibility, and allow interaction  with
1254     extra  mrxvt  features  (e.g.  tabs).  The supported escape sequences are
1255     listed in the file mrxvt_seq.txt included in the distribution.
1256
1257     For omissions in the documentation, and  a  more  complete  reference  to
1258     escape  sequences you should look at the file ctlseqs.txt that comes with
1259     the xterm package, console_codes(4) and the original  rxvt  documentation
1260     in the file rxvtRef.txt.
1261
1262     For  basic  interaction with mrxvt (e.g. changing the tab title etc.) you
1263     should  also  look   at   the   programs   share/scripts/settitle.c   and
1264     share/scripts/mrxvtset.pl that are supplied with the mrxvt distribution.
1265

ENVIRONMENT

1267     COLORFGBG
1268           Set to the terminal foreground and background colors.
1269
1270     COLORTERM
1271           Sets to the terminal sub-name that indicates its color.
1272
1273     DISPLAY
1274           Used (and set) to the X display bieng used.
1275
1276     PATH_ENV
1277           Path to look for menu / background files (see -path option).
1278
1279     TERM  Set to the terminal name in the window you have created.
1280
1281     MRXVT_TABTITLE
1282           Set  to  the  initial  tab  title of each terminal. Notice that its
1283           value will not be altered if the user uses  a  shortcut  or  escape
1284           sequence  to change the tab title. The user must modify it manually
1285           after doing that.
1286
1287     WINDOWID
1288           Set to the X window id number of the mrxvt window.
1289

FILES

1291     The actual pathnames given may differ on your system.
1292
1293     default.menu
1294           The default menu file loaded  at  startup  (searched  for  in  your
1295           -path).
1296
1297     ~/mrxvt
1298           Directory in which to look for user menu and image files.
1299
1300     ~/.mrxvtrc
1301           This  is  the default configuration file (since 0.3.9). If present,
1302           resources read from this file override existing resources.
1303
1304     ~/.Xdefaults
1305           (OBSOLETE) This was the default configuration file (before  0.3.9).
1306           If  present,  resources  read  from  this  file  override  existing
1307           resources.
1308
1309     ~/.Xresources
1310           (OBSOLETE) If both .mrxvtrc and .Xdefaults are not found, try  this
1311           one.
1312
1313     /etc/mrxvt
1314           System  wide  directory  in  which  to look for user menu and image
1315           files.
1316
1317     /etc/mrxvt/default.menu
1318           Default menu file read on startup.
1319
1320     /etc/mrxvt/mrxvtrc
1321           System wide configuration file. (By default this file only  defines
1322           the default keyboard macros)
1323
1324     /etc/utmp
1325           System file for login records.
1326
1327     /usr/lib/X11/rgb.txt
1328           Color names.
1329
1330     /usr/X11R6/lib/X11/app-defaults/XTerm
1331           (OBSOLETE)  If  enable  xgetdefaults  at compiled time, this is the
1332           first configuration file read.
1333

BUGS

1335   Reporting bugs
1336     Please report bugs using the sourceforge bug tracker system at
1337
1338                      http://sourceforge.net/projects/materm
1339
1340     Alternately you can send your bug report to the mrxvt  developer  mailing
1341     list at
1342
1343                        materm-devel@lists.sourceforge.net
1344
1345     Be  sure  you  give us enough details to reproduce the bug ourselves, and
1346     check to see if your bug still exists in the current CVS version.
1347
1348   Known bugs
1349     - Tabs don't work properly when running under Xnest.
1350     - Transparency and tinting are global, not specific to a terminal.
1351     - The transparentForce option does not work well with all window managers
1352       (e.g. OpenBox).
1353

SEE ALSO

1355     rxvt(1),  xterm(1),  resize(1),  mrxvt_seq.txt,  Xterm  control sequences
1356     (this is the file ctlseqs.ms or ctlseqs.txt), console_codes(4)
1357
1358                           http://materm.sourceforge.net
1359

AUTHORS

1361     Terminator <jimmyzhou@users.sourceforge.net>
1362     Gautam Iyer <gi1242@users.sourceforge.net>
1363
1364X Version 11                   January 10, 2006                   X Version 11
Impressum