DIMPLE: Dynamically Interactive Musically PhysicaL Environment



John Sullivan


This project is an implementation of a physical dynamics environment which can be controlled via OSC, so that audio projects such as PureData can create physical objects in a virtual space, and then let them interact with each other, colliding and otherwise moving around. Data about objects’ position and acceleration, for example, can be retrieved and then used to affect some sort of audio synthesis. It is a part of the force feedback for audio systems IDMIL project and was first presented at NIME 2007.

The environment can also be used for interacting with a hand controller haptic device.

This is all accomplished via many GPL (or similar) libraries, such as:

  • CHAI 3D, for haptics
  • ODE, for physical dynamics
  • LibLo, for OSC messaging
  • GLUT & FreeGLUT, for graphics (optional)

It is cross-platform, running on Linux, OS X, and Windows. Unfortunately, most haptic devices only provide drivers for Windows, though CHAI 3D does support the SensAble Phantom family of devices under Linux if you have the driver.

A beta version of this software is available here:

The Ubuntu release is my first .deb, so please inform me if you have any trouble installing or executing it. (Currently it provides no menu icon, so you’ll need to start a terminal and type `dimple` to run it.) Users of other Linux distros or 64-bit architectures may compile the software from source. Please run “bootstrap.sh” before proceeding with “configure” and “make”.

Snapshots of older versions are also available.

Documentation of DIMPLE’s messages is available.



To run the included test patch, test.pd, you’ll need PureData. You need at least 0.40.1, with the extended build since it requires sendOSC and dumpOSC, and a few other objects. Remember to run dimple.exe before clicking the “Initialize” bang.


Mailing list

A mailing list for discussing both using and developing DIMPLE can be subscribed to here:



If you’d like to track the development version, or even contribute patches, please feel free to clone the git tree with the following command:

git clone https://github.com/IDMIL/dimple.git

Please run the bootstrap.sh script before compiling, which takes care of downloading and compiling dependencies on the respective platform. The build platform for Windows is MingW/MSYS with msysGit.

To contribute patches, please either provide an accessible repository to pull from, use github pull requests, or generate them using git format-patch and send to the mailing list as an attachment.

IDMIL Participants:

Research Areas: