wiki:Source Code

Version 31 (modified by zach, 4 years ago) (diff)


Guide to navigating the Colloquy source code and building it.

Step By Step Guide to Building Colloquy

Colloquy for Mac OS X is an open source project under the GNU General Public License version 2. Chat Core is licensed under the BSD license terms, as is Mobile Colloquy. Please understand the terms of this license before using Colloquy's source for any other projects.

You can find the source code in our Subversion repository. Colloquy uses a bundled framework called Chat Core (part of the Colloquy project) that implements the IRC protocol and wraps around the SILC Toolkit — the heart of the Colloquy's IRC & SILC communication layer.

Step 1:

Either install Xcode version 3.0 or later by downloading from the Apple Developer Connection or install the package from your Xcode Tools CD. This means you'll need OS X 10.5 or later.

Step 2:

Download a copy from the Subversion repository. In the OS X terminal type the following:

svn checkout Colloquy

On OS X 10.5, Subversion is installed in /usr/bin and is therefore part of the default search path.

Step 3:

Desktop only. Download and install the latest version of F-Script. (F-Script is a powerful SmallTalkish scripting language that uses the Cocoa frameworks.) Copy Fscript.framework to /Library/Frameworks? or ~/Library/Frameworks?.

Step 4:

Open the Colloquy project and Build.

No longer able to download the latest updates?

We have moved the site and the path has changed. To fix this to the correct path, use the OS X terminal, go to your Colloquy directory, and type the following:

svn switch --relocate

Up-to-the-minute Code Changes

Colloquy uses a system to track Subversion changes, you can browse what has been changed in the Timeline.