Client software for the Madrona Labs Soundplane.
C++ CMake C
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
Data
MacOS/helloSoundplane
SoundplaneLib
Source
cmake
docs
external/libusb
.gitignore
.gitmodules
CMakeLists.txt
README.md
Source.zip

README.md

Soundplane

Client application for the Madrona Labs Soundplane.

Copyright (c) 2013 Madrona Labs LLC. http://www.madronalabs.com

Distributed under the MIT license: http://madrona-labs.mit-license.org/

Building

OS X

To compile this project, the Xcode Command Line Tools and CMake are required. Xcode Command Line Tools can be downloaded and installed from the "Downloads" tab in Xcode's settings. An easy way of installing CMake is to do it via Homebrew: With Homebrew installed, type brew install cmake in a terminal.

The madronalib project at (https://github.com/madronalabs/madronalib) is currently required and must be downloaded separately. If the madronalib project is located within the same directory as the soundplane project, it should be found by the relative path SP_MADRONALIB_DIR as specified in CMakeLists.txt.

In order to prepare the build, the following commands can be used. The BUILD_NEW_ONLY option is set OFF to include the JUCE libraries needed.

$ mkdir build
$ cd build
$ cmake .. -DBUILD_NEW_ONLY=OFF -GXcode

At this point, there is an Xcode project soundplane.xcodeproj ready for coding and compiling in build/. If you just want to build the application and run it from the comfort of the terminal, these commands can be used

$ xcodebuild -project soundplane.xcodeproj -target Soundplane -configuration MinSizeRel
$ open ./MinSizeRel/Soundplane.app

Linux

On Linux, the Soundplane application requires a few packages to be installed in order to be built. GCC is required, but that is bundled with most Linux distributions. On Ubuntu, the following command installs the dependencies:

$ sudo apt-get install cmake libx11-dev libusb-1.0.0-dev libfreetype6-dev \
      libgl1-mesa-dev libxrandr-dev libxinerama-dev libxcursor-dev \
      libasound2-dev freeglut3-dev libavahi-compat-libdnssd-dev

In order to fetch source dependencies and build, the following commands can be used (in a terminal)

$ mkdir build
$ cd build
$ cmake ..
$ make

On Linux, the Soundplane application typically uses udev to access Soundplane via USB. On most stock Linux installations, the default configuration is to block non-superuser access to the Soundplane. In order to allow the Soundplane application to access the device, add a udev rule that allows it:

$ sudo cp Data/59-soundplane.rules /etc/udev/rules.d/
$ sudo udevadm control --reload-rules

The app can now be run with

$ ./soundplane

If desired, it is possible to build a Debian package with the command

$ make Soundplane_deb