ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/cvsroot/rxvt-unicode/README.FAQ
(Generate patch)

Comparing cvsroot/rxvt-unicode/README.FAQ (file contents):
Revision 1.70 by root, Fri Dec 26 22:52:22 2014 UTC vs.
Revision 1.75 by root, Sun Nov 14 17:59:19 2021 UTC

1RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS 1RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS
2 Meta, Features & Commandline Issues 2 Meta, Features & Commandline Issues
3 My question isn't answered here, can I ask a human? 3 My question isn't answered here, can I ask a human?
4 Before sending me mail, you could go to IRC: "irc.freenode.net", channel 4 Before sending me mail, you could go to IRC: "irc.libera.chat", channel
5 "#rxvt-unicode" has some rxvt-unicode enthusiasts that might be 5 "#rxvt-unicode" has some rxvt-unicode enthusiasts that might be
6 interested in learning about new and exciting problems (but not FAQs :). 6 interested in learning about new and exciting problems (but not FAQs :).
7 7
8 I use Gentoo, and I have a problem... 8 I use Gentoo, and I have a problem...
9 There are two big problems with Gentoo Linux: first, most if not all 9 There are two big problems with Gentoo Linux: first, most if not all
67 67
68 This tries to create a new terminal, and if fails with exit status 2, 68 This tries to create a new terminal, and if fails with exit status 2,
69 meaning it couldn't connect to the daemon, it will start the daemon and 69 meaning it couldn't connect to the daemon, it will start the daemon and
70 re-run the command. Subsequent invocations of the script will re-use the 70 re-run the command. Subsequent invocations of the script will re-use the
71 existing daemon. 71 existing daemon.
72
73 Another option is to use systemd socket-based activation (see
74 systemd.socket(5)). Here is an example of a service unit file and of a
75 socket unit file for the default socket path:
76
77 urxvtd.service
78 [Unit]
79 Description=urxvt terminal daemon
80 Requires=urxvtd.socket
81
82 [Service]
83 ExecStart=/usr/bin/urxvtd -o
84
85 urxvtd.socket
86 [Unit]
87 Description=urxvt terminal daemon socket
88
89 [Socket]
90 ListenStream=%h/.urxvt/urxvtd-%H
91
92 [Install]
93 WantedBy=sockets.target
72 94
73 How do I distinguish whether I'm running rxvt-unicode or a regular 95 How do I distinguish whether I'm running rxvt-unicode or a regular
74xterm? I need this to decide about setting colours etc. 96xterm? I need this to decide about setting colours etc.
75 The original rxvt and rxvt-unicode always export the variable 97 The original rxvt and rxvt-unicode always export the variable
76 "COLORTERM", so you can check and see if that is set. Note that several 98 "COLORTERM", so you can check and see if that is set. Note that several
188 rite of passage: ... and you failed. 210 rite of passage: ... and you failed.
189 211
190 Here are four ways to get transparency. Do read the manpage and option 212 Here are four ways to get transparency. Do read the manpage and option
191 descriptions for the programs mentioned and rxvt-unicode. Really, do it! 213 descriptions for the programs mentioned and rxvt-unicode. Really, do it!
192 214
193 1. Use transparent mode: 215 1. Use pseudo-transparency:
194 216
195 Esetroot wallpaper.jpg 217 Esetroot wallpaper.jpg
196 urxvt -tr -tint red -sh 40 218 urxvt -tr -tint red -sh 40
197 219
198 That works. If you think it doesn't, you lack transparency and tinting 220 That works. If you think it doesn't, you lack transparency and tinting
213 3. Use an ARGB visual: 235 3. Use an ARGB visual:
214 236
215 urxvt -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc 237 urxvt -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc
216 238
217 This requires XFT support, and the support of your X-server. If that 239 This requires XFT support, and the support of your X-server. If that
218 doesn't work for you, blame Xorg and Keith Packard. ARGB visuals aren't 240 doesn't work for you, find a working composite manager or window
219 there yet, no matter what they claim. Rxvt-Unicode contains the 241 manager, both are required to support ARGB visuals for client windows.
220 necessary bugfixes and workarounds for Xft and Xlib to make it work, but
221 that doesn't mean that your WM has the required kludges in place.
222 242
223 4. Use xcompmgr and let it do the job: 243 4. Use xcompmgr and let it do the job:
224 244
225 xprop -frame -f _NET_WM_WINDOW_OPACITY 32c \ 245 xprop -frame -f _NET_WM_WINDOW_OPACITY 32c \
226 -set _NET_WM_WINDOW_OPACITY 0xc0000000 246 -set _NET_WM_WINDOW_OPACITY 0xc0000000
428 We are working on it, in the meantime, as a workaround, use something 448 We are working on it, in the meantime, as a workaround, use something
429 like: 449 like:
430 450
431 urxvt -b 600 -geometry 20x1 -e sh -c 'mplayer -wid $WINDOWID file...' 451 urxvt -b 600 -geometry 20x1 -e sh -c 'mplayer -wid $WINDOWID file...'
432 452
453 Why is the cursor now blinking in emacs/vi/...?
454 This is likely caused by your editor/program's use of the "cvvis"
455 terminfo capability. Emacs uses it by default, as well as some versions
456 of vi and possibly other programs.
457
458 In emacs, you can switch that off by adding this to your ".emacs" file:
459
460 (setq visible-cursor nil)
461
462 For other programs, if they do not have an option, your have to remove
463 the "cvvis" capability from the terminfo description.
464
465 When urxvt first added the blinking cursor option, it didn't add a
466 "cvvis" capability, which served no purpose before. Version 9.21
467 introduced "cvvis" (and the ability to control blinking independent of
468 cursor shape) for compatibility with other terminals, which
469 traditionally use a blinking cursor for "cvvis". This also reflects the
470 intent of programs such as emacs, who expect "cvvis" to enable a
471 blinking cursor.
472
433 Keyboard, Mouse & User Interaction 473 Keyboard, Mouse & User Interaction
434 The new selection selects pieces that are too big, how can I select single words? 474 The new selection selects pieces that are too big, how can I select single words?
435 If you want to select e.g. alphanumeric words, you can use the following 475 If you want to select e.g. alphanumeric words, you can use the following
436 setting: 476 setting:
437 477
462 URxvt.perl-ext-common: default,-selection-popup,-option-popup 502 URxvt.perl-ext-common: default,-selection-popup,-option-popup
463 503
464 This will keep the default extensions, but disable the two popup 504 This will keep the default extensions, but disable the two popup
465 extensions. Some extensions can also be configured, for example, 505 extensions. Some extensions can also be configured, for example,
466 scrollback search mode is triggered by M-s. You can move it to any other 506 scrollback search mode is triggered by M-s. You can move it to any other
467 combination either by setting the searchable-scrollback resource: 507 combination by adding a keysym resource that binds the desired
508 combination to the "start" action of "searchable-scrollback" and another
509 one that binds M-s to the "builtin:" action:
468 510
469 URxvt.searchable-scrollback: CM-s 511 URxvt.keysym.CM-s: searchable-scrollback:start
512 URxvt.keysym.M-s: builtin:
470 513
471 The cursor moves when selecting text in the current input line, how do I switch this off? 514 The cursor moves when selecting text in the current input line, how do I switch this off?
472 See next entry. 515 See next entry.
473 516
474 During rlogin/ssh/telnet/etc. sessions, clicking near the cursor outputs strange escape sequences, how do I fix this? 517 During rlogin/ssh/telnet/etc. sessions, clicking near the cursor outputs strange escape sequences, how do I fix this?
595 time into customising your terminal. To get you started, here is the 638 time into customising your terminal. To get you started, here is the
596 author's .Xdefaults entries, with comments on what they do. It's 639 author's .Xdefaults entries, with comments on what they do. It's
597 certainly not *typical*, but what's typical... 640 certainly not *typical*, but what's typical...
598 641
599 URxvt.cutchars: "()*,<>[]{}|' 642 URxvt.cutchars: "()*,<>[]{}|'
600 URxvt.print-pipe: cat >/tmp/xxx 643 URxvt.print-pipe: cat >/some/path
601 644
602 These are just for testing stuff. 645 These are just for testing stuff.
603 646
604 URxvt.imLocale: ja_JP.UTF-8 647 URxvt.imLocale: ja_JP.UTF-8
605 URxvt.preeditType: OnTheSpot,None 648 URxvt.preeditType: OnTheSpot,None
805 See next entry. 848 See next entry.
806 849
807 I need a termcap file entry. 850 I need a termcap file entry.
808 One reason you might want this is that some distributions or operating 851 One reason you might want this is that some distributions or operating
809 systems still compile some programs using the long-obsoleted termcap 852 systems still compile some programs using the long-obsoleted termcap
810 library (Fedora Core's bash is one example) and rely on a termcap entry 853 library (Fedora's bash is one example) and rely on a termcap entry for
811 for "rxvt-unicode". 854 "rxvt-unicode".
812 855
813 You could use rxvt's termcap entry with reasonable results in many 856 You could use rxvt's termcap entry with reasonable results in many
814 cases. You can also create a termcap entry by using terminfo's infocmp 857 cases. You can also create a termcap entry by using terminfo's infocmp
815 program like this: 858 program like this:
816 859

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines