Use Gibber inside Ableton Live
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
css
dist
gibberwocky.demo Project
gibberwocky_2 Project
js
misc
.gitignore
LICENSE
README.md
debug.html
dups.sh
gibbergen0.maxpat
gibbergen1.maxpat
gibbergen10.maxpat
gibbergen11.maxpat
gibbergen12.maxpat
gibbergen13.maxpat
gibbergen14.maxpat
gibbergen15.maxpat
gibbergen16.maxpat
gibbergen17.maxpat
gibbergen18.maxpat
gibbergen19.maxpat
gibbergen2.maxpat
gibbergen20.maxpat
gibbergen21.maxpat
gibbergen22.maxpat
gibbergen23.maxpat
gibbergen24.maxpat
gibbergen25.maxpat
gibbergen26.maxpat
gibbergen27.maxpat
gibbergen28.maxpat
gibbergen29.maxpat
gibbergen3.maxpat
gibbergen30.maxpat
gibbergen31.maxpat
gibbergen4.maxpat
gibbergen5.maxpat
gibbergen6.maxpat
gibbergen7.maxpat
gibbergen8.maxpat
gibbergen9.maxpat
gibberwocky.js
gibberwocky_master.amxd
gibberwocky_midi.amxd
gulpfile.js
index.html
index_template.html
package.json

README.md

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

  1. 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.
  2. Download the most recent release of the plugin
  3. 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 the gibberwocky_midi.amxd on the track and add an instrument/fx of your choice.

Using

  1. 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 the gibberwocky_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.
  2. 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 the index.html file found in the top-level directory.
  3. 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!
  4. 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.