lopack

an oscpack-inspired C++ wrapper for the liblo OSC library

Description

This is an oscpack-style wrapper for the liblo Open Sound Control (OSC) library. You should be able to use this as a drop in replacement in most cases.

Features include:

OscReceiver server class
OscSender class w/ C++ stream based interface for building & sending messages
OscObject class for subclasses based message handling, nestable within address spaces
ReceivedMessage class with smart message parsing and argument introspection
support for all argument types used by liblo (and as defined by the official OSC spec)
support for sending & receiving multicast messages

Documentation

See the headers in src/lopack and the example in src/lptest for more info.

Building & Installing

Download a release tarball from http://docs.danomatika.com/releases/lopack/.

Otherwise, if cloning this repo, you will also need to run autogen.sh to create the configure script:

git clone https://github.com/danomatika/lopack.git
cd lopack
./autogen.sh

You will need liblo installed before building.

On macOS, you can use Homebrew with:

brew install liblo

On Ubuntu/Debian, you would do the following:

sudo apt-get install liblo-dev

On Windows, it is recommended to use Msys2. Install the build tool chain (make, gcc or clang, pkgconfig, autconf, automake, libtool). Msys2 does not have a package for liblo, so you need to download the source from https://github.com/radarsat1/liblo/releases then build & install it manually:

cd liblo-0.30
./configure --disable-debug --disable-dependency-tracking --disable-tests --disable-network-tests --disable-tools --disable-examples
make
make install

This is an automake project, so build the lib & test with:

./configure
make

Run the test program with:

cd src/lptest
./lptest

src/lptest/lptest

Install via:

sudo make install

Developing

A Premake4 script and IDE files can be found in the prj folder. Premake4 can generate IDE files from a given lua script. Download Premake4 from http://industriousone.com/premake.

You can enable a debug build using:

./configure --enable-debug

I develop using an IDE, then update the autotools files when the sources are finished. I run make distcheck to make sure the distributable package can be built successfully.