miniosc

Single-file-header OSC library for C (includes platform-independent sockets).

It only supports a subset of the OSC protocol. #bundle, the basic types: i, f, s, and b and extended types I, F, N, and T, and t, c and r. Where c and r are aliased to i.

Tested 2022-02-24 working with TouchOSC input and output (well except for the extended functionality). While basic bounds checking is happening it is likely that there are flaws with this. This library has not yet been fuzzed.

Tested working on Linux and Windows 2022-02-24

Tested working with VRChat 2022-02-25

It may be licensed under the MIT/x11, NewBSD, CC0 or Public Domain where applicable.

Example

#include <stdio.h>

#define MINIOSC_IMPLEMENTATION
#include "miniosc.h"

void rxcb( const char * address, const char * type, void ** parameters )
{
	// Called when a message is received.  Check "type" to get parameters 
	// This message just blindly assumes it's getting a float.
	printf( "RXCB: %s %s [%p %p] %f\n", address, type, type, parameters[0],
		(double)*((float*)parameters[0]) );
}

int main()
{
	// 9003 is the input port, 9005 is the output port.
	// Each is optional.
	miniosc * osc = minioscInit( 9003, 9005, "127.0.0.1", 0 );

	int frameno = 0;
	while( 1 )
	{
		// Poll, waiting for up to 10 ms for a message.
		int r = minioscPoll( osc, 10, rxcb );

		char strtosend[128];
		sprintf( strtosend, "Frameno: %d", frameno );
		
		// Immediately send a message
		minioscSend( osc, "/label1", ",s", strtosend );

		// Bundle messages together and send.
		mobundle bun = { 0 };
		minioscBundle( &bun, "/text1", ",s", strtosend );
		minioscBundle( &bun, "/label2", ",i", frameno&1 );
		minioscBundle( &bun, "/box2", ",i", (frameno&255) );
		minioscSendBundle( osc, &bun );

		frameno++;
	}
}

Future

Make it possible to #define non-BSD sockets, to support systems like the ESP32 and ESP8266.
Do more testing.

hyblocker/miniosc

miniosc

Example

Future