pyhoca-gui man page

pyhoca-gui — graphical X2Go client applet written in Python

Synopsis

pyhoca-gui [ options ]

Description

pyhoca-gui is a cross-platform (Windows, MacOS X, Linux) graphical X2Go client applet that docks to your desktop's system tray.

From your desktop's system tray you can start/resume/share pre-configured X2Go sessions. You can manage the pre-configured session profiles in the X2Go profile manager and also configure the basic setup of pyhoca-gui.

pyhoca-gui uses the same set of config files (settings, printing and sessions in ~/.x2goclient) as the original X2Go Client application (by Heinz-M. Graesing and Oleksandr Schneyder) does.

On Windows systems pyhoca-gui uses the same set of Windows registry keys and values as the original X2Go Client application.

See the included README and TODO for further information on pyhoca-gui.

Common Options

pyhoca-gui accepts the following common options:

-h, --help
Display a help with all available command line options and exit.
-V, --version
Output version information and exit.
-d, --quiet
No output to stdout at all! Use this option on Windows!!!
-d, --debug
Enable debugging output.
--libdebug
Enable debugging code of the unterlying Python X2Go module.
--libdebug-sftpxfer
Enable debugging code of Python X2Go's sFTP server code (very verbose, and it may even reveal promiscuous data).

Brokerage Options

In case you want to retrieve X2Go session profiles from an X2Go Session Broker use the following options:

--broker-url=<URL>

Specify the <URL> of the X2Go Session Broker. pyhoca-gui can access http:// and ssh:// style URLs.

Syntax of <URL> for HTTP brokerage:

http(s)://<user>:<password>@<hostname>:<port>/path/to/broker

Syntax of <URL> for SSH brokerage:

ssh://<user>:<password>@<hostname>:<port>/usr/bin/x2gobroker (or any executable that provides the broker via SSH).

As a special <URL> you can type "HTTP" or "SSH" and then the application will provide a login window with a pre-formatted / schematic URL.

--broker-password <password>
Session broker password for retrieving session profiles from the X2Go Session Broker. The cleartext password that has been specified at the command line will be masqueraded in the systems process list (Linux, MacOS). On Windows systems the usage of the --broker-password option is forbidden.
--broker-name <broker-name>
Provide a human readable name for the session broker. This name overrides the default broker name ("X2Go Session Broker") in the application's menus and notification bubbles.
--broker-cacertfile CACERT_FILE
For https:// brokers with SSL certificates that have been signed against a self-signed root-CA, use this command line option to point to the self-signed root-CA certificate file.
--broker-autoconnect
If this command line option is given the session broker authentication dialog will appear on application startup.

Branding Options

The pyhoca-gui provides some feature that allow to easily brand its appearance. Here some options for tweaking the pyhoca-gui appearance and behaviour.

--splash-image <your-splash-image>
Define an alternative splash image that gets shown on application startup (PNG files only, full path or filename as found in <share>/img).
--about-image <your-about-window-image>
Define an alternative image for the application's ,,About'' window (PNG files only, full path or filename as found in <share>/img). For those who distribute a customized version of this application: As PyHoca-GUI and its backend Python X2Go are licensed under AGPL, the ,,About'' window is a good place for placing the download location of your modified version of the source code.
--disable-splash
Do not show the application's splash screen.
--disable-options
Grey-out the ,,Options'' menu item and thus disable the client configuration window.
--disable-printingprefs
Grey-out the ,,Printing Preferences'' menu item and thus disable the client's printing preferences window.
--disable-profilemanager
Grey-out the profile manager menu items and thus disable all profile management functionalities.
--disable-notifications
Disable all applet notifications.
--logon-window-position <x-pos>x<y-pos>
Give a custom position for the logon window, use negative values to position relative to right/bottom border.
--published-applications-no-submenus <number>
The number of published applications that will be rendered without submenus.

Backend Options

pyhoca-gui supports transparent use of different data backends. For configuration three backends are common: FILE, GCONF (Linux only) and WINREG (Windows only). The default backend currently is the FILE backend on all platforms.

For client-server communication the only yet implemented backend is the STDOUT backend (as X2Go server commands print their execution results to /dev/stdout. (But other communication backends might be possible in the future...).

In the same way we are focusing on a successor of the current NX3 agent/proxy tool. A change in the proxy backend will also be implemented as a backend.

--backend-controlsession <CONTROLSESSION_BACKEND>
Force usage of a certain CONTROLSESSION_BACKEND (do not use this unless you know exactly what you are doing).
--backend-terminalsession <TERMINALSESSION_BACKEND>
Force usage of a certain TERMINALSESSION_BACKEND (do not use this unless you know exactly what you are doing).
--backend-serversessioninfo <SERVERSESSIONINFO_BACKEND>
Force usage of a certain SERVERSESSIONINFO_BACKEND (do not use this unless you know exactly what you are doing).
--backend-serversessionlist <SERVERSESSIONLIST_BACKEND>
Force usage of a certain SERVERSESSIONLIST_BACKEND (do not use this unless you know exactly what you are doing).
--backend-proxy <PROXY_BACKEND>
Force usage of a certain PROXY_BACKEND (do not use this unless you know exactly what you are doing).
--backend-sessionprofiles <SESSIONPROFILES_BACKEND>
Use given backend for accessing session profiles, available backends on Linux: FILES, GCONF; on Windows: FILES, WINREG.
--backend-clientsettings <CLIENTSETTINGS_BACKEND>
Use given backend for accessing the client settings configuration, available backends on Linux: FILES, GCONF; on Windows: FILES, WINREG.
--backend-clientprinting <CLIENTPRINTING_BACKEND>
Use given backend for accessing the client printing configuration, available backends on Linux: FILES, GCONF; on Windows: FILES, WINREG.

Portable Options

--client-rootdir <CLIENT_ROOTDIR>
Define an alternative location where to find plain text config files (default: <HOME>/.x2goclient). This option will set ,,--backend-profiles FILE'', ,,--backend-clientsettings FILE'' and ,,--backend-clientprinting FILE''
--sessions-rootdir <SESSIONS_ROOTDIR>
Define an alternative location for session runtime files (default: <HOME>/.x2go).
--ssh-rootdir <SSH_ROOTDIR>
Define an alternative location for user SSH files (default: <HOME>/.ssh).

Windows Options

There are some options that are only available on Windows:

--start-xserver
Start an XServer (if available) before starting pyhoca-gui. The application will detect the best suitable XServer automatically, if more than one XServer is installed on your system (currently known: Xming, Cygwin-X).
--preferred-xserver <XSERVER_NAME>
Start either of the currently supported XServers: Xming, Cygwin-X and VcXsrv -- make sure your preferred XServer is installed on your system (default and recommended is VcXsrv).
--start-pulseaudio
Start the PulseAudio server before starting pyhoca-gui. This option is needed to get X2Go audio working. However, it is not enabled by default.
--lang [en|de|nl|es]
Select the GUI language.

See Also

/usr/share/doc/pyhoca-gui

Author

This manual has been written for the X2Go project by Mike Gabriel <mike.gabriel@das-netzwerkteam.de>.

Info

Jan 2016 Version 0.5.0.6 X2Go Application