Template:TOC

GNU Psychosynth can be controlled from third party software using the Open Sound Control protocol. It provides to different ways of interacting via OSC, either using a passive stateless interface, or using a stateful protocol that enables multi-peer coordinated sessions. Both 3D user interface and the command line version allow OSC controlling. The later, indeed, is intended to work via OSC mostly. More information on how to enable OSC can be found in the user manual.

The passive interface

The passive interface it is the easier to use, because it relies on no shared state between the controller and Psychosynth. The following messages are available.

/ps/add client-id

i obj-id:i object-kind:s

Adds a new object of kind *object-kind* that can be later referenced by the identifier tuple *(client-id obj-id)*.