Compiling Mixxx for Mac OS X is pretty straight forward once you have all the dependancies and Qt set up properly. This guide assumes you have basic knowledge about compiling (untar/ungzip, ./configure, make). If you don't, there is a basic guide available at http://www.ee.surrey.ac.uk/Teaching/Unix/unix7.html.

This guide is written for Leopard (10.5.x) but should work on Tiger. You will need the XCode development tools installed; if you don't a guide is available at this page.

Mixxx relies on several external libraries for various features. At the moment, installing the supporting libraries through fink does not work properly as the install script expects them in a different place. When executing make install, you may need to use 'sudo make install' instead.

You will need to install the following before continuing with the compile process:

• scons (Download page, Install guide)
• libid3tag, libmad (Download page)
• PortAudio-v19
• QT 4.3.0+ (Download page)
• fftw3 (Download page)
• libogg, libvorbis (Download page)
• libsndfile (Download page)

Important note for Qt: In order for Mixxx to compile, you have to ./configure Qt with the -no-framework option. Don't forget, Qt takes a long time to reconfigure and compile!

If you want to compile Mixxx, you'll need to download the source code. Either grab the source for the latest release off our downloads page, or checkout a snapshot from SVN:

svn co https://mixxx.svn.sourceforge.net/svnroot/mixxx/trunk/mixxx

If you got the source code from SVN, change to the newly created “mixxx” directory, and use scons to compile and install:

cd mixxx
scons

This will generate Mixxx.app.

If you wanted to update later to a newer SVN snapshot, you would go back to the mixxx directory and run:

svn update

This is taken from the Scons site, who have a pretty good description of how to get a scons project up and running in XCode:

1. File→New Project, choose “External Build System”
2. Save the project into the same directory as your SConstruct file.
3. In Groups and Files → Targets, double click the target that was automatically created.
4. In the Build Tool field, put the full path to scons - like ”/System/Library/Frameworks/Python.framework/Versions/2.3/bin/scons”
5. You should now be able to build using the Build command from Xcode
6. Right click “Executables” and choose “Add new custom executable” and point it to the executable you are building and then you can debug using Xcode.
7. Use Debug → Breakpoints menu to add a symbolic breakpoint at main() - just type main where it says 'Double click for Symbol' - if you don't add this break point none of the breakpoints set in the editors will work, because gdb doesn't have the symbol information until you start debugging (Jim Ingham suggests turning off “Lazy Symbol Loading” in Debug Preferences.)