Expert Sleepers MIDI & OSC Scripting v1.1.0 - Manual (Page 5)

MIDI & OSC Lua scripting
For most Expert Sleepers plug-ins it is possible to extend the plug-in’s MIDI & OSC func-
tionality via user-writeable scripts. Indeed, the plug-in’s standard MIDI functionality is
usually implemented using such a script, which you can use as reference for your cus-
tomisations. Refer to the user manual of the individual plug-ins for information on their
particular scripting implementation.
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.