an openFrameworks addon for interfacing with ICubeX digitizers
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Addon to interface with ICubeX digitizers. Currently tested with the USB-microDig, WI-microdig and the MIDI Digitizer (first 8 ports). Supports both sensor input and actuator output.

On portable platforms, the supported features are limited, as shown in the following table:


OS USB-microDig Wi-microDig MIDI Digitizer
Windows Yes Yes Yes*
OSX Yes Yes Yes*
Linux Yes Yes Yes*
iOS Limited No Yes*
Android Limited Yes Yes*

*Requires class compliant USB MIDI adapter

Limited: can only be used in stand alone mode to receive MIDI messages from the digitizer, and requires an existing stand alone configuration on Desktop system using the ICubeX Editor. In this case, the oF app cannot change the settings/operation mode of the digitizer, but once set up (via the desktop Editor), the digitizer can be used as a standard MIDI out device, and messages can be parsed using the inputExample from ofxMidi (TBD: tutorial for this).

Other (non-default) Addons required:

Setup Requirements:


  • USB-microDig: follow setup instructions here until BlueMIDI is set up. (No need to proceed further):
  • Wi-microDig: follow setup instructions here: (...)



  • USB-microDig:
    • Tested with Ubuntu 10.04LTS, and Raspbian (For Raspberry Pi)
    • UBB Driver built into most modern releases
  • Wi-microDig: to be tested/documented.


  • No special setup is required, other than making sure the required addons are in the path.
  • We have tested with the iRig Midi 2 as well as iConnect MIDI adapters; Any generic, class-compliant USB-MIDI cable should work fine.


The Android version is experimental, and requires the following additional components:

  • AndroidMidi library
  • Our slightly modified version of ofxMidi, and ofxAndroid addons. (link link) Make sure you are familiar with the Android/oF toolchain and comfortable compiling generic oF applications for Android before attempting to do this!

Other Notes:

  • If you create a blank project with the oF project generator, make sure to manually add the CoreMIDI framework (Build Phases->Link Binary With Libraries) for MAC/iOS, or winmm.lib in Windows.

There are three example applications. Once the driver is loaded and Connect is running, the following apps should work out of the box:

    • exampleICubeX: a more featured GUI application that visually shows sensor data, and allows control of a number of parameters of the digitizer
    • exampleSimpleICubeX: a bare bones app showing the basic commands for talking to the digitizer. if you want to hook up to sensors directly, this is a good place to start as the relevant features are not interlarded with GUI setup code. The setup() function in ofApp.cpp contains comments walking through the process of connecting to, setting up and getting data from the ICubeX digitizers.

Created by Johnty Wang ( Oct 2014

Latest revision 13 Jan 2015