dssi_osc_update(1)

✨ dssi_osc_update ✨

okay bestie, so this is the manual page for dssi_osc_update, from the General Commands Manual section — yes, section 1, the "just a lil command you run in your shell" section. 🫶

🌸 NAME 🌸

dssi_osc_update — literally just sends a DSSI update OSC request. that's the whole job. that's the assignment. 💅

🦋 SYNOPSIS 🦋

dssi_osc_update <OSC URL>

💖 DESCRIPTION 💖

so here's the vibe: dssi_osc_update sends a DSSI update OSC request to a DSSI host, and then it just… waits. 🕐 like a bestie waiting for a text back.

it waits for OSC responses from the host, writes any responses it receives to stdout, and then — and this is the important part — it exits when it has not received anything for five seconds. so it's not gonna sit there forever, it has a life, it has places to be. 👑

and here's why that's iconic: DSSI hosts should respond to an update request by sending the complete state of the plugin. so this program is basically your little state-retrieval-and-display machine — you use it to retrieve and display that state. no cap. ✨

🎀 OPTIONS 🎀

• <OSC URL> — the URL specifying the host and plugin, to which the request is sent. 🦋 this is typically obtained from the host, perhaps from startup messages or the host's About dialog. iykyk. for example:

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

💜 SEE ALSO 💜

• dssi_osc_send(1).

🌈 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). slay, Mark. 🫶

and that's the whole page, bestie!! 💖 this was dssi_osc_update(1), brought to you by January 5th, 2009 — yes, the manual page is a lil vintage, it's giving retro, we love her for it. 🎀 mwah, go send some OSC. 💅🌸