ModBox is a ShaperBox-inspired M4L Device (requires Ableton Suite) that applies custom envelopes to various effects. These repeat over 1-bar. It includes: -Pitch Shift (ZTX) -Amplitude -Pan -Distortion (Soft/Hard Clip, Bitcrush) -Modulation (Chorus/Flange/Phaser/Vibrato) -Multi-mode Filter (LPF/BPF/HPF) There are some "universal" controls for each module found to the immediate right of the envelope: -active/bypass -snap to grid (horizontal for all but pitch, which is horizontal and vertical) -join/split (allows separate envelopes for left and right channel) -clear (currently selected envelope only) -subdivision (how many gridlines per beat will display and snap) -smooth (LPF applied to envelope signal to smooth it out) -envelope select (circles below envelope to select channels or distortion modes Envelope Hot Keys: -shift-click deletes point -option/alt drag turns straight line to curve Range Slider Hot Keys: -shift-click adjusts one side's value only -command-drag (mac) / control-double-click (win) shifts/slides range left or right -option/alt-drag expands/collapses range Some Specifics: -Most modules have a stereo split mode (join/split button) to provide separate envelopes for the left and right channel. You can switch between them with the colored dots below the envelope -The distortion module has split mode available only for the soft/hard clipping modes. The bitcrusher mode instead has two envelopes for bit rate (1-24 bit) and sample rate (a reduction ratio from original SR) -The distortion module can GET LOUD at high range values. I included these because you can get specific effects from mixing high gain waveshapers back with the dry audio at a very low level. But be careful! -The delay mode of the Modulation processor can produce flangers (short delay time, 1-5ms), chorus (6-40ms), and vibrato (full mix). The phase mode is self-explanitory :) -The feedback section has the following signal path: phase/delay output (wet) -> HPF (fixed) -> LPF (variable) -> gain (+/-) -> saturator (tanh) -> phase/delay input (mixed with dry signal) -WATCH OUT! Feedback gain approaching +/- 100% can self oscillate and get loud! The tanh() function keeps the signal amplitude between -1 and 1 but it can still get funky and ring the resonances (and interesting effect, if you are careful!) ModBox only "plays" envelope during Ableton playback. Initially, none of the modules will pass audio until at least one instance of playback. After that, it should pause and hold the values when playback is stopped. It should resume from where it stopped after using "shift-space" to play, but in testing, this didn't always work as it looses tracking a bit. I'm squeezing everything I can out of the M4L integration, and may have hit its limit for this project! It is worth noting that ModBox triggers the envelopes at the start of each bar. The tempo and time signature are factored into these calculations, but it does mean that it will not be able to track tempo changes MID BAR. Luckily, it catches/resets the start of the next bar so it shouldn't stay out of sync! I'm expecting some feedback on stability and bugs for this one. Its a VERY complex project and I would be surprised if everything was compatible for everyone right out the gate. Feel free to send me messages on Ko-Fi if you encounter any problems and I will do my best to remedy them (if possible, I'm learning sometimes it may not be). Enjoy! -Pete