Please notice that compile.command is deprecated. Use Makefile instead (or a binary release).

The Short Version

Requirements

• Sorry, at this time 0.3 only supports Mac OS X 10.6.x (r331 and newer in trunk).
• An svn client, and
• Xcode 2.5 (for Tiger and 10.4.x builds), 3.1.1 (for Leopard and 10.5.x builds), 3.2 or newer.

Procedure

1. Check out http://svn.kismac-ng.org/kmng/trunk/
2. Navigate a Finder window to trunk/ as appropriate
3. Run make <command> where command can be one of "development" or "release"
4. Copy the app from build/Development or build/Release to your Applications directory
5. Delete the old prefs file

The Longer, Detailed GUI-based Version

Requirements

• Download and install the latest Xcode (3.2.4) from  Apple or the disks included with newer Macs.
• Download and install  SmartSVN (the free foundation version).
• Download and install  SVN 1.5 or later

Procedure

Leopard shown for illustration only; Neither Tiger nor Leopard works.

1. Open SmartSVN and a new window will appear. Chose option "Check out project from repository" and click OK:
   
2. Enter the paths for both the repository and where you would like to keep your local copy. If you click the folder icon on the far right of the local directory path it will bring up a file browser to make the path selection easier. There must not be any spaces anywhere in any of the folder names that lead to the source code. The example below shows the main KisMAC build, trunk, being saved in the KisMAC folder located in BugDave's home directory.
   
3. Confirm your settings are correct and click finish:
   
4. Wait for the checkout process to complete. (This may take a while depending on things like your internet connection and number of hops to the server.) You should see something like this:
   
5. When SmartSVN reports that its checkout is complete you can quit the program. Open a Finder window and navigate to the local directory that you chose to to save the repository in:
   
6. Open a terminal window and type "cd " (you will need the empty space after cd). Now drag the folder that contains the all of the kismac files to the terminal window and hit the return key. Alternatively, you can just type the command "cd <path_to_folder>". It should look similar to this:
   
7. Now type "make development" in the same terminal window:
   
8. If done correctly, the compiling process will now begin. This can take anywhere from one to ten minutes or perhaps even longer depending on your machine. (If it doesn't complete successfully as illustrated, have a look at the output in the terminal window -- you may have to have someone else look at it to make sense of it.) After it has completed:
   
9. You should now have the built application in the new subfolder build/Development that you can copy to your /Applications folder. NOTE: In order to properly compile again, you must delete the build folder and its contents.
   
10. You must delete the old preference file before running the new build. It should be at: ~/Library/Preferences/org.kismac-ng.kismac.plist. Older versions of KisMAC stored this file in different places so, if you have either of the following, delete those too:
    1. ~/Library/Preferences?/com.kismac-ng.kismac.plist
    2. ~/Library/Preferences?/de.binaervarianz.kismac.plist
11. In the terminal, you can use rm ~/Library/Preferences/?*kismac.plist to delete all of these.

Updating

Read on if a new revision has been released and you would like to update and compile it.

1. Open SmartSVN back up and choose the project that you already have saved. There will be an option for it in the first window. Once it opens click the Update Local Copy button (circled in red in the screen capture):
   
2. A new window will open up. Leave the default settings and click OK to update your copy to the latest revision. If you choose to downgrade your local copy to an older revision you can type in the revision number and click OK:
   
3. Just repeat steps 5 through 8 above and you're done! :-D

Problems?

When I compile the revision number doesn't show in the about kismac box. Example below.

Some users have pointed out that when compiling with this method the revision number is not shown in the about kismac window. This seems to be a problem with the svn version 1.4 that is installed in the operating system and SmartSVN. To prevent this you will need to upgrade your svn to version 1.5. To do so  install this package.

Postscript

Installer Images

• If you would like to build an installer package for both PPC and x86 architectures, you must open up a Terminal window and from the source code's root directory (/Users/BugDave/KisMAC/trunk in the example above) type:

./compile.command Universal image

• To build an installer for just the architecture you are currently running, instead type:

./compile.command Deployment image

Previous Version

The previous version of this page can be found here for those who prefer it.