/mapper-max-pd

MaxMSP and Puredata objects for libmapper devices

Primary LanguageMaxGNU Lesser General Public License v2.1LGPL-2.1

libmapper bindings for Max and Pure Data

Max and Pure Data (Pd) objects instantiating libmapper devices and signals. 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 Max there is also 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.

Building

To build on OSX, 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.

MacOS

You can then build all the binaries by running the script package-osx.sh from the command-line:

./macos-build.sh

Once the script has run the externals will be found in /dist/Max and dist/pd.

Windows

For Windows machines, run the ./windows_build.ps1 script in this repository's root from powershell. The script will download and install the libmapper and liblo dependencies and build the externals. To use the Max externals on Windows, you'll need to copy the libmapper, liblo and zlib dll's into C:\Program Files\Cycling '74\Max 8 or equivalent on your machine.

Linux

Since Max is not available for Linux only the Pd bindings can be built. A makefile is included in the mapper directory:

cd mapper
make

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.