User Tools

Site Tools


This is an old revision of the document!

PyHoca-GUI - Download/Installation & Usage

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

PyHoca-GUI is a client implementation for X2Go using the project's Python X2Go client API (a Python module). PyHoca-GUI uses wxPython for rendering graphical desktop elements (menus, dialog boxes etc.).

PyHoca-GUI is designed as a very minimal GUI that behaves very similar to GNOME's network manager applet (nm-applet). It appears as a small Phoca icon (a little seal) that docks to your systray panel (also called notification area) and allows you to manage multiple X2go sessions simultaneously.


Debian GNU/Linux

PyHoca-GUI can be installed from the X2Go package repository. Add the X2Go repository for Debian to your APT system before you continue.

Ubuntu GNU/Linux

PyHoca-GUI can be installed from X2Go PPA on Launchpad. Add the X2Go/stable PPA to your APT system before you continue.

After adding either of the above package sources to your Debian/Ubuntu system you will need to update your system with the new repository information by starting a terminal and execute the following commands (on Debian make sure you have sudo installed and configured):

$ sudo aptitude update
$ sudo aptitude install pyhoca-gui

Other GNU/Linux (from source tarball)

Other GNU/Linux distributions can install PyHoca-GUI from source tarballs. The PyHoca-GUI tarball releases can be downloaded from, please choose the newest version available there and also consult the README.recommended file if available at the same location.

Before installation make sure your system fulfills the (Python module) dependencies for PyHoca-GUI, amongst others: python-x2go, python-paramiko, python-gevent, python-greenlet, python-setproctitle, python-argparse, wxPython (2.8/2.9).

If you have seen to installing required dependencies, extract the source tarball and run the Python installation script:

tar -vzxf pyhoca-gui_<version>.tar.gz
cd pyhoca-gui_<version>
python install

MS Windows

To install PyHoca-GUI for MS Windows click here. Download the bundled (PyHoca-GUI + VcXsrv + Ghostscript) or the pure (PyHoca-GUI only) setup installer to you computer and run the PyHoca-GUI setup and follow the presented installation instructions.


A PyHoca-GUI installer for MacOS is currently not available. Sorry.


Command Line Arguments

PyHoca-GUI has a man page. Considering that it actually is a GUI there are quite some command line options to choose from.

On your GNU/Linux system execute

   $ man pyhoca-gui

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

Launching PyHoca-GUI

You can launch PyHoca-GUI by typing pyhoca-gui on the command line (from a terminal) or by starting it from your desktop's application menu (topic: Internet).

PyHoca-GUI will appear on your desktop as a small icon that docks into your systray (as the GNOME applet for Network Manager does). Find this icon—it looks like a little white seal on grey background.

Note that on Ubuntu 12.04 or later, the Unity interface does not allow PyHoca-gui to create the systray icon. To enable this, we need to edit the gsettings. To allow all applications in the systray, type this in the terminal.

  $ gsettings set com.canonical.Unity.Panel systray-whitelist "['all']"

If you would rather whitelist a set of applications, use this command instead, where YOUR_APPLICATION is 'pyhoca-gui'

$ gsettings set com.canonical.Unity.Panel systray-whitelist \
      "['JavaEmbeddedFrame', 'Mumble', 'Wine', 'Skype', 'hp-systray', 'YOUR_APPLICATION']"

Profile Manager

PyHoca-GUI uses the same configuration files as an x2goclient. Thus PyHoca-GUI should work out of the box for most setups and user profiles on a System with a working x2goclient configuration.

If you are new to X2go and try PyHoca-GUI first, then you have to add a session profile for your (first) X2go server.

If you right-click on the PyHoca-GUI icon you are offered a sub-menu called Profile Manager. From there, you can access all your defined X2go session profiles.

Starting Sessions

To start a PyHoca-GUI session left-click on the PyHoca icon and then choose Authenticate X2go Server to be presented with a list of existing session profiles.

After you have authenticated against one of your configured server session profiles, you can access the authenticated session profile by left-clicking the PyHoca-GUI icon. Navigate through the GUI's menu from there, most of it should be self-explanatory.

Further Readings

Please also consult further README and TODO documentation in the PyHoca-GUI Git project (X2go upstream site):;a=tree

wiki/components/pyhoca-gui.1352814060.txt.gz · Last modified: 2013/03/08 13:31 (external edit)