/MapperUGen

A SuperCollider UGen for using libmapper

Primary LanguageC++GNU Lesser General Public License v2.1LGPL-2.1

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