The Lemur and TouchOSC Templates

The Lemur and TouchOSC Templates

In this article, we will provide you with some useful insights regarding the Lemur and TouchOSC templates and Gig Performer.

If you’re using Lemur or TouchOSC, we have created templates that make it easy to control Gig Performer widgets from these popular OSC apps. See this blog for the Lemur template and this blog for the TouchOSC template. Note that these templates merely provide a starting point for your own OSC setup and you certainly are not required to use them – in fact, we encourage you to construct your own custom OSC environments.

Note: Deskew Technologies does not provide official support for these templates.

The Lemur Template

The Mixer page of the Lemur template (as viewed on a tablet or a smartphone) looks like this:

Lemur is an OSC application and here's the template for VST Host Gig Performer.

1. Template page tabs – touch these tabs to switch between the Lemur template’s Mixer, Setlists, and Songs pages.

2. Current song name – when a song is loaded, the name is displayed here.

3. Song part tiles – when a song is loaded, these tiles show the names of song parts. Clicking on a tile loads the indicated part.

4. Lemur controls – these rows of knob, fader, and button controls get mapped to widgets in your rackspaces.

5. Previous/Next Song buttons – touch one of these to move to the next or previous song in the current setlist.

6. Current rackspace name – each song part is associated with a rackspace variation. The name of the current rackspace is displayed here.

7. Settings menu – touch here to drop down a menu that allows you to load and save projects, plus access Lemur settings.

8. Tap Tempo button – the Tap Tempo button is always active and has the highest priority, so it can be tapped at any time to set a tempo. This can be useful for syncing delays to the tempo of a live performance.

9. Tuner current note display – when the tuner is on, the note currently detected from the input is displayed here.

10. Tuner current intonation display – when the tuner is on, this display shows how sharp or flat the note currently detected from the input actually is from the note displayed.

11. Tuner on/off button – touch this button to bring up Gig Performer’s Tuner view for tuning. Touch it again to hide the tuner.

12. Songnotes display – a small display for a reminder or any short message you would like to have shown on the Lemur screen. Create a label on a panel in Gig Performer, check the Customize caption box in the Widget Properties area. and enter as the caption the text you want displayed in Lemur. In the OSC Name field, enter “Songnotes”, and then check the Enable OSC box. The caption for that label will now appear in Lemur in place of the Songnotes label.

Lemur OSC application and Gig Performer - label and songnotes

13. Tempo field – displays Gig Performer’s current tempo.

14. Snapshot button – this is the same as the Capture variation into this part button just above the panel in the Setlist/Song view. It captures any changes you may have made to widget settings since recalling the rackspace variation associated with the song part, and stores the changes with the part, so they are recalled each time that part is.

15. Snapshot indicator – when a snapshot is taken, this indicator turns red to show that the variation has been edited. Touching the red button recalls the variation as stored. Changes to widget values are lost.

16. Refresh button – touch this button after making changes to a Gig Performer rackspace to update the Lemur display with the changes.

The Setlists and Song pages in the Lemur template offer quick touch access to, of course, your setlists and songs.

Note: this template assumes that you have defined up to:
– 10 knobs whose handles are Knob1, Knob2, …Knob10,
– 10 sliders with handles Slider1, Slider2, … Slider10,
– and 10 buttons with handles Button1, Button2, … Button10.

Lemur and Gig Performer - Setlist

Communication Between Lemur and Gig Performer

The first step is to provide Lemur and Gig Performer with the contact information of each other. The contact information consists of two parts: the IP address of the device and the port number to which the application is listening for messages. When configured properly the communication can be established.

Important note: Deskew Technologies cannot provide support for either the Lemur application or wireless communications in general. However, we offer the information below to try and facilitate Gig Performer users getting the two applications working together.

1. In Gig Performer, choose the Options -> OSC Setup command. The OSC Options open.

2. The IP address of the computer running Gig Performer is shown in the Gig Performer IP address display. The port to which Gig Performer is listening for OSC messages is shown in the Gig Performer listening port field.

3. In the Lemur app, open the Settings menu and choose the More Settings… command.

4. In the OSC Targets area, enter the IP address of the computer running Gig Performer into the Host field, and the port in the Port field.

5. The Lemur IP display shows the IP address of the device running Lemur. The right-most segment, after the colon (“:”) is the port. Enter this into the Remote client IP address field in the OSC Options in Gig Performer.

