Main Page

From ModWiki
Revision as of 15:53, 2 January 2012 by Amounra (talk | contribs) (How?)
Jump to: navigation, search

MediaWiki has been successfully installed.

Consult the User's Guide for information on using the wiki software.


Monomodular

Monomodular is a modular environment for plugin control and development for use with grid-based controllers in Max for Live. It began as a multi-color Monome experiment over two years ago. It was designed with live musical performance as its most important goal. It is currently still in development, and is being offered as beta, but is being used for both production and performance by its author and many others (so you should, too!).


Monomodular is a Python control surface plugin, containing a basic framework for communicating with several types of hardware (currently Launchpad, APC20, APC40, Livid's Ohm64, Block, Code, and iPad via a custom interface built both TouchOSC and Lemur). It allows communication between up to 5 grid controllers with up to 16 client patches directly from the surface of the controller. It gives basic functionality of navigating and displaying a Monome256 workspace, and provides the base functionality for quickly writing or converting new plugins to work with its format.


There are many client patches included with the suite. Most of the early patches were ports of popular monome patches, and I have released many of amounra's own creations since first publishing Monomodular. The majority are for MIDI generation and generative processes, but the capabilities for using Monomodular are only limited by the imagination of the scripter.


The Monomodular format is largely dependent upon a single javascript object, which can be manipulated in many different ways. In addition to using the prebuilt Mods, it offers the capability of creating your own custom patches easily in MaxforLive and using them within the framework of Monomodular, or adapting patches that you've already built to be used with a grid controller.

Installation

You can view a more detailed explanation of how the installer works by visiting the Installation page.

How?

Download the installer only, and use its "Subversion" button to download the most current version (recommended): OSX_Installer

If you are using Windows, you will need to install the command-line subversion tool, SlikSVN (or something else that takes compatible commands).

or

Download the last major build, with all dependent files frozen, here: (placeholder)

Where?

If you need to know where certain files are located, or would like to change some things with the installation, please refer to the Manual Installation page.

What?

The Installer patch is a fairly simple utility that parses information about your Live and Max installations and tries to determine where files should be located on your system. Because Monomodular is not an application in itself, but instead a collection of scripts and Max patches, it is somewhat exempt from the normal routines of the average installer. The installer patch gets what information it can from Ableton's log.txt file in its preferences folder and parses the locations from your currently running instance of Live. This process is, however, not perfect, and under certain circumstances you will have to locate the correct installation paths manually.

If this is a persistent problem, please contact amounra with the specifics, and a copy of your log.txt file, so that the installer can be improved.

The installer installs three main categories of files:

Mods

MaxforLive patches that do 'something' in conjunction with a grid controller. The list is growing, but you can go to the Mods page to see what they are about. You can also access their information page from within the plugin itself by hitting the help button and linking to this wiki.

_Framework Scripts

These are the Python scripts that allow your controller to make things happen in live and link to the Monomodular hub (also a Python script).

Other Stuff

Miscellaneous files that need to be here or there in order for things to work right.

Who? Why? When?

Some guy with nothing better to do, I guess. You should be nice to him ;)

Because.

NOW!

How Monomodular Works

You can read a description of the basic functionality of every Monomodular enabled control script on the How Monomodular Works page. For a detailed description of the rest of a control scripts functionality, please refer to the links below:

How to use the Ohm64 script

How to use the BlockMod script

How to use the LaunchMod script

How to use the Codec script

How to use the AumPC scripts

How to build your own preb99