User Tools

Site Tools


wiki:components:pyhoca-gui

This is an old revision of the document!


PyHoca-GUI - Download/Installation & Usage

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.).

Download/Installation

Debian GNU/Linux

PyHoca-GUI can be installed from the X2Go package repository. Add the X2Go repository 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 source 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

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.

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 API (module) python-x2go. 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.

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.

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.

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