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.
In the OSC tab, you can setup the interface used for OSC communication.
The Input for OSC messages has to be enabled in order to receive messages from the Kratos station.
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.
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.
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.
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.
Enable Send rights to allow the GrandMA3 station to send OSC messages to the Kratos station and don't forget to Enable Output.
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.