livepilot 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (64) hide show
  1. package/CHANGELOG.md +33 -0
  2. package/LICENSE +21 -0
  3. package/README.md +409 -0
  4. package/bin/livepilot.js +390 -0
  5. package/installer/install.js +95 -0
  6. package/installer/paths.js +79 -0
  7. package/mcp_server/__init__.py +2 -0
  8. package/mcp_server/__main__.py +5 -0
  9. package/mcp_server/connection.py +210 -0
  10. package/mcp_server/memory/__init__.py +5 -0
  11. package/mcp_server/memory/technique_store.py +296 -0
  12. package/mcp_server/server.py +87 -0
  13. package/mcp_server/tools/__init__.py +1 -0
  14. package/mcp_server/tools/arrangement.py +407 -0
  15. package/mcp_server/tools/browser.py +86 -0
  16. package/mcp_server/tools/clips.py +218 -0
  17. package/mcp_server/tools/devices.py +256 -0
  18. package/mcp_server/tools/memory.py +198 -0
  19. package/mcp_server/tools/mixing.py +121 -0
  20. package/mcp_server/tools/notes.py +269 -0
  21. package/mcp_server/tools/scenes.py +89 -0
  22. package/mcp_server/tools/tracks.py +175 -0
  23. package/mcp_server/tools/transport.py +117 -0
  24. package/package.json +37 -0
  25. package/plugin/agents/livepilot-producer/AGENT.md +62 -0
  26. package/plugin/commands/beat.md +18 -0
  27. package/plugin/commands/memory.md +22 -0
  28. package/plugin/commands/mix.md +15 -0
  29. package/plugin/commands/session.md +13 -0
  30. package/plugin/commands/sounddesign.md +16 -0
  31. package/plugin/plugin.json +19 -0
  32. package/plugin/skills/livepilot-core/SKILL.md +208 -0
  33. package/plugin/skills/livepilot-core/references/ableton-workflow-patterns.md +831 -0
  34. package/plugin/skills/livepilot-core/references/device-atlas/00-index.md +110 -0
  35. package/plugin/skills/livepilot-core/references/device-atlas/distortion-and-character.md +687 -0
  36. package/plugin/skills/livepilot-core/references/device-atlas/drums-and-percussion.md +753 -0
  37. package/plugin/skills/livepilot-core/references/device-atlas/dynamics-and-punch.md +525 -0
  38. package/plugin/skills/livepilot-core/references/device-atlas/eq-and-filtering.md +402 -0
  39. package/plugin/skills/livepilot-core/references/device-atlas/midi-tools.md +963 -0
  40. package/plugin/skills/livepilot-core/references/device-atlas/movement-and-modulation.md +874 -0
  41. package/plugin/skills/livepilot-core/references/device-atlas/space-and-depth.md +571 -0
  42. package/plugin/skills/livepilot-core/references/device-atlas/spectral-and-weird.md +714 -0
  43. package/plugin/skills/livepilot-core/references/device-atlas/synths-native.md +953 -0
  44. package/plugin/skills/livepilot-core/references/m4l-devices.md +352 -0
  45. package/plugin/skills/livepilot-core/references/memory-guide.md +107 -0
  46. package/plugin/skills/livepilot-core/references/midi-recipes.md +402 -0
  47. package/plugin/skills/livepilot-core/references/mixing-patterns.md +578 -0
  48. package/plugin/skills/livepilot-core/references/overview.md +209 -0
  49. package/plugin/skills/livepilot-core/references/sound-design.md +392 -0
  50. package/remote_script/LivePilot/__init__.py +42 -0
  51. package/remote_script/LivePilot/arrangement.py +693 -0
  52. package/remote_script/LivePilot/browser.py +424 -0
  53. package/remote_script/LivePilot/clips.py +211 -0
  54. package/remote_script/LivePilot/devices.py +596 -0
  55. package/remote_script/LivePilot/diagnostics.py +198 -0
  56. package/remote_script/LivePilot/mixing.py +194 -0
  57. package/remote_script/LivePilot/notes.py +339 -0
  58. package/remote_script/LivePilot/router.py +74 -0
  59. package/remote_script/LivePilot/scenes.py +99 -0
  60. package/remote_script/LivePilot/server.py +293 -0
  61. package/remote_script/LivePilot/tracks.py +268 -0
  62. package/remote_script/LivePilot/transport.py +151 -0
  63. package/remote_script/LivePilot/utils.py +123 -0
  64. package/requirements.txt +2 -0
