Skip to content

Commit

Permalink
Tweak OSC documentation
Browse files Browse the repository at this point in the history
Signed-off-by: falkTX <[email protected]>
  • Loading branch information
falkTX committed Sep 16, 2023
1 parent 2ae3cf4 commit bfb0e4a
Showing 1 changed file with 11 additions and 5 deletions.
16 changes: 11 additions & 5 deletions docs/OSC-REMOTE-CONTROL.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down Expand Up @@ -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.

0 comments on commit bfb0e4a

Please sign in to comment.