.. _complete-installation: Full Installation ================= GoMaxi! is rather a small program, only about 5000 LOC, comments included. At the time of this writing, the .zip archive is about 70kB. This is possibile thanks to a lot of very good libraries that are available today, with Python bindings. In particular, the Python_ language has a lot of useful modules in its standard distribution, `GTK+ `_ is a great graphical toolkit and `SQLAlchemy `_, a object-relational mapper, is really a nice piece of software. Unfortunately, some operating systems don't have these great libraries included, and you need to install them before running GoMaxi!. Of course you need to do so only once. Please note that at the time of this writing Python 3.0 is NOT supported. Installing GoMaxi! is quite easy, once you've installed the libraries. Here is what to do: download the latest gomaxi-X.Y.Z.zip from `SourceForge `_. Double click on it, and choose to extract all files in a folder named gomaxi-X.Y.Z, in your Deskop or whereever you feel like. Even the folder name may be changed, GoMaxi! doesn't care. If you're already using another version, all you need to do is copying the database file `myteam.db` from the old folder to the new one. To run the program, just double-click on the 'gomaxi' file (on Windows you should see a Python icon). That's all you need to do every time a new release is out. The first time you may need to install missing libraries. Here follow the instructions. There's a small program named 'envtest' included with the distribution packages. Just run it and it will try and access all the required libraries, and tell you which ones are missing should it fail to find any. To uninstall it, just remove the folder. Gomaxi doesn't save anything in the Windows Registry, and doesn't create files outside its folder. Linux ----- Linux is the main developing O.S. for GoMaxi!. It's very likely that most if not all of the required libraries are already part of your favorite distribution, or even installed by default. I strongly advise to check with your distribution package list, before taking the route of compiling and installing the libraries yourself. GoMaxi! currently requires Python 2.6, GTK+ 2, pygtk 2, SQLAlchemy 0.5. As for me, I'm using Fedora Linux 11, with the following packages: python-2.6, gtk2-2.16.6, pygobject2-2.16.1, pycairo-1.8.2, pygtk2-2.14.1, python-sqlalchemy-0.5.4. Beware that in your distribution they might have slightly different names. OS X (Mac) ---------- I know of no installation of GoMaxi! on OS X. So I can't really be sure of the following. If you are a Mac user, and run GoMaxi!, please contact me, expecially if something in these instructions is wrong. OS X has it's own X11 server, from Apple. You need to install and run it. There are a few repositories for open source software, such as `the Fink project `__ and `the MacPorts Project `__. You may want to check those out, they allow you to download, compile and install a lot of open source software easily. You may find all the needed libraries there. Please follow the instructions for installing Python_ on your MAC on the Python site. You need python 2.6. Python 3.0 is NOT supported yet. GTK is the toolkit for `The Gimp `__. Please refer to the `page on Macintosh installation `__ for the Gimp, if you manage to run the Gimp, you have GTK successfully installed. Next install pygtk 2.x. It requires pygobject and pycairo, check out your repository and see if they are in separate packages. Last but not least install SQLAlchemy 0.5. Windows ------- Windows lacks all the libraries, much like the Mac. The instructions are similar. Luckily (for you) I've installed GoMaxi! a couple of times, on Windows XP and Vista. You need Python, GTK+ runtime, pycairo, pyobject, pygtk and SQLAlchemy. At the time of this writing, the required packages are: - `gtk-2.12.9-win32-2.exe `_ - Python 2.6, please see `Python download area `_ (sorry no direct links cause they make too frequent releases). Please note, Python 3.0 is NOT supported yet. - `pycairo-1.4.12-2.win32-py2.6.exe `_ - `pygobject-2.14.2-2.win32-py2.6.exe `_ - `pygtk-2.12.1-3.win32-py2.6.exe `_ There's no binary distribution of SQLAlchemy for Windows. I've build one, and made it available on SourceForge: - `my SQLAlchemy package for python 2.6 `_ Beware, they aren't the most up to date packages. You may want to check the sites of those libraries and look for more recent versions. If you do, please drop me a note, and I'll update the links above. To uninstall these libraries, use the Windows Control Panel. Uninstall them in reverse order, expecially python modules (pygtk, pycairo, pygobject, and SQLAlchemy) require Python to uninstall cleanly, so you'd better uninstall them before uninistalling Python itself. Other operating systems ----------------------- Well, you're on your own. You need GTK 2, Python 2.6, pyGTK 2, SQLAlchemy 0.5 installed on your system. If you manage to install GoMaxi! and want to share your experience, write a small paragraph describing the required steps, I'll gladly add it up to this page. .. _Python: http://www.python.org/