voyager

Voyager browser

Syntax:

voyager [options]

Runs on:

Neutrino

Options:

-A
Run alone: don't connect to a currently running Voyager client, and don't allow other clients to connect to this client.
-C my_config
Load the startup configuration from the file identified by my_config. The default configuration file is ${HOME}/.ph/voyager/config.full.
-c
Run in compact mode: launch the compact server, and use text labels in the main toolbar.
-D options
Disable one or more of the following options:
-e my_encoding
Use my_encoding as the startup encoding. The default encoding is "Western European (ISO 8859-1)".
-h height[%]
The height of the window, in pixels, or as a percentage of the screen height if % is specified.
-n ServerName
Specifies the connector name of the server to connect to. The connector name has to match the connector name that is used by the server. Both vserver and netfront have a -n option that allows you to tell them what connector name to register; see the documentation for the server you're using for more information.

Note: The default connector name used by the Voyager client is specified in the online section of the webservers profile.

-N client_name
Register this name for this client. The default client_name is VoyagerClient.
-P my_server
Start the Voyager Server executable identified by my_server, if necessary. You must also specify the server connector name using the -n option.

Note: When used with the -n ServerName option, Voyager first attempts to connect to the ServerName. If it isn't running, it spawns the server indicated by my_server, and tries to connect to it using the connector name specified by ServerName.

The default server used by the Voyager client is specified in the online section of the webservers profile.


-Si|m
The initial state of the main window (iconified or maximized).
-s server_name
The name of the Photon server:
If server_name is: This server is used:
node_path node_path/dev/photon
fullpath fullpath
relative_path /dev/relative_path
-u URL
The URL to load on starting up.
-W
Don't open a new window when another client with a URL connects; reuse the current window.
-w width[%]
The width of the window, in pixels, or as a percentage of the screen width if % is specified.
-x position[%][r]
The x coordinate of the upper-left corner of the window, in pixels, or as a percentage of screen width if % is specified. If r is specified, the coordinate is relative to the current console.
-y position[%][r]
The y coordinate of the upper-left corner of the window, in pixels, or as a percentage of screen height if % is specified. If r is specified, the coordinate is relative to the current console.

Description:

This command starts the QNX Voyager browser. You need to be running Photon to use it.

The QNX Voyager browser is a client-server application. The client provides the GUI interface for the browser, and the server provides the rendering engine. You can configure the browser to use either the vserver or netfront servers -- the features available in the browser are slightly different with each server. You can specify which server is used for different browsing situations, or profiles. See the Pt_ARG_WEB_SERVER resource of PtWebClient for a description of web server profiles.

Voyager browser

Voyager launches phplay and the appropriate plugin when you select an HREF on a web page. This works for .mpg, .mpeg, .wav, .au, .aif, .mp3, .mp1, .mp2, .mpa, .mpv, and .m2v (Mpeg II video) files. A helper application downloads the file to /tmp and runs phplay on it.


Note: You'll need to clean up your /tmp directory if you use a lot of video.

Voyager has embedded plugins for the media types listed above. If you create an HTML page as shown below with any of the above file types, Voyager handles it. Video embedded in the HTML page, and audio play in the background.

<html>
<body>
<embed src="l30sstd.mpv" width=400 height=300>
</embed>
some text some test <br>
<br>
<br>
some text some text
</body>
</html>

or:

<html>
<body>
<embed src="Slayers-Get_Along.mp3" >
</embed>
some text some test <br>
<br>
<br>
some text some text
</body>
</html>

or:

<html>
<body>
<embed src="cat.wav" >
</embed>
some text some test <br>
<br>
<br>
some text some text
</body>
</html>

Browsing with Voyager

You can perform these browsing tasks using Voyager:

Task Menu command Shortcut
Open a URL File-->Open Ctrl-O
Open a new Voyager window File-->New Browser Window Ctrl-N
Save the current web page File-->Save Document As Ctrl-S
Email the current page (an email client must be configured for this command to work) File-->Mail Page Ctrl-M
Print the current page File-->Print Ctrl-P
View or import client certificates (netfront only) File-->Client Certificates
Close the current Voyager window File-->Close Alt-F4
Close all Voyager windows and exit File-->Exit
Copy text selected on a web page Edit-->Copy Ctrl-C
Paste clipboard text into a form field or the site bar Edit-->Paste Ctrl-V
Select all the text on a web page Edit-->Select All Ctrl-A
Find a word or phrase on a web page Edit-->Find In Document Ctrl-F
Find the same word or phrase again Find-->Again Ctrl-G
Change the appearance of the toolbar View-->Toolbar-->Show, View-->Toolbar-->Text Only, View-->Toolbar-->Image Only, and View-->Toolbar-->Text and Image
Turn the site bar and status bar on and off View-->Site Bar and View-->Status Bar
Increase or decrease the size of the text on the web page vserver: View-->Increase Font or View-->Decrease Font

netfront: View-->Text Zoom

Ctrl-] or Ctrl-[
Change page magnification (netfront only) View-->Magnifying Factor Ctrl-Shift-] or Ctrl-Shift-[
Load all images on the web page, if the auto image load feature is disabled View-->Load All Images
Reload the web page View-->Reload Ctrl-R
Stop loading a web page View-->Stop Loading Esc
View the web page HTML source in a pterm window View-->Document Source

Navigating

You can navigate web pages by using the following commands:

Task Menu command Shortcut
Go back in the history list to the previously viewed web page Go-->Back Alt-<--
Go forward in the history list, if the Go-->Back has been used Go-->Forward Alt--->
Go the the home web page, defined in Voyager's preferences Go-->Home
View a list of previously visited web pages Go-->History List Ctrl-I
View a list of bookmarked web pages Hotlist-->Edit Hotlist Ctrl-L
Add the current web page to the hotlist Hotlist-->Add to Hotlist Ctrl-D

Examples:

Start with Japanese encoding, get configuration information from the file /setup/vconfig, disable the splash-screen and the toolbar, use the Voyager Server called new.server in /tmp:

voyager -e "Japanese (Shift JIS)" \
-C /setup/vconfig -D pt -P /tmp/new.server

Run at the initial position (10,10) with an initial dimension of 200*300:

voyager -x10 -y10 -h200 -w300

Start with the NetFront server:

voyager -n NetfrontServer

Files:

${HOME}/.ph/voyager/config.full
The default configuration file.
$HOME/.ph/webservers and /etc/photon/webservers
The server profiles, which specify the server for different browsing situations. See the Pt_ARG_WEB_SERVER resource of PtWebClient for a description of web server profiles.

Environment variables:

FLASHQUALITY
The resolution to use with Macromedia Flash. If this environment variable isn't set, high resolution is used. To use low resolution, set FLASHQUALITY to LOW: this uses less CPU.

Caveats:

You need hardware with an FPU for MPEG decoding because floating-point emulation is too slow. We don't currently support a fixed-point MPEG audio decoder.

You need to run the pipe manager in order for Voyager to perform a DNS lookup.

See also:

netfront, phplay, vserver

PtWebClient in the Photon Widget Reference

"Surfing the web with Voyager" in the Using the Photon microGUI chapter of the Neutrino User's Guide