commit 8ad31b4e3ffa42b6daf1f60df2cb8f4fa2faca52
parent 5aad8834594ab619d73edb2ed6a4568ba3ca8304
Author: Christoph Lohmann <20h@r-36.net>
Date: Sun, 27 Aug 2023 09:13:42 +0200
Manually apply patch for urxvt info in README.md.
Thanks Scarlett McAllister <git@roygbyte.com>!
Diffstat:
1 file changed, 26 insertions(+), 2 deletions(-)
diff --git a/README.md b/README.md
@@ -64,14 +64,14 @@ variables for openers.
% echo "Please go to http://searx.me please." | p -tme
# Be surprised about the ease of usage!
-## st (simple terminal) integration
+### st (simple terminal) integration
In my setup I am calling »plumber -tme« via the externalpipe patch, applied to
st mainline. The config.h would include:
{ MODKEY, XK_o, externalpipe, {.v = "plumber -tme" } },
-## dwm (dynamic window manager) integration
+### dwm (dynamic window manager) integration
For using the plumber in dwm I have the »opener(1)« script, which gets the
X11 selection and gives it to the plumber. Here is the config.h entry:
@@ -83,6 +83,30 @@ which opens the selected text. If you use double click to select some URI or
text, plumber has included stripping support to shorten quotation marks or
(square) brackets.
+### urxvt
+
+Urxvt integrates with plumber beautifully because of urxvt-matcher.
+urxvt-matcher can highlight strings of interest like URLs and pass these
+along to plumber, where they will be opened with the assigned opener. To
+do this, you will need to have urxvt-matcher installed on your system.
+Then add the following line to your .Xresources:
+
+ URxvt.matcher.launcher: plumb $0
+ URxvt.matcher.button: 1
+
+Additional URLs can be matched and launched by specifying more patterns
+to urxvt-matcher, as below where two patterns are added for launching
+gopher and gophers:
+
+ URxvt.matcher.pattern.1: \\b(gopher\\:\\/\\/\\S+)\\b
+ URxvt.matcher.launcher.1: plumb $1
+ URxvt.matcher.pattern.2: \\b(gophers\\:\\/\\/\\S+)\\b
+ URxvt.matcher.launcher.2: plumb $1
+
+To see and select the matches, you press M-Del on your keyboard to invoke
+match-select. Then use the up and down arrows to move between matches.
+Press enter to send a selected match to plumb.
+
## Openers
The distribution includes nearly all openers I have written for my local use
