… | |
… | |
4 | |
4 | |
5 | SYNOPSIS |
5 | SYNOPSIS |
6 | rxvt [options] [-e command [ args ]] |
6 | rxvt [options] [-e command [ args ]] |
7 | |
7 | |
8 | DESCRIPTION |
8 | DESCRIPTION |
9 | rxvt-unicode, version 7.4, is a colour vt102 terminal emulator intended |
9 | rxvt-unicode, version 8.0, is a colour vt102 terminal emulator intended |
10 | as an *xterm*(1) replacement for users who do not require features such |
10 | as an *xterm*(1) replacement for users who do not require features such |
11 | as Tektronix 4014 emulation and toolkit-style configurability. As a |
11 | as Tektronix 4014 emulation and toolkit-style configurability. As a |
12 | result, rxvt-unicode uses much less swap space -- a significant |
12 | result, rxvt-unicode uses much less swap space -- a significant |
13 | advantage on a machine serving many X sessions. |
13 | advantage on a machine serving many X sessions. |
14 | |
14 | |
15 | FREQUENTLY ASKED QUESTIONS |
15 | FREQUENTLY ASKED QUESTIONS |
16 | See rxvt(7) (try "man 7 rxvt") for a list of frequently asked questions |
16 | See rxvt(7) (try "man 7 rxvt") for a list of frequently asked questions |
17 | and answer to them and some common problems. That document is also |
17 | and answer to them and some common problems. That document is also |
18 | accessible on the World-Wide-Web at |
18 | accessible on the World-Wide-Web at |
19 | <http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html>. |
19 | <http://cvs.schmorp.de/browse/rxvt-unicode/doc/rxvt.7.html>. |
20 | |
20 | |
21 | RXVT-UNICODE VS. RXVT |
21 | RXVT-UNICODE VS. RXVT |
22 | Unlike the original rxvt, rxvt-unicode stores all text in Unicode |
22 | Unlike the original rxvt, rxvt-unicode stores all text in Unicode |
23 | internally. That means it can store and display most scripts in the |
23 | internally. That means it can store and display most scripts in the |
24 | world. Being a terminal emulator, however, some things are very |
24 | world. Being a terminal emulator, however, some things are very |
25 | difficult, especially cursive scripts such as arabic, vertically written |
25 | difficult, especially cursive scripts such as arabic, vertically written |
26 | scripts like mongolian or scripts requiring extremely complex combining |
26 | scripts like mongolian or scripts requiring extremely complex combining |
27 | rules, like tibetan or devenagari. Don't expect pretty output when using |
27 | rules, like tibetan or devenagari. Don't expect pretty output when using |
28 | these scripts. Most other scripts, latin, cyrillic, kanji, thai etc. |
28 | these scripts. Most other scripts, latin, cyrillic, kanji, thai etc. |
29 | should work fine, though. A somewhat difficult case are left-to-right |
29 | should work fine, though. A somewhat difficult case are right-to-left |
30 | scripts, such as hebrew: rxvt-unicode adopts the view that bidirectional |
30 | scripts, such as hebrew: rxvt-unicode adopts the view that bidirectional |
31 | algorithms belong into the application, not the terminal emulator (too |
31 | algorithms belong into the application, not the terminal emulator (too |
32 | many things -- such as cursor-movement while editing -- break |
32 | many things -- such as cursor-movement while editing -- break |
33 | otherwise), but that might change. |
33 | otherwise), but that might change. |
34 | |
34 | |
35 | If you are looking for a terminal that supports more exotic scripts, let |
35 | If you are looking for a terminal that supports more exotic scripts, let |
36 | me recommend "mlterm", which is a very userfriendly, lean and clean |
36 | me recommend "mlterm", which is a very user friendly, lean and clean |
37 | terminal emulator. In fact, the reason rxvt-unicode was born was solely |
37 | terminal emulator. In fact, the reason rxvt-unicode was born was solely |
38 | because the author couldn't get "mlterm" to use one font for latin1 and |
38 | because the author couldn't get "mlterm" to use one font for latin1 and |
39 | another for japanese. |
39 | another for japanese. |
40 | |
40 | |
41 | Therefore another design rationale was the use of multiple fonts to |
41 | Therefore another design rationale was the use of multiple fonts to |
42 | display characters: The idea of a single unicode font which many other |
42 | display characters: The idea of a single unicode font which many other |
43 | programs force onto it's users never made sense to me: You should be |
43 | programs force onto its users never made sense to me: You should be able |
44 | able to choose any font for any script freely. |
44 | to choose any font for any script freely. |
45 | |
45 | |
46 | Apart from that, rxvt-unicode is also much better internationalised than |
46 | Apart from that, rxvt-unicode is also much better internationalised than |
47 | it's predecessor, supports things such as XFT and ISO 14755 that are |
47 | its predecessor, supports things such as XFT and ISO 14755 that are |
48 | handy in i18n-environments, is faster, and has a lot less bugs than the |
48 | handy in i18n-environments, is faster, and has a lot bugs less than the |
49 | original rxvt. This all in addition to dozens of other small |
49 | original rxvt. This all in addition to dozens of other small |
50 | improvements. |
50 | improvements. |
51 | |
51 | |
52 | It is still faithfully following the original rxvt idea of being lean |
52 | It is still faithfully following the original rxvt idea of being lean |
53 | and nice on resources: for example, you can still configure rxvt-unicode |
53 | and nice on resources: for example, you can still configure rxvt-unicode |
54 | without most of it's features to get a lean binary. It also comes with a |
54 | without most of its features to get a lean binary. It also comes with a |
55 | client/daemon pair that lets you open any number of terminal windows |
55 | client/daemon pair that lets you open any number of terminal windows |
56 | from within a single process, which makes startup time very fast and |
56 | from within a single process, which makes startup time very fast and |
57 | drastically reduces memory usage. See rxvtd(1) (daemon) and rxvtc(1) |
57 | drastically reduces memory usage. See rxvtd(1) (daemon) and rxvtc(1) |
58 | (client). |
58 | (client). |
59 | |
59 | |
60 | It also makes technical information about escape sequences (which have |
60 | It also makes technical information about escape sequences (which have |
61 | been extended) easier accessible: see rxvt(7) for technical reference |
61 | been extended) more accessible: see rxvt(7) for technical reference |
62 | documentation (escape sequences etc.). |
62 | documentation (escape sequences etc.). |
63 | |
63 | |
64 | OPTIONS |
64 | OPTIONS |
65 | The rxvt options (mostly a subset of *xterm*'s) are listed below. In |
65 | The rxvt options (mostly a subset of *xterm*'s) are listed below. In |
66 | keeping with the smaller-is-better philosophy, options may be eliminated |
66 | keeping with the smaller-is-better philosophy, options may be eliminated |
… | |
… | |
85 | Attempt to open a window on the named X display (-d still |
85 | Attempt to open a window on the named X display (-d still |
86 | respected). In the absence of this option, the display specified by |
86 | respected). In the absence of this option, the display specified by |
87 | the DISPLAY environment variable is used. |
87 | the DISPLAY environment variable is used. |
88 | |
88 | |
89 | -depth *bitdepth* |
89 | -depth *bitdepth* |
90 | Compile *frills*: Attempt to find a visual with the given bit depth; |
90 | Compile *xft*: Attempt to find a visual with the given bit depth; |
91 | resource depth. |
91 | resource depth. |
92 | |
92 | |
93 | -geometry *geom* |
93 | -geometry *geom* |
94 | Window geometry (-g still respected); resource geometry. |
94 | Window geometry (-g still respected); resource geometry. |
95 | |
95 | |
… | |
… | |
100 | Turn on/off jump scrolling; resource jumpScroll. |
100 | Turn on/off jump scrolling; resource jumpScroll. |
101 | |
101 | |
102 | -ip|+ip | -tr|+tr |
102 | -ip|+ip | -tr|+tr |
103 | Turn on/off inheriting parent window's pixmap. Alternative form is |
103 | Turn on/off inheriting parent window's pixmap. Alternative form is |
104 | -tr; resource inheritPixmap. |
104 | -tr; resource inheritPixmap. |
|
|
105 | |
|
|
106 | *Please note that transparency of any kind if completely unsupported |
|
|
107 | by the author. Don't bug him with installation questions! Read the |
|
|
108 | FAQ (man 7 rxvt)!* |
105 | |
109 | |
106 | -fade *number* |
110 | -fade *number* |
107 | Fade the text by the given percentage when focus is lost. Small |
111 | Fade the text by the given percentage when focus is lost. Small |
108 | values fade a little only, 100 completely replaces all colours by |
112 | values fade a little only, 100 completely replaces all colours by |
109 | the fade colour; resource fading. |
113 | the fade colour; resource fading. |
110 | |
114 | |
111 | -fadecolor *colour* |
115 | -fadecolor *colour* |
112 | Fade to this colour when fading is used (see -fade). The default |
116 | Fade to this colour when fading is used (see -fade). The default |
113 | colour is black. resource fadeColor. |
117 | colour is opaque black. resource fadeColor. |
114 | |
118 | |
115 | -tint *colour* |
119 | -tint *colour* |
116 | Tint the transparent background pixmap with the given colour when |
120 | Tint the transparent background pixmap with the given colour when |
117 | transparency is enabled with -tr or -ip. This only works for |
121 | transparency is enabled with -tr or -ip. This only works for |
118 | non-tiled backgrounds, currently. See also the -sh option that can |
122 | non-tiled backgrounds, currently. See also the -sh option that can |
… | |
… | |
156 | characters. The first font defines the cell size for characters; |
160 | characters. The first font defines the cell size for characters; |
157 | other fonts might be smaller, but not (in general) larger. A |
161 | other fonts might be smaller, but not (in general) larger. A |
158 | (hopefully) reasonable default font list is always appended to it. |
162 | (hopefully) reasonable default font list is always appended to it. |
159 | See resource font for more details. |
163 | See resource font for more details. |
160 | |
164 | |
161 | In short, to specify an X11 core font, just specify it's name or |
165 | In short, to specify an X11 core font, just specify its name or |
162 | prefix it with "x:". To specify an XFT-font, you need to prefix it |
166 | prefix it with "x:". To specify an XFT-font, you need to prefix it |
163 | with "xft:", e.g.: |
167 | with "xft:", e.g.: |
164 | |
168 | |
165 | rxvt -fn "xft:Bitstream Vera Sans Mono:pixelsize=15" |
169 | rxvt -fn "xft:Bitstream Vera Sans Mono:pixelsize=15" |
166 | rxvt -fn "9x15bold,xft:Bitstream Vera Sans Mono" |
170 | rxvt -fn "9x15bold,xft:Bitstream Vera Sans Mono" |
… | |
… | |
354 | |
358 | |
355 | -keysym.*sym* *string* |
359 | -keysym.*sym* *string* |
356 | Remap a key symbol. See resource keysym. |
360 | Remap a key symbol. See resource keysym. |
357 | |
361 | |
358 | -embed *windowid* |
362 | -embed *windowid* |
359 | Tells rxvt to embed it's windows into an already-existing window, |
363 | Tells rxvt to embed its windows into an already-existing window, |
360 | which enables applications to easily embed a terminal. |
364 | which enables applications to easily embed a terminal. |
361 | |
365 | |
362 | Right now, rxvt will first unmap/map the specified window, so it |
366 | Right now, rxvt will first unmap/map the specified window, so it |
363 | shouldn't be a top-level window. rxvt will also reconfigure it quite |
367 | shouldn't be a top-level window. rxvt will also reconfigure it quite |
364 | a bit, so don't expect it to keep some specific state. It's best to |
368 | a bit, so don't expect it to keep some specific state. It's best to |
… | |
… | |
367 | The window will not be destroyed when rxvt exits. |
371 | The window will not be destroyed when rxvt exits. |
368 | |
372 | |
369 | It might be useful to know that rxvt will not close file descriptors |
373 | It might be useful to know that rxvt will not close file descriptors |
370 | passed to it (except for stdin/out/err, of course), so you can use |
374 | passed to it (except for stdin/out/err, of course), so you can use |
371 | file descriptors to communicate with the programs within the |
375 | file descriptors to communicate with the programs within the |
372 | terminal. This works regardless of wether the "-embed" option was |
376 | terminal. This works regardless of whether the "-embed" option was |
373 | used or not. |
377 | used or not. |
374 | |
378 | |
375 | Here is a short Gtk2-perl snippet that illustrates how this option |
379 | Here is a short Gtk2-perl snippet that illustrates how this option |
376 | can be used (a longer example is in doc/embed): |
380 | can be used (a longer example is in doc/embed): |
377 | |
381 | |
… | |
… | |
381 | system "rxvt -embed $xid &"; |
385 | system "rxvt -embed $xid &"; |
382 | }); |
386 | }); |
383 | |
387 | |
384 | -pty-fd *file descriptor* |
388 | -pty-fd *file descriptor* |
385 | Tells rxvt NOT to execute any commands or create a new pty/tty pair |
389 | Tells rxvt NOT to execute any commands or create a new pty/tty pair |
386 | but instead use the given filehandle as the tty master. This is |
390 | but instead use the given file descriptor as the tty master. This is |
387 | useful if you want to drive rxvt as a generic terminal emulator |
391 | useful if you want to drive rxvt as a generic terminal emulator |
388 | without having to run a program within it. |
392 | without having to run a program within it. |
389 | |
393 | |
390 | If this switch is given, rxvt will not create any utmp/wtmp entries |
394 | If this switch is given, rxvt will not create any utmp/wtmp entries |
391 | and will not tinker with pty/tty permissions - you have to do that |
395 | and will not tinker with pty/tty permissions - you have to do that |
… | |
… | |
437 | settings. The following resources are supported (you might want to check |
441 | settings. The following resources are supported (you might want to check |
438 | the rxvtperl(3) manpage for additional settings by perl extensions not |
442 | the rxvtperl(3) manpage for additional settings by perl extensions not |
439 | documented here): |
443 | documented here): |
440 | |
444 | |
441 | depth: *bitdepth* |
445 | depth: *bitdepth* |
442 | Compile *frills*: Attempt to find a visual with the given bit depth; |
446 | Compile *xft*: Attempt to find a visual with the given bit depth; |
443 | option -depth. |
447 | option -depth. |
444 | |
448 | |
445 | geometry: *geom* |
449 | geometry: *geom* |
446 | Create the window with the specified X window geometry [default |
450 | Create the window with the specified X window geometry [default |
447 | 80x24]; option -geometry. |
451 | 80x24]; option -geometry. |
… | |
… | |
509 | |
513 | |
510 | inheritPixmap: *boolean* |
514 | inheritPixmap: *boolean* |
511 | True: make the background inherit the parent windows' pixmap, giving |
515 | True: make the background inherit the parent windows' pixmap, giving |
512 | artificial transparency. False: do not inherit the parent windows' |
516 | artificial transparency. False: do not inherit the parent windows' |
513 | pixmap. |
517 | pixmap. |
|
|
518 | |
|
|
519 | *Please note that transparency of any kind if completely unsupported |
|
|
520 | by the author. Don't bug him with installation questions!* |
514 | |
521 | |
515 | fading: *number* |
522 | fading: *number* |
516 | Fade the text by the given percentage when focus is lost; option |
523 | Fade the text by the given percentage when focus is lost; option |
517 | -fade. |
524 | -fade. |
518 | |
525 | |
… | |
… | |
616 | normal text font will being used for the given style. |
623 | normal text font will being used for the given style. |
617 | |
624 | |
618 | intensityStyles: *boolean* |
625 | intensityStyles: *boolean* |
619 | When font styles are not enabled, or this option is enabled (True, |
626 | When font styles are not enabled, or this option is enabled (True, |
620 | option -is, the default), bold and italic font styles imply high |
627 | option -is, the default), bold and italic font styles imply high |
621 | intensity foreground/backround colours. Disabling this option |
628 | intensity foreground/background colours. Disabling this option |
622 | (False, option +is) disables this behaviour, the high intensity |
629 | (False, option +is) disables this behaviour, the high intensity |
623 | colours are not reachable. |
630 | colours are not reachable. |
624 | |
631 | |
625 | selectstyle: *mode* |
632 | selectstyle: *mode* |
626 | Set mouse selection style to old which is 2.20, oldword which is |
633 | Set mouse selection style to old which is 2.20, oldword which is |
… | |
… | |
669 | Example: |
676 | Example: |
670 | |
677 | |
671 | URxvt.print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX) |
678 | URxvt.print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX) |
672 | |
679 | |
673 | This creates a new file in your home directory with the screen |
680 | This creates a new file in your home directory with the screen |
674 | contents everytime you hit "Print". |
681 | contents every time you hit "Print". |
675 | |
682 | |
676 | scrollBar: *boolean* |
683 | scrollBar: *boolean* |
677 | True: enable the scrollbar [default]; option -sb. False: disable the |
684 | True: enable the scrollbar [default]; option -sb. False: disable the |
678 | scrollbar; option +sb. |
685 | scrollbar; option +sb. |
679 | |
686 | |
… | |
… | |
694 | do not scroll to bottom when tty receives output; option +si. |
701 | do not scroll to bottom when tty receives output; option +si. |
695 | |
702 | |
696 | scrollWithBuffer: *boolean* |
703 | scrollWithBuffer: *boolean* |
697 | True: scroll with scrollback buffer when tty receives new lines (and |
704 | True: scroll with scrollback buffer when tty receives new lines (and |
698 | scrollTtyOutput is False); option -sw. False: do not scroll with |
705 | scrollTtyOutput is False); option -sw. False: do not scroll with |
699 | scrollback buffer when tty recieves new lines; option +sw. |
706 | scrollback buffer when tty receives new lines; option +sw. |
700 | |
707 | |
701 | scrollTtyKeypress: *boolean* |
708 | scrollTtyKeypress: *boolean* |
702 | True: scroll to bottom when a non-special key is pressed. Special |
709 | True: scroll to bottom when a non-special key is pressed. Special |
703 | keys are those which are intercepted by rxvt-unicode for special |
710 | keys are those which are intercepted by rxvt-unicode for special |
704 | handling and are not passed onto the shell; option -sk. False: do |
711 | handling and are not passed onto the shell; option -sk. False: do |
… | |
… | |
879 | |
886 | |
880 | *string* may contain escape values ("\a": bell, "\b": backspace, |
887 | *string* may contain escape values ("\a": bell, "\b": backspace, |
881 | "\e", "\E": escape, "\n": newline, "\r": carriage return, "\t": tab, |
888 | "\e", "\E": escape, "\n": newline, "\r": carriage return, "\t": tab, |
882 | "\000": octal number) or verbatim control characters ("^?": delete, |
889 | "\000": octal number) or verbatim control characters ("^?": delete, |
883 | "^@": null, "^A" ...) and may be enclosed with double quotes so that |
890 | "^@": null, "^A" ...) and may be enclosed with double quotes so that |
884 | it can start or end with whitespace. |
891 | it can start or end with whitespace. This feature is deprecated and |
|
|
892 | will be removed. |
885 | |
893 | |
886 | Please note that you need to double the "\" in resource files, as |
894 | Please note that you need to double the "\" in resource files, as |
887 | Xlib itself does it's own de-escaping (you can use "\033" instead of |
895 | Xlib itself does its own de-escaping (you can use "\033" instead of |
888 | "\e" (and so on), which will work with both Xt and rxvt's own |
896 | "\e" (and so on), which will work with both Xt and rxvt's own |
889 | processing). |
897 | processing). |
890 | |
898 | |
891 | You can define a range of keysyms in one shot by providing a |
899 | You can define a range of keysyms in one shot by providing a |
892 | *string* with pattern list/PREFIX/MIDDLE/SUFFIX, where the delimeter |
900 | *string* with pattern list/PREFIX/MIDDLE/SUFFIX, where the delimiter |
893 | `/' should be a character not used by the strings. |
901 | `/' should be a character not used by the strings. |
894 | |
902 | |
895 | Its usage can be demonstrated by an example: |
903 | Its usage can be demonstrated by an example: |
896 | |
904 | |
897 | URxvt.keysym.M-C-0x61: list|\033<M-C-|abc|> |
905 | URxvt.keysym.M-C-0x61: list|\033<M-C-|abc|> |
… | |
… | |
959 | For example, "default,-selection" will use all the default extension |
967 | For example, "default,-selection" will use all the default extension |
960 | except "selection". |
968 | except "selection". |
961 | |
969 | |
962 | Extension names can also be followed by an argument in angle |
970 | Extension names can also be followed by an argument in angle |
963 | brackets (e.g. "searchable-scrollback<M-s>", which binds the hotkey |
971 | brackets (e.g. "searchable-scrollback<M-s>", which binds the hotkey |
964 | for searchable scorllback to Alt/Meta-s). Mentioning the same |
972 | for searchable scrollback to Alt/Meta-s). Mentioning the same |
965 | extension multiple times with different arguments will pass multiple |
973 | extension multiple times with different arguments will pass multiple |
966 | arguments to the extension. |
974 | arguments to the extension. |
967 | |
975 | |
968 | Each extension is looked up in the library directories, loaded if |
976 | Each extension is looked up in the library directories, loaded if |
969 | necessary, and bound to the current terminal instance. |
977 | necessary, and bound to the current terminal instance. |
… | |
… | |
1104 | This mode lets you input characters representing the keycap symbols |
1112 | This mode lets you input characters representing the keycap symbols |
1105 | of your keyboard, if representable in the current locale encoding. |
1113 | of your keyboard, if representable in the current locale encoding. |
1106 | |
1114 | |
1107 | Start by pressing "Control" and "Shift" together, then releasing |
1115 | Start by pressing "Control" and "Shift" together, then releasing |
1108 | them. The next special key (cursor keys, home etc.) you enter will |
1116 | them. The next special key (cursor keys, home etc.) you enter will |
1109 | not invoke it's usual function but instead will insert the |
1117 | not invoke its usual function but instead will insert the |
1110 | corresponding keycap symbol. The symbol will only be entered when |
1118 | corresponding keycap symbol. The symbol will only be entered when |
1111 | the key has been released, otherwise pressing e.g. "Shift" would |
1119 | the key has been released, otherwise pressing e.g. "Shift" would |
1112 | enter the symbol for "ISO Level 2 Switch", although your intention |
1120 | enter the symbol for "ISO Level 2 Switch", although your intention |
1113 | might have been to enter a reverse tab (Shift-Tab). |
1121 | might have been to enter a reverse tab (Shift-Tab). |
1114 | |
1122 | |
… | |
… | |
1169 | It is also possible to specify the colour values of foreground, |
1177 | It is also possible to specify the colour values of foreground, |
1170 | background, cursorColor, cursorColor2, colorBD, colorUL as a number |
1178 | background, cursorColor, cursorColor2, colorBD, colorUL as a number |
1171 | 0-15, as a convenient shorthand to reference the colour name of |
1179 | 0-15, as a convenient shorthand to reference the colour name of |
1172 | color0-color15. |
1180 | color0-color15. |
1173 | |
1181 | |
1174 | If Xft support has been compiled in and as long as Xft/Xrender/X don't |
1182 | In addition to the colours defined above, rxvt offers an additional 72 |
1175 | get their act together, rxvt-unicode will support |
1183 | colours. The first 64 of those (with indices 16 to 79) consist of a |
1176 | "rgba:rrrr/gggg/bbbb/aaaa" (recommended, but MUST have 4 |
1184 | 4*4*4 RGB colour cube (i.e. *index = r * 16 + g * 4 + b + 16*), followed |
1177 | digits/component), "#ARGB", "#AARRGGBB" and "#AAAARRRRGGGGBBBB" colour |
1185 | by 8 additional shades of gray (with indices 80 to 87). |
1178 | specifications, in addition to the ones provided by X, where the |
1186 | |
1179 | additional A component specifies alpha (opacity) values (0 is completely |
1187 | Together, all those colours implement the 88 colour xterm colours. Only |
1180 | transparent and the maximum is opaque). You probably need to specify |
1188 | the first 16 can be changed using resources currently, the rest can only |
1181 | "-depth 32", too, and have the luck that your X-server uses ARGB pixel |
1189 | be changed via command sequences ("escape codes"). |
1182 | layout, as X is far from just supporting ARGB visuals out of the box, |
|
|
1183 | and rxvt-unicode just fudges around. |
|
|
1184 | |
1190 | |
1185 | Note that -rv ("reverseVideo: True") simulates reverse video by always |
1191 | Note that -rv ("reverseVideo: True") simulates reverse video by always |
1186 | swapping the foreground/background colours. This is in contrast to |
1192 | swapping the foreground/background colours. This is in contrast to |
1187 | *xterm*(1) where the colours are only swapped if they have not otherwise |
1193 | *xterm*(1) where the colours are only swapped if they have not otherwise |
1188 | been specified. For example, |
1194 | been specified. For example, |
1189 | |
1195 | |
1190 | rxvt -fg Black -bg White -rv |
1196 | rxvt -fg Black -bg White -rv |
1191 | would yield White on Black, while on *xterm*(1) it would yield Black |
1197 | would yield White on Black, while on *xterm*(1) it would yield Black |
1192 | on White. |
1198 | on White. |
1193 | |
1199 | |
|
|
1200 | ALPHA CHANNEL SUPPORT |
|
|
1201 | If Xft support has been compiled in and as long as Xft/Xrender/X don't |
|
|
1202 | get their act together, rxvt-unicode will support |
|
|
1203 | "rgba:rrrr/gggg/bbbb/aaaa" (recommended, but MUST have 4 |
|
|
1204 | digits/component) colour specifications, in addition to the ones |
|
|
1205 | provided by X, where the additional A component specifies opacity |
|
|
1206 | (alpha) values. The minimum value of 0 is completely transparent). You |
|
|
1207 | can also prefix any color with "[a]", where "a" is on to four hex digits |
|
|
1208 | specifiying the opacity value. |
|
|
1209 | |
|
|
1210 | You probably need to specify "-depth 32", too, and have the luck that |
|
|
1211 | your X-server uses ARGB pixel layout, as X is far from just supporting |
|
|
1212 | ARGB visuals out of the box, and rxvt-unicode just fudges around. |
|
|
1213 | |
|
|
1214 | For example, the following selects an almost completely transparent red |
|
|
1215 | background, and an almost opaque pink foreground: |
|
|
1216 | |
|
|
1217 | rxvt -depth 32 -bg rgba:0000/0000/0000/2222 -fg "[e]pink" |
|
|
1218 | |
|
|
1219 | *Please note that transparency of any kind if completely unsupported by |
|
|
1220 | the author. Don't bug him with installation questions!* |
|
|
1221 | |
1194 | ENVIRONMENT |
1222 | ENVIRONMENT |
1195 | rxvt sets and/or uses the following environment variables: |
1223 | rxvt sets and/or uses the following environment variables: |
1196 | |
1224 | |
1197 | TERM |
1225 | TERM |
1198 | Normally set to "rxvt-unicode", unless overwritten at configure |
1226 | Normally set to "rxvt-unicode", unless overwritten at configure |
1199 | time, via resources or on the commandline. |
1227 | time, via resources or on the command line. |
1200 | |
1228 | |
1201 | COLORTERM |
1229 | COLORTERM |
1202 | Either "rxvt", "rxvt-xpm", depending on wether rxvt was compiled |
1230 | Either "rxvt", "rxvt-xpm", depending on whether rxvt was compiled |
1203 | with XPM support, and optionally with the added extension "-mono" to |
1231 | with XPM support, and optionally with the added extension "-mono" to |
1204 | indicate that rxvt-unicode runs on a monochrome screen. |
1232 | indicate that rxvt-unicode runs on a monochrome screen. |
1205 | |
1233 | |
1206 | COLORFGBG |
1234 | COLORFGBG |
1207 | Set to a string of the form "fg;bg" or "fg;xpm;bg", where "fg" is |
1235 | Set to a string of the form "fg;bg" or "fg;xpm;bg", where "fg" is |
… | |
… | |
1221 | Set to the terminfo directory iff rxvt was configured with |
1249 | Set to the terminfo directory iff rxvt was configured with |
1222 | "--with-terminfo=PATH". |
1250 | "--with-terminfo=PATH". |
1223 | |
1251 | |
1224 | DISPLAY |
1252 | DISPLAY |
1225 | Used by rxvt to connect to the display and set to the correct |
1253 | Used by rxvt to connect to the display and set to the correct |
1226 | display in it's child processes. |
1254 | display in its child processes. |
1227 | |
1255 | |
1228 | SHELL |
1256 | SHELL |
1229 | The shell to be used for command execution, defaults to "/bin/sh". |
1257 | The shell to be used for command execution, defaults to "/bin/sh". |
1230 | |
1258 | |
1231 | RXVT_SOCKET |
1259 | RXVT_SOCKET |
… | |
… | |
1255 | |
1283 | |
1256 | CURRENT PROJECT COORDINATOR |
1284 | CURRENT PROJECT COORDINATOR |
1257 | Project Coordinator |
1285 | Project Coordinator |
1258 | Marc A. Lehmann <rxvt-unicode@schmorp.de> |
1286 | Marc A. Lehmann <rxvt-unicode@schmorp.de> |
1259 | |
1287 | |
1260 | <http://software.schmorp.de/#rxvt-unicode> |
1288 | <http://software.schmorp.de/pkg/rxvt-unicode.html> |
1261 | |
1289 | |
1262 | AUTHORS |
1290 | AUTHORS |
1263 | John Bovey |
1291 | John Bovey |
1264 | University of Kent, 1992, wrote the original Xvt. |
1292 | University of Kent, 1992, wrote the original Xvt. |
1265 | |
1293 | |