gibberwocky
v1.0.0
Published
music sequencing for Live and Max/MSP
Downloads
26
Maintainers
Readme
Gibberwocky
This repo is for a plugin to live code Ableton Live using a browser-based editor. It is implemented using Max4Live, Max/MSP/Jitter, and JavaScript, and draws significantly from the Gibber browser-based live coding platform.
More recent (10/2016) demo performance.
A screen capture / demo of an early version.
This project is jointly developed by Graham Wakefield and Charlie Roberts.
If you're interested in creating your own front-end using a different language (gibberwocky uses JavaScript), please see the communication spec which outlines how to send messages to the max4live plugin using websockets. Theoretically you should be able to use a language of your choice (as long as it has a websocket library...)
Installing
- Follow the instructions for installing the Max Worldmaking Package: https://github.com/worldmaking/Max_Worldmaking_Package. This will install a websocket external for Max that the code editor will use to communicate with Max4Live and Max/MSP.
- Download the most recent release of the plugin
- In Ableton Live, place the
gibberwocky_master.amxd
M4L object on the Master track in your Live set. For each MIDI instrument track, place an instance of thegibberwocky_midi.amxd
on the track and add an instrument/fx of your choice.
Using
- In the master instance, click the
Edit
button to open the browser-based code editor. You can send note/duration/velocity messages to all instrument tracks with an instance of thegibberwocky_midi.amxd
plugin. If an instrument track does not have a plugin, you won't be able to send it these messages. You can also target all fx parameters, volume controls, track sends, mute and solo functions from this single editor. - If the
Edit
button fails to open a code editor, there are two options. The simplest is to use the online editor. You can also try manually opening theindex.html
file found in the top-level directory. - Execute code by selecting it and hitting Ctrl+Enter. Alt+Enter will select and execute an entire block of code (blocks are delimited by empty lines). Ctrl+. (period) will stop all running sequences. Make sure your transport is running in Live, otherwise executing code will have no effect!
- Read through the example code. Click on the "demos" button in the right sidebar to view other examples / explanations.
Development
Max for Live device
Remember to unfreeze the device to edit it, and freeze it again afterward.
Also, watch out to not edit the .amxd directly in Max, but only launch the editor from within Live. I don't know why this makes a difference, but it caused all kinds of headaches.
Browser-based client editor
First, install all packages with:
npm install
Then use the gulp
command from the top-level directory to launch a watcher that will recompile the application whenever any JavaScript files are changed. Due to some quirks regarding how Max reads in external files, the resulting index.html
file that is created will contain all HTML, CSS, and Javascript in a single (very large) file.