Pre-requisites

Ableton Live (Preferably 7.0.3, 6 is also reported as working)

Max/MSP (4.6.3)

On the PC you will need Midi Yoke installed, Mac users are lucky because it has built-in interapplication midi routing.

Installing

In the zip are 2 folders

1. APIMidi : The MIDI Remote Scripts python code
2. Max : Patches and javascript code

And there is a simple Ableton Live Set in the top level : API-Midi.als (created in Live 7.0.2)

Put the APIMidi (1) folder into your MIDI Remote Scripts folder :

PC : LIVE_INSTALL_DIR\Resources\MIDI Remote Scripts

MAC : /Applications/Live 7.0.2 OS X/Live.app/Contents/App-Resources/MIDI Remote Scripts

On the MAC you'll have to navigate to /Applications/Live 7.0.2 OS X, right click on the Live app icon and 'Show Package Contents'. I dragged a shortcut from the MIDI Remote Scripts folder to the sidebar of Finder for easy access.

Then put the Max folder somewhere and in Max add it to your path via Options -> File Preferences

Next setup the midi ports in max (File -> Midi Setup..)

PC : Set 'In from Midi Yoke 1' to use 'm' in the 'abbrev' column, and 'In from Midi Yoke 2' to use 'n'. Then use the same letters for the output ports.

MAC : 'to MaxMSP 1' and 'from MaxMSP 1' to 'm' and 'to MaxMSP 2' and 'from MaxMSP 2' to 'n'

Then open up the main max patch : Max/patches/APIMidi-Demo.pat

Now in Live open up the preferences and setup the control surface like this

PC : APIMidi - In from MidiYoke 2 - Out from MidiYoke 1

MAC : APIMidi - from MaxMSP 2 - to MaxMSP 1

Finally, open up the demo project. If all goes well the Max patch should receive a 'Hello' message from Live and connect itself up to the API. (You'll see a lot of debug output in the max message window)

Thats it. :)