WebBrowser

Package: WA2L/WinTools 1.2.08
Section: General Commands (1)
Updated: 24 June 2024
Index Return to Main Contents

 

NAME

WebBrowser - start a WebBrowser using run WebBrowser

 

SYNOPSIS

WA2LWinTools/bin/WebBrowser [ -h | -i | -u | -V ]

WebBrowser [ options ]

 

AVAILABILITY

WA2L/WinTools

 

DESCRIPTION

start a web browser as defined in run(1) respectively run.cfg(4) thru a single command.

This enables to start a self-defined web browser using your special options thru an icon on the 'Desktop' (as when you invoked run -i WebBrowser).

In addition it is possible to define the bin/WebBrowser.exe program as system wide default to be used when clicking on HTML files, as *.html or *.htm using the Windows™ dialog in 'File Explorer' where default applications can be specified.

To configure the WebBrowser to be started, add an application with the name WebBrowser to the etc/run.cfg file.

Example etc/run.cfg entry:

 :
 WebBrowser;Opera\OperaPortable.exe;--user-data-dir="%INSTALLDRIVE%:\data\Opera\%USERNAME%";;
 :

This definition would start the Opera web browser saving the user profile data to the %INSTALLDRIVE%:\data\Opera\%USERNAME% directory.

Of course the WebBrowser application name can also be added as an alias to an already existing entry in the run.cfg file:

 :
 Opera,WebBrowser;OperaPortable\OperaPortable.exe; ....
 :

The positive "side effect" is, that the web browser (Opera in this example) also can be started using run WebBrowser from the command line, a shortcut or an other program starter, as pstart(1), qsel(1) and hotkeyp(1).

 

OPTIONS

-h
usage help.

-V
print program version.

-i
install the WebBrowser command as 'Web Browser' to the Windows™ 'Desktop'.

-u
uninstall the 'Web Browser' shortcut from the 'Desktop'.

options
additional options for the started web browser. This will normally be the URL of a web site or a local file.

 

EXIT STATUS

0
no error.

4
usage printed.

5
version printed.

 

FILES

etc/run.cfg
configuration file of run(1). See run.cfg(4) for a description of all configuration possibilities.

var/scripts/WebBrowser.PREEXEC.cmd
optional script that is called prior to starting the web browser.

This allows to apply certain adjustments or cleanups ahead of the browser start.

The template lib/WebBrowser.PREEXEC.cmd can be copied to var/scripts/WebBrowser.PREEXEC.cmd and used as a starting point.

 

EXAMPLES

-

 

SEE ALSO

wintoolsintro(1), config(1m), hotkeyp(1), pstart(1), qsel(1), run(1), run.cfg(4),

 

BUGS

-

 

AUTHOR

WebBrowser was developed by Christian Walther. Send suggestions and bug reports to wa2l@users.sourceforge.net . 

 

COPYRIGHT

Copyright © 2021 Christian Walther

This is free software; see WA2LWinTools/man/COPYING for copying conditions. There is ABSOLUTELY NO WARRANTY; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.


 

Index

NAME
SYNOPSIS
AVAILABILITY
DESCRIPTION
OPTIONS
EXIT STATUS
FILES
EXAMPLES
SEE ALSO
BUGS
AUTHOR
COPYRIGHT

This document was created by man2html using the manual pages.
Time: 16:33:19 GMT, September 14, 2024