108 lines
3.9 KiB
Markdown
108 lines
3.9 KiB
Markdown
A small collection of perl extensions for the rxvt-unicode terminal emulator.
|
|
|
|
Installation
|
|
------------
|
|
Simply place the scripts you want to install in /usr/lib/urxvt/perl/ for
|
|
system-wide availability or in ~/.urxvt/ext/ for user-only availability.
|
|
You can also put them in a folder of your choice, but then you have to add this
|
|
line to your .Xdefaults/.Xresources:
|
|
|
|
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/.Xresources.
|
|
|
|
|
|
keyboard-select
|
|
---------------
|
|
Use keyboard shortcuts to select and copy text.
|
|
|
|
After installing, put the following lines in your .Xdefaults/.Xresources:
|
|
|
|
URxvt.perl-ext-common: ...,keyboard-select
|
|
URxvt.keysym.M-Escape: perl:keyboard-select:activate
|
|
|
|
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
|
|
|
|
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)
|
|
g/G/0/^/$/H/M/L/f/F/;/,/w/W/b/B/e/E: More vi-like cursor movement keys
|
|
'/'/?: Start forward/backward search
|
|
n/N: Repeat last search, N: in reverse direction
|
|
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
|
|
|
|
|
|
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.
|
|
|
|
After installing, put the following lines in your .Xdefaults/.Xresources:
|
|
|
|
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:
|
|
|
|
j/k: Select next downward/upward URL (also with arrow keys)
|
|
g/G: Select first/last URL (also with home/end key)
|
|
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
|
|
|
|
Options:
|
|
|
|
URxvt.url-select.autocopy: if set to true, selected URLs are automatically
|
|
copied to the PRIMARY buffer
|
|
URxvt.url-select.button: mouse button to click-open URLs (default: 2)
|
|
URxvt.url-select.launcher: browser/command to open selected URL with
|
|
URxvt.url-select.underline: if set to true, all URLs get underlined
|
|
|
|
For compatibility reasons, url-select will also use any patterns defined for
|
|
the matcher extension by reading all `URxvt.matcher.pattern.[0-9]` resources.
|
|
|
|
|
|
clipboard
|
|
---------
|
|
Use keyboard shortcuts to copy the selection to the clipboard and to paste the
|
|
clipboard contents (optionally escaping all special characters).
|
|
|
|
After installing, put the following lines in your .Xdefaults/.Xresources:
|
|
|
|
URxvt.perl-ext-common: ...,clipboard
|
|
URxvt.keysym.M-c: perl:clipboard:copy
|
|
URxvt.keysym.M-v: perl:clipboard:paste
|
|
URxvt.keysym.M-C-v: perl:clipboard:paste_escaped
|
|
|
|
Options:
|
|
URxvt.clipboard.autocopy: if set to true, the clipboard is automatically
|
|
updated whenever the PRIMARY selection changes
|
|
|
|
You can also overwrite the system commands to use for copying/pasting.
|
|
The default ones are:
|
|
|
|
URxvt.clipboard.copycmd: xsel -ib
|
|
URxvt.clipboard.pastecmd: xsel -ob
|
|
|
|
If you prefer xclip, then put these lines in your .Xdefaults/.Xresources:
|
|
|
|
URxvt.clipboard.copycmd: xclip -i -selection clipboard
|
|
URxvt.clipboard.pastecmd: xclip -o -selection clipboard
|
|
|
|
On Mac OS X, put these lines in your .Xdefaults/.Xresources:
|
|
|
|
URxvt.clipboard.copycmd: pbcopy
|
|
URxvt.clipboard.pastecmd: pbpaste
|
|
|
|
The use of the functions should be self-explanatory!
|