Manuals

DiGiCo Macro OSC

Introduction

This guide explains how to use the Macro OSC feature on DiGiCo consoles to remotely control KLANG:app, KLANG processors or KLANG:kontroller. By sending Open Sound Control (OSC) messages directly from DiGiCo’s macro system, users can switch KLANG:app views or control connected KLANG:kontroller devices.

The setup requires DiGiCo software version v2021 or newer, along with KLANG:app/KOS version 5.7 or later, to ensure full compatibility with Macro OSC communication.

DiGiCo Macro OSC Configuration

On the DiGiCo console:

Go to Setup > External Control
Ensure that Enable External Control is set to YES
and Suppress OSC retransmit is enabled.

If you are running the KLANG DiGiCo console integration, these settings are already in place.

Click on add device
Choose Macro OSC
Enter IP address of the device you want to send OSC messages to, e.g. KLANG:app (shown in KLANG:app > CONFIG > CONNECT > lower right corner) or KLANG processor.
Choose Send Port 9111
Remember the DevID

In this guide we use the following devices with their IP addresses and the subnet mask on all devices is 10.11.255.255 = /16. The DiGiCo Console has IP address 10.11.12.62.

Device	IP Address	DevID in this Example	Description
KLANG processor (DMI-KLANG) with stand-alone integration	`10.11.12.120`	`1`	This IP is also required for the stand-alone console integration. The processor can forward messages to its connected KLANG:apps and KLANG:kontrollers, e.g. show a message on connected devices that the show begins now. Or dim all kontroller displays.
Main Computer running KLANG:app in Admin mode	`10.11.12.90`	`2`	This is the IP of the main computer running KLANG:app. If not running stand-alone integration this is IP is used for the console integration. With macroOSC you can e.g. change to FADERS, METER or STAGE view.
KLANG:kontroller	`10.11.12.99`	`3`	Just an example: A particular :kontroller that you want to e.g. show a message on or dim its LEDs.

Remote Control KLANG:app

Define Macro to send OSC messages via DiGiCo > Setup > Macros. Make sure to use the DevID corresponding to your Main Computer running KLANG:app in Admin mode from External Control in the following window in den column Device. In our example it is DevID 2 with IP address 10.11.12.90

Switch KLANG:app Screens

Select Address Only OSC
OSC Address: /Ka/screen/FADERS1

Click on “fire macro” to test and KLANG:app will change to the FADERS view.

Similar Commands

Switch to Fader-View /Ka/screen/FADERS1
Switch to Group-View /Ka/screen/FADERS2
Switch to Stage-View (Orbit) /Ka/screen/STAGE1
Switch to Stage-View (Landscape) /Ka/screen/STAGE2
Switch to Meters-View /Ka/screen/METERS
Switch to Config-View (Last page that was selected) /Ka/screen/CONFIG
Open Channel Focus for a specific channel /Ka/screen/CHANNELFOCUS i <hwChNumber>
Open Channel Details for a specific channel /Ka/screen/CHANNELDETAILS i <ChannelNumber>
Fire next KLANG Snapshot (e.g. if running in Lite Integration mode)

Switch KLANG:app to a Different Mix

Select Integer OSC
OSC Address: /Ka/screen/user
Data (mix number): 2

Dim/Darken :kontroller Displays

There are different ways to send this message to :kontrollers. The straight-forward approach is to send the OSC message to each :kontroller separately. However, it is much more convenient to send a message to the KLANG processor and let it handle the forwarding to all connected kontrollers.

In the example we use the first and second method.

Configure a MacroOSC as shown above.
Choose Integer OSC.
Enter OSC Address /Ka/ToOthers/Ka/Kc/Display/Dark.
Choose Data: 1

If you want to send it to all devices on the network, use OSC address /Ka/ToBroadcast/Ka/Kc/Display/Dark

And to deactivate the Dark Mode again, duplicate the macro and change Data to 0

Fire the macros and see that all :kontroller on the network will go Dark and also light up again.

Alternatively, use …/Display/Dim to only dim the :kontroller LEDs and buttons instead.

Here is the message to send to a single the kontroller directly and also two similar options but instead of sending it to the KLANG processor, we can send it to a KLANG:app and let if forward.

to specific kontroller IP addresses directly, e.g. devID 3 and IP address 10.11.12.99 with /Ka/Kc/Display/Dark i 1 Integer OSC and Data 1
via KLANG:app to the connected processor and from there to all connected :kontrollers (e.g. devID 2 with /Ka/ToOthers/Ka/Kc/Display/Dark i 1 Integer OSC and Data 1)
via KLANG:app as a broadcast to ALL devices on the network (e.g. devID 2 with /Ka/ToBroadcast/Ka/Kc/Display/Dark i 1 Integer OSC and Data 1)

See this page for more OSC commands:

OSC Reference Documentation

DiGiCo Macro OSC

Introduction

DiGiCo Macro OSC Configuration