Envelop is a nonprofit organization that amplifies the connective power of music through immersive listening spaces and open source spatial audio software. Three-dimensional experiences of sound and music bring people together, catalyzing shared moments of inspiration, empathy and wonder.

Envelop for Live (E4L) is an open source audio production framework for spatial audio composition and performance. Envelop for Live operates within the music production environment of Ableton Live 10 and Max for Live. Envelop for Live is designed to be a highly modular, flexible platform for artists to compose and perform spatial audio, and for developers to create new kinds of audio effects for the Ambisonics domain.

• Join the Facebook Group for questions, tips, etc.
• Sign up for the Envelop email newsletter
• Learn more on the Envelop for Live Wiki

E4L makes use of the advanced routing capabilities in Live 10 and Max for Live. Before continuing, make sure that you have installed both of these programs.

Please note that E4L is not officially supported on Windows. Max for Live is technically cross-platform, but some Windows users have reported issues with sporadic crashing and project corruption. We recommend working with macOS if possible. If experimenting with Windows, we encourage making regular backups and copies of project files.

• Download the latest release →
• Unzip the file and place the Envelop for Live folder in a good location on your hard drive

For easy access, you may wish to bookmark the Envelop for Live folder in the Places section of Ableton Live. Do this by dragging and dropping the folder, or using the "Add Folder..." button.

$ cd ~/Documents/Max\ 8/Packages/
$ git clone https://github.com/EnvelopSound/EnvelopForLive.git
$ cd EnvelopForLive

The E4L Max for Live devices can all be found in the devices subfolder. You will need to load the devices and work out of this directory.

The following intro video offers a quick overview of the Envelop for Live software.

Create a new audio track. Add one of the E4L Master Bus device to this track. Note that the track will automatically be renamed to "E4L Master." It is recommended to leave this track name in place, though you may optionally rename it. This track and device will act as a receiver for Ambisonics audio, and allow you to monitor the output of a decoder.

By default, the E4L Master Bus device will use a Binaural decoder, which enables you to preview your spatial mix on a pair of headphones. Make sure that the Monitor 1+2 switch is engaged. Input meters on the E4L Master Bus device provide a visual reference for whether the device is receiving input.

Now, create a new audio or instrument track. In the track's effect chain, add the E4L Source Panner device. This device takes a stereo input and encodes it into 16 channels of high order ambisonics. This device automatically detects the master bus and uses Max for Live's routing capabilities to send its output to the E4L Master Bus.

Note that by default, adding this device automatically sets the track's audio output routing to Sends Only. This is because E4L is already routing the Ambisonics-domain audio behind the scenes. Sending the stereo output from this track would result in two overlapping copies of the audio. For advanced use cases, you may override this setting and route the track output elsewhere (keep in mind that the track output sends only the stereo signal, not the 16-channel surround encoding).

Repeat this process to build up your surround mix. You may use as many E4L Source Panner devices as you like, on as many tracks as your CPU can handle.

For more in-depth documentation and tutorials, see the Envelop for Live Wiki.