1 | FREQUENTLY ASKED QUESTIONS |
1 | FREQUENTLY ASKED QUESTIONS |
2 | The new selection selects pieces that are too big/too small, can I |
2 | The new selection selects pieces that are too big, how can I select |
3 | change this? |
3 | single words? |
4 | Yes. For example, if you want to select smaller pieces ("words") you |
4 | Yes. For example, if you want to select alphanumeric words, you can |
5 | can use the following resource: |
5 | use the following resource: |
6 | |
6 | |
7 | URxvt.selection.pattern-0: ([[:word:]]+) |
7 | URxvt.selection.pattern-0: ([[:word:]]+) |
8 | |
8 | |
9 | If you click more than twice, the selection will be extended more |
9 | If you click more than twice, the selection will be extended more |
10 | and more. |
10 | and more. |
11 | |
11 | |
12 | To get a selection that is very similar to the old code, try this |
12 | To get a selection that is very similar to the old code, try this |
13 | pattern: |
13 | pattern: |
14 | |
14 | |
15 | URxvt.selection.pattern-0: ([^"&'()*,;<=>?@[\\\\]^`{|})]+) |
15 | URxvt.selection.pattern-0: ([^"&'()*,;<=>?@[\\\\]^`{|})]+) |
|
|
16 | |
|
|
17 | Please also note that the *LeftClick Shift-LeftClik* combination |
|
|
18 | also selects words like the old code. |
16 | |
19 | |
17 | I don't like the new selection/popups/hotkeys/perl, how do I |
20 | I don't like the new selection/popups/hotkeys/perl, how do I |
18 | change/disable it? |
21 | change/disable it? |
19 | You can disable the perl extension completely by setting the |
22 | You can disable the perl extension completely by setting the |
20 | perl-ext-common resource to the empty string, which also keeps |
23 | perl-ext-common resource to the empty string, which also keeps |
… | |
… | |
33 | scrollback search mode is triggered by M-s. You can move it to any |
36 | scrollback search mode is triggered by M-s. You can move it to any |
34 | other combination either by setting the searchable-scrollback |
37 | other combination either by setting the searchable-scrollback |
35 | resource: |
38 | resource: |
36 | |
39 | |
37 | URxvt.searchable-scrollback: CM-s |
40 | URxvt.searchable-scrollback: CM-s |
|
|
41 | |
|
|
42 | The cursor moves when selecting text in the current input line, how do I |
|
|
43 | switch this off? |
|
|
44 | During rlogin/ssh/telnet/etc. sessions, clicking near the cursor outputs |
|
|
45 | strange escape sequences, how do I fix this? |
|
|
46 | These are caused by the "readline" perl extension. Under normal |
|
|
47 | circumstances, it will move your cursor around when you click into |
|
|
48 | the line that contains it. It tries hard not to do this at the wrong |
|
|
49 | moment, but when running a program that doesn't parse cursor |
|
|
50 | movements or in some cases during rlogin sessions, it fails to |
|
|
51 | detect this properly. |
|
|
52 | |
|
|
53 | You can permamently switch this feature off by disabling the |
|
|
54 | "readline" extension: |
|
|
55 | |
|
|
56 | URxvt.perl-ext-common: default,-readline |
|
|
57 | |
|
|
58 | Why doesn't rxvt-unicode read my resources? |
|
|
59 | Well, why, indeed? It does, in a way very similar to other X |
|
|
60 | applications. Most importantly, this means that if you or your OS |
|
|
61 | loads resources into the X display (the right way to do it), |
|
|
62 | rxvt-unicode will ignore any resource files in your home directory. |
|
|
63 | It will only read $HOME/.Xdefaults when no resources are attached to |
|
|
64 | the display. |
|
|
65 | |
|
|
66 | If you have or use an $HOME/.Xresources file, chances are that |
|
|
67 | resources are loaded into your X-server. In this case, you have to |
|
|
68 | re-login after every change (or run xrdb -merge $HOME/.Xresources). |
|
|
69 | |
|
|
70 | Also consider the form resources have to use: |
|
|
71 | |
|
|
72 | URxvt.resource: value |
|
|
73 | |
|
|
74 | If you want to use another form (there are lots of different ways of |
|
|
75 | specifying resources), make sure you understand wether and why it |
|
|
76 | works. If unsure, use the form above. |
|
|
77 | |
|
|
78 | I can't get transparency working, what am I doing wrong? |
|
|
79 | First of all, transparency isn't officially supported in |
|
|
80 | rxvt-unicode, so you are mostly on your own. Do not bug the author |
|
|
81 | about it (but you may bug everybody else). Also, if you can't get it |
|
|
82 | working consider it a rite of passage: ... and you failed. |
|
|
83 | |
|
|
84 | Here are four ways to get transparency. Do read the manpage and |
|
|
85 | option descriptions for the programs mentioned and rxvt-unicode. |
|
|
86 | Really, do it! |
|
|
87 | |
|
|
88 | 1. Use inheritPixmap: |
|
|
89 | |
|
|
90 | Esetroot wallpaper.jpg |
|
|
91 | rxvt -ip -tint red -sh 40 |
|
|
92 | |
|
|
93 | That works. If you think it doesn't, you lack transparency and |
|
|
94 | tinting support, or you are unable to read. |
|
|
95 | |
|
|
96 | 2. Use a simple pixmap and emulate pseudo-transparency. This enables |
|
|
97 | you to use effects other than tinting and shading: Just |
|
|
98 | shade/tint/whatever your picture with gimp: |
|
|
99 | |
|
|
100 | convert wallpaper.jpg -blur 20x20 -modulate 30 background.xpm |
|
|
101 | rxvt -pixmap background.xpm -pe automove-background |
|
|
102 | |
|
|
103 | That works. If you think it doesn't, you lack XPM and Perl support, |
|
|
104 | or you are unable to read. |
|
|
105 | |
|
|
106 | 3. Use an ARGB visual: |
|
|
107 | |
|
|
108 | rxvt -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc |
|
|
109 | |
|
|
110 | This requires XFT support, and the support of your X-server. If that |
|
|
111 | doesn't work for you, blame Xorg and Keith Packard. ARGB visuals |
|
|
112 | aren't there yet, no matter what they claim. Rxvt-Unicode contains |
|
|
113 | the neccessary bugfixes and workarounds for Xft and Xlib to make it |
|
|
114 | work, but that doesn't mean that your WM has the required kludges in |
|
|
115 | place. |
|
|
116 | |
|
|
117 | 4. Use xcompmgr and let it do the job: |
|
|
118 | |
|
|
119 | xprop -frame -f _NET_WM_WINDOW_OPACITY 32c \ |
|
|
120 | -set _NET_WM_WINDOW_OPACITY 0xc0000000 |
|
|
121 | |
|
|
122 | Then click on a window you want to make transparent. Replace |
|
|
123 | 0xc0000000 by other values to change the degree of opacity. If it |
|
|
124 | doesn't work and your server crashes, you got to keep the pieces. |
38 | |
125 | |
39 | Isn't rxvt supposed to be small? Don't all those features bloat? |
126 | Isn't rxvt supposed to be small? Don't all those features bloat? |
40 | I often get asked about this, and I think, no, they didn't cause |
127 | I often get asked about this, and I think, no, they didn't cause |
41 | extra bloat. If you compare a minimal rxvt and a minimal urxvt, you |
128 | extra bloat. If you compare a minimal rxvt and a minimal urxvt, you |
42 | can see that the urxvt binary is larger (due to some encoding tables |
129 | can see that the urxvt binary is larger (due to some encoding tables |
… | |
… | |
110 | |
197 | |
111 | No large bloated libraries (of course, none were linked in |
198 | No large bloated libraries (of course, none were linked in |
112 | statically), except maybe libX11 :) |
199 | statically), except maybe libX11 :) |
113 | |
200 | |
114 | Does it support tabs, can I have a tabbed rxvt-unicode? |
201 | Does it support tabs, can I have a tabbed rxvt-unicode? |
115 | rxvt-unicode does not directly support tabs. It will work fine with |
202 | Beginning with version 7.3, there is a perl extension that |
116 | tabbing functionality of many window managers or similar tabbing |
203 | implements a simple tabbed terminal. It is installed by default, so |
117 | programs, and its embedding-features allow it to be embedded into |
204 | any of these should give you tabs: |
118 | other programs, as witnessed by doc/rxvt-tabbed or the upcoming |
205 | |
119 | "Gtk2::URxvt" perl module, which features a tabbed urxvt (murxvt) |
206 | rxvt -pe tabbed |
120 | terminal as an example embedding application. |
207 | |
|
|
208 | URxvt.perl-ext-common: default,tabbed |
|
|
209 | |
|
|
210 | It will also work fine with tabbing functionality of many window |
|
|
211 | managers or similar tabbing programs, and its embedding-features |
|
|
212 | allow it to be embedded into other programs, as witnessed by |
|
|
213 | doc/rxvt-tabbed or the upcoming "Gtk2::URxvt" perl module, which |
|
|
214 | features a tabbed urxvt (murxvt) terminal as an example embedding |
|
|
215 | application. |
121 | |
216 | |
122 | How do I know which rxvt-unicode version I'm using? |
217 | How do I know which rxvt-unicode version I'm using? |
123 | The version number is displayed with the usage (-h). Also the escape |
218 | The version number is displayed with the usage (-h). Also the escape |
124 | sequence "ESC [ 8 n" sets the window title to the version number. |
219 | sequence "ESC [ 8 n" sets the window title to the version number. |
125 | When using the rxvtc client, the version displayed is that of the |
220 | When using the rxvtc client, the version displayed is that of the |
126 | daemon. |
221 | daemon. |
127 | |
222 | |
128 | I am using Debian GNU/Linux and have a problem... |
223 | I am using Debian GNU/Linux and have a problem... |
129 | The Debian GNU/Linux package of rxvt-unicode in sarge contains large |
224 | The Debian GNU/Linux package of rxvt-unicode in sarge contains large |
130 | patches that considerably change the behaviour of rxvt-unicode. |
225 | patches that considerably change the behaviour of rxvt-unicode (but |
131 | Before reporting a bug to the original rxvt-unicode author please |
226 | unfortunately this notice has been removed). Before reporting a bug |
132 | download and install the genuine version |
227 | to the original rxvt-unicode author please download and install the |
133 | (<http://software.schmorp.de#rxvt-unicode>) and try to reproduce the |
228 | genuine version (<http://software.schmorp.de#rxvt-unicode>) and try |
134 | problem. If you cannot, chances are that the problems are specific |
229 | to reproduce the problem. If you cannot, chances are that the |
135 | to Debian GNU/Linux, in which case it should be reported via the |
230 | problems are specific to Debian GNU/Linux, in which case it should |
136 | Debian Bug Tracking System (use "reportbug" to report the bug). |
231 | be reported via the Debian Bug Tracking System (use "reportbug" to |
|
|
232 | report the bug). |
137 | |
233 | |
138 | For other problems that also affect the Debian package, you can and |
234 | For other problems that also affect the Debian package, you can and |
139 | probably should use the Debian BTS, too, because, after all, it's |
235 | probably should use the Debian BTS, too, because, after all, it's |
140 | also a bug in the Debian version and it serves as a reminder for |
236 | also a bug in the Debian version and it serves as a reminder for |
141 | other users that might encounter the same issue. |
237 | other users that might encounter the same issue. |
… | |
… | |
162 | of encodings built-in that increase download times and are rarely |
258 | of encodings built-in that increase download times and are rarely |
163 | used). |
259 | used). |
164 | |
260 | |
165 | I need to make it setuid/setgid to support utmp/ptys on my OS, is this |
261 | I need to make it setuid/setgid to support utmp/ptys on my OS, is this |
166 | safe? |
262 | safe? |
167 | Likely not. While I honestly try to make it secure, and am probably |
263 | It should be, starting with release 7.1. You are encouraged to |
168 | not bad at it, I think it is simply unreasonable to expect all of |
264 | properly install urxvt with privileges necessary for your OS now. |
169 | freetype + fontconfig + xft + xlib + perl + ... + rxvt-unicode |
265 | |
170 | itself to all be secure. Also, rxvt-unicode disables some options |
|
|
171 | when it detects that it runs setuid or setgid, which is not nice. |
266 | When rxvt-unicode detects that it runs setuid or setgid, it will |
172 | Besides, with the embedded perl interpreter the possibility for |
267 | fork into a helper process for privileged operations (pty handling |
173 | security problems easily multiplies. |
268 | on some systems, utmp/wtmp/lastlog handling on others) and drop |
|
|
269 | privileges immediately. This is much safer than most other terminals |
|
|
270 | that keep privileges while running (but is more relevant to urxvt, |
|
|
271 | as it contains things as perl interpreters, which might be "helpful" |
|
|
272 | to attackers). |
174 | |
273 | |
175 | Elevated privileges are only required for utmp and pty operations on |
274 | This forking is done as the very first within main(), which is very |
176 | some systems (for example, GNU/Linux doesn't need any extra |
275 | early and reduces possible bugs to initialisation code run before |
177 | privileges for ptys, but some need it for utmp support). It is |
276 | main(), or things like the dynamic loader of your system, which |
178 | planned to mvoe this into a forked handler process, but this is not |
277 | should result in very little risk. |
179 | yet done. |
|
|
180 | |
|
|
181 | So, while setuid/setgid operation is supported and not a problem on |
|
|
182 | your typical single-user-no-other-logins unix desktop, always |
|
|
183 | remember that its an awful lot of code, most of which isn't checked |
|
|
184 | for security issues regularly. |
|
|
185 | |
278 | |
186 | When I log-in to another system it tells me about missing terminfo data? |
279 | When I log-in to another system it tells me about missing terminfo data? |
187 | The terminal description used by rxvt-unicode is not as widely |
280 | The terminal description used by rxvt-unicode is not as widely |
188 | available as that for xterm, or even rxvt (for which the same |
281 | available as that for xterm, or even rxvt (for which the same |
189 | problem often arises). |
282 | problem often arises). |
… | |
… | |
577 | |
670 | |
578 | My input method wants <some encoding> but I want UTF-8, what can I do? |
671 | My input method wants <some encoding> but I want UTF-8, what can I do? |
579 | You can specify separate locales for the input method and the rest |
672 | You can specify separate locales for the input method and the rest |
580 | of the terminal, using the resource "imlocale": |
673 | of the terminal, using the resource "imlocale": |
581 | |
674 | |
582 | URxvt*imlocale: ja_JP.EUC-JP |
675 | URxvt.imlocale: ja_JP.EUC-JP |
583 | |
676 | |
584 | Now you can start your terminal with "LC_CTYPE=ja_JP.UTF-8" and |
677 | Now you can start your terminal with "LC_CTYPE=ja_JP.UTF-8" and |
585 | still use your input method. Please note, however, that you will not |
678 | still use your input method. Please note, however, that you will not |
586 | be able to input characters outside "EUC-JP" in a normal way then, |
679 | be able to input characters outside "EUC-JP" in a normal way then, |
587 | as your input method limits you. |
680 | as your input method limits you. |
… | |
… | |
630 | Mouse cut/paste suddenly no longer works. |
723 | Mouse cut/paste suddenly no longer works. |
631 | Make sure that mouse reporting is actually turned off since killing |
724 | Make sure that mouse reporting is actually turned off since killing |
632 | some editors prematurely may leave the mouse in mouse report mode. |
725 | some editors prematurely may leave the mouse in mouse report mode. |
633 | I've heard that tcsh may use mouse reporting unless it otherwise |
726 | I've heard that tcsh may use mouse reporting unless it otherwise |
634 | specified. A quick check is to see if cut/paste works when the Alt |
727 | specified. A quick check is to see if cut/paste works when the Alt |
635 | or Shift keys are depressed. See rxvt(7) |
728 | or Shift keys are depressed. |
636 | |
729 | |
637 | What's with this bold/blink stuff? |
730 | What's with this bold/blink stuff? |
638 | If no bold colour is set via "colorBD:", bold will invert text using |
731 | If no bold colour is set via "colorBD:", bold will invert text using |
639 | the standard foreground colour. |
732 | the standard foreground colour. |
640 | |
733 | |
… | |
… | |
726 | |
819 | |
727 | # use Backspace = ^? |
820 | # use Backspace = ^? |
728 | $ stty erase ^? |
821 | $ stty erase ^? |
729 | $ rxvt |
822 | $ rxvt |
730 | |
823 | |
731 | Toggle with "ESC [ 36 h" / "ESC [ 36 l" as documented in rxvt(7). |
824 | Toggle with "ESC [ 36 h" / "ESC [ 36 l". |
732 | |
825 | |
733 | For an existing rxvt-unicode: |
826 | For an existing rxvt-unicode: |
734 | |
827 | |
735 | # use Backspace = ^H |
828 | # use Backspace = ^H |
736 | $ stty erase ^H |
829 | $ stty erase ^H |