MapperUGen

A SuperCollider UGen for using libmapper

Installation

• Install SuperCollider
• Build and install libmapper
• Unzip MapperUGen.zip from releases into SuperCollider extensions folder (Platform.userExtensionDir)

Compile from source

• Build and install libmapper

• Note: when cloning supercollider below, if the cloning hangs just execute git config --global url."https://".insteadOf git:// to fix the issue. It's a known issue with older versions of the supercollider sdk.

GNU/Linux

git clone https://github.com/libmapper/MapperUGen.git
cd MapperUGen
mkdir build && cd build
cmake -DSUPERNOVA=ON ..
cmake --build . --target install

macOS

git clone --recursive https://github.com/libmapper/MapperUGen.git
cd MapperUGen
mkdir build && cd build
cmake -DSUPERNOVA=ON ..
cmake --build . --target install

Windows

git clone https://github.com/libmapper/MapperUGen.git
cd MapperUGen
git config --global url."https://".insteadOf git://
git submodule update --init --recursive

Now edit the CMakeLists.txt LIBMAPPER_DIR and LIBLO_DIR paths to match with your local libmapper paths. For libmapper installation help, consult the instructions here. Finally:

mkdir build
cd build
cmake -DSUPERNOVA=ON ..
cmake --build .

Windows manual installation after compiling

1. Evaluate Platform.userExtensionDir in supercollider and create a "Mapper" folder there
2. Copy everything inside the ./sc folder to the Mapper folder
3. Create a "plugins" folder in the Mapper directory
4. Copy the build outputs from ./build/Debug and your libmapper, liblo and zlib .dlls to the plugins folder
5. Reboot the supercollider interpreter