Checking out Jamoma from GIT

First you have to install Git

  1. Depending on your OS and taste, open a terminal Window, the cygwin Window, or a Git client.
  2. Go into the folder where you like to create the Jamoma repository using the cd command (or stay in your ~ folder).
  3. To clone the repository in this folder: git clone git://
    • The default folder name will be Jamoma.
    • In case you want to have Jamoma checked out into another folder, do this instead: git clone git:// folder-name
  4. Now you would have a Jamoma folder. Go into: cd Jamoma/Tools
  5. You have to update all submodules of the project: ruby update.rb
  6. Wait until it is done...
  7. When the update process is finish, you have all the Jamoma repository !
  8. You probably want to build everything: ruby build.rb Development
  9. Congratulation and welcome to the Jamoma development !
  10. You might want to add certain Jamoma folders to your Max5/Max6 searchpath
    • the folder of all compiled exernals: /Jamoma/Builds/MaxMSP
    • the Jamoma UserLib: /Jamoma/UserLib
    • the Jamoma Modular files: /Jamoma/Modules/Modular/Max
    • the 3rd party externals:
      • /Jamoma/Modules/Dependencies/Max/Mac (for Mac)
      • /Jamoma/Modules/Dependencies/Max/WinXP (for windows)

Note that if you are planning on pushing to any of the repositories, you will need set that up in each repository's .git/config file. Alternatively, you can set all of the main modules in the repository to be pushable by simply running the makeAllSubmodulesWritable.rb script in the Tools folder.

To use Git properly and know more about the Jamoma workflow : Go there.

Solving build problems

Here are a few things to check if you have problems with building Jamoma:

  • Be aware of the Pitfalls for Developers.
  • Check out the Developer's Corner.
  • You need write access to the /usr/local/ (OSX) and Max's Cycling '74 folder
  • You should remove previously installed versions of Jamoma before trying to build, especially Jamoma-related files in the above locations, there is a uninstall script that can be used: Tools/installertools/Uninstall.command (OSX)