Skip to content

Connect GrandMA3 and Kratos via OSC

Your Kratos station and the GrandMA3 console or onPC can communicate via OSC (Open Sound Control) protocol. This allows you to control GrandMA3’s parameters such as Executors and Faders via Kratos using Actions. You can use the multiple actions available in Kratos to interact with your GMA3 system, or create your own custom actions to fit your needs and behaviors wanted.

Hardware connection

The Kratos station and the GrandMA3 station must be connected to the same ethernet network. - The Kratos station needs to have an ethernet address in the same subnet as the GrandMA3 station.

Control GrandMA3 using Kratos

To allow the Kratos station to communicate with the GrandMA3 station, you need to enable the OSC protocol in the GrandMA3 settings.

You can do this by going to the GrandMA3 settings, then to the In & Out page, and finally to the OSC tab.

img img

In the OSC tab, you can setup the interface used for OSC communication.

img

The Input for OSC messages has to be enabled in order to receive messages from the Kratos station.

img

Then, in the table below, you can set the port used for OSC communication. By default, the port is 8000. You can also set a prefix for the OSC messages received by the GrandMA3 station.

img img

Note

The OSC prefix is used to filter the messages received by the GrandMA3 station. For example, if you set the prefix to kratos, the GrandMA3 station will only receive messages starting with /kratos. (ie /kratos/page1/executor1 will be received, but /page1/executor1 will not)

You can also set the rights for the OSC messages received by the GrandMA3 station by enabling Receive rights, as well as Receive Commands rights.

img

Warning

Some actions in Kratos require the Receive Commands rights to be enabled in order to work properly. If you encounter issues with some actions, make sure that the Receive Commands rights are enabled.

Check the connection

You can add a "System monitor" view on one of your GrandMA3 screens to check the OSC messages received by the GrandMA3 station. Make sure you enable Echo Input in the OSC row of the console to see the messages received.

Then you can use the "OSC - Send Message" action in Kratos to send a message to the GrandMA3 station and check if it is received by the GrandMA3 station. See the Actions page for more information on how to use actions in Kratos.

img img

Control Kratos using GrandMA3

You can also control Kratos using the GrandMA3 station by sending OSC messages to the Kratos station.

Setup Kratos

Make sure you have a KratOSC module active in your Kratos show. Check the KratOSC and Modules pages for more information on how to activate KratOSC in Kratos.

Setup GrandMA3

Create a new OSCData object in the OSC menu of the GrandMA3 station. Configure the IP adress and the port of the Kratos station in the OSCData object.

img

Enable Send rights to allow the GrandMA3 station to send OSC messages to the Kratos station and don't forget to Enable Output.

img img

Send Messages

You can now send OSC messages to Kratos using the GrandMA3 station. Messages can be sent using Macros or Commands in the GrandMA3 station.

Syntax for sending messages is : 

SendOSC [ID] "[URI],[Type],[Value]"
  • [ID] is the ID of the OSCData object in the GrandMA3 station.
  • [URI] is the OSC message to send to the Kratos station.
  • [Type] is the type of the message (i : int, f : float, s : string).
  • [Value] is the value of the message.

More information for SendOSC is available in GrandMA3's documentation

You can enable "Echo Output" in the OSC row of the GrandMA3 station to see the messages sent by the GrandMA3 station. You can also enable "Log Incoming" in the KratOSC module to see the messages received by the Kratos station.

alt text alt text