Installation
From Griffith
Contents |
UNIX systems
Installing on some Linux distributions
Debian GNU/Linux and Ubuntu
Griffith is available in official repositories, all you have to do is execute:
# aptitude install griffith
Arch Linux
Download PKGBUILD file from here and follow this guide
Gentoo Linux
# emerge -a griffith
Installing from FreeBSD ports
# cd /usr/ports/deskutils/griffith/ && make install clean # pkg_add -r griffith
Installing from source
Unpack the Griffith tarball using these commands:
$ tar -zxf griffith-<version>.tar.gz
Switch to the newly created directory and type as root:
# make install
The Makefile will copy the files to the correct location in your system. You do not need to configure or compile Griffith as it is written in interpreted Python code. You can test Griffith without installing it:
$ cd griffith-version $ ./griffith --home /tmp/griffith
Installing from downloaded package
If you have downloaded Griffith package, just do as root:
- deb packages (Debian, Ubuntu, ...)
# dpkg -i griffith_<version>_all.deb
- rpm packages (Redhat, Fedora, Mandrake, ...)
# rpm -Uvh griffith_<version>.rpm
Making Debian package
If you want to make your own Debian package, follow these steps:
- change your working directory to griffith source
- edit debian/changelog file, f.e. like this:
$ dch -v <version> -D UNRELEASED -i NOT RELEASED YET
- type `debuild` or `dpkg-buildpackage -rfakeroot` to build package
- install new package (`dpkg -i ../griffith_<version>_all.deb`)
Microsoft Windows systems
Installing using the installer
Just run the griffith installer available for your system. A separated GTK+ Runtime Environment for Win32 is NOT necessary. For now, Griffith is known to work as expected under Microsoft Windows XP and Microsoft Windows Vista but should work on other windows flavours too.
Compiling and making a custom installer
This was tested with Griffith 0.9.5. Should work with later versions. You will need the following packages installed on your system.
- Python - python 2.5.1 [1]
- GTK development environment - gtk-dev-2.10.11-win32-1 [2]
- PyGTK - pygtk-2.10.4-1.win32-py2.5 [3]
- Glade 3 - glade-3-0-2-win32-1 [4]
- PyCairo - pycairo-1.2.6-1.win32-py2.5 [5]
- PyGObject - pygobject-2.12.3-1.win32-py2.5 [6]
- ReportLab - ReportLab_2_1 [7]
- winshell - winshell-0.2 [8]
- PIL - PIL-1.1.6.win32-py2.5 [9]
- py2exe - py2exe-0.6.6.win32-py2.5 [10]
- Python For Windows Extensions (pywin32) - pywin32-210.win32-py2.5 [11]
- SQLAlchemy - SQLAlchemy-0.3.10 [12]
- PyXML - PyXML-0.8.4 [13]
- psycopg2 - psycopg2-2.0.6.win32-py2.5 [14]
- MySQLPython - MySQL-python-1.2.2.win32-py2.5 [15]
- Python-chardet - chardet-1.0 [16]
- Python SQLite - pysqlite-2.3.5.win32-py2.5 [17]
- Inno Setup - isetup-5.1.14 [18]
- After installing all the above packages, get griffith from SVN or download the latest source tarball from the official site [19]
- Put the whole Griffith tree under c:\griffith
- Open a command prompt window and type:
cd c:\griffith winsetup.bat
- When the process is finished, locate c:\griffith\winpackage.iss file using the explorer, right click it and choose 'compile'. This will create a single file installer using Inno Setup application.
- You can find the final installer in c:\griffith\installer
Apple MacOSX
Installing from source
These setup guides were tested on MacOSX 10.4.x (both intel and powerpc based systems), using a Python 2.4.3 framework. If you have a prior python version, please make sure to grab a 2.4 universal binary version from [20]
- Download and install DarwinPorts from [21]
- Open a terminal window and syncronize DarwinPorts' port tree with
sudo port -d selfupdate
- Then we need to install XCode that will provide us somes required tools, like a compiler :)
You can find it on your original MacOSX disk or download it from [22] Be aware that this is a very big download - almost 1 Gb. Pick version 2.4 or later.
- Type
sudo port install py-gtk2
this will install all the dependencies needed to pygtk and will take a while to complete
- Install Reportlab by typing
sudo port install py-reportlab
- Next grab the following packages from [23] and install all of them using the included installers:
PIL [24] pysqlite2 [25] pyxml [26]
- If you want MySQL support download
MySQLdb [27]
- Install python-sqlite2 by typing
- Then you will need to install at least version 0.3.1 of py-sqlalchemy from [28] because Darwin ports doesn't provide a recent version of this library. So, download it, untar it and from the inside of the package directory type:
sudo python setup.py install
Probably you will need to upgrade setuptools to 0.6c3 version as well during this process.
- Last but not least, you will need a X11 server because GTK is not native yet on the MacOSX. Use the Apple's X11 server because it will be much easier to configure. If not already installed you can find it on your MacOSX install DVD.
- To run Griffith just type
open-x11 griffith
on terminal to see if all is working as expected.
Changing gtk2 theme
pygtk uses the gtk2 default theme which is not very macosx-like. You can install a custom gtk2 theme. For example, download an aqua theme from [29]. Create gtk2 themes directory:
cd ~ mkdir .themes
and place the aqua theme on this new directory.
- Next, lets install a gtk theme manager that will make theme selection a breeze:
sudo port install gtk-chtheme
- Now, run it with
open-x11 gtk-chtheme
and choose your custom gtk2 theme. Close the application and fire up griffith.
Installing from dmg package
Not yet.
