SpatGRIS

SpatGRIS is a sound spatialization software that frees composers and sound designers from the constraints of real-world speaker setups.

With the ControlGRIS plugin distributed with SpatGRIS, rich spatial trajectories can be composed directly in your DAW and reproduced in real-time on any speaker layout. It is fast, stable, cross-platform, easy to learn and works with the tools you already know.

SpatGRIS supports any speaker setup, including 2D layouts like quad, 5.1 or octophonic rings, and 3D layouts like speaker domes, concert halls, theatres, etc. Projects can also be mixed down to stereo using a binaural head-related transfer function or simple stereo panning.

It can handle up to 128 inputs and outputs simultaneously and features 3D and 2D views that help visualizing sources motions and monitor sound activity.

SpatGRIS is developed by the Groupe de recherche en immersion spatiale (GRIS) at Université de Montréal and is in active development. Updates are published on a regular basis.

• Using a virtual audio device
• Building
• Running
• Using custom OSC interfaces

Using a virtual audio device

If you want to use SpatGRIS and ControlGRIS on the same computer, you will need a virtual audio device that can route the audio from your DAW to SpatGRIS.

MacOS

We officially support using BlackHole. A 128 channels version is distributed alongside SpatGRIS.

Windows

If you are a Reaper user, ReaRoute seems to be the best-working virtual interface available at this time on Windows. Because ASIO dissalows interfacing with two different audio devices simoultaneously, sound has to be sent back to Reaper.

If you use an other DAW, there is a donationware called VB-CABLE Virtual Audio Device that sorta works, although it seems to have trouble staying in sync with SpatGRIS and is limited to 32 channels.

Linux

While we do not support a specific routing solution on Linux, there are a lot of different ways of creating loopback audio ports with either JACK, ALSA or PulseAudio.

Building

1. Install dependencies

Download and extract Juce 7.0.2

Additional dependencies on Linux :

sudo apt-get install clang++-14 ladspa-sdk freeglut3-dev libasound2-dev \
libcurl4-openssl-dev libfreetype6-dev libx11-dev libxcomposite-dev \
libxcursor-dev libxinerama-dev libxrandr-dev mesa-common-dev libjack-dev

Additional dependencies on Windows :

The freeglut library must be globally available.

Usage of vcpkg is highly recommended on Windows.

# as an admin
vcpkg install freeglut:x64-windows
vcpkg integrate install

2. Generating project files

cd <ServerGRIS-path>
<path-to-projucer> --resave SpatGRIS.jucer

Compiling

Go to the generated Builds/ folder.

On Windows, use the Visual Studio 2022 solution file.

On MacOS, use the Xcode project. You will have to supply your own developer ID to XCode.

On Linux :

cd Builds/LinuxMakeFile
make CONFIG=Release CXX=clang++-14 -j 8

Running

SpatGRIS must be launched from the project root directory.

Using custom OSC interfaces

OSC can be sent directly to SpatGRIS without having to use ControlGRIS.

There is an example patch made for MAX 7 provided in this repo (osc_max_example.maxpat).

Please note that angles are always measured clockwise, starting from the upstage center (the positive Y direction).

The server address is always /spat/serv.

pol moves a source using polar coordinates in radians.

ex : The message /spat/serv pol 7 0.0 0.78 0.5 0.1 0.2 moves the source #7 in the front at half elevation and placed at half the distance from the origin, with an horizontal span of 10% and a vertical span of 20%.

deg moves a source using polar coordinates in degrees.

ex : The message /spat/serv deg 7 -90.0 45.0 0.5 0.1 0.2 moves the source #7 at the extreme left, at half elevation and half the distance of the space, with an horizontal span of 10% and a vertical span of 20%.

car moves a source using cartesian coordinates.

ex : The message /spat/serv car 7 1.0 1.0 1.0 0.0 0.0 moves the source #7 at the top right corner, with no horizontal or vertical spans.

clr clears a source's position.

ex : The message /spat/serv clr 7 clears the seventh source's position.

alg sets a source's hybrid spatialization mode.

ex : The message /spat/serv alg 7 cube sets the seventh source's spatialization algorithm to "cube" (only works in hybrid mode).