Skip to main content.

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.