diff --git a/docs/OSC-REMOTE-CONTROL.md b/docs/OSC-REMOTE-CONTROL.md index a0f3432e..582aed0f 100644 --- a/docs/OSC-REMOTE-CONTROL.md +++ b/docs/OSC-REMOTE-CONTROL.md @@ -3,27 +3,33 @@ OSC (Open Sound Control) is a protocol commonly used for remote control over the network. Starting with version 23.09, Cardinal allows remote control of the entire patch/project and individual parameters through OSC. +Please note **OSC Remote Control is not available when using Cardinal as a plugin**, only in standalone. + ## Activating remote control Make sure you are using version 23.08 or later of Cardinal, start up the standalone (both Native and JACK variants will work) and under "Engine" menu click on "Enable OSC remote control". -NOTE: This option is not available when using Cardinal as a plugin, only in standalone. - ![screenshot](Docs_Remote-Control-1.png "Screenshot") This will ask you for which network port to use, Cardinal will default to 2228. Valid range is typically between 1025 and 32767. If unsure just stick the default value. -Depending on the OS security features you might be asked to allow network usage at this point. - ![screenshot](Docs_Remote-Control-2.png "Screenshot") +Depending on the OS security features you might be asked to allow network usage at this point. If all went well opening the "Engine" menu again should show a checkmark, indicating that OSC remote control is enabled. For the moment there is no error dialog or information in case things go wrong. If you are unable to connect, make sure your OS network firewall settings allows opening port 2228. +## TouchOSC example setup + +A TouchOSC compatible file is available [here](https://github.com/DISTRHO/Cardinal/raw/main/patches/touchosc/24-direct-fader-params.tosc). + +It maps Cardinal's 24 parameters into 3 pages of sliders, 8 per page, each with a different color. +Inside Cardinal the Host Parameters and Host Parameters Map modules can be used as a way to control module knobs and other controls with it. + ## Available messages The following OSC messages are available: @@ -54,4 +60,4 @@ NOTE: the first argument must of be int64 type, as regular 32-bit integer is not Sending a `/load` message will load the patch file contained in the message. Patch contents must be in compressed format, not plain-text json. -Cardinal reply back indicating either success or failure, using `/resp` path and "load" message. +Cardinal replies back indicating either success or failure, using `/resp` path and "load" message.