Expert Sleepers Oomingmak v1.0.0 - Manual (Page 27)

MIDI & OSC Scripting
Preamble
It is possible to extend the plug-in’s MIDI & OSC functionality via user-writeable scripts.
Indeed, the standard MIDI functionality described above has been re-implemented using
such a script, which you can use as reference for your customisations.
The language used for the MIDI scripts is Lua. You will find a complete description of the
language, and some useful tutorials, at the Lua website:
www.lua.org
All the standard language features of Lua are available in the scripts, plus some extra func-
tions (documented below) specific to the Expert Sleepers system.
Learn by example
The best way to learn about scripting the MIDI & OSC functionality is to look at the exist-
ing examples, particularly the default script that ships with the plug-in. Just open up the
plug-in bundle and find the midi.lua file within. (Windows users should download the
Mac OS X version of the plug-in and get the script from there, since in the Windows ver-
sion the script is munged into the plug-in as a Windows resource.)
Most of the example snippets in the documentation below are taken directly from the de-
fault midi script.
You should be able to find more scripts on the Expert Sleepers website.
Share your scripts!
You are encouraged to share your scripts with other users. For example, you could post
them on the Expert Sleepers forum (linked from the website). Alternatively, email them to
us, and we’ll make the best of the bunch downloadable directly from the Expert Sleepers
site.