1urlview(1)                  General Commands Manual                 urlview(1)
2
3
4

NAME

6       urlview - URL extractor/launcher
7

SYNOPSIS

9       urlview filename [ filename ... ]
10

DESCRIPTION

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

CONFIGURATION

17       urlview attempts to read ~/.urlview upon startup.  If this file doesn't
18       exist, it will try to read a system  wide  file  in  /etc/urlview.conf.
19       There are two configuration commands (order does not matter):
20
21       REGEXP regexp
22              urlview uses a regular expression to extract URLs from the spec‐
23              ified text files.  \r, \t, \n and \f are all converted to  their
24              normal printf(3) meanings.  The default REGEXP is:
25
26       (((http|https|ftp|gopher)|mailto):(//)?[^ <>"\t]*|(www|ftp)[0-9]?\.[-a-z0-9.]+)[^ .,;\t\n\r<">\):]?[^, <>"\t]*[^ .,;\t\n\r<">\):]
27
28
29       COMMAND command
30              If  the  specified  command contains a %s, it will be subsituted
31              with the URL that was requested, otherwise the URL  is  appended
32              to the COMMAND string.  The default COMMAND is:
33
34              /usr/bin/url_handler.sh
35
36       Note:  You  should never put single quotes around the %s.  urlview does
37       this for you, and also makes sure that single quotes eventually showing
38       up inside the URL are handled properly.  (Note that this shouldn't hap‐
39       pen with the default regular expression, which explicitly excludes sin‐
40       gle quotes.)
41
42       WRAP  choice
43              Enable  or  disable  URL  wrapping. Valid values for choice are:
44              yes, no (case insensitive).  If this option is not supplied, the
45              default behaviour is to disable wrapping.
46
47       QUITONLAUNCH
48              Will cause urlview to quit after you launch a URL.
49

FILES

51       /etc/urlview.conf
52              system-wide urlview configuration file
53
54       ~/.urlview
55              urlview configuration file
56

ENVIRONMENT

58       If  the  environment variable BROWSER is set to a browser command, or a
59       colon-delimited list of commands to try, then the specified browser  is
60       used.  %s is replaced with the quoted url to view. If %s is not part of
61       a command, the url is appended to the command.
62
63       The BROWSER environment variable is honored only if the rc-file doesn't
64       contain the COMMAND option.  The rc-file provided by the Debian package
65       contains a COMMAND option.
66

SEE ALSO

68       printf(3), regcomp(3), regex(7), environ(7)
69

AUTHOR

71       Michael Elkins <me@sigpipe.org>
72
73       Modified for Debian by Luis Francisco Gonzalez <luisgh@debian.org>  and
74       Emanuele Rocca <ema@debian.org>.
75
76       Modified  for SuSE by Dr. Werner Fink <werner@suse.de> and Stepan Kasal
77       <kasal@suse.cz>.
78
79       Changes put together by Thomas Roessler <roessler@does-not-exist.org>.
80
81
82
83
84                                                                    urlview(1)
Impressum