Our website is made possible by displaying online advertisements to our visitors.
Please consider supporting us by disabling your ad blocker.

UltraVNC Viewer Commandline Parameters

-help, -? or -h
Print a help message.
-listen [port]
Start the UltraVNC Viewer in listen mode. If port is specified, the viewer listens on that port instead of 5900 default port.
example UltraVNC Viewer listen non standard port 80
vncviewer.exe -listen 80
-dsmplugin filename.dsm
example1: vncviewer.exe host -dsmplugin msrc4plugin.dsm
example2: vncviewer.exe host -dsmplugin securevncplugin.dsm

-proxy host:port
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 UltraVNC Viewer listen with dsmplugin
-autoreconnect [DelayInSeconds]
-autoreconnect (default value 3 seconds)
example: autoreconnect after 15 seconds
vncviewer.exe -autoreconnect 15 -connect hostname
commandline autoreconnect
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 UltraVNC Viewer message error
-fttimeout sec
Filetransfer timeout sec [1-60]
-keepalive sec
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.
not used
Emulate a 3-button mouse.
Do not emulate a 3-button mouse.
don't change cursor chapes
"." is used as remote cursor
-scale A/B
Scale the display by the factor A/B.
-emulate3timeout Timeout
emulate 3 button mouse with 2 buttons
-emulate3fuzz Emul3Fuzz
emulate 3 button mouse with 2 buttons
Do not transfer clipboard content.
-delay delay
debug option
-loglevel loglevel
Set the loglevel. This can range from 0 (minimal) to 10 (maximum logging).
Open a console window for log output.
-logfile filename
Log to the file specified by filename.
-config filename
Read the configuration from filename.
Record the path to the VNC viewer and the type of the .vnc files in the registry
-encoding encoding
Encoding is either raw, rre, corre, hextile, zlib, zlibhex, tight or ultra. Encodings are described here.
-compresslevel level
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.
-quality quality
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.
-user msuser
ms logon (NTLM1) username set at server (not viewer side)

-password password
Use the specified password for "classic" VNC authentication.
-serverscale scale
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).
-quickoption n
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".