netscape-remote
is used to remotely control the Netscape web browser. If it is called,
and there is no Netscape running, it will start a new
one and pass the
action
command on to it. Otherwise, it will pass the
action
command to an already running Netscape.
The functionality
provided by this program is identical to running Netscape
with the
-remote
argument. However, since it is provided in a separate, small
program, it will start much more quickly than
netscape
itself.
Full documentation and source code is available at:
This option is required. The
action
argument is described below.
-id window
You can select a window to control with the
-id
command-line option;
otherwise, the first Netscape Navigator window found will be used.
The argument to this option is an X window id, as a decimal or
hexadecimal number. (You can find window IDs with the
xwininfo(1)
or
xlswins(1)
programs.) For example:
You can control whether the
-remote
command will cause the Netscape window to
automatically raise itself to the top with the
-raise
and
-noraise
options. The default is to raise, but this may be disabled as follows:
The
-raise
and
-noraise
options apply to all following
-remote
commands on the command line, and may be interleaved. For example,
to add a bookmark without raising the window, and
then open a URL and raise the window, one could do
This would open the specified website in a new Netscape window,
or would launch Netscape if it wasn't running.
KNOWN BUGS
The
netscape-remote
program is very finicky about the command line options. You
have to use it with the
-remote
option, or it will spit out not very helpful error messages.
Also, it is known to not work with some beta versions of Netscape
and any version of Netscape before version 1.1.
AUTHOR
This man page was written by Jim Pick <jim@jimpick.com>, based
on information from the Netscape web site.