Download

Before you go ahead and install Gaphor, make sure the following things are set up:

  1. You should have Python installed, version 2.4.0 or newer
  2. PyGTK 2.10.0 or newer should have been installed.
    • For Linux users, it's pretty certain this package is already installed.
      NOTE: On Ubuntu (and probably most other Linux distros as well) you'll have to install the python2.x-dev package in order to install both the easy_install tool and Gaphor via the source.
    • FreeBSD users should install py-cairo and py-gtk2 from the ports.
    • Mac OS X users should consider installing py-cairo and py-gtk2 from the MacPorts.
    • Windows users should check out the Win32 page.
  3. It's a good idea to have a CustomInstallationLocation for your own Python packages.

Requirements

  • Python 2.4.0 or newer
  • PyGTK (2.10.0 or newer) and py-cairo language bindings
  • Setuptools (will automatically be downloaded if not yet available)
  • Python dependencies will be downloaded when you install Gaphor

See also LinuxDistros.

Releases

Gaphor

You can find the latest release at http://cheeseshop.python.org/pypi/gaphor. To find out what's new check out the News file.

The easiest way to obtain Gaphor is through the easy_install tool:

  1. Download and install easy_install (follow the link for instructions).
  2. Download and install the latest version of Gaphor by executing (use -U switch to update): 
    $ easy_install -U gaphor
  3. Launch Gaphor

Alternatively, you can download the latest version of Gaphor from the Python Cheeseshop: http://cheeseshop.python.org/pypi/gaphor.

FreeBSD users can find Gaphor in their ports tree (devel/gaphor), although you might prefer the easy_install solution.

Windows users can download gaphor-0.8.1-win32.zip from the Sourceforge download area. You have to download and install Python 2.4 separately from http://python.org.

Older releases can be found in the Sourceforge download area.

Gaphas

The latest release of Gaphas (Gaphor's canvas component) can be found at the Python Cheeseshop: http://cheeseshop.python.org/pypi/gaphas.

Gaphas is available as .tar.gz and as Python Egg (install using easy_install as described above).

Cutting edge

Those of you who do not fear can download the latest version from the Subversion repository.

The repository is located at http://svn.devjavu.com/gaphor.

The latest code is located at http://svn.devjavu.com/gaphor/gaphor/trunk (Gaphor) and http://svn.devjavu.com/gaphor/gaphas/trunk (Gaphas).

Gaphor uses PEAK's setuptools, a superset of Pythons distutils. Setuptools will automatically be downloaded and installed if not already available. You might not want to let setuptools install stuff in your system's site-packages directory. We recommend setting up a CustomInstallationLocation for your python packages.

Installation from source (.tar.gz)

To install Gaphor from source:

  • unzip (/untar) the Gaphor archive
  • enter the directory gaphor-x.x.x and do a 
    $ python setup.py install

In order to run Gaphor without installing:

  • unzip (/untar) the Gaphor archive
  • enter the directory gaphor-x.x.x and do a 
    $ python setup.py develop
$ ./run-gaphor.sh

The develop target only has to be executed once, so Gaphor's package dependencies are downloaded and installed. after that the run-gaphor.sh script will suffice.

Windows users should not need to install Gaphor at all, but have to download the gaphor-win32-libs package from Subversion and place in the directory gaphor-x.x.x.

Note for Mac OS X users

Gaphor runs under X11. The default behaviour is to select a window first before stuff like menus and buttons can be pressed. If you just want to act those windows as if they're native Mac windows, set this : 

defaults write org.x.X11 wm_click_through -bool true