The name PyHoca is a word play combining two powerful entities: Python and Phoca (mascot of X2go, Latin species name for seals).

PyHoca-CLI is a client implementation for X2go using the project's Python API (module) Python-X2go. PyHoca-CLI can be operated completely from the command line and the goal is to reflect the full functionality spectrum of Python-X2go.

PyHoca-CLI has a man page.

On your GNU/Linux system execute

   $ man pyhoca-cli

An always up-to-date html version of the pyhoca-cli man page can be be retrieved from the X2go Git repository: man pyhoca-cli.

Security notice: amongst many options PyHoca-CLI offers a –password option. You should never use this password option from the command line, directly (as it will probably appear in the command history of your terminal shell). However, it might be handy for some of you to use this option when calling pyhoca-cli from within your own scripts.

The –password value (i.e. the actual password passed to PyHoca-CLI) will also be obfuscated in the process list of your system (*nix operating systems only).

Note: On Windows systems the –password option is disabled, and so not available.

To start an X2go session for remote user foo on X2go server myserver.local with PyHoca-CLI open a terminal window and execute the following command:

$ pyhoca-cli --server myserver.local -N -c GNOME --user foo --add-to-known-hosts

If you have a valid X2go session profile configuration ($HOME/.x2goclient/sessions file) you can also use the –session-profile option. For a session profile in x2goclient's sessions file named MyProfile use this command:

$ pyhoca-cli --session-profile MyProfile

Please also consult further README and TODO documentation in the PyHoca-CLI to Git project (X2go upstream site): http://code.x2go.org/gitweb?p=pyhoca-cli.git;a=tree