Installation

Before installing Monomodular, make sure you have the most current versions of MaxMSP and Ableton Live installed on your computer. You will also need a license to use MaxforLive (although it is possible to use everything here in Demo Mode).

You may have navigated here from the installer itself, and you're wondering what its all about.

To install all the Monomodular software, just follow the instructions printed in the console window of the Installer patch.

There are four fields that need to be correct in order for the installation to proceed. They display the file paths to the locations that the files will be copied on your system. If they are correct, the field will be white. If the path couldn't automatically be found, it will say so in red, and you can locate it manually by either clicking on the text or dropping the file/folder onto the box on the left of the text. The default paths for the files:

Installation Package (all platforms):

This is the data that the installer will copy to your computer. If you downloaded the bundle, it should have been autodetected if you launched the installer from inside that bundles folder. If not, you can either drag the folder from its location to the box on the left side of the text indicating the path, or you can click on the path and choose it from a file browser.

If you are installing from SVN (recommended), you must press the "Subversion" button on the right side of the interface, and you will be given a choice of a temp folder where the installer will download the package from its subversion repository. You can delete this folder manually after the installation is complete, or leave it in place until the next time you update Monomodular with the installer (however, its path is not stored....it will need to be reselected the next time you run the installer).

These are the default locations that the installer is looking for. Under most circumstances, this is where things will be:

---

MacOS

Live.app = ~/Applications/Live 8.x.x/Live.app

MaxMSP Folder = ~/Applications/Max 5

Live Library = ~/Library/Preferences/Live 8.x.x/Library

---

Windows (pre win7)

Live Folder = \Program Files\Ableton\Live 8.x.x

MaxMSP Folder = \Program Files\Cycling '74\Max 5.x

Live Library =\Documents and Settings\USER\Documents\Ableton

---

Windows 7

Live Folder = \Program Files\Ableton\Live 8.x.x

MaxMSP Folder = \Program Files\Cycling '74\Max 5.x

Live Library = \users\username\documents\ableton\Library

---

Once the installer has verified that the installation paths that you've chosen to be valid places to put its files, you can press the "Install" button to begin moving files to their proper places. The terminal window on the right will indicate exactly what is being sent to the [shell] object in the patch, and if you are on MacOS, the return result from the shell will be displayed.

The installer will copy its payload to new folders if the correct folders don't already exist. For every new revision, a new set of folders will be generated. This is good and bad. It means that none your old installation will be harmed, so there will be no 'broken' sets when you upgrade. It also means, however, that if you upgrade as often as revisions are made, you will end up with a bunch of deprecated folders. For now, you will have to delete these manually. You can refer to the Manual Installation page to see what files go where, and what you can delete.

The good news is that Monomodular takes up very little room, so the only downside is a bitter of clutter (mostly in the Control Surface Scripts folder inside your Live installation....this can be a bit frustrating if you change things around often, but otherwise, is completely harmless).

If you try to install a Monomodular revision over that same revision, the installer will not overwrite any files. It should, however, replace any files that might have gone missing through erroneous deletion or movement.

Once the installer is finished, it will indicate that you need to restart Live. So....restart Live already.

Limitations

All I can really say is: READ THE DIRECTIONS. I've done my best to make the installation as painless as possible, and I've included as much documentation both with the Installer patches and in this Wiki as I can think to.

That said, this is the first 'm4l Native' installer that I've seen in the wild, and I'm doing all I can to make it compatible with as many systems as possible. Worst case scenario with this installer is that you have to choose your own paths before you hit the "Install" button, which still eases the process of having to manually install all of the files.

The newest installation will get tagged with the revision number (e.g. blahblahb992r13) if you are using SVN and OSX, but not if you are doing it from and install package. That means it should add to/overwrite any old data if you are installing without SVN. This will change in the future, as I'm still figuring out a way to do things better in Windows (and OSX for that matter) in this matter.

Currently, we're still testing out the Installer on different systems to see what works and what won't. There may be problems with Lion and Win7, because I don't have an installation of either at the moment and I'm therefore relying on end user input to work out the details. If you have one of these operating systems and want to help out, please contact me via email and we'll work on it.

Otherwise, unless your system is "REALLY" weird, the installer should work fine. I have no experience with trying to install to external partitions, but you should have all this stuff on the root partition anyway. Regardless, let me know how this works out (or doesn't).