From 568db6c02b7cc2e1aa128cfb0c70f753a8cf85c4 Mon Sep 17 00:00:00 2001 From: Michael Date: Mon, 1 Dec 2025 15:15:55 +0800 Subject: [PATCH] Add command line example for startup Can potentially help address #796 --- docs/OSC-REMOTE-CONTROL.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/OSC-REMOTE-CONTROL.md b/docs/OSC-REMOTE-CONTROL.md index 6867317..ccab070 100644 --- a/docs/OSC-REMOTE-CONTROL.md +++ b/docs/OSC-REMOTE-CONTROL.md @@ -23,6 +23,14 @@ If all went well opening the "Engine" menu again should show a checkmark, indica 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. +### Automatic startup using command line + +To start the OSC server automatically when Cardinal starts up, you can do a headless build and pass the environment variable +```sh +cardinal CARDINAL_REMOTE_HOST_PORT=2228 +``` +This can be useful, for example: starting Cardinal for an art exhibit where no mouse/keyboard are attached but you want remote control. + ## TouchOSC example setup A TouchOSC compatible file is available [here](https://github.com/DISTRHO/Cardinal/raw/main/patches/touchosc/24-direct-fader-params.tosc).