Building Max/MSP externals

Jamoma has become a fairly large project with a number of dependencies. This page describes how to go about to compile the externals on both Mac and Windows.

On the Mac platform

Assuming you did follow the Setup instructions, install git and checked out all the Jamoma repositories, first make sure you do the steps below as an admin user or give yourself write permission to /Library/Frameworks and /Applications/Max5.

From the main Jamoma repository, navigate to the “Tools” folder using the following command:

cd Tools

For users incomfortable with the Terminal, just type the command cd followed by a space and drop the Tools folder from the Finder to the Terminal window.

To build all Jamoma projects (i.e. all its subprojects), use the provided Ruby script by running

ruby build.rb Deployment clean

Alternatively, you can use “Development clean” as arguments to the script if you want to build on Development mode and be able to debug externals from XCode.

This will build externals, libraries and frameworks. You may have to do the last step twice to get everything to build.

There are also scripts to build only one Jamoma sub-project at a time (e.g. only DSP or modular).
To do so, navigate to it, e.g. cd /Modules/DSP to build the DSP framework and externals, and then run its specific build.rb script by running (while being in its folder):

ruby build.rb Deployment clean

On the Windows platform

NOTE: You first need Cygwin to be set up properly (needs to have the ruby, git, gcc, packages). You also need to have Microsoft Visual C++ 2008 Installed.

Open the Cygwin terminal and run the same scripts as described for building on the Mac.