UltraVNC Commandline Parameters

Here you will find an description of all the commandline parameters that could be applied to winvnc.exe , winvncsc.exe (SingleClick) and vncviewer.exe .

WinVNC

Running WinVNC

-service: Runs WinVNC as a service.
-servicehelper: Runs the WinVNC Service Helper app, i.e. the systray icon.
-run: WinVNC is being run as a user-level program.

Installing WinVNC as Windows service

-install: Installs WinVNC as a service.
-sinstall: Installs WinVNC as a service silently, i.e. no message box appears.
-remove: Removes the WinVNC service.
-reinstall: Silently removes WinVNC service, then re-installs it.

Accessing various Configuration Options

-settings: Shows the Properties dialog of an existing instance of WinVNC.
-defaultsettings: Show the Admin Properties dialog of an existing instance of WinVNC.
-multi: WinVNC is being run as a user-level program. Multiple simultaneous instances are allowed.
-fus: WinVNC is being run as a user-level program. Warning about multiple instances is disabled.
-about: Shows the About dialog of an existing instance of WinVNC.
-help

Connecting VNCViewers

-connect host[:display]: Adds a new client to an existing copy of winvnc.
Needs the computername (DNS name) or IP address and optionally the display number (separated from the hostname with a colon (:).
-connect host[::port]: Adds a new client to an existing copy of winvnc.
Needs the computername (DNS name) or IP address and optionally the port number (separated from the hostname with two colons (::).
-autoreconnect: ???
Note that this "autoreconnect" param must be before the "connect" one on the command line!
-kill: Kills any already running copy of WinVNC.

WinVNC SingleClick

In addition to the normal WinVNC commandline parameters, WinVNC SC supports the following parameters:

-id number: Used with the repeater in mode II. Specifies a number to identify the session. In the -connect parameter use the repeater's name or IP address (and the repeater's port) instead of the remote host name.
-plugin: ???
-noregistry: ???
-notrayicon: ???
-readonly: ???
-username: ???
-password: ???

VNCviewer

VNCViewer supports numerous commandline parameters which allow for configuration of nearly every aspect of the viewer.

-help, -? or -h

Print a help message.

-listen [port]

Start the VNCviewer in listen mode. If port is specified, the viewer listens on that port instead of ???.

-restricted

???

-viewonly

Do not send local keyboard or mouse events to the remote computer.

-nostatus

???

-nohotkeys

???

-notoolbar

Do not display the toolbar.

-autoscaling

???

-fullscreen

Diplay in full screen mode.

-noauto

???

-8bit, -256colors, -64colors, -8colors, -4greycolors, -2greycolors

Set the color depth. Fewer colors can significantly reduce the required bandwidth.

-shared

???

-swapmouse

Swap left and right button of the mose.

-nocursor

???

-dotcursor

???

-normalcursor

???

-belldeiconify

???

-emulate3

Emulate a 3-button mouse.

-noemulate3

Do not emulate a 3-button mouse.

-nocursorshape

???

-noremotecursor

???

-scale A/B

Scale the display by the factor A/B.

-emulate3timeout Timeout

???

-emulate3fuzz Emul3Fuzz

???

-disableclipboard

???

-delay delay

???

-loglevel loglevel

Set the loglevel. This can range from 0 (minimal) to 10 (maximum logging).

-console

???

-logfile filename

Log to the file specified by filename.

-config filename

Read the configuration from filename.

-register

???

-encoding encoding

Encoding is either raw, rre, corre, hextile, zlib, zlibhex, tight or ultra.

-compresslevel level

???

-quality quality

???

-password password

Use the specified password for "classic" VNC authentication.

-serverscale scale

Scale the display on the server side by scale.

-quickoption option

Select a quickoption. Modem option is default.

1: Auto
2: LAN
3: Medium
4: Modem
5: Slow
7: Ultra

-dsmplugin filename

Use the DSM plugin specified by filename.

-proxy host[:port]

Use the repeater specified by host and optionally port.