1urxvt-matcher(1)                 RXVT-UNICODE                 urxvt-matcher(1)
2
3
4

NAME

6       matcher - match strings in terminal output and change their rendition
7

DESCRIPTION

9       Uses per-line display filtering ("on_line_update") to underline text
10       matching a certain pattern and make it clickable. When clicked with the
11       mouse button specified in the "matcher.button" resource (default 2, or
12       middle), the program specified in the "matcher.launcher" resource
13       (default, the "url-launcher" resource, "sensible-browser") will be
14       started with the matched text as first argument.  The default
15       configuration is suitable for matching URLs and launching a web
16       browser, like the former "mark-urls" extension.
17
18       The default pattern to match URLs can be overridden with the
19       "matcher.pattern.0" resource, and additional patterns can be specified
20       with numbered patterns, in a manner similar to the "selection"
21       extension.  The launcher can also be overridden on a per-pattern basis.
22
23       It is possible to activate the most recently seen match or a list of
24       matches from the keyboard.  Simply bind a keysym to "matcher:last" or
25       "matcher:list" as seen in the example below.
26
27       The "matcher:select" action enables a mode in which it is possible to
28       iterate over the matches using the keyboard and either activate them or
29       copy them to the clipboard. While the mode is active, normal terminal
30       input/output is suspended and the following bindings are recognized:
31
32       "Up"
33           Search for a match upwards.
34
35       "Down"
36           Search for a match downwards.
37
38       "Home"
39           Jump to the topmost match.
40
41       "End"
42           Jump to the bottommost match.
43
44       "Escape"
45           Leave the mode and return to the point where search was started.
46
47       "Enter"
48           Activate the current match.
49
50       "y" Copy the current match to the clipboard.
51
52       It is also possible to cycle through the matches using a key
53       combination bound to the "matcher:select" action.
54
55       Example: load and use the matcher extension with defaults.
56
57           URxvt.perl-ext:           default,matcher
58
59       Example: use a custom configuration.
60
61           URxvt.url-launcher:       sensible-browser
62           URxvt.keysym.C-Delete:    matcher:last
63           URxvt.keysym.M-Delete:    matcher:list
64           URxvt.matcher.button:     1
65           URxvt.matcher.pattern.1:  \\bwww\\.[\\w-]+\\.[\\w./?&@#-]*[\\w/-]
66           URxvt.matcher.pattern.2:  \\B(/\\S+?):(\\d+)(?=:|$)
67           URxvt.matcher.launcher.2: gvim +$2 $1
68
69
70
719.22                              2020-11-10                  urxvt-matcher(1)
Impressum