urlscan (1)

urlscan [options] < message

urlscan [options] message

urlscan accepts a single email message on standard input, then displays a terminal-based list of the URLs in the given message. Selecting a URL will invoke sensible-browser(1) on it (and hence any browser specified in the BROWSER environment variable).

urlscan is primarily intended to be used with the mutt (1) mailreader, but it should work well with any terminal-based mail program.

urlscan is similar to urlview(1), but has the following additional features:

1. Support for more message encodings, such as quoted-printable and base64.

2. Extraction and display of the context surrounding each URL.

-b, --background

Run the Web browser in the background, so you can select another URL without closing it (this will not work with terminal-based Web browsers such as lynx, links, or w3m).

-c, --compact

Display a simple list of the extracted URLs, instead of showing the context of each URL.

To integrate urlscan with mutt, include the following two commands in ~/.muttrc:

macro index,pager \cb "<pipe-message> urlscan<Enter>" "call urlscan to extract URLs out of a message"

macro attach,compose \cb "<pipe-entry> urlscan<Enter>" "call urlscan to extract URLs out of a message"

Once these lines are in your mutt configuration file, pressing Control-b will allow you to browse and open the URLs in the currently selected message.

/usr/share/doc/urlscan/README, sensible-browser(1), urlview(1), mutt(1)

This manual page was written by Daniel Burrows <[email protected]>.