|-help, -h||Prints out to the terminal a brief description and the options.|
|--help||Starts up the GUI as though the Help button was pressed to show the main Help panel.|
|Launch the ssvnc_cmd utility command directly (no GUI) with the given arguments (for use when ssvnc_cmd is not in ones PATH.) If neither ssvnc_cmd nor ssvncviewer is in PATH, one can launch the viewer directly via: ssvnc-gui -cmd -viewer [viewer-args] See the next option -viewer for an alias.|
|Shorthand for ssvnc-gui -cmd -viewer [viewer-args].|
|List the saved SSVNC profiles you have created. A profile is a destination host with specific parameter settings.|
|-list||Same as -profiles|
|-ssh||Start in "SSH Only Mode". No SSL aspects are shown. Same as running the command sshvnc|
|-ts||Start in "Terminal Services Mode". This is like "SSH Only Mode", but simpler and assumes x11vnc is available on the remote side to start and manage X and VNC sessions. Same as running the command tsvnc|
|-tso||Same as -ts "Terminal Services Mode", however never let the user leave this mode (no button to switch modes is provided.) Same as SSVNC_TS_ALWAYS=1.|
|-ssl||Force the full GUI Mode: both SSL and SSH. This is the default. Same as -ss.|
|-nv||Toggle the "Verify All Certs" button to be off at startup.|
|-nvb||Never show the "Verify All Certs" button. Same as SSVNC_NO_VERIFY_ALL_BUTTON=1.|
|-bigger||Make the Profile Selection Dialog window bigger. Same as SSVNC_BIGGER_DIALOG=1.|
|-noenc||Start off in a mode where a No Encryption check button is present. You can toggle the mode with Ctrl-E. Same as SSVNC_DISABLE_ENCRYPTION_BUTTON=1. Or noenc=1 in ~/.ssvncrc. Selecting no encryption is the same as the vnc:// and Vnc:// prefixes described below. The -noenc mode is now the default, use -enc or noenc=0 for the opposite behavior.|
|On Windows, automatically terminate the STUNNEL process when the viewer exits instead of prompting you (same as killstunnel=1 in ssvnc_rc or toggle in Options menu)|
|On Windows, disable -killstunnel mode. Same as killstunnel=0 in ssvnc_rc or toggle in Options menu. Note that -killstunnel mode is now the default.|
|Set the default "MyCert" to be /path/to/mycert.pem. Same as -cert. If the file does not exist, ~/.vnc/certs is prefixed and tried. You can also set mycert=/path/to/mycert.pem in ~/.ssvncrc.|
|Set the default "ServerCert" to be /path/to/cacert.crt. Same as -ca. If the file does not exist, ~/.vnc/certs is prefixed and tried. You can also set cacert=/path/to/cacert.crt in ~/.ssvncrc.|
|Set the default Certificate Revocation List to be /path/to/mycrl.pem. If the file does not exist, ~/.vnc/certs is prefixed and tried. You can also set crl=/path/to/mycrl.pem in ~/.ssvncrc.|
Here are all of our URL-like prefixes that you can put in front of host:display (or host:port):
For SSL: vncs:// vncssl:// and vnc+ssl://
For SSH: vncssh:// and vnc+ssh://
For No Encryption: vnc:// and Vnc://
To quickly make an SSL connection: ssvnc vncs://snoopy.com:0
To quickly make an SSH connection: ssvnc vnc+ssh://email@example.com:0
To quickly make a direct connection: ssvnc Vnc://snoopy.com:0
The above will also work in the "VNC Host:Display" entry box in the GUI. Press the "Connect" button after entering them.
The difference between vnc:// and Vnc:// is that the latter one will not prompt you whether you really want to make an unencrypted connection or not.
Your SSVNC vnc profiles are stored in the $HOME/.vnc/profiles directory. They end in suffix .vnc
Your SSVNC vnc certificates and keys are stored in the $HOME/.vnc/certs directory. They typically end in .pem (both certificate and private key) or .crt (certificate only).
You can put a few global parameters (e.g. mode=sshvnc) in your $HOME/.ssvncrc file (ssvnc_rc on Windows); see the application Help for more information.
The following is from Tip 18 in the Help panel.
Fonts: To change the tk fonts, set these environment variables before starting up ssvnc-gui: SSVNC_FONT_DEFAULT and SSVNC_FONT_FIXED. For example:
% env SSVNC_FONT_DEFAULT=helvetica -20 bold ssvnc-gui
% env SSVNC_FONT_FIXED=courier -14 ssvnc-gui
or set both of them at once.
To achieve the same effect, you can also set parameters in your ~/.ssvncrc file, for example:
font_default=helvetica -20 bold
ssvncviewer(1), vncviewer(1), stunnel(8), ssh(1), x11vnc(1), vncserver(1) http://www.karlrunge.com/x11vnc http://www.karlrunge.com/x11vnc/ssvnc-gui.html
Karl J. Runge <firstname.lastname@example.org> wrote the SSVNC gui (tcl/tk) and associated wrapper scripts, and added features to the unix vncviewer source code.
|SSVNC-GUI (1)||January 2011|