Welcome to Mic Pool’s QLab Cookbook. I am a  British sound and video designer, working mainly in theatre, and I use QLab as the playback system for much of my work.

You can find out more about me here.

The QLab Cookbook contains a selection of projects and examples using a broad range of QLab programming techniques including Applescript, OSC and external control  using QLab Remote and third party OSC controllers.

The Site is currently  updated for QLab 4.1 (released June 2017).  Many of the screenshots are from QLab 3 but unless noted are generally similar, functionally, to the same workspace opened in QLab 4. Example workspaces may have been created in QLab 3. All QLab 3 workspaces have been tested in QLab 4.1. If no specific QLab 4 workspace is available then the QLab 3 workspace should open and function in QLab 4.1

It is not intended as a comprehensive manual or tutorial. Some of it is quite random.,  and it’s really intended to be explored, rather than used  as a comprehensive reference work. I also prefer coffee table books to programming manuals, so that probably has had an influence on how I have put this together. But hopefully, there is some substance among the style. Because it has grown to be rather large I have indexed it in the form of a downloadable table ( or a squint on screen) here.

There is less information on light cues as they are only a relatively recent addition and I am not a lighting specialist. Much of the programming information in other chapters can be applied to aspects of lighting with QLab.  If lighting is your main interest, why not jump straight to:

Lighting Playground


The site is optimised for browsers, but will display well on mobile devices and tablets.

Much of the basis of the underlying techniques used, in particular a lot of the scripting,  has been based on the work  of  other QLab users and Figure 53 staff in posts to the QLab Google group or on the QLab Wiki. I have tried to credit these contributions where possible. I am grateful to Rich Walsh for his many contributions to the QLab scripting WIKI, and for helping me out on many occasions when I have been completely stuck on a script.

For a more complete selection of QLab tips, the following links may be useful:

QLab Google group

Figure 53 WIKI

QLab Official Documentation

This site is not affiliated to Figure 53. Figure 53 and QLab are registered trademarks of Figure 53 LLC. All contents of this site including photographs (except where noted in the photo credits on each page) are copyright and may not be reproduced without permission. Finally, I am a designer, not a programmer. I have put this together without an editorial team or technical proof-readers. All suggestions and comments, particularly improvements to scripts and other code  are very welcome. I will be adding chapters regularly. Click the wordpress follow button to get notifications when new material is added.

Click the logo below for more info and contact details:


You can return to the main menu by clicking the site title, using your browser back button, or by clicking this graphic which appears at the end of each page.