OSC Remote Control and Automation

How to integrate KLANG into your ideal workflow

Whether you are touring with your favourite mixing console and want to use faders and knobs to remote control the 3D in-ear mixing on a KLANG device, or if you are in the studio working with your favourite DAW – you have your individual workflow that works best for you.

With the help of some third-party tools, MIDI to OSC conversion, OSC to OSC conversion and automation with OSC control of your KLANG processor is possible. In the following, we will go through the setup steps.

If you want to learn more about Open Sound Control (OSC) and the KLANG messages, please take a look at this guide:

KLANG OSC Reference Guide

ToscA is a tool from IRCAM and available for free. It works as a VST, AU, RTAS plugin and can therefore be used with DAWs like Apple Logic, ProTools or Reaper. It enables the automation feature of the DAW to be used with external gear and apps. It transforms the internal automation data to basic OSC messages and lets you specify the OSC listening port and target port and IP address. It allows up to 32 parameters to be exchanged via OSC for alle audio channels.

Step 1 | Download and install ToscA

You can download ToscA here and find detailed documentation on the tool there as well.

Step 2 | Open your favourite DAW

Add ToscA to each channel you need automation for. It will send OSC data in the following format:

/<channel number>/param<parameter number>

Here, ToscA has been added to several channels in an Apple Logic project. Make sure that the index in ToscA matches the channel number:

Step 3 | Configure ToscA Plugin

You only need to configure ToscA once. Go to any channel that you have added ToscA to and open the plugin windows.

Note for using ToscA with ProTools: Make sure to open the plugins in each channel one by one and not via “alt-plugin” to assure correct assignment of channels and avoid possible instability of ToscA.

If required, create and load a configuration XML for parameter name mapping. Basic linear scaling of values can be achieved via XML preset as well. As an example, a preset that maps and labels gain, azimuth and elevation angles can be downloaded here.

For OSC automation – especially in combination with OSCulator –, we use localhost 127.0.0.1 as IP and send OSC messages to the same computer. We use the standard UDP ports 4001 and 4002.

Step 4 | Create Automation Tracks

As an example, automation tracks for gain, azim (azimuth), elev (elevation) are created in Logic and shown in the following screenshot. The DAW can now send automation data via OSC:

OSCulator is a commercial application for Mac OS X. It is a converter tool for MIDI and OSC and allows complex routings to and from MIDI and OSC. Hence, it is the perfect companion to translate OSC messages from various gear to connect the devices to a larger and more powerful combined setup.

After starting OSCulator and loading this template file that routes incoming OSC commands from ToscA to a KLANG processor, you have to specify the receive port; in this example OSC input port: 4002.

Click on Parameters and go to OSC Routing tab. In the example, we have specified the IP address of a KLANG processor with the following syntax: osc.udp://192.168.1.180:9110 (adapt to your KLANG processor IP address) and set it as default destination (indicated by that special D with a hyphen):

In the template file, azim, elev, and gain are mapped for the first 16 channels to phi, theta and gain for the KLANG processor. The following screenshot shows how it should look like. When commands are received, yellow and green squares appear in front of the lines:

Now you are ready to send automation commands from your DAW via OSCulator turned into commands for a KLANG processor.

---