User Tools

Site Tools


wiki:components:pyhoca-gui

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
wiki:components:pyhoca-gui [2012/11/13 13:41]
ckrakou [Launching PyHoca-GUI]
— (current)
Line 1: Line 1:
-====== 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 [[wiki:​libs:​python-x2go|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. 
- 
-===== Download/​Installation ===== 
- 
-==== Debian GNU/Linux ==== 
- 
-PyHoca-GUI can be installed from the X2Go package repository. [[:​wiki:​x2go-repository-debian|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. [[:​wiki:​x2go-repository-ubuntu|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):​ 
- 
-<​code>​ 
-$ sudo aptitude update 
-$ sudo aptitude install pyhoca-gui 
-</​code>​ 
- 
-==== 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 http://​code.x2go.org/​releases/​source/​pyhoca-gui,​ 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: 
- 
-<​code>​ 
-tar -vzxf pyhoca-gui_<​version>​.tar.gz 
-cd pyhoca-gui_<​version>​ 
-python setup.py install 
-</​code>​ 
- 
-==== MS Windows ==== 
- 
-[[http://​code.x2go.org/​releases/​binary-win32/​pyhoca-gui/​|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. 
- 
-==== MacOS ==== 
- 
-A PyHoca-GUI installer for MacOS is currently not available. Sorry. 
- 
-===== Usage ===== 
- 
-==== 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: [[http://​code.x2go.org/​doc/​pyhoca-gui/​man/​man1/​pyhoca-gui.1.html|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. 
-<​code>​ 
-  $ gsettings set com.canonical.Unity.Panel systray-whitelist "​['​all'​]"​ 
-</​code>​ 
- 
-If you would rather whitelist a set of applications,​ use this command instead, where YOUR_APPLICATION is '​pyhoca-gui'​ 
- 
-<​code>​ 
-$ gsettings set com.canonical.Unity.Panel systray-whitelist \ 
-      "​['​JavaEmbeddedFrame',​ '​Mumble',​ '​Wine',​ '​Skype',​ '​hp-systray',​ '​YOUR_APPLICATION'​]"​ 
-</​code>​ 
- 
- 
-==== 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): 
-http://​code.x2go.org/​gitweb?​p=pyhoca-gui.git;​a=tree 
- 
- 
- 
  
wiki/components/pyhoca-gui.1352814060.txt.gz ยท Last modified: 2013/03/08 13:31 (external edit)