urxvt-matcher(1)

NAME
matcher - match strings in terminal output and change their rendition

DESCRIPTION
Uses per-line display filtering ("on_line_update") to underline text matching a certain pattern and make it clickable. When clicked with the mouse button specified in the "matcher.button" resource (default 2, or middle), the program specified in the "matcher.launcher" resource (default, the "urlLauncher" resource, "sensible-browser") will be started with the matched text as first argument. The default configuration is suitable for matching URLs and launching a web browser, like the former "mark-urls" extension.

The default pattern to match URLs can be overridden with the "matcher.pattern.0" resource, and additional patterns can be specified with numbered patterns, in a manner similar to the "selection" extension. The launcher can also be overridden on a per-pattern basis.

It is possible to activate the most recently seen match or a list of matches from the keyboard. Simply bind a keysym to "perl:matcher:last" or "perl:matcher:list" as seen in the example below.

Example configuration:

    URxvt.perl-ext:           default,matcher
    URxvt.url-launcher:       sensible-browser
    URxvt.keysym.C-Delete:    perl:matcher:last
    URxvt.keysym.M-Delete:    perl:matcher:list
    URxvt.matcher.button:     1
    URxvt.matcher.pattern.1:  \\bwww\\.[\\w-]+\\.[\\w./?&@#-]*[\\w/-]
    URxvt.matcher.pattern.2:  \\B(/\\S+?):(\\d+)(?=:|$)
    URxvt.matcher.launcher.2: gvim +$2 $1