Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time


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.

E4L is free to use — but it takes time, energy, and resources to create and maintain. If you find these tools useful, please consider making a donation to support the Envelop nonprofit organization:

Getting Started

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.


For Users: Download

  • 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.


For Developers: Clone Repository

$ cd ~/Documents/Max\ 8/Packages/
$ git clone
$ 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. Note that E4L uses components of the CNMAT odot and ICST Ambisonics packages, please install these directly via the Max Package Manager.

Open the Max Package Manager via the File menu (File | Show Package Manager) and then search for "odot" and "ICST Ambisonics"

Max Package odot Max Package ICST Ambisonics

First Steps

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

Envelop for Live Software Intro

Create the E4L Master Bus

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.

E4L Master Bus

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.

Add Source Tracks

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.

E4L Source Panner

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.

Learn More

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