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.
