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)