Open Sound Control

This example shows an implementation of OSC (Open Sound Control) which was developed at UC Berkeley Center for New Music and Audio Technology (CNMAT).

It is designed to be run alongside resources/osc/osc.js

The OSC server port on which to receive is set in setup() via oscServer.setup(). Likewise the OSC client port on which to send is set in oscClient.setup().

In setup() an OSC message to address /osc-setup, it then waits 1 second for a reply on /osc-setup-reply.

in render() the code receives OSC messages, parses them, and sends back an acknowledgment.

____ _____ _ _
| __ )| ____| | / \
| _ \| _| | | / _ \
| |_) | |___| |___ / ___ \
|____/|_____|_____/_/ \_\
The platform for ultra-low latency audio and sensor processing
A project of the Augmented Instruments Laboratory within the
Centre for Digital Music at Queen Mary University of London.
(c) 2016 Augmented Instruments Laboratory: Andrew McPherson,
Astrid Bin, Liam Donovan, Christian Heinrichs, Robert Jack,
Giulio Moro, Laurel Pardue, Victor Zappi. All rights reserved.
The Bela software is distributed under the GNU Lesser General Public License
(LGPL 3.0), available here: https://www.gnu.org/licenses/lgpl-3.0.txt
#include <Bela.h>
#include <OSCServer.h>
#include <OSCClient.h>
OSCServer oscServer;
OSCClient oscClient;
// this example is designed to be run alongside resources/osc/osc.js
// parse messages received by OSC Server
// msg is Message class of oscpkt: http://gruntthepeon.free.fr/oscpkt/
void parseMessage(oscpkt::Message msg){
rt_printf("received message to: %s\n", msg.addressPattern().c_str());
int intArg;
float floatArg;
if (msg.match("/osc-test").popInt32(intArg).popFloat(floatArg).isOkNoMoreArgs()){
rt_printf("received int %i and float %f\n", intArg, floatArg);
bool setup(BelaContext *context, void *userData)
// setup the OSC server to receive on port 7562
// setup the OSC client to send on port 7563
// the following code sends an OSC message to address /osc-setup
// then waits 1 second for a reply on /osc-setup-reply
bool handshakeReceived = false;
while (oscServer.messageWaiting()){
if (oscServer.popMessage().match("/osc-setup-reply")){
handshakeReceived = true;
if (handshakeReceived){
rt_printf("handshake received!\n");
} else {
return true;
void render(BelaContext *context, void *userData)
// receive OSC messages, parse them, and send back an acknowledgment
while (oscServer.messageWaiting()){
oscClient.queueMessage(oscClient.newMessage.to("/osc-acknowledge").add(5).add(4.2f).add(std::string("OSC message received")).end());
void cleanup(BelaContext *context, void *userData)