[Updated 13 JUL 17 for QLab 4.1]

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. I have tried to index  with tags so you can  find your way around,  but 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.

The major omission in the areas covered is lighting.  This is a major feature of QLab 4 and a reason  many people use QLab in their work.  I do not use these features regularly enough to reach the stage where I would be comfortable writing about them with any sort of authority. However, many of the techniques in the examples in the Cookbook are not video or sound specific and may well have applications in shows where QLab is used as a lighting controller.

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.


One thought on “Welcome

  1. Mic,

    great stuff here, very useful indeed. I do sound for several amateur groups and have been using QLab since 2 was released but as I really only do four or five shows a year I never really made full use of QLab. Part of the problem was the very poor documentation that Figure53 provided which tended to detract from an otherwise fabulous product and made it difficult to get to grips with it if you weren’t using it 24/7. Just my opinion of course.

    However, with stuff like your Cook Book you can learn by looking at how someone has done a particular task and use that as a springboard for understanding how a particular task can be carried out.

    As an example of this I have made a small modification to your Typewriter workspace which I hope you don’t mind. To make the typing sound more human I thought that it would be good to make the speed vary so I replaced the speed variable with two others one for a short delay and one for a long delay and then create a random value based on the upper and lower values. This results in a very lifelike typing effect.

    set speedQuick to 0.1 — short gap between typed characters in seconds
    set speedSlow to 0.5 — long gap between typed characters in seconds

    delay (random number from speedQuick to speedSlow)

    I would not have been able to do that without your code as a framework so my thanks once again.



Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s