Differences

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

--- wiki:components:pyhoca-gui [2011/11/15 09:45]
sunweaver
+++ wiki:components:pyhoca-gui [2013/03/08 13:31]
127.0.0.1 external edit
@@ 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 =====
@@ Line 7: / Line 11: @@
 ==== Debian GNU/Linux ====
-PyHoca-GUI can be installed from the X2Go package repository. [[:wiki:x2go-repository-debian|Add the X2Go repository to your APT system]] before you continue.
+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 ====
@@ Line 13: / Line 17: @@
 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 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):
+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>
@@ Line 22: / Line 26: @@
 </code>
-===== Usage =====
+==== Other GNU/Linux (from source tarball) ====
-The name PyHoca is a word play combining two powerful entities: Python and Phoca (mascot of X2go, Latin species name for seals).
+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.
-PyHoca-GUI is a client implementation for X2go using the project's Python API (module) [[wiki:libs:python-x2go]]. PyHoca-GUI uses wxPython for rendering graphical desktop elements (menus, dialog boxes etc.).
+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).
-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.
+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 ====
@@ Line 46: / Line 66: @@
 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>
@@ Line 64: / Line 96: @@
 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

X2Go - everywhere@home

User Tools

Site Tools

Differences

Page Tools