@@ -0,0 +1,714 @@
1
+ # Spectral & Weird — Device Atlas
2
+
3
+ > Spectral processors, granular effects, glitch engines, oscilloscope instruments, and experimental M4L devices in Ableton Live 12.
4
+ > Use this reference to choose, configure, and chain spectral/experimental devices via LivePilot.
5
+
6
+ ---
7
+
8
+ ## Native Devices
9
+
10
+ ---
11
+
12
+ ### Spectral Time
13
+
14
+ - **Type:** Native (Live 11+, Suite only)
15
+ - **Load via:** `find_and_load_device("Spectral Time")`
16
+ - **What it does:** FFT-based effect combining a spectral freeze engine and a spectral delay. Freeze captures and sustains incoming audio as a spectral snapshot; Delay applies per-frequency delay times with pitch shift, tilt, spray, and masking. Sections run independently or in series (Freeze into Delay or Delay into Freeze). Built-in sonogram display shows dry (yellow) and wet (blue) signals.
17
+ - **Signal flow:** Input → Pre Gain → [Freezer ↔ Delay (order switchable)] → Mix → Output
18
+ - **Key parameters:**
19
+ - **Freezer Section:**
20
+ - **Freezer On** (toggle) → enable/disable freeze engine
21
+ - **Freeze** (toggle) → capture/hold current spectral snapshot (Manual mode) or re-freeze on trigger (Retrigger mode)
22
+ - **Mode** (Manual / Retrigger) → Manual = button-press freeze; Retrigger = auto-freeze on onset or sync
23
+ - **Retrig Mode** (Onsets / Sync) → Onsets triggers on transients with Sensitivity (0--100%); Sync triggers at regular Interval
24
+ - **Sensitivity** (0--100%) → onset detection threshold → lower catches more transients
25
+ - **Interval** (ms or beat-synced) → retrigger spacing in Sync mode
26
+ - **Fade** (Crossfade / Envelope) → Crossfade blends old/new freezes smoothly; Envelope uses separate fade in/out
27
+ - **Fade In** (0.002--10 s) → ramp-up time for new freeze
28
+ - **Fade Out** (0.02--10 s) → ramp-down time for old freeze
29
+ - **X-Fade** (0--100%) → crossfade duration as percentage of interval → supports up to 8 simultaneous stacked freezes
30
+ - **Delay Section:**
31
+ - **Delay On** (toggle) → enable/disable spectral delay
32
+ - **Time** (0.01--3 s, or beat-synced: 16th / 16th-T / 16th-D / Notes) → delay duration
33
+ - **Feedback** (0--100%) → output fed back to delay input → > 80% builds up, approaches infinity
34
+ - **Shift** (-400 to +400) → frequency shift applied to delayed signal → successive repeats shift progressively
35
+ - **Tilt** (-2 to +2) → skews delay times by frequency → positive = highs delayed more, negative = lows delayed more
36
+ - **Spray** (0--0.4) → randomizes delay times per frequency bin → low = subtle smear, high = scattered chaos
37
+ - **Mask** (-1 to +1) → limits Tilt/Spray to frequency range → negative = lows only, positive = highs only
38
+ - **Spread** (0--100%) → stereo width of Tilt and Spray processing
39
+ - **Global:**
40
+ - **Order** (Freeze→Delay / Delay→Freeze) → processing chain sequence
41
+ - **Resolution** (Low / Mid / High / Ultra) → FFT processing quality → Ultra = pristine, Low = lo-fi character
42
+ - **Pre Gain** (-70.6 to 0 dB) → input signal level
43
+ - **Dry/Wet** → 30--50% for subtle spectral sheen, 100% on send, 100% for drone/texture work
44
+ - **Presets:** "Spectral Wash" (ambient starting point), "Glitch Freeze" (retrigger stutters), "Pitch Cloud" (shift + spray chaos)
45
+ - **Reach for this when:** you need spectral freezes for drones/pads, glitchy retrigger stutters, per-frequency delay with tilt/spray, or otherworldly textures from any source
46
+ - **Don't use when:** you need a clean transparent delay (use Delay), simple reverb tails (use Reverb), or tempo-locked rhythmic repeats (use Echo)
47
+ - **Pairs well with:** Corpus (freeze into resonator), Reverb (post-freeze ambient wash), Auto Pan (movement on frozen textures), Utility (mono check for Spray width)
48
+ - **vs Grain Delay:** Spectral Time works in frequency domain (FFT), Grain Delay in time domain (granular). Spectral Time excels at freeze/sustain and per-frequency processing; Grain Delay excels at pitch-shifting textures and granular scatter.
49
+
50
+ ---
51
+
52
+ ### Spectral Resonator
53
+
54
+ - **Type:** Native (Live 11+, Suite only)
55
+ - **Load via:** `find_and_load_device("Spectral Resonator")`
56
+ - **What it does:** FFT-based pitched resonance processor. Breaks incoming audio into spectral partials, then resonates them at a tuned frequency with harmonic stretching, shifting, and modulation. Can be driven by internal frequency or external MIDI for pitched spectral effects. Turns any audio into a resonant, tonal instrument.
57
+ - **Signal flow:** Input → FFT analysis → Partial generation (Harmonics + Stretch + Shift) → Decay/Damping → Modulation (Chorus/Wander/Granular) → Unison → Dry/Wet Output
58
+ - **Key parameters:**
59
+ - **Pitch Mode:**
60
+ - **Internal Mode:** Freq dial sets pitch in Hz or note name; Frequency Dial Mode buttons toggle Hz/pitch display
61
+ - **MIDI Mode:** MIDI router selects source track; Mono/Poly switch; Polyphony chooser (2/4/8/16 voices); MIDI Gate (only resonates while notes held); Glide (ms, Mono only); PB range (0--24 semitones)
62
+ - **Harmonic Processing:**
63
+ - **Harmonics** → number of generated partials → higher = brighter, more complex
64
+ - **Stretch** (-100% to +100%) → compress or stretch harmonic spacing → 0 = natural harmonics, 100% = odd harmonics only (clarinet-like), negative = sub-harmonics emphasized
65
+ - **Shift** (±48 semitones) → transpose entire spectrum up/down
66
+ - **Decay & Damping:**
67
+ - **Decay** (ms) → resonance sustain time → short (< 200 ms) for plucky, long (> 1 s) for sustained drones
68
+ - **HF Damp** → high-frequency partial decay → increase for darker, warmer resonance
69
+ - **LF Damp** → low-frequency partial decay → increase for thinner, brighter resonance
70
+ - **Modulation (4 modes):**
71
+ - **None** → static resonance
72
+ - **Chorus** → gentle detuning movement
73
+ - **Wander** → random sawtooth modulation on partials → organic, evolving texture
74
+ - **Granular** → granular decomposition of resonance → glitchy, textural, broken
75
+ - **Mod Rate** → modulation speed for active mode
76
+ - **Pch. Mod** (±semitones) → pitch modulation range
77
+ - **Output:**
78
+ - **Input Send** → gain applied to processed signal
79
+ - **Unison** (1/2/4/8 voices) → stacked voices for width and density
80
+ - **Uni. Amt** (0--100%) → unison detuning intensity → high = thick chorus, low = subtle width
81
+ - **Dry/Wet** → 35--50% for tonal coloring, 100% for full spectral instrument
82
+ - **Presets:** "Metallic Ring" (short decay, high harmonics), "Drone Machine" (long decay, wander), "Spectral Instrument" (MIDI mode, poly)
83
+ - **Reach for this when:** you need to add pitched resonance to percussion/noise, create spectral instruments from any audio, build drones from textures, or add metallic/harmonic coloring
84
+ - **Don't use when:** you want physical-body resonance (use Corpus), transparent reverb (use Hybrid Reverb), or simple EQ resonance (use EQ Eight with narrow peaks)
85
+ - **Pairs well with:** Spectral Time (chain for freeze-into-resonance), Beat Repeat (glitch source into resonator), Corpus (physical + spectral layering), Compressor (tame resonant peaks)
86
+ - **vs Corpus:** Spectral Resonator works in frequency domain with harmonic partials; Corpus uses physical modeling of real objects. Spectral Resonator is more "digital/alien," Corpus is more "acoustic/material."
87
+
88
+ ---
89
+
90
+ ### Corpus
91
+
92
+ - **Type:** Native (all Live editions)
93
+ - **Load via:** `find_and_load_device("Corpus")`
94
+ - **What it does:** Physical modeling resonator simulating 7 types of resonant objects. Developed with Applied Acoustics Systems. Adds the acoustic character of beams, strings, membranes, plates, pipes, and tubes to any input signal. Turns percussive hits into tuned metal, wood, or membrane sounds; turns sustained audio into vibrating physical objects.
95
+ - **Signal flow:** Input → Band-pass Filter (optional) → Resonator body (selected type) → LFO modulation → Bleed mix → Gain/Limiter → Dry/Wet Output. MIDI sidechain can control tuning and decay.
96
+ - **Key parameters:**
97
+ - **Resonance Type** (7 models):
98
+ - **Beam** → metal/wood beam → bright, bell-like overtones
99
+ - **Marimba** → specialized beam with marimba-tuned overtones → warm, woody
100
+ - **String** → vibrating string → rich harmonics, plucky to sustained
101
+ - **Membrane** → rectangular drumhead → deep, boomy, thuddy
102
+ - **Plate** → flat metal/glass plate → bright, shimmering, complex
103
+ - **Pipe** → cylindrical tube (one end open) → hollow, breathy, flute-like
104
+ - **Tube** → cylindrical tube (both ends open) → airy, more open than Pipe
105
+ - **Resonator Parameters:**
106
+ - **Quality** (Eco / Mid / High) → processing resolution → Eco for lo-fi, High for realism
107
+ - **Decay** → internal damping → short for plucky percussion, long for sustained singing
108
+ - **Material** → ratio of high-to-low frequency damping → low = rubber/wood (highs die fast), high = metal/glass (highs ring)
109
+ - **Bright** → amplitude of frequency components → higher = more present upper partials
110
+ - **Inharm** (Inharmonics) → stretches or compresses harmonic series → negative = compressed (bell-like), positive = stretched (metallic, dissonant)
111
+ - **Radius** (Pipe/Tube only) → tube diameter → affects timbre and pitch
112
+ - **Opening** (Pipe only, 0--100%) → how open the end is → 0% = closed (muted), 100% = fully open
113
+ - **Ratio** (Membrane/Plate only) → aspect ratio of the surface → affects overtone pattern
114
+ - **Hit** (0--100%) → excitation point on the body → different positions emphasize different modes
115
+ - **Width** → stereo mix between left/right resonators
116
+ - **Pos. L / Pos. R** → listening point positions → like moving microphones around the object
117
+ - **Tune** (Hz) → fundamental frequency → set by ear or MIDI
118
+ - **Fine** (cents) → fine-tuning for MIDI mode
119
+ - **Spread** → detunes L/R resonators → positive = L higher / R lower, negative = opposite
120
+ - **LFO Section:**
121
+ - **Amount** → modulation depth on resonant frequency
122
+ - **Rate** (Hz or tempo-synced) → LFO speed
123
+ - **Waveform** → Sine, Square, Triangle, Sawtooth up/down, Noise variants
124
+ - **Phase** (0--360 degrees) → offset between L/R channels
125
+ - **Spin** → detunes LFO speeds between channels → creates stereo motion
126
+ - **Filter Section:**
127
+ - **Filter** (toggle) → enables band-pass filter on input before resonator
128
+ - **Freq** → center frequency
129
+ - **Bandwidth** → filter width → narrow = focused excitation, wide = full-spectrum
130
+ - **Global:**
131
+ - **Bleed** → unprocessed signal mixed in → restores highs lost to low tuning/quality
132
+ - **Gain** → output level with built-in limiter
133
+ - **Dry/Wet** → 50--80% for effect, 100% for full resonator instrument
134
+ - **Sidechain (MIDI):**
135
+ - **Frequency** (toggle) → MIDI controls resonator pitch
136
+ - **Off Decay** (toggle) → Note Off triggers faster decay
137
+ - **Last / Low** → note priority for polyphonic MIDI input
138
+ - **PB Range** → pitch bend range in semitones
139
+ - **Transpose / Fine** → MIDI offset controls
140
+ - **Presets:** "Metal Plate" (bright percussion), "Wooden Beam" (warm marimba-like), "Drum Membrane" (deep tom resonance), "Glass Tube" (ethereal, breathy)
141
+ - **Reach for this when:** you need tuned percussion from noise/clicks, physical material character on any source, acoustic resonance modeling, pitched MIDI-controlled resonation, or metallic/woody coloring
142
+ - **Don't use when:** you need spectral/FFT processing (use Spectral Resonator), simple reverb/space (use Reverb), or frequency-domain manipulation (use Spectral Time)
143
+ - **Pairs well with:** Drum Rack (Corpus on individual pads for tuned percussion), Operator (simple click/noise exciter → Corpus), Spectral Time (freeze → Corpus for sustained resonance), Utility (volume control after high-Gain resonances)
144
+ - **vs Spectral Resonator:** Corpus models physical objects (material, geometry); Spectral Resonator manipulates FFT partials (harmonics, stretch). Corpus sounds acoustic/organic, Spectral Resonator sounds digital/alien. Use both in series for hybrid textures.
145
+
146
+ ---
147
+
148
+ ### Grain Delay
149
+
150
+ - **Type:** Native (all Live editions)
151
+ - **Load via:** `find_and_load_device("Grain Delay")`
152
+ - **What it does:** Granular delay that chops incoming audio into tiny grains and replays them with delay, pitch shift, and randomization. Sits between a delay and a granular processor -- capable of subtle chorus-like effects, dramatic pitch-shifted textures, and complete signal destruction depending on settings.
153
+ - **Signal flow:** Input → Grain engine (Frequency sets grain rate) → Pitch shift → Spray (time randomization) → Random Pitch → Feedback → Dry/Wet Output
154
+ - **Key parameters:**
155
+ - **Delay Time** (Sync mode: beat divisions; Time mode: 1--300 ms) → base delay time → 1--5 ms for timbre coloring, 10--35 ms for chorus/flam, synced divisions for rhythmic
156
+ - **Frequency** (1--150 Hz) → grain rate (grains per second) → lower = larger/smoother grains, higher = smaller/buzzier grains → < 4 Hz for smooth texture, 10--30 Hz for standard granular, > 60 Hz for buzzy artifacts
157
+ - **Pitch** (±semitones, 2 decimal places) → pitch shift per grain → +5 = perfect fourth up, -7 = perfect fifth down, ±1 = subtle detuning → stacks with feedback for cascading transposition
158
+ - **Spray** (ms) → random jitter on delay time → low (1--5 ms) for subtle smear, high for full time-scatter and rhythmic destruction
159
+ - **Random Pitch** (0--100) → random pitch variation per grain → low (5--15) for mutant chorus, high (> 50) for unintelligible pitch chaos
160
+ - **Feedback** (0--100%) → delayed grains fed back → 30% for cascading echoes, 60% for phaser-like buildup, > 90% for self-oscillation
161
+ - **Dry/Wet** → 50% starting point for effect; 100% on send; use clip envelope or automation for dynamic control
162
+ - **Sweet spots for experimental use:**
163
+ - **Stereo widener:** Sync off, delay < 35 ms, low Spray, low Frequency, low Random Pitch
164
+ - **Granular texture:** High Frequency (40--100 Hz), moderate Spray (10--30 ms), Pitch at harmony interval, feedback 40--60%
165
+ - **Complete destruction:** Max Spray, max Random Pitch, high Frequency, high Feedback
166
+ - **Pitch harmonizer:** Pitch at musical interval (+3, +5, +7, +12), low Spray, zero Random Pitch, feedback 0%, delay < 10 ms
167
+ - **Presets:** "Shimmer" (octave up pitch cascade), "Granular Wash" (texture pad), "Pitch Chaos" (full destruction)
168
+ - **Reach for this when:** you want granular textures, pitch-shifted delays, subtle chorus-like widening from granular processing, or controlled signal destruction
169
+ - **Don't use when:** you need clean transparent delay (use Delay), spectral freeze (use Spectral Time), or tempo-locked rhythmic echoes (use Echo)
170
+ - **Pairs well with:** Reverb (post-grain wash), Auto Filter (sweep the granular output), Compressor (tame feedback buildup), Utility (mono check for stereo widening mode)
171
+ - **vs Spectral Time:** Grain Delay works in time domain (grain slicing); Spectral Time works in frequency domain (FFT). Grain Delay is better for pitch shifting and granular scatter; Spectral Time is better for freeze and per-frequency processing.
172
+
173
+ ---
174
+
175
+ ### Beat Repeat
176
+
177
+ - **Type:** Native (all Live editions)
178
+ - **Load via:** `find_and_load_device("Beat Repeat")`
179
+ - **What it does:** Real-time audio buffer capture and loop effect. Grabs chunks of audio at configurable intervals and repeats them with grid slicing, pitch decay, filtering, and volume decay. The definitive glitch/stutter tool in Live -- can produce everything from subtle fills to extreme rhythmic destruction.
180
+ - **Signal flow:** Incoming audio → Interval-triggered capture → Gate-length repetition → Grid slicing → Variation (random grid) → Pitch shifting → Filter (HP + LP) → Volume Decay → Mix/Insert/Gate output
181
+ - **Key parameters:**
182
+ - **Interval** (1/32 to 4 Bars) → how often Beat Repeat captures new audio → 1 Bar for fills at bar boundaries, 1/4 for frequent stutters
183
+ - **Offset** (0--16 sixteenths) → shifts capture point forward in time → use to target specific beats
184
+ - **Chance** (0--100%) → probability that a repetition actually occurs → 100% = always, 50% = half the time (random glitch feel)
185
+ - **Gate** (sixteenth notes) → duration of the repetition burst → short (1--2) for tight stutters, long (4--8) for extended loops
186
+ - **Repeat** (toggle) → manual capture/repeat override → map to MIDI for performance control
187
+ - **Grid** (1/4 to 1/32) → size of the repeated slice → 1/16 for standard stutter, 1/32 for rapid-fire glitch, 1/8 for chunky chops
188
+ - **No Triplets** (toggle) → restricts grid to binary divisions only
189
+ - **Variation** (0--100%) → random fluctuation of grid size → adds organic inconsistency
190
+ - **Variation Mode** (Trigger / 1/4 / 1/8 / 1/16 / Auto) → how often variation recalculates → Trigger = once per capture, Auto = every slice
191
+ - **Pitch** (0 to -48 semitones) → downward pitch shift via resampling → -12 for octave-down drops, -24 for horror effects
192
+ - **Pitch Decay** (%) → progressive pitch reduction per repeat → creates descending stutter effect
193
+ - **Filter Freq** → center frequency of combined HP/LP filter
194
+ - **Filter Width** → bandwidth → narrow for resonant telephone effect, wide for gentle shaping
195
+ - **Volume** → output level control
196
+ - **Decay** (%) → gradual volume fade per repeat → creates natural stutter decay
197
+ - **Mix Mode:**
198
+ - **Mix** → original audio + repetitions play together
199
+ - **Insert** → original audio muted during repetitions → cleaner glitch cuts
200
+ - **Gate** → only repetitions pass through, original is fully cut → use on send for parallel glitch processing
201
+ - **Sweet spots for glitch/experimental:**
202
+ - **Classic stutter:** Grid 1/16, Gate 2, Interval 1 Bar, Chance 70%, Insert mode
203
+ - **Glitch fill:** Grid 1/32, Variation 80%, Pitch Decay 20%, Gate 4, Chance 100%
204
+ - **Bass drop:** Grid 1/8, Pitch -12 to -24, Pitch Decay 50%, Insert mode
205
+ - **Random destruction:** Grid 1/16, Variation 100% Auto, Chance 50%, Pitch -12, Decay 30%
206
+ - **Performance stutter:** Map Repeat to MIDI button, Grid 1/16, Gate 8, Insert mode
207
+ - **Presets:** "Glitch Fill" (random stutters), "Tape Stop" (pitch decay), "Break Chop" (beat slicing)
208
+ - **Reach for this when:** you need real-time stutters, glitch fills, rhythmic destruction, performance-triggered repeats, or audio buffer manipulation
209
+ - **Don't use when:** you need smooth delay repeats (use Delay/Echo), granular textures (use Grain Delay), or spectral freeze (use Spectral Time)
210
+ - **Pairs well with:** Auto Filter (filter sweeps on stutters), Redux (bit-crush the repeats), Grain Delay (granular after stutter for chaos), Utility (gain staging after pitch decay)
211
+ - **vs Grain Delay for glitch:** Beat Repeat is rhythmic and beat-aligned; Grain Delay is textural and pitch-oriented. Beat Repeat for stutters/fills, Grain Delay for textures/harmonics.
212
+
213
+ ---
214
+
215
+ ## User M4L — Confetti Suite (Rodrigo Constanzo)
216
+
217
+ > 14 free Max for Live devices based on modules from The Party Van, Cut Glove, and TPV2. FluCoMa-powered analysis, creative destruction, and lo-fi processing. All parameters automatable. Free / open-source on GitHub.
218
+
219
+ ---
220
+
221
+ ### Confetti: Analysis
222
+
223
+ - **Type:** M4L Audio Effect (FluCoMa-powered)
224
+ - **Load via:** `find_and_load_device("M4L_Confetti Analysis")`
225
+ - **What it does:** Real-time audio descriptor analysis engine. Extracts onset detection, loudness, spectral centroid, and spectral flatness from incoming audio. Outputs continuous signal-rate streams or sample-and-hold values triggered by onset detection. Use as a modulation source for other Confetti devices or parameter mapping.
226
+ - **Key parameters:** Onset sensitivity, descriptor selection (loudness / centroid / flatness), output mode (continuous / sample-and-hold), smoothing
227
+ - **Reach for this when:** you need audio-reactive modulation, feature extraction for driving other effects, or analytical monitoring of spectral content
228
+
229
+ ---
230
+
231
+ ### Confetti: Chopper
232
+
233
+ - **Type:** M4L Audio Effect
234
+ - **Load via:** `find_and_load_device("M4L_Confetti Chopper")`
235
+ - **What it does:** Time-domain granular analysis/resynthesis. Segments incoming audio at zero-crossings (wavesets) and stores them, then plays back stored segments in various orders. Creates waveset-based effects from subtle timbral shifts to complete reconstruction of audio from individual waveform cycles.
236
+ - **Key parameters:** Segment size, playback order, waveset selection, mix
237
+ - **Reach for this when:** you need waveset manipulation, zero-crossing granular effects, or timbral deconstruction at the waveform level
238
+
239
+ ---
240
+
241
+ ### Confetti: Chorus
242
+
243
+ - **Type:** M4L Audio Effect
244
+ - **Load via:** `find_and_load_device("M4L_Confetti Chorus")`
245
+ - **What it does:** Multi-mode modulation effect with three distinct algorithms: Digital (8-stage chorus), Analog (sine LFO), and LoFi (triangle LFO with wow/flutter). Includes saturation processing stage. More character-driven than Live's native Chorus-Ensemble.
246
+ - **Key parameters:** Mode (Digital / Analog / LoFi), rate, depth, saturation amount, mix
247
+ - **Reach for this when:** you want characterful chorus with lo-fi or analog flavor, wow/flutter tape effects, or saturated modulation
248
+
249
+ ---
250
+
251
+ ### Confetti: Cloud
252
+
253
+ - **Type:** M4L Audio Effect (FluCoMa-powered)
254
+ - **Load via:** `find_and_load_device("M4L_Confetti Cloud")`
255
+ - **What it does:** Real-time granulator that writes incoming audio to a buffer while simultaneously reading back grains. Uses FluCoMa harmonic/percussive/transient decomposition to balance spectral components before granulation. The core granular texture engine of the Confetti suite.
256
+ - **Key parameters:** Grain size, grain density, position, pitch, harmonic/percussive/transient balance (FluCoMa), spray, feedback, mix
257
+ - **Reach for this when:** you need real-time granular processing with spectral decomposition, textural clouds from any audio, or harmonic/percussive separation before granulation
258
+
259
+ ---
260
+
261
+ ### Confetti: Dirt
262
+
263
+ - **Type:** M4L Audio Effect
264
+ - **Load via:** `find_and_load_device("M4L_Confetti Dirt")`
265
+ - **What it does:** Dual-algorithm distortion combining cubic nonlinear distortion and variable-hardness clipping. Both algorithms 4x oversampled to minimize aliasing. Includes post-distortion EQ for tonal shaping.
266
+ - **Key parameters:** Algorithm selection, drive, hardness (clip algorithm), post-EQ, mix
267
+ - **Reach for this when:** you need clean-aliasing distortion, variable clipping character, or post-EQ-shaped saturation
268
+
269
+ ---
270
+
271
+ ### Confetti: Dub
272
+
273
+ - **Type:** M4L Audio Effect
274
+ - **Load via:** `find_and_load_device("M4L_Confetti Dub")`
275
+ - **What it does:** Dirty delay that responds to audio onsets for dub-style processing. Multiple delay modes with onset-triggered behavior create dub snare slapbacks and Karplus-Strong-like resonant string effects from transient material.
276
+ - **Key parameters:** Delay time, feedback, onset sensitivity, mode selection, filter, mix
277
+ - **Reach for this when:** you need onset-reactive delay, dub-style processing, or Karplus-Strong string synthesis from percussive input
278
+
279
+ ---
280
+
281
+ ### Confetti: Filter
282
+
283
+ - **Type:** M4L Audio Effect
284
+ - **Load via:** `find_and_load_device("M4L_Confetti Filter")`
285
+ - **What it does:** Multi-mode filter combining 4 classic filter topologies: MS-20, Sallen-Key, Moog Ladder, and Butterworth. Each offers lowpass/highpass modes with adjustable character parameters unique to each topology. More colorful and aggressive than Live's Auto Filter.
286
+ - **Key parameters:** Topology (MS-20 / Sallen-Key / Moog / Butterworth), mode (LP / HP), cutoff, resonance, character/drive, mix
287
+ - **Reach for this when:** you need specific analog filter character, aggressive self-oscillating resonance (MS-20), or filter topology comparison
288
+
289
+ ---
290
+
291
+ ### Confetti: Lofi
292
+
293
+ - **Type:** M4L Audio Effect
294
+ - **Load via:** `find_and_load_device("M4L_Confetti Lofi")`
295
+ - **What it does:** Combines bit depth reduction, sample rate reduction, audio-rate bitwise manipulation, and MP3-style compression artifacts. More destructive and flexible than Live's Redux.
296
+ - **Key parameters:** Bit depth, sample rate, bitwise mode, compression quality, mix
297
+ - **Reach for this when:** you need deep bit-crushing, codec artifacts, bitwise audio manipulation, or layered lo-fi degradation beyond Redux
298
+
299
+ ---
300
+
301
+ ### Confetti: Octaver
302
+
303
+ - **Type:** M4L Audio Effect
304
+ - **Load via:** `find_and_load_device("M4L_Confetti Octaver")`
305
+ - **What it does:** Lo-fi analog octave effect roughly modeled on the Boss OC-2 pedal. Generates sub-octave from input with added drive and filtering for fuzz-like character. Monophonic tracking like the hardware original.
306
+ - **Key parameters:** Octave level (-1, -2), drive, filter, direct signal level, mix
307
+ - **Reach for this when:** you need analog-style sub-octave, lo-fi bass fattening, or OC-2 pedal character in the box
308
+
309
+ ---
310
+
311
+ ### Confetti: Pitch
312
+
313
+ - **Type:** M4L Audio Effect
314
+ - **Load via:** `find_and_load_device("M4L_Confetti Pitch")`
315
+ - **What it does:** Pitch shifting using PSOLA (pitch-synchronous overlap-add) algorithm, modeled on the character of the Digitech Whammy pedal. Four modes: Clean, Dirty, Automatic, and Random. Glitchy artifacts are a feature, not a bug.
316
+ - **Key parameters:** Pitch interval (semitones), mode (Clean / Dirty / Auto / Random), glide, mix
317
+ - **Reach for this when:** you need Whammy-style pitch effects, glitchy PSOLA pitch shifting, or random pitch chaos
318
+
319
+ ---
320
+
321
+ ### Confetti: Resonator
322
+
323
+ - **Type:** M4L Audio Effect
324
+ - **Load via:** `find_and_load_device("M4L_Confetti Resonator")`
325
+ - **What it does:** Onset-triggered oscillator bank with pitch detection. Detects incoming transients, analyzes pitch, then triggers a bank of oscillators with randomized partial frequencies that fade out over time. Creates harmonic ghosts from percussive input.
326
+ - **Key parameters:** Onset sensitivity, partial count, frequency randomization, decay time, pitch tracking, mix
327
+ - **Reach for this when:** you need harmonic resonance from percussion, pitched ghost tones from transients, or oscillator-bank effects driven by audio input
328
+
329
+ ---
330
+
331
+ ### Confetti: Skipper
332
+
333
+ - **Type:** M4L Audio Effect
334
+ - **Load via:** `find_and_load_device("M4L_Confetti Skipper")`
335
+ - **What it does:** Models a skipping CD player. Attack detection causes the virtual disc to skip, creating buffer-repeat and stutter effects. Multiple Sony Discman models available with different skip characteristics. Nostalgia as an effect.
336
+ - **Key parameters:** Discman model, skip sensitivity, repeat length, attack threshold, mix
337
+ - **Reach for this when:** you need CD-skip glitch effects, nostalgic digital artifacts, or onset-triggered buffer stutters
338
+
339
+ ---
340
+
341
+ ### Confetti: Tremolo
342
+
343
+ - **Type:** M4L Audio Effect
344
+ - **Load via:** `find_and_load_device("M4L_Confetti Tremolo")`
345
+ - **What it does:** VCA and low-pass gate (LPG) based tremolo with waveshaping LFOs. Optional stereo panning mode. More organic and characterful than simple volume modulation due to LPG filtering behavior.
346
+ - **Key parameters:** Rate, depth, LFO waveshape, VCA/LPG mode, stereo pan mode, mix
347
+ - **Reach for this when:** you need LPG-colored tremolo, waveshaped modulation, or organic volume/filter movement
348
+
349
+ ---
350
+
351
+ ### Confetti: Wavefolder
352
+
353
+ - **Type:** M4L Audio Effect
354
+ - **Load via:** `find_and_load_device("M4L_Confetti Wavefolder")`
355
+ - **What it does:** Multiple wavefolder algorithms inspired by Buchla, Madrona Labs Aalto, and Whimsical Raps Cold Mac, combined with sigmoid saturation. Creates complex harmonic overtones by folding waveforms back on themselves. Rich, aggressive, and unpredictable.
356
+ - **Key parameters:** Algorithm (Buchla / Aalto / Cold Mac), fold amount, symmetry, saturation, mix
357
+ - **Reach for this when:** you need complex harmonic generation, wavefolding distortion, or aggressive timbral transformation
358
+
359
+ ---
360
+
361
+ ## User M4L — Oscilloscopemusic (Jerobeam Fenderson)
362
+
363
+ > 11 Max for Live instrument devices that generate audio signals designed to produce visual patterns on an XY oscilloscope. Left channel = X axis, Right channel = Y axis. These are primarily visual-audio synthesis instruments -- they make sound AND images simultaneously. All based on mathematical equations (trigonometry, fractals, geometry).
364
+
365
+ ---
366
+
367
+ ### blubb 0.0
368
+
369
+ - **Type:** M4L Instrument
370
+ - **Load via:** `find_and_load_device("blubb")`
371
+ - **What it does:** Generates bubbly water-drop sounds and circular oscilloscope visuals. Uses sin/cos equations to draw circles; applies pitch and volume envelopes for short rising-frequency tones; jumps randomly between positions. Includes automatic sequencer.
372
+ - **Key parameters:** Pitch envelope, volume envelope, position randomization, sequencer rate
373
+ - **Reach for this when:** you need bubbly/water synthesis, circular oscilloscope patterns, or generative percussive textures
374
+
375
+ ---
376
+
377
+ ### boing 1.1
378
+
379
+ - **Type:** M4L Instrument
380
+ - **Load via:** `find_and_load_device("boing")`
381
+ - **What it does:** Renders bouncing-ball animation on oscilloscope with corresponding audio. Draws horizontal circles, moves them vertically to form spirals, adjusts width for ball appearance. Envelopes and LFOs control spiral density, rotation, and 3D depth.
382
+ - **Key parameters:** Bounce height, spiral density, rotation speed, 3D depth, LFO rate
383
+ - **Reach for this when:** you need bouncy percussive synthesis, spiral oscilloscope visuals, or physics-inspired sound generation
384
+
385
+ ---
386
+
387
+ ### butterfly 0.1
388
+
389
+ - **Type:** M4L Instrument
390
+ - **Load via:** `find_and_load_device("butterfly")`
391
+ - **What it does:** Generates butterfly-shaped patterns on oscilloscope based on the transcendental butterfly curve equation. Blends three different mathematical shapes together for visual and sonic complexity.
392
+ - **Key parameters:** Shape blend (3 shapes), curve parameters, morphing speed
393
+ - **Reach for this when:** you need mathematical curve synthesis, organic visual patterns, or transcendental function-based sound design
394
+
395
+ ---
396
+
397
+ ### fractal spiral 1.8
398
+
399
+ - **Type:** M4L Instrument
400
+ - **Load via:** `find_and_load_device("fractal spiral")`
401
+ - **What it does:** Creates fractal spiral patterns with continuous zoom capability. Draws circles moved along spiral lines with seamless zooming by blending spiral stages. Controls for spiral density, width, rotation, zoom speed, and 3D depth via envelopes and LFOs. The most versatile and visually complex of the oscilloscope instruments.
402
+ - **Key parameters:** Spiral density, width, rotation, zoom speed, 3D depth, envelope/LFO assignments
403
+ - **Reach for this when:** you need fractal visual synthesis, zooming spiral patterns, or complex evolving oscilloscope visuals
404
+
405
+ ---
406
+
407
+ ### Kepler-Bouwkamp 0.4
408
+
409
+ - **Type:** M4L Instrument
410
+ - **Load via:** `find_and_load_device("Kepler-Bouwkamp")`
411
+ - **What it does:** Renders interlocking polygons and inscribed circles based on the Kepler-Bouwkamp constant (nested polygon geometry). Draws and rotates lines to form polygons with circles inserted between them. Adjustable shape, polygon count, direction, and rotation.
412
+ - **Key parameters:** Polygon count, rotation speed, direction, shape morphing, nesting depth
413
+ - **Reach for this when:** you need geometric oscilloscope patterns, mathematical polygon synthesis, or sacred-geometry-inspired visuals
414
+
415
+ ---
416
+
417
+ ### line horizon 0.1
418
+
419
+ - **Type:** M4L Instrument
420
+ - **Load via:** `find_and_load_device("line horizon")`
421
+ - **What it does:** Displays horizontal line arrays creating perspective depth effect with Minecraft-style sunrise visuals. Lines compress near zero for perspective illusion. Creates circle/square shapes in center with bow and squeeze distribution functions for line spacing.
422
+ - **Key parameters:** Line count, perspective depth, beat sync, center shape, bow/squeeze distribution
423
+ - **Reach for this when:** you need horizon/landscape oscilloscope visuals, perspective-based synthesis, or beat-synced visual patterns
424
+
425
+ ---
426
+
427
+ ### mushrooms 0.3
428
+
429
+ - **Type:** M4L Instrument
430
+ - **Load via:** `find_and_load_device("mushrooms")`
431
+ - **What it does:** Draws mushroom shapes on oscilloscope via sin/cos circle generation, ellipses through unequal channel volumes, spirals through vertical movement. Width modulation shapes stems and heads. Includes rotation and bending controls.
432
+ - **Key parameters:** Stem width, head size, rotation, bending, channel volume ratio
433
+ - **Reach for this when:** you need organic mushroom-shaped oscilloscope visuals, or creative stereo-field synthesis
434
+
435
+ ---
436
+
437
+ ### Nyquist-Shannon 0.1
438
+
439
+ - **Type:** M4L Instrument
440
+ - **Load via:** `find_and_load_device("Nyquist-Shannon")`
441
+ - **What it does:** Educational tool demonstrating sampling rate, aliasing effects, and signal reconstruction on oscilloscope. Visualizes sine waves with sampling point indicators, includes phase shift control, demonstrates aliasing artifacts. Primarily instructional.
442
+ - **Key parameters:** Sampling rate, frequency, phase shift, reconstruction display
443
+ - **Reach for this when:** you need aliasing demonstration, sampling theory visualization, or educational oscilloscope content
444
+
445
+ ---
446
+
447
+ ### Oscilloscope 2.0
448
+
449
+ - **Type:** M4L Audio Effect
450
+ - **Load via:** `find_and_load_device("Oscilloscope 2.0")`
451
+ - **What it does:** Lissajous pattern oscilloscope visualization using stereo audio input. Routes left channel to horizontal deflection, right channel to vertical. Multiple drawing modes and color options. This is a visualizer/monitor, not a synthesizer -- put it at the end of a chain to see what your audio looks like on a scope.
452
+ - **Key parameters:** Drawing mode, color, persistence, zoom, trigger
453
+ - **Reach for this when:** you need to monitor oscilloscope patterns from other devices, visualize stereo audio as Lissajous figures, or verify XY output of other oscilloscope instruments
454
+
455
+ ---
456
+
457
+ ### radar 1.3
458
+
459
+ - **Type:** M4L Instrument
460
+ - **Load via:** `find_and_load_device("radar")`
461
+ - **What it does:** Versatile pattern generator for spirals, tunnels, radar screens, and percussion synthesis. Draws circles along lines forming spirals with phasing for direction/shape variation. Includes 3D rotation, bending, fading effects. Multiple trigger modes for varied sound synthesis. The most sonically useful oscilloscope instrument due to extensive preset library.
462
+ - **Key parameters:** Pattern type, spiral phase, 3D rotation, bending, fade, trigger mode, preset selection
463
+ - **Reach for this when:** you need versatile oscilloscope synthesis, radar/tunnel visuals, or percussion synthesis with visual feedback
464
+
465
+ ---
466
+
467
+ ### sincos 4001
468
+
469
+ - **Type:** M4L Instrument
470
+ - **Load via:** `find_and_load_device("sincos 4001")`
471
+ - **What it does:** Harmonic Lissajous pattern generator through additive synthesis. Creates circles with x=sin(t), y=cos(t) and combines up to 8 harmonic frequencies (each multiplied by harmonic number). Includes volume randomization, fine frequency control, and pattern animation. Produces the most complex and musically rich oscilloscope patterns.
472
+ - **Key parameters:** Harmonic count (up to 8), harmonic levels, fine frequency, volume randomization, animation speed
473
+ - **Reach for this when:** you need additive oscilloscope synthesis, complex Lissajous patterns, or harmonically rich visual-audio generation
474
+
475
+ ---
476
+
477
+ ## User M4L — Sonus Dept. Abstructs
478
+
479
+ > 12 Max for Live devices for abstract electronic music and sound art. All parameters automatable. Requires Live Suite 10.1.30+ or Standard with Max for Live. Price: 15 EUR.
480
+
481
+ ---
482
+
483
+ ### SpectroGlitch
484
+
485
+ - **Type:** M4L Audio Effect
486
+ - **Load via:** `find_and_load_device("SpectroGlitch")`
487
+ - **What it does:** Randomly suppresses or inverts the magnitude or phase of the incoming signal's spectrum. FFT-based destruction that operates on individual frequency bins, creating spectral holes, phase inversions, and unpredictable timbral mutations. The most immediately destructive spectral effect in the collection.
488
+ - **Key parameters:** Magnitude suppression probability, phase inversion probability, FFT size, randomization rate, mix
489
+ - **Reach for this when:** you need spectral destruction, random frequency-bin manipulation, glitchy timbral mutation, or unpredictable spectral effects
490
+ - **Pairs well with:** Reverb (smooth out the chaos), Compressor (tame transient spikes from phase inversion), Spectral Time (freeze then glitch)
491
+
492
+ ---
493
+
494
+ ### SpectroSynth
495
+
496
+ - **Type:** M4L Instrument
497
+ - **Load via:** `find_and_load_device("SpectroSynth")`
498
+ - **What it does:** Compact polyphonic synthesizer that creates sounds from a wide and complex spectral timbre. Generates dense spectral content ideal for rich atmospheres, drones, and evolving pads. Designed for abstract/ambient sound creation.
499
+ - **Key parameters:** Spectral complexity, timbre control, polyphony, envelope, filter, mix
500
+ - **Reach for this when:** you need dense spectral atmospheres, abstract polyphonic pads, or complex-timbre synthesis for ambient/experimental music
501
+
502
+ ---
503
+
504
+ ### BrokenDelays
505
+
506
+ - **Type:** M4L Audio Effect
507
+ - **Load via:** `find_and_load_device("BrokenDelays")`
508
+ - **What it does:** Delay effect featuring up to 16 delay lines that abruptly change their lengths and playback probability on rhythmic intervals. Creates never-repeating bizarre delay patterns from mundane audio input. Each delay line has independent chance-to-play, creating probabilistic rhythmic delay textures.
509
+ - **Key parameters:** Delay line count (up to 16), length range, change rate (rhythmic), probability per line, feedback, mix
510
+ - **Reach for this when:** you need chaotic multi-delay textures, probabilistic rhythmic delays, never-repeating echo patterns, or controlled delay-line randomization
511
+ - **Pairs well with:** SpectroGlitch (destroy then delay), Beat Repeat (stutter into broken delays), Filter (shape the chaotic output)
512
+
513
+ ---
514
+
515
+ ### Disturbances
516
+
517
+ - **Type:** M4L Audio Effect / Generator
518
+ - **Load via:** `find_and_load_device("Disturbances")`
519
+ - **What it does:** Generator of stutters and noise interference applied to incoming audio. Injects controlled disruptions -- buffer stutters, noise bursts, signal interruptions -- into the audio stream. Creates the sound of a malfunctioning system, broken transmission, or corrupted playback.
520
+ - **Key parameters:** Stutter rate, noise intensity, interference type, probability, mix
521
+ - **Reach for this when:** you need transmission-error aesthetics, controlled signal disruption, noise interference, or stutter generation layered onto existing audio
522
+ - **Pairs well with:** Lofi (Confetti), Redux, BrokenDelays (chain for maximum disruption)
523
+
524
+ ---
525
+
526
+ ### Other Abstructs Devices (brief reference)
527
+
528
+ - **AbstractSynth** (Instrument) → atmospheric polyphonic synth with dense evolving spectrum → drones, pads, atmospheres
529
+ - **BiShift** (Effect) → independent magnitude/phase spectrum shifting → strange pitch-shifting that separates spectral components
530
+ - **Essential** (Effect) → analyzes spectrum, returns only prominent features → spectral reduction, abstract spiraling textures with reverb
531
+ - **FromOuterSpace** (Instrument) → drone generator → sustained evolving drones
532
+ - **InfiniteTrain** (Generator) → pulse-train generator → abstract punctiform patterns for glitch/minimal music
533
+ - **MadHatter** (Instrument) → polyphonic hi-hat synth that doubles as unusual synthesizer → metallic textures, hi-hat synthesis
534
+ - **OneToMany** (Sampler) → 32-voice sample player with per-trigger parameter randomization → unpredictable variations from single sample
535
+ - **SineBursts** (Instrument) → high-pitched sounds, noises, and glitches → sine-based glitch generation
536
+
537
+ ---
538
+
539
+ ## User M4L — Altar of Wisdom
540
+
541
+ ---
542
+
543
+ ### GrainTable v0.6.1
544
+
545
+ - **Type:** M4L Instrument
546
+ - **Load via:** `find_and_load_device("GrainTable_AoW")`
547
+ - **What it does:** Recreates the Access Virus TI/TI2 graintable synthesis mode in Max for Live. Uses wavetable carrier modulated by slave wavetables with pulse-width compression for sync-like sounds. Historically significant in psytrance production. Supports up to 256 wavetable files per folder, drag-and-drop loading, and custom waveform drawing.
548
+ - **Key parameters:**
549
+ - **Slave Wavetable:** wavetable file/folder, wavetable size, wave number, note-dependent randomization, two alternating oscillators with independent pitch detuning
550
+ - **Carrier (AM):** waveform (Sine / Triangle / Saw up / Saw down / Custom), import/export custom waveforms, amplitude modulation depth
551
+ - **GrainTable Engine:** Pulse Width (PW) → compresses slave wavetable for sync-like effect; PW amplitude, interpolation, glide smoothing
552
+ - **Signal Processing:** ADSR envelope with velocity sensitivity, multimode multislope filter with cutoff randomization, waveshaper with S-curve saturation, output volume
553
+ - **Display:** real-time oscilloscope
554
+ - **Compatibility:** Live 10.1.41+, Live 11, Live 12; Max 8.1.5+
555
+ - **Reach for this when:** you need Virus-style graintable synthesis, wavetable-based psytrance leads, or complex modulated wavetable timbres
556
+
557
+ ---
558
+
559
+ ### AUTOGLITCH v1.1
560
+
561
+ - **Type:** M4L Audio Effect
562
+ - **Load via:** `find_and_load_device("AUTOGLITCH_AoW")`
563
+ - **What it does:** Random multi-effect glitch generator built around a step sequencer engine (borrowed from AutoPlay). The sequencer controls not just volume but an entire chain of effects. At its heart is a stutter engine that decomposes each step into up to 32 sub-glitches played forward or backward at up to 8x speed. After stuttering: repanning, bitcrush/downsample, pitch/frequency shifting (±48 semitones), comb filter, multimode filter, and a delayed feedback loop that can feed back into 3 different sections.
564
+ - **Key parameters:**
565
+ - **Step Sequencer:** step count, step length, random parameter section per step
566
+ - **Stutter Engine:** sub-glitch count (up to 32), direction (forward/backward), speed multiplier (up to 8x), stutter probability
567
+ - **Repan Section:** stereo repositioning per step
568
+ - **Bitcrush/Downsample:** bit depth, sample rate reduction
569
+ - **Pitch/Frequency Shifter:** ±48 semitones range
570
+ - **Comb Filter:** delay, feedback, frequency
571
+ - **Multimode Filter:** type, cutoff, resonance
572
+ - **Feedback Loop:** routes output back to 3 selectable insertion points
573
+ - **Loop Mode** (v1.3.2+): engine loops from 1/8th to 16 bars for repeatable stutter patterns
574
+ - **Compatibility:** Live 10.1.41+, Live 11, Live 12
575
+ - **Reach for this when:** you need automated multi-effect glitch sequences, complex stutter patterns with pitch/filter/bitcrush per step, or controllable chaos with repeatable loop option
576
+ - **Pairs well with:** AutoGrid (sequence the source), Beat Repeat (additional stutter layer), Reverb (smooth the chaos)
577
+
578
+ ---
579
+
580
+ ### AUTOGRID4 v1.8
581
+
582
+ - **Type:** M4L Audio Effect
583
+ - **Load via:** `find_and_load_device("AUTOGRID4_AoW")`
584
+ - **What it does:** Random grid pattern generator that creates stutter patterns from up to 4 incoming audio tracks mixed with the current track. Generates complex FM-style patterns, sequenced arpeggios, and basslines from multiple sources, ensuring sounds never overlap. Used by major psytrance artists (Tristan, Jumpstreet).
585
+ - **Key parameters:**
586
+ - **Input Sources:** up to 4 incoming tracks (AutoGrid8 variant handles 8)
587
+ - **Signal Levels:** per-source volume control
588
+ - **Occurrence Weight:** probability control per source sound
589
+ - **Time Allocation:** duration range from 1/32 to 8 bars including dotted and triplet notes
590
+ - **Min/Max Length:** per-note minimum and maximum duration
591
+ - **Mix Amount:** balance between current track and stutter output
592
+ - **Stutter Probability:** chance of inserting random silences
593
+ - **Ducking:** optional sidechain ducking of current track
594
+ - **Variants:** AutoGrid4 (4 inputs), AutoGrid8 (8 inputs), AutoGrid MIDI Edition (8 MIDI channels)
595
+ - **Compatibility:** Live 10.1.41+, Live 11, Live 12
596
+ - **Reach for this when:** you need multi-source grid stuttering, probabilistic pattern generation from multiple tracks, or psytrance-style grid sequencing
597
+
598
+ ---
599
+
600
+ ## User M4L — Other Experimental
601
+
602
+ ---
603
+
604
+ ### Grain Forest (Dillon Bastan / Isotonik)
605
+
606
+ - **Type:** M4L Audio Effect / Instrument
607
+ - **Load via:** `find_and_load_device("Grain Forest")`
608
+ - **What it does:** Granular synthesizer/effect driven by a simulated forest ecosystem. Each "tree" is an independent grain/voice with its own DNA that modulates playback and FX parameters. Trees cross-pollinate, mix DNA, and create new seeds with optional mutations, causing the sound to evolve organically over time. Supports up to 4 audio source mixes (Soil) that trees sample from.
609
+ - **Key parameters:**
610
+ - **Soil (Audio Sources):** up to 4 mixes from: direct audio input, routed track audio, dropped audio file (repitchable)
611
+ - **Forest Simulation:** tree count, DNA parameters per species (up to 4 species), pollination rate, mutation probability, generation speed
612
+ - **Grain Controls:** grain size, direction, pitch, position
613
+ - **FX Section:** multimode filter, delay, gain, pan per grain
614
+ - **Motion:** 2 LFOs with Perlin noise option for dynamic movement
615
+ - **Playback Modes:** Grain mode, Spectral mode, Time-based mode
616
+ - **Price:** $15+ USD
617
+ - **Compatibility:** Live 10+, Live 11, Live 12 with Max for Live
618
+ - **Reach for this when:** you need evolving granular textures that change over time without automation, nature-inspired generative processing, or multi-source granular with evolutionary behavior
619
+ - **Pairs well with:** Reverb (soften the granular edges), Spectral Resonator (resonate the grains), Compressor (tame evolving dynamics)
620
+
621
+ ---
622
+
623
+ ### Particle-Reverb 7.0 (Kentaro Suzuki)
624
+
625
+ - **Type:** M4L Audio Effect (also available as VST3/AU)
626
+ - **Load via:** `find_and_load_device("Particle-Reverb")`
627
+ - **What it does:** Granular network reverb built on 4 discrete granular units with distinct characteristics. Operates entirely in time-domain using granular synthesis (no FFT or conventional delay trains). Internal feedback logic tracks size and pitch adjustments with near-instantaneous response. Four units mapped to dual pitch-shift coordinates generate complex non-linear resonance. Includes 4 built-in modulator modules.
628
+ - **Key parameters:**
629
+ - **4 Granular Units:** each with independent size, pitch, density, character
630
+ - **Pitch Shift Coordinates:** dual-axis pitch mapping across units → non-linear resonance
631
+ - **Modulator Modules:**
632
+ - **mod-d3** → xyzw-axis controller (4D modulation)
633
+ - **mod-atrg** → slew-modulated trigger
634
+ - **lfo-morf** → compact dual-axis wavetable LFO
635
+ - **lfo-pnoise** → structured chaos LFO (Perlin noise)
636
+ - **Global:** size, feedback, mix, all parameters continuously modulatable
637
+ - **Price:** $60
638
+ - **Compatibility:** Live 10.1+, Live 11, Live 12; also VST3/AU for other DAWs; macOS 10.12+ (Universal), Windows 10+
639
+ - **Reach for this when:** you need granular reverb with non-linear resonance, pitch-shifted reverb networks, or heavily modulated spatial effects that go far beyond conventional reverb
640
+ - **Pairs well with:** Spectral Time (freeze into particle reverb), Grain Delay (granular chain), Auto Filter (shape the reverb tail)
641
+
642
+ ---
643
+
644
+ ### GrainFreeze 2.0 (Robert Henke / Monolake)
645
+
646
+ - **Type:** M4L Audio Effect
647
+ - **Load via:** `find_and_load_device("GrainFreeze")`
648
+ - **What it does:** Granular audio freezer that captures audio in real time and scrubs through the captured buffer using granular playback. Press "Ready" to capture a 3-second buffer, then manipulate position, grain size, and other parameters to create textures from rhythmic deconstruction to massive static sound smears. CPU-efficient, simple interface, hackable.
649
+ - **Key parameters:**
650
+ - **Ready** (toggle) → arm/capture audio buffer (3-second default)
651
+ - **Position** → scrub through captured buffer → automate for evolving textures
652
+ - **Grain Size** → size of playback grains → small = buzzy/granular, large = smooth/sustained
653
+ - **Pitch** → grain playback pitch
654
+ - **Density** → grain overlap/density
655
+ - **Mix** → dry/wet balance
656
+ - **Price:** Free (Creative Commons Attribution-ShareAlike)
657
+ - **Compatibility:** Live 8.1+, Max 5.1.8+ (works in all modern Live versions)
658
+ - **Reach for this when:** you need simple real-time granular freeze, textural sustain from any audio, or a lightweight granular buffer effect
659
+ - **Pairs well with:** Spectral Time (spectral freeze + granular freeze in series), Reverb (post-freeze wash), Auto Filter (movement on frozen textures)
660
+ - **vs Spectral Time Freeze:** GrainFreeze operates in time domain (grain buffer); Spectral Time freezes in frequency domain (FFT snapshot). GrainFreeze has position scrubbing; Spectral Time has per-frequency delay. Use both for different freeze characters.
661
+
662
+ ---
663
+
664
+ ## Quick Decision Matrix
665
+
666
+ | Need | First Choice | Why | Runner-Up |
667
+ |------|-------------|-----|-----------|
668
+ | **Spectral freeze / drone** | Spectral Time | FFT freeze with fade control, up to 8 stacked freezes | GrainFreeze (time-domain alternative) |
669
+ | **Per-frequency delay** | Spectral Time | Tilt, Spray, Mask give per-bin delay control | Grain Delay (time-domain granular delay) |
670
+ | **Pitched resonance from any audio** | Spectral Resonator | FFT partials with MIDI control, stretch, harmonics | Corpus (physical modeling resonance) |
671
+ | **Physical material resonance** | Corpus | 7 real object models, MIDI sidechain tuning | Spectral Resonator (digital/alien character) |
672
+ | **Granular texture** | Grain Delay | Simple, effective, built-in, automatable | Cloud (Confetti, FluCoMa decomposition) |
673
+ | **Evolving granular ecosystem** | Grain Forest | DNA/mutation system, multi-source, self-evolving | Particle-Reverb (granular network reverb) |
674
+ | **Glitch stutter (rhythmic)** | Beat Repeat | Beat-aligned capture, grid, chance, Insert mode | AUTOGLITCH (multi-effect stutter sequencer) |
675
+ | **Glitch stutter (multi-FX)** | AUTOGLITCH | 32 sub-glitches, pitch/filter/bitcrush per step | Beat Repeat (simpler, native) |
676
+ | **Multi-source grid stutter** | AUTOGRID4 | 4-track probabilistic pattern mixing | Beat Repeat + routing (manual approach) |
677
+ | **Spectral destruction** | SpectroGlitch | Random magnitude/phase suppression per bin | Grain Delay (high Spray + Random Pitch) |
678
+ | **Chaotic multi-delay** | BrokenDelays | 16 delay lines with probabilistic playback | Echo (feedback + modulation chaos) |
679
+ | **Signal disruption / noise** | Disturbances | Stutters + noise interference generator | Lofi (Confetti, codec artifacts) |
680
+ | **Waveset manipulation** | Chopper (Confetti) | Zero-crossing segmentation and resynthesis | Grain Delay (granular alternative) |
681
+ | **CD-skip glitch** | Skipper (Confetti) | Onset-triggered buffer skip, Discman models | Beat Repeat (similar stutter concept) |
682
+ | **Wavefolding distortion** | Wavefolder (Confetti) | Buchla/Aalto/Cold Mac algorithms | Saturator (simpler, native) |
683
+ | **Analog filter character** | Filter (Confetti) | MS-20, Moog, Sallen-Key topologies | Auto Filter (native, simpler) |
684
+ | **Whammy pitch glitch** | Pitch (Confetti) | PSOLA Whammy-style with dirty/random modes | Grain Delay (pitch parameter) |
685
+ | **Granular reverb** | Particle-Reverb | 4 granular units, non-linear resonance, 4D mod | Hybrid Reverb (native, convolution+algo) |
686
+ | **Granular buffer freeze** | GrainFreeze | Simple capture + scrub, CPU-light, free | Spectral Time (FFT freeze, more parameters) |
687
+ | **Virus graintable synth** | GrainTable | Virus TI2 graintable recreation, PW control | Wavetable (native, different character) |
688
+ | **Oscilloscope visuals** | sincos 4001 | 8 harmonics, most complex Lissajous patterns | radar (most versatile, extensive presets) |
689
+ | **Oscilloscope monitor** | Oscilloscope 2.0 | Visualizer for any stereo audio as XY scope | (put at end of chain) |
690
+ | **Dense spectral atmosphere** | SpectroSynth | Polyphonic, complex timbre, ideal for ambient | AbstractSynth (evolving spectrum) |
691
+ | **Onset-reactive delay** | Dub (Confetti) | Onset-triggered, dub snare + Karplus-Strong | Echo (native, character delay) |
692
+ | **Lo-fi degradation** | Lofi (Confetti) | Bit/sample rate + bitwise + MP3 compression | Redux (native, simpler) |
693
+
694
+ ---
695
+
696
+ ### Suggested Chains for Experimental Sound Design
697
+
698
+ **Spectral Drone Engine:**
699
+ Audio → Spectral Time (Freeze, Retrigger Sync 2 bars, Crossfade) → Spectral Resonator (long Decay, Wander mod, 4 Unison) → Hybrid Reverb (Shimmer algo) → Utility (Bass Mono)
700
+
701
+ **Glitch Destruction Chain:**
702
+ Audio → Beat Repeat (Grid 1/32, Variation 100%, Insert) → AUTOGLITCH (32 sub-glitches, feedback loop) → SpectroGlitch → BrokenDelays (8 lines) → Compressor (catch peaks)
703
+
704
+ **Granular Texture Stack:**
705
+ Audio → Grain Delay (high Freq, moderate Spray, +5 Pitch) → Grain Forest (4 species, high mutation) → Particle-Reverb (mod-d3 active) → EQ Eight (shape)
706
+
707
+ **Physical → Spectral Resonance:**
708
+ Noise/Click → Corpus (Plate, MIDI sidechain) → Spectral Resonator (MIDI, Granular mod) → Spectral Time (Delay, Tilt, Spray) → Reverb
709
+
710
+ **Lo-Fi Experimental:**
711
+ Audio → Lofi (Confetti, low bit depth) → Chopper (waveset resynthesis) → Skipper (CD skip) → Dirt (cubic distortion) → Filter (MS-20 LP, resonant) → Dub (onset delay)
712
+
713
+ **Oscilloscope Performance:**
714
+ MIDI → sincos 4001 (harmonics) → SpectroGlitch (subtle, 20% wet) → Grain Delay (shimmer) → Oscilloscope 2.0 (monitor)