Skip to main content.
Related Sites: Home | Project Page | Forum | Docs | SingleClick | CVS

# UltraVNC

Remote Control for all
Tools: download stable version « | download develop version «
Navigation: Home | General | Installation | Features | Add-ons

- Install
- Configure
- Usage
- Cmdline
- Viewer
- Registry
- Unattended

# 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`.