UltraVNC Viewer Commandline Parameters
-help, -? or -h
Print a help message.
Start the VNCviewer in listen mode. If port is specified, the viewer listens on that port instead of 5900 default port.
example vncviewer listen non standard port 80
vncviewer.exe -listen 80
example1: vncviewer.exe host -dsmplugin msrc4plugin.dsm
example2: vncviewer.exe host -dsmplugin securevncplugin.dsm
the proxy is not your office proxy, is ultravnc repeater proxy.
the proxy/repeater mode I (distributor) repeater must be on your lan
"%:\programfiles%\UltraVNC\vncviewer.exe" -proxy host:5901 -connect hostname
"%programfiles%\UltraVNC\vncviewer.exe" -proxy distributor:5901 -connect host -dsmplugin filename.dsm
proxy/repeater mode II (with ID number)
"%:\programfiles%\UltraVNC\vncviewer.exe" -proxy host:5901 ID:1234
"%programfiles%\UltraVNC\vncviewer.exe" -proxy host:5901 ID:1234 -dsmplugin filename.dsm"
Auto Accept Incoming connection (no SC server info)
server connection set without encryption, there no message is NOT encrypted while vncviewer listen with dsmplugin
-autoreconnect (default value 3 seconds)
example: autoreconnect after 15 seconds
vncviewer.exe -autoreconnect 15 -connect hostname
value is number of seconds between reconnects This allow to set a bigger timeout between reconnect intervals this function is blocked by repeater for viewer."
%programfiles%\ultravnc\vncviewer.exe" -autoreconnect 30 -connect hostname::5900 -quickoption 3 -dsmplugin SecureVNCPlugin.dsm
-reconnect x (warning) not yet available by command line) only gui
This is the number of times a reconnect is made before the viewer
close the connection.
remove the sponsor of vncviewer message error
Filetransfer timeout sec [1-60]
Interval to send a keepalive message
Open a dialogbox on exit " do you realy want to quit"
remove options from system menu ( Filetransfer, chat ....)
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+F9 for 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).
-8bit, -256colors, -64colors, -8colors, -8greycolors, -4greycolors, -2greycolors
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.
don't change cursor chapes
"." is used as remote cursor
Scale the display by the factor A/B.
emulate 3 button mouse with 2 buttons
emulate 3 button mouse with 2 buttons
Do not transfer clipboard content.
Set the loglevel. This can range from 0 (minimal) to 10 (maximum logging).
Open a console window for log output.
Log to the file specified by filename.
Read the configuration from filename.
Record the path to the VNC viewer and the type of the .vnc files in the registry
Encoding is either raw, rre, corre, hextile, zlib, zlibhex, tight or 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.
ms logon (NTLM1) username set at server (not viewer side)
Use the specified password for "classic" VNC authentication.
Scale the display on the server side by 1/scale. For instance scale = 2 means 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
1 = AUTO (auto select best settings, this never use ultra experimental maybe "forever")
2 = LAN (> 1Mbit/s) Max Colors
3 = MEDIUM (> 128Kbit/s )- 256 Colors
4 = MODEM (19K - 128Kbit/s) - 64 Colors
5 = SLOW (< 19Kbit/s) 8 Colors
6 = (custom ?) N/A (not available and fail)
7 = ULTRA (> 2Mbit/s) - Experimental (still experimental after 2 years)
-position x y w h
Commandline options are Merged with the default saved settings.
if you save viewonly as default -> a viewer started with a commandline option will always be "viewonly".