urxvt-perls/README.md

83 lines
2.8 KiB
Markdown
Raw Normal View History

2010-08-13 15:19:52 -04:00
A small collection of perl extensions for the rxvt-unicode terminal emulator.
Installation
------------
Simply place the scripts you want to install in the /usr/lib/urxvt/perl/ folder
for system-wide availability. You can also put them in a folder of your
choice, but then you have to add this line to your .Xdefaults:
URxvt.perl-lib: /your/folder/
See the following sections for information on how to enable the scripts or set
script-specific options and keyboard mappings in your .Xdefaults.
keyboard-select
---------------
Use keyboard shortcuts to select and copy text.
2010-08-19 15:44:18 -04:00
After installing, put the following lines in your .Xdefaults:
2010-08-13 15:19:52 -04:00
URxvt.perl-ext-common: ...,keyboard-select
URxvt.keysym.M-Escape: perl:keyboard-select:activate
2010-09-12 15:10:26 -04:00
The following line overwrites the default Meta-s binding and allows to activate
keyboard-select directly in backward search mode:
URxvt.keysym:M-s: perl:keyboard-select:search
2010-08-13 15:19:52 -04:00
Use Meta-Escape to activate selection mode, then use the following keys:
h/j/k/l: Move cursor left/down/up/right (also with arrow keys)
2010-11-29 13:30:49 -05:00
g/G/0/^/$/H/M/L/f/F/;/,/w/W/b/B/e/E: More vi-like cursor movement keys
2010-09-12 15:10:26 -04:00
'/'/?: Start forward/backward search
n/N: Repeat last search, N: in reverse direction
2010-08-18 19:05:35 -04:00
Ctrl-f/b: Scroll down/up one screen
Ctrl-d/u: Scroll down/up half a screen
v/V/Ctrl-v: Toggle normal/linewise/blockwise selection
y/Return: Copy selection to primary buffer, Return: deactivate afterwards
q/Escape: Deactivate keyboard selection mode
2010-08-13 15:19:52 -04:00
url-select
----------
Use keyboard shortcuts to select URLs.
This should be used as a replacement for the default matcher extension, it also
makes URLs clickable with the middle mouse button.
2010-08-19 15:44:18 -04:00
After installing, put the following lines in your .Xdefaults:
2010-08-13 15:19:52 -04:00
URxvt.perl-ext-common: ...,url-select
URxvt.keysym.M-u: perl:url-select:select_next
Use Meta-u to activate URL selection mode, then use the following keys:
k: Select next upward URL (also with Meta-u)
j: Select next downward URL
o/Return: Open selected URL in browser, Return: deactivate afterwards
y: Copy (yank) selected URL and deactivate selection mode
q/Escape: Deactivate URL selection mode
2010-08-13 15:19:52 -04:00
Options:
URxvt.urlLauncher: browser/command to open selected URL with
URxvt.underlineURLs: if set to true, all URLs get underlined
clipboard
---------
Use keyboard shortcuts to copy the selection to the clipboard and to paste the
clipboard contents (optionally escaping all special characters).
Requires xsel to be installed!
2010-08-19 15:44:18 -04:00
After installing, put the following lines in your .Xdefaults:
2010-08-13 15:19:52 -04:00
URxvt.perl-ext-common: ...,clipboard
2010-08-13 15:19:52 -04:00
URxvt.keysym.M-c: perl:clipboard:copy
URxvt.keysym.M-v: perl:clipboard:paste
URxvt.keysym.M-C-v: perl:clipboard:paste_escaped
The use of the functions should be self-explanatory!