dssi_osc_send(1)

💖 dssi_osc_send(1) 💖

okay bestie, welcome to the dssi_osc_send page — it lives in the General Commands Manual section of your friendly neighbourhood manual, and it's genuinely one of the most useful little gremlins in the DSSI toolbox. Let's get into it. ✨

🌸 NAME 🌸

dssi_osc_send — send OSC messages to DSSI applications. that's it, that's the whole job, and she does it flawlessly. 💅

🦋 SYNOPSIS 🦋

dssi_osc_send <option> <OSC URL> <values>

💜 DESCRIPTION 💜

So dssi_osc_send sends DSSI OSC methods to DSSI applications. no cap.

Typically you'd use it to control DSSI hosts — possibly for scripted operation, because automation is the moment — or to test DSSI user interfaces. lowkey both, highkey both. 🫶

✨ OPTIONS ✨

• -c — send a control message. you gotta supply two values in the <values> section: the control port, and the value. for example, to set control port 1 to 0.1:

dssi_osc_send -c <OSC URL> 1 0.1

• -p — send a program message. two values in <values>, bestie: bank and program number. for example, to select bank 0 program number 7:

dssi_osc_send -p <OSC URL> 0 7

• -m — send a midi message. this one wants four numbers in the <values> section. for example, to send a note on, middle C, velocity 64:

dssi_osc_send -m <OSC URL> 0 144 60 64

• -C — send a configure message. the <values> here are the key and value pair. for example, to send key load and value /tmp/patches.pat:

dssi_osc_send -C <OSC URL> load /tmp/patches.pat

• -s — send a show message.

dssi_osc_send -s <OSC URL>

• -h — send a hide message. yes it's hide and not help, we know, we've all been there 🙈

dssi_osc_send -h <OSC URL>

• -q — send a quit message.

dssi_osc_send -q <OSC URL>

• -e — send a exiting message.

dssi_osc_send -e <OSC URL>

• <OSC URL> — the URL to connect to. she's the main character of every single invocation. for example:

osc.udp://localhost:19383/dssi/test.1
osc.udp://my.host.org:10886/dssi/xsynth-dssi/Xsynth/chan00

👑 SEE ALSO 👑

dssi_osc_update(1). go read her too, she's iconic in her own right. 💖

🎀 AUTHOR 🎀

This manual page was originally created by Mark Hymers from the help text of the application, for the Debian project (but may be freely used by others). so generous, we're obsessed. 🫶

and that's the vibe check, bestie — this page was last touched on January 5th, 2009, so if you're reading it, congrats, you're part of the legacy. stay slaying, go send some OSC. 💅✨🌈