www.fifi.org
    Documentation
        Manpages
        GNU Info
        Debian document tree
        Whole document tree
    Trigance web page
    Public services
    User info
    Mailing lists
    Secure server
    Multilingual usage

Manpages

Manpage of netscape-remote

netscape-remote

Section: User Commands (1)
Updated: May 25th, 1997
Index
Return to Main Contents

NAME

netscape-remote - a program to remotely control mozilla

SYNOPSIS

netscape-remote [-id window] [-raise] [-noraise] -remote 'action'

DESCRIPTION

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:

: http://www.netscape.com/newsref/std/x-remote.html

OPTIONS

-remote 'action'

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:

: netscape -id 0x3c00124 -remote 'openURL(http://home.netscape.com)'

-raise, -noraise

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:

netscape -noraise -remote 'openURL(http://home.netscape.com)'

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

netscape -noraise -remote 'addBookmark(http://foo)' -raise -remote 'openURL(http://bar)'

ACTIONS

openURL ( )

: Prompts for a URL with a dialog box.

openURL (URL)

: Opens the specified document without prompting.

openURL (URL,new-window)

: Create a new window displaying the specified document.

openFile ( )

: Prompts for a file with a dialog box.

openFile (File)

: Opens the specified file without prompting.

saveAs ( )

: Prompts for a file with a dialog box (like the menu item).

saveAs (Output-File)

: Writes HTML to the specified file without prompting.

saveAs (Output-File, Type)

: Writes to the specified file with the type specified - the type may be HTML, Text, or PostScript.

mailto ( )

: pops up the mail dialog with the To: field empty.

mailto (a, b, c)

: Puts the addresses "a, b, c" in the default To: field.

addBookmark ( )

: Adds the current document to the bookmark list.

addBookmark (URL)

: Adds the given document to the bookmark list.

addBookmark (URL, Title)

: Adds the given document to the bookmark list, with the given title.

EXAMPLES

netscape-remote -remote 'openURL(http://www.jimpick.com/)': This would open the specified website in an already existing Netsape window, or would launch Netscape if it wasn't running.
netscape-remote -remote 'openURL(http://www.jimpick.com),new_window)': 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.

This document was created by man2html, using the manual pages.
Time: 12:42:57 GMT, April 20, 2024