6. Enter the port portion of the Lemur IP display into the Remote client port field.

7. Turn on the Use augmented Lemur messages toggle button in the OSC Options. This enables Gig Performer to send more detailed OSC messages, which Lemur can handle (turn it off when using Gig Performer with TouchOSC or other more basic OSC applications).

8. For the most reliable communications, launch Lemur first, then launch Gig Performer.

Communication between OSC application Lemur and VST host Gig Performer

The TouchOSC Template

The TouchOSC template, as viewed on an iPhone, looks like this:

TouchOSC template for Gig Performer

Note that the Lemur template has been designed for general use, while the TouchOSC template has been designed specifically for guitarists. Both templates display the currently selected rackspace and variation prominently; the Lemur template also displays the caption of a text label in the “Songnotes” field.

If you would like to experiment with either template, relaunch Gig Performer and then touch the Tuner On/Off button in the template. Gig Performer should immediately open the Tuner (if for some reason the Tuner On/Off button doesn’t work, double-check the communication between the device running your OSC app and the computer running Gig Performer).

In Lemur, if you have a microphone or instrument connected to one or more inputs of your audio interface, the virtual dial to the left of the Tuner On/Off button will move and the note number to the left of that knob will change to reflect the note coming in on the channel(s) Gig Performer is currently “listening” to. In TouchOSC, the box at top center will display the note coming in, and the slider below it will show the tuning offset in cents, with the center position indicating that you are exactly in tune.

Touch the Tuner On/Off button again to return Gig Performer to Panel View. If you are using Lemur,  touch the “Tap” button presented by the template several times. You should see the Tempo display in the upper-right hand corner of Gig Performer’s screen change the BPM value as you do so; the shorter the intervals between taps, the higher (faster) the BPM value.

Note: give your widgets the appropriate OSC names. One of the requirements of OSC is that each object in both the host computer and remote device must have matching unique case-sensitive names. You can make up any names you like, as long as they are comprised of ASCII characters only, with no spaces. If you are running Lemur or TouchOSC, here are the OSC names used in the templates we have created:

Lemur and TouchOSC: OSC names in Gig Performer

To use the templates, simply put Gig Performer into Edit mode, select a widget, and in the Widget Properties Inspector, enable the Enable OSC option, enter one of the OSC names in the “Name” field, then press Enter (this is important):

OSC name knob1 in gig performer

For example, if you are using the Lemur template, add a knob widget and name it “Knob1”; if you are using the TouchOSC template, name the knob widget “knob1”.

Then take Gig Performer out of Edit mode and move the knob widget with your mouse. As you do so, the identically named knob in the Lemur or TouchOSC screen changes the same way. Because OSC is bi-directional (meaning that changes can be made in either the device running the OSC app or the host computer running the target software – in this case, Gig Performer), the opposite occurs too: You can move the onscreen knob in Lemur or TouchOSC and the knob widget in Gig Performer changes the same way.

Do the same with a switch or LED button widget, changing its OSC name to Button1 (for use with the Lemur template) or button1 (for use with the TouchOSC template). Exit Edit mode and test to make sure that touching the corresponding button in your tablet or smartphone turns the associated Gig Performer widget on or off, and vice versa.

To use OSC in rackspaces, make your existing rackspaces OSC-compatible. It’s easy to make any rackspace OSC-compatible: all you have to do is assign OSC names to your widgets that match the names being used in the environments you create in your OSC app editor. For example, load any of the templates while starting Gig Performer, then open the Edit mode, and select each widget in turn. The only change you have to make to each is in the “Name” field in the Properties area of the inspector and checking the Enable OSC box below it; all MIDI device and plugin parameters remain the same. The only difference is that you can now move these widgets remotely from the tablet or smartphone running your OSC app, and vice versa (i.e. any widget adjustments you make from your laptop or from a connected MIDI controller are reflected in the tablet/smartphone screen).

Please note that this only scratches the surface of what can be accomplished when using an OSC app with Gig Performer. Again, the Lemur and TouchOSC templates provided on our website make good jumping-off points towards constructing your own custom OSC environments. Consult the documentation of your OSC app for more information.

Own The Stage® with Gig Performer®!

Related topics:
Gig Performer integrates perfectly with MIDI and OSC enabled apps (community)
Gig Performer is the best companion for all your musical efforts and more (blog)

Scaling Curves

Scaling curves allow you to control the shape of the output of a widget or convert an incoming note velocity to a new velocity. Various predefined curves are available and they can be tweaked as necessary. You can also just draw your own curve as well to achieve the effect you require.


MIDI File Player Plugin

You can load up to 128 MIDI song files in a single plugin instance. Switch from one song to another, mute tracks and/or change their channel numbers. Tempo can be controlled by individual songs or you can use the global tempo and tap tempo to control the BPM interactively.


Favorites and Presets

Create a sound by placing and interconnecting your desired plugins, such as a synth, some effects and perhaps a mixer. Select them all and then save the selection as a named favorite. The favorite will subsequently show up in all plugin insert menus, making it easy for you to recreate that configuration whenever you need it again. This feature is also very powerful for creating your needed sounds on your studio computer and then transferring them to your touring laptop.


Probabilistic Sound Designer

Parameters you select in an open plugin are captured into the Probabilistic Sound Designer dialog window. When you click Randomize, you're only adjusting those selected parameters. Each entry in the PSD dialog has a curve but unlike widgets where the curve controls scaling, in the PSD the curves are used to define the probability of particular values being selected. Make sure the filter cutoff never gets too slow so as to block all sound. Perhaps adjust the max range of the VCA attack parameter so that the sound doesn't have too much delay. Constrain the octave ranges of the oscillators, perhaps ensuring that 1/3rd of the time we select 8' and 2/3rds of the time we select 4'. The possibilities are endless.


More Widgets

Numerous new widgets are included in Gig Performer - a new sustain pedal, plastic knobs, drum pads and more colored sliders. Shapes can be colored with different borders and fill colors and morphed from rectangular to circular. Your creativity is now the limit to creating fabulous front panels in Gig Performer.


MIDI Message Helper

Select MIDI devices by name. Choose the MIDI message type and adjust the appropriate parameters for the specific type



Layout management

Gig Performer supports arbitrary resizing. Layout your widgets the way you want - resize the main window and the widgets will grow or shrink as necessary to maintain the same interrelationships. No matter what size screen you have, your front panels will still be neat and usable.


Undo Support

If you move your widgets around and/or resize them, or even delete them by mistake, the Undo facility will correct your mistake. Minor moves to a widget by mistake will no longer spoil your design


Plugin Channel Count

Some plugins support a large number of outputs and they depend on the traditional channel strip to control how many ports should be available.   When you only need a stereo pair, it is convenient not to have a large horizontal block. In Gig Performer, the number of available ports  is controlled by the channel count override, which can be applied to individual plugins and will be remembered when the gigfile is reloaded or if the plugin is saved as a favorite.


Input muting and output fading

Rather than a single audio length tail, Gig Performer 4 gives you the ability to control input muting and output fading separately. Input muting controls how much time it takes for audio input to be silenced when you leave the rackspace. Output fading controls how much time will be taken for audio to fade out when you leave the rackspace.


Faster Plugin Finder

Instead of searching through menus of perhaps hundreds of plugins (you know who you are!), the Quick Plugin Finder makes it easy to find the plugin you need by simply typing partial strings. For example, as shown here, to find the Modartt Pianoteq 7 plugins, it's enough to type pia mod 7 (in any order, by the way)  to restrict the list of available plugins to those matching your query. The Quick Plugin Finder also knows about manufacturers, presets and favorites.



Touch Friendly Input

Any entry field can be changed by either dragging your mouse (or finger) up or down, or by using the large popup touchpad where you can just tap on the squares to enter a value. The large popup keypad also does validation so you can't enter an invalid value. You can also just tap the BPM field to pop up a larger view where you can quickly change tempo, tranpose, trigger Tap Tempo and enable Ableton Link, the last allowing you to synchronize Gig Performer with any other application that also supports Ableton Link.


New Tuner Display

The tuner view makes it easy for guitarists to quickly check and adjust their tuning. You can toggle into the tuner view from any other view and toggle right back as soon as you're done. All output will be silenced automatically while you're in tuning mode. You can adjust the concert reference pitch from its default of 440 Hz to suit your own needs. The tuner view fills the entire screen so you can easily see it from a distance.