![EnvelopLX](media/enveloplx-screenshot.png)

[Envelop](http://envelop.us) is a non-profit 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.

**EnvelopLX** is an interactive lighting application for [Envelop](http://www.envelop.us/). It runs in Processing using the [LX Studio](https://github.com/heronarts/LXStudio) framework. The system may be controlled directly, or via remote OSC control from [Envelop for Live](https://github.com/EnvelopSound/EnvelopForLive) devices, which can be composed and sequenced within Ableton Live 10. Real-time spatial audio metering and position data can also be used to control animation.

***EnvelopLX 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: https://www.envelop.us/membership-donations***


## Installation

First, download and install [Processing 3 &rarr;](https://processing.org/download/?processing)

### For Users

- [Download the software &rarr;](https://github.com/EnvelopSound/EnvelopLX/archive/master.zip)
- Open EnvelopLX.pde in Processing and run the sketch

### For Developers

Make a clone of the repository in your Processing sketchbook folder.

```Shell
$ cd ~/Documents/Processing/
$ git clone https://github.com/EnvelopSound/EnvelopLX.git
$ cd EnvelopLX
$ git checkout -b <name_of_your_branch>
$ open EnvelopLX/EnvelopLX.pde
```

---

**BY DOWNLOADING OR USING THE LX STUDIO SOFTWARE OR ANY PART THEREOF, YOU AGREE TO THE TERMS AND CONDITIONS OF THE [LX STUDIO SOFTWARE LICENSE AND DISTRIBUTION AGREEMENT](http://lx.studio/license).**

Please note that LX Studio is not open-source software. The license grants permission to use this software freely in non-commercial applications. Commercial use is subject to a total annual revenue limit of $25K on any and all projects associated with the software. If this licensing is obstructive to your needs or you are unclear as to whether your desired use case is compliant, contact me to discuss proprietary licensing: mark@heronarts.com
