libmapper bindings for MaxMSP and Pure Data
Max and Pure Data (Pd) objects instantiating libmapper devices. Help patches are included for documentation.
The mapper
object can be used with both Max and Pd - it encapsulates the functionality of a libmapper device and works as a central hub in your patch by sending and receiving labeled messages from the libmapper network.
For MaxMSP there are now another set of bindings which attempt to provide a more Max-like interface to the libmapper ecosystem. The mpr.device
object creates a libmapper device as before, but it communicates with an arbitrary number of mpr.in
and mpr.out
objects in your patch (and subpatchers) which can be used essentially as networked replacements
for the internal inlet
and outlet
objects. Please load the help patches for more documentation and examples of use.
Hopefully in the near future the new bindings will also be adapted for Pure Data - for now Pd users are stuck with the (fully-functional) mapper
object.
This software is licensed under the GNU Lesser Public General License version 2.1 or later; see the attached file COPYING for details, which should be included in this download.
To build, you will first need to install libmapper and liblo from their respective repositories. An installation of liblo < v0.30 is not sufficient, as libmapper depends on new functionality in the library.
On OSX you can build all the binaries by running the script package-osx.sh
from the command-line.
Acknowledgements
Development of this software was supported by the Input Devices and Music Interaction Laboratory at McGill University and the Graphics and Experiential Media (GEM) Lab at Dalhousie University.