urlview(1)                           General Commands Manual                           urlview(1)



NAME
       urlview - URL extractor/launcher

SYNOPSIS
       urlview filename [ filename ... ]

DESCRIPTION
       urlview  is a screen oriented program for extracting URLs from text files and displaying a
       menu from which you may launch a command to view a specific item.

CONFIGURATION
       urlview attempts to read ~/.urlview upon startup.  If this file doesn't exist, it will try
       to  read  a  system wide file in /etc/urlview/system.urlview.  There are two configuration
       commands (order does not matter):

       REGEXP regexp
              urlview uses a regular expression to extract URLs from the  specified  text  files.
              \r,  \t,  \n  and  \f  are  all  converted to their normal printf(3) meanings.  The
              default REGEXP is:

       (((http|https|ftp|gopher)|mailto):(//)?[^ <>"\t]*|(www|ftp)[0-9]?\.[-a-z0-9.]+)[^ .,;\t\n\r<">\):]?[^, <>"\t]*[^ .,;\t\n\r<">\):]


       COMMAND command
              If the specified command contains a %s, it will be subsituted with the URL that was
              requested,  otherwise  the URL is appended to the COMMAND string.  The default COM‐
              MAND is:

              /etc/urlview/url_handler.sh

       Note: You should never put single quotes around the %s.  urlview does this  for  you,  and
       also  makes sure that single quotes eventually showing up inside the URL are handled prop‐
       erly.  (Note that this shouldn't happen with the default regular expression, which explic‐
       itly excludes single quotes.)

       WRAP  choice
              Enable or disable URL wrapping. Valid values for choice are: yes, no (case insensi‐
              tive).  If this option is not supplied, the default behaviour is to  disable  wrap‐
              ping.

FILES
       /etc/urlview/system.urlview
              system-wide urlview configuration file

       ~/.urlview
              urlview configuration file

ENVIRONMENT
       If the environment variable BROWSER is set to a browser command, or a colon-delimited list
       of commands to try, then the specified browser is used. %s is replaced with the quoted url
       to view. If %s is not part of a command, the url is appended to the command.

       The  BROWSER  environment variable is honored only if the rc-file doesn't contain the COM‐
       MAND option.  The rc-file provided by the Debian package contains a COMMAND option.

SEE ALSO
       printf(3), regcomp(3), regex(7), environ(7)

AUTHOR
       Michael Elkins <me AT cs.edu>.

       Modified for Debian by Luis Francisco  Gonzalez  <luisgh AT debian.org>  and  Emanuele  Rocca
       <ema AT debian.org>.

       Modified for SuSE by Dr. Werner Fink <werner AT suse.de> and Stepan Kasal <kasal AT suse.cz>.

       Changes put together by Thomas Roessler <roessler AT does-not-exist.org>.




                                                                                       urlview(1)