UltraVnc Command line Parameters
- Runs WinVNC as a service.
- Runs the WinVNC Service Helper app, i.e. the systray icon.
- WinVNC is being run as a user-level program.
Installing WinVNC as Windows service
- Installs WinVNC as a service.
- Installs WinVNC as a service silently, i.e. no message box appears.
- Removes the WinVNC service.
- Silently removes WinVNC service, then re-installs it.
Accessing various Configuration Options
- Shows the Properties dialog of an existing instance of WinVNC.
- Show the Admin Properties dialog of an existing instance of WinVNC.
- WinVNC is being run as a user-level program. Multiple simultaneous instances are allowed.
- WinVNC is being run as a user-level program. Warning about multiple instances is disabled.
- Shows the About dialog of an existing instance of WinVNC.
- Adds a new client to an existing copy of winvnc.
Needs the computer name (DNS name) or IP address and optionally the display number (separated from the host name with a colon (:).
- Adds a new client to an existing copy of winvnc.
Needs the computer name (DNS name) or IP address and optionally the port number (separated from the host name with two colons (::).
- Is used in conjunction with the
-connectswitch when having a server "back-connect" to a listening viewer. You can use it in a batch file for your clients that are behind a firewall that is not under your control. The batch file looks something like this:
"c:\program files\ultravnc\winvnc" -autoreconnect -connect 126.96.36.199
On the local computer run the viewer in "listening" mode, and have someone on the server end run the batch file. The
-autoreconnectwill make the server end attempt to reconnect to the listening viewer if the connection drops or is closed. It will immediately reconnect to the listening viewer if the session is closed. Close the listening viewer altogether in order to stop the server end from "autoreconnecting" to your computer. The server attempts to "autoreconnect" for only a few seconds.
Note that this "autoreconnect" param must be before the "connect" one on the command line!
- Kills any already running copy of WinVNC.
In addition to the normal WinVNC command line parameters, WinVNC SC supports the following parameters:
- Used with the repeater in mode II.
Specifies a number to identify the session. In the
-connectparameter use the repeater's name or IP address (and the repeater's port) instead of the remote host name.
- Use the specified DSM plugin.
- Don't store SingleClick DSM settings in the registry. Used in conjunction with the -plugin parameter.
- Do not display the UltraVNC icon in the system tray.
- Don't send keyboard and mouse events to the remote computer.
- Use the specified username.
- Use the specified password.
VNCViewer supports numerous command line parameters which allow for configuration of nearly every aspect of the viewer.
- Print a help message.
- Start the VNCviewer in listen mode. If
portis specified, the viewer listens on that port instead of ???.
- Do not send local keyboard or mouse events to the remote computer.
- Don't show the status window while connecting.
- Do not enable hot keys (like
CTRL+ALT+F9for full screen mode etc.). Can be useful in case of conflict with other installed software hotkeys.
- Do not display the toolbar.
- Automatically scale the viewer window so that the remote screen fits at best your local screen size.
- Display viewer in full screen mode.
- Disable auto mode. Required for using the color options below or saving a custom configuration (otherwise the settings from quick options always override).
- Set the color depth. Fewer colors can significantly reduce the required bandwidth.
Note: Grey colors only work with 32 bits color screen resolution. 16 or 24 bits color resolutions just don't work with grey colors.
- Share the server with other viewers, i.e. allow several viewers to connect simultaneously to the server.
- Swap left and right button of the mouse.
- Do not display any local dot mouse cursor.
- Display the local dot mouse cursor.
- Display the normal local mouse cursor.
- Emulate a 3-button mouse.
- Do not emulate a 3-button mouse.
- Scale the display by the factor
- Do not transfer clipboard content.
- Set the loglevel. This can range from
- Open a console window for log output.
- Log to the file specified by
- Read the configuration from
- Encoding is either
ultra. Encodings are described here.
- Use specified compression level (0..9) for "tight" and "zlib" encodings (Tight encoding specific). Level 1 uses minimum of CPU time and achieves weak compression ratios, while level 9 offers best compression but is slow in terms of CPU time consumption on the server side. Use high levels with very slow network connections, and low levels when working over high-speed LANs. It's not recommended to use compression level 0, reasonable choices start from the level 1.
- Use the specified JPEG quality (0..9) for the "tight" encoding (Tight encoding specific). Quality level 0 denotes bad image quality but very impressive compression ratios, while level 9 offers very good image quality at lower compression ratios. Note that the "tight" encoder uses JPEG to encode only those screen areas that look suitable for lossy compression, so quality level 0 does not always mean unacceptable image quality.
- Use the specified
passwordfor "classic" VNC authentication.
- Scale the display on the server side by
1/scale. For instance
scale = 2means that the remote screen dimensions are reduced by 2 ("half screen size"), reducing at the same time the amount of graphical data received by a factor 4 (2^2).
- Select a quickoption. Modem option is default.
- Use the DSM plugin specified by
- Use the repeater specified by