Introduction ------------ This is an alpha release of Gajim for OS/X using native GTK+. It is not finished nor is it relatively stable. The native port of GTK+ is alpha and not stable yet, though it has proven to be usable for Gajim. Having said that it is usable, basic functionality works. See the TODO file for a list of what is and is not working. Installing ---------- Install the GTK+ framework into your /Library/Frameworks directory. It can be found at http://codepunks.org/misc/gtk/osx. Copy the Gajim.app into the /Applications directory or any other directory. Installing language dictionaries -------------------------------- The codepunks.org build of the GTK+ framework comes with the US English dictionary pre-installed. If you wish to install a different dictionary download the appropriate dictionary from here: http://ftp.gnu.org/gnu/aspell/dict/ Then follow these instructions: source /Library/Frameworks/GTK+.framework/Versions/Current/bin/env tar -jxf aspell--.tbz2 cd aspell-- ./configure make make install Compiling Requirements ---------------------- These instructions were gathered for building a universal binary on a PPC. The steps for building on an i386 should be essentially the same. Requirements: - OS/X 10.4, i386 or ppc - Universal MacPython 2.5 http://www.pythonmac.org/packages/py25-fat/index.html - Latest XCode (2.4.0 or greater) - py2app http://svn.pythonmac.org/py2app/py2app/trunk/doc/index.html Install all of the requirements. Make sure that the universal MacPython is installed before py2app. Then ensure that this is the first python in your PATH. export PATH=/Library/Frameworks/Python.framework/Versions/2.5/bin:$PATH Then install py2app. Compiling --------- In the top level run the configure script. If this is source is from subversion then run the autogen.sh script. Follow it up with a make: ./configure or ./autogen.sh make Once that is done Gajim can be run from the source tree. You may also create an app bundle suitable for use or distribution. To do that run: python setup_osx.py build The Gajim.app bundle is created in the dist directory. This bundle is ready for use as is. Copy it to your /Applications directory and you're good to go. You now have a self contained (almost, requires GTK+.framework still) universal native build of Gajim. Optionally to create a distribution of the Gajim app bundle do: python setup_osx.py dist Development ----------- It is possible to run Gajim correctly from the app bundle but still use the python code in the source tree. This line must be added to the _run() function in the Gajim.app/Resources/__boot__.py file. It needs to be located just after the sys module is imported. Font forget to fix the path to match your environment. sys.path = ["/Users/user/Source/gajim/src"] + sys.path