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)