debian man page for urlscan

URLSCAN(1)						      General Commands Manual							URLSCAN(1)

NAME
       urlscan - browse the URLs in an email message from a terminal

SYNOPSIS
       urlscan [options] < message

       urlscan [options] message

DESCRIPTION
       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.

OPTIONS
       -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.

MUTT INTEGRATION
       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.

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

AUTHOR
       This manual page was written by Daniel Burrows <dburrows@debian.org>.

								 December 10, 2006							URLSCAN(1)