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,525 @@
1
+ # Dynamics & Punch — Device Atlas
2
+
3
+ > Deep reference for every dynamics processor available in this Ableton Live 12 installation.
4
+ > Covers native devices, Creative Extensions M4L, Transient Machines pack, and user CLX_02 collection.
5
+
6
+ ---
7
+
8
+ ## Native Ableton Devices
9
+
10
+ ---
11
+
12
+ ### Compressor
13
+
14
+ - **Type:** Native
15
+ - **Load via:** `find_and_load_device("Compressor")`
16
+ - **What it does:** General-purpose dynamics processor that attenuates signals above a threshold. Extremely versatile — can be transparent glue or aggressive pumping depending on settings. Clean, digital character with no inherent coloration.
17
+ - **Signal flow:** Input -> Sidechain EQ (optional) -> Envelope Follower (Peak/RMS/Expand) -> Gain Reduction -> Makeup/Output -> Dry/Wet
18
+ - **Key parameters:**
19
+ - **Threshold** (-inf to 0 dB) -> where compression begins -> start at -20 dB for gentle, -10 dB for moderate
20
+ - **Ratio** (1:1 to inf:1) -> compression intensity -> 2:1-4:1 for bus glue, 6:1-10:1 for peak control, inf:1 for limiting
21
+ - **Attack** (0.01 ms to 1000 ms) -> how fast compression engages -> 0.1-1 ms for peak catching, 10-30 ms to let transients through, 50+ ms for transparent leveling
22
+ - **Release** (1 ms to 3000 ms + Auto) -> recovery time -> 50-100 ms for transparent, 25 ms for pumping, Auto for adaptive behavior
23
+ - **Knee** (0 dB to 36+ dB) -> compression gradient -> 0 dB = hard knee (aggressive), 6-10 dB for vocals, 36 dB for ultra-transparent
24
+ - **Output/Makeup** -> compensates for volume loss -> use Makeup button for auto-compensation
25
+ - **Lookahead** (0 ms, 1 ms, 10 ms) -> anticipates peaks -> 10 ms for true peak limiting, 0 ms for zero latency
26
+ - **Dry/Wet** (0-100%) -> parallel compression blend -> 30-50% for parallel on drums, 100% for insert
27
+ - **Mode:** Peak (reacts to short peaks, aggressive), RMS (averages level, more musical), Expand (upward expansion, ratio inverted e.g. 1:2)
28
+ - **Envelope:** Lin (linear) vs Log (logarithmic) -> Lin for fast transient response, Log for smoother behavior
29
+ - **Sidechain EQ:** low-shelf, peak, high-shelf, low-pass, band-pass, notch -> use HP sidechain at 80-100 Hz to prevent bass pumping
30
+ - **Presets:** Acoustic Guitar, Bass, Drums Bus, Kick, Mastering, Vocal, Slow Attack, Fast Attack, Limiter, NY Compression (parallel)
31
+ - **Reach for this when:** you need precise, surgical control over dynamics; sidechain pumping; transparent bus compression; any situation where you want maximum flexibility
32
+ - **Don't use when:** you want analog warmth/color (use Glue Compressor), you want a quick one-knob solution (use Drum Buss or Squeeze), you need multiband processing (use Multiband Dynamics)
33
+ - **Pairs well with:** Saturator before it for warmth, EQ Eight after for tonal shaping, Utility for gain staging
34
+ - **vs Glue Compressor:** Compressor is more flexible and clinical; Glue adds SSL-style analog character. Use Compressor for surgical control, Glue for musical bus processing.
35
+
36
+ ---
37
+
38
+ ### Glue Compressor
39
+
40
+ - **Type:** Native
41
+ - **Load via:** `find_and_load_device("Glue Compressor")`
42
+ - **What it does:** SSL 4000 G Bus Compressor emulation by Cytomic. Adds analog warmth, glues elements together on buses. Has inherent musical character — slightly rounds transients and adds subtle harmonic content. The "gel" compressor.
43
+ - **Signal flow:** Input -> Sidechain EQ (optional) -> VCA-style Compression -> Soft Clip (optional) -> Makeup -> Dry/Wet
44
+ - **Key parameters:**
45
+ - **Threshold** (-40 to 0 dB) -> where compression starts -> -20 to -15 dB for gentle bus glue, -30 dB for aggressive
46
+ - **Ratio** (2:1, 4:1, 10:1 — fixed steps, SSL-style) -> 2:1 for bus glue, 4:1 for moderate taming, 10:1 for aggressive limiting
47
+ - **Attack** (0.01, 0.1, 0.3, 1, 3, 10, 30 ms — fixed steps) -> 0.3 ms for punchy drums, 1-3 ms for bus, 10-30 ms for transparent
48
+ - **Release** (0.1, 0.2, 0.4, 0.6, 0.8, 1.2 s + Auto — fixed steps) -> 0.2-0.4 s for rhythmic pumping, Auto for adaptive, 0.1 s for aggressive
49
+ - **Range** (-40 to 0 dB) -> limits maximum gain reduction -> -6 dB for gentle bus (prevents over-compression), -3 dB for subtle glue
50
+ - **Makeup** (0 to +36 dB) -> volume compensation
51
+ - **Soft Clip** (on/off) -> analog-style waveshaping at -0.5 dB -> always ON for bus processing, adds subtle warmth
52
+ - **Dry/Wet** (0-100%) -> parallel compression -> 60-70% for parallel drum bus, 100% for insert
53
+ - **Sidechain:** external source + EQ (same filter types as Compressor)
54
+ - **Presets:** Bus Glue, Master Glue, Drum Bus, Parallel Drum, Bass Control
55
+ - **Reach for this when:** mixing buses (drum bus, music bus, master), you want elements to "gel" together, you need musical compression with character, drum group processing
56
+ - **Don't use when:** you need precise surgical control (use Compressor), you need per-band processing (use Multiband Dynamics), processing individual elements that need transparency
57
+ - **Pairs well with:** EQ Eight before for problem solving, Limiter after on master, Drum Buss before it on drum groups
58
+ - **vs Compressor:** Glue has fixed SSL-style attack/release/ratio steps (less flexible, more musical). Compressor has continuous ranges (more flexible, more clinical). Glue adds character; Compressor is transparent.
59
+ - **vs Drum Buss:** Glue is a pure compressor; Drum Buss combines saturation, transient shaping, and resonant bass. Use Glue for bus-level cohesion, Drum Buss for color and punch on drums.
60
+
61
+ ---
62
+
63
+ ### Limiter
64
+
65
+ - **Type:** Native
66
+ - **Load via:** `find_and_load_device("Limiter")`
67
+ - **What it does:** Brickwall limiter — no signal passes above the ceiling. Completely redesigned in Live 12.1 with True Peak, Soft Clip, and Maximize modes. The safety net. Ensures nothing clips, or pushes loudness when used as a maximizer.
68
+ - **Signal flow:** Input -> Gain -> Lookahead Peak Detection -> Gain Reduction -> Ceiling -> Output
69
+ - **Key parameters:**
70
+ - **Gain** -> boosts input level before limiting -> push into limiter for louder output, keep at 0 dB for safety limiting
71
+ - **Ceiling** -> maximum output level -> -1.0 dB for streaming (Spotify/YouTube standard), -0.3 dB for CD, 0 dB only for intermediate processing
72
+ - **Lookahead** (1.5 ms, 3 ms, 6 ms) -> anticipation time -> 6 ms for cleanest limiting (least distortion), 1.5 ms for minimal latency
73
+ - **Release** (0.01 ms to 3 s + Auto) -> recovery speed -> Auto for most situations, short for aggressive/pumping, long for transparent
74
+ - **Stereo Link:** Linked (both channels reduced equally, preserves stereo image) vs L/R (independent, can shift stereo image) vs Mid/Side (12.1+)
75
+ - **Mode (12.1+):** Standard (light limiting, open sound), True Peak (prevents inter-sample peaks, streaming-ready), Soft Clip (adds crunch/character, great for aggressive mixes)
76
+ - **Maximize (12.1+):** boosts output by amount of gain reduction -> single-knob loudness control via Threshold
77
+ - **Presets:** Mastering, Safety, Loudness, Streaming
78
+ - **Reach for this when:** final device on master chain, preventing clipping, maximizing loudness for delivery, safety limiting on live performance
79
+ - **Don't use when:** you want dynamics shaping (use Compressor), you want warmth (use Color Limiter or Glue Compressor), you need the sound to breathe
80
+ - **Pairs well with:** Compressor or Glue Compressor before it for dynamics shaping, EQ Eight before for final tonal balance, Utility before for gain staging
81
+ - **vs Color Limiter:** Limiter is clinical and transparent; Color Limiter adds saturation and harmonic character. Limiter for mastering precision, Color Limiter for lo-fi/vintage vibe.
82
+
83
+ ---
84
+
85
+ ### Gate
86
+
87
+ - **Type:** Native
88
+ - **Load via:** `find_and_load_device("Gate")`
89
+ - **What it does:** Noise gate that silences audio below a threshold. Cleans up recordings, shapes drum tails, creates rhythmic effects via sidechain. The "bouncer" — only lets loud enough signals through.
90
+ - **Signal flow:** Input -> Sidechain EQ (optional) -> Envelope Follower -> Gate Open/Close -> Floor Attenuation -> Output
91
+ - **Key parameters:**
92
+ - **Threshold** (-80 to 0 dB) -> level that opens the gate -> set just above noise floor, -40 to -30 dB for mic cleanup
93
+ - **Return/Hysteresis** -> dB difference between open and close thresholds -> prevents rapid open/close chattering, 2-6 dB typical
94
+ - **Attack** (0.01 to 100 ms) -> how fast gate opens -> 0.01-0.5 ms for drums (preserve transient), 5-10 ms for vocals (avoid clicks)
95
+ - **Hold** (0 to 500 ms) -> minimum open time -> 20-50 ms for drums, 100+ ms for vocals
96
+ - **Release** (1 to 1000 ms) -> how fast gate closes -> 20-50 ms for tight drums, 100-200 ms for natural vocal tails
97
+ - **Floor** (-inf to 0 dB) -> attenuation when closed -> -inf for complete silence, -20 to -10 dB for natural bleed reduction
98
+ - **Flip** (on/off) -> inverts behavior: gate closes above threshold -> creative tremolo/chopping effects
99
+ - **Lookahead** (0 to 10 ms) -> anticipates transients -> 1-5 ms to catch drum attacks cleanly
100
+ - **Sidechain EQ:** LP/HP/BP/Notch/Shelf filters -> HP at 5 kHz to trigger on hi-hats only, LP at 200 Hz to trigger on kicks only
101
+ - **Presets:** Drum Gate, Noise Reduction, Vocal Cleanup, Rhythmic Gate
102
+ - **Reach for this when:** cleaning drum bleed, gating noisy recordings, removing amp hum, creating rhythmic chopping effects via sidechain, tightening drum tails
103
+ - **Don't use when:** you need smooth dynamics control (use Compressor), the source has complex dynamics that need riding (use Gain Rider), you want creative envelope reshaping (use Re-Enveloper)
104
+ - **Pairs well with:** Compressor after for dynamics control, EQ Eight before to shape what the gate "hears", Corpus/Reverb after gated drums for big room sound
105
+ - **vs Re-Enveloper:** Gate is binary (open/close); Re-Enveloper reshapes the amplitude envelope continuously per frequency band. Gate for cleanup, Re-Enveloper for creative reshaping.
106
+
107
+ ---
108
+
109
+ ### Multiband Dynamics
110
+
111
+ - **Type:** Native
112
+ - **Load via:** `find_and_load_device("Multiband Dynamics")`
113
+ - **What it does:** Three-band dynamics processor that can independently compress, expand, or gate each frequency band. The Swiss Army knife of dynamics — can do OTT, multiband compression, frequency-selective gating, and upward/downward processing. Home of the legendary OTT preset.
114
+ - **Signal flow:** Input -> 3-Band Crossover -> Per-Band Above/Below Threshold Processing -> Per-Band Output Gain -> Output
115
+ - **Key parameters:**
116
+ - **Crossover Frequencies** (2 adjustable points) -> split into Low/Mid/High -> default ~120 Hz and ~2.5 kHz, adjust per material
117
+ - **Above Threshold** (per band) -> downward compression when signal is above -> ratio + threshold control
118
+ - **Below Threshold** (per band) -> upward compression when signal is below -> ratio + threshold control -> this is the OTT magic
119
+ - **Above Ratio** (1:1 to inf) -> downward compression intensity -> 3:1 for gentle, 10:1 for aggressive
120
+ - **Below Ratio** (1:1 to inf) -> upward compression intensity -> 2:1 for subtle detail enhancement, 10:1 for extreme OTT
121
+ - **Attack** (per band, 0.01 to 1000 ms) -> 10-30 ms for kicks, 1-5 ms for snares
122
+ - **Release** (per band, 1 to 3000 ms) -> 150-300 ms for drums, 500+ ms for pads
123
+ - **Soft Knee** (on/off) -> gradual compression onset
124
+ - **Peak/RMS** (per band) -> Peak for transient control, RMS for level averaging
125
+ - **Output Gain** (per band) -> post-processing level control
126
+ - **Time** scaling -> global multiplier for all attack/release times
127
+ - **Amount** -> global depth control for all dynamics processing
128
+ - **Presets:** OTT (extreme multiband upward+downward), Multiband Comp, Bass Tightener, De-Esser, Mastering
129
+ - **Reach for this when:** you need frequency-selective dynamics (tighten bass without affecting highs), OTT effect, de-essing, creative multiband squashing, mastering where specific bands need different treatment
130
+ - **Don't use when:** simple compression suffices (use Compressor), you want quick one-knob results (use Squeeze or Drum Buss), you need more than 3 bands (use PentaComp)
131
+ - **Pairs well with:** EQ Eight before for pre-shaping, Saturator after for warmth, Limiter after for final peak control
132
+ - **vs PentaComp:** Multiband Dynamics has 3 bands with upward+downward processing; PentaComp has 5 bands but only downward. Multiband Dynamics for creative OTT-style processing, PentaComp for transparent multiband mixing.
133
+ - **vs Squeeze:** Both do upward compression. Multiband Dynamics is surgical with per-band control. Squeeze is simpler and more extreme. Multiband Dynamics for precision, Squeeze for vibe.
134
+
135
+ ---
136
+
137
+ ### Drum Buss
138
+
139
+ - **Type:** Native
140
+ - **Load via:** `find_and_load_device("Drum Buss")`
141
+ - **What it does:** All-in-one drum processor combining compression, distortion, transient shaping, and low-end enhancement. Designed to add body, punch, and character to drum groups. The "instant drums sound better" device. Analog-modeled throughout.
142
+ - **Signal flow:** Input -> Trim -> Fixed Compressor (optional) -> Distortion (Soft/Medium/Hard) -> Drive -> Crunch (mid-high distortion) -> Damp (LP filter) -> Transients (above 100 Hz) -> Boom (resonant LP filter below 100 Hz) -> Dry/Wet -> Output
143
+ - **Key parameters:**
144
+ - **Trim** -> input level reduction -> use to prevent internal clipping on hot signals
145
+ - **Comp** (on/off) -> fixed compressor: fast attack, medium release, moderate ratio, ample makeup -> always try ON first for drum groups
146
+ - **Distortion Type:** Soft (waveshaping, subtle warmth), Medium (limiting distortion, moderate grit), Hard (clipping + bass boost, aggressive)
147
+ - **Drive** (0 to max) -> input drive into distortion -> 20-40% for warmth, 50-80% for crunch, 100% for destruction
148
+ - **Crunch** -> sine-shaped distortion on mid-high frequencies -> adds presence and bite to snares/hats -> 0-30% for subtle, 50%+ for aggressive
149
+ - **Damp** -> low-pass filter -> removes harsh high-frequency artifacts from distortion -> adjust to taste, lower = darker
150
+ - **Transients** (-100 to +100) -> emphasizes (positive) or de-emphasizes (negative) transients above 100 Hz -> +30-50 for punch, -20 for smoothing, 0 for neutral
151
+ - **Boom** -> resonant low-pass filter boost amount below 100 Hz -> adds sub-bass weight -> 20-40% for warmth, 60%+ for booming sub
152
+ - **Boom Freq** -> center frequency of low-end enhancer -> tune to track's key frequency
153
+ - **Force To Note** -> snaps Boom frequency to nearest MIDI note -> ensures low-end is tuned
154
+ - **Boom Decay** -> fade rate of low frequencies -> short for tight kick, long for rumble
155
+ - **Boom Audition** (headphone icon) -> solo the Boom signal to tune it
156
+ - **Dry/Wet** (0-100%) -> blend -> 30-50% for subtle enhancement, 100% for full processing
157
+ - **Output Gain** -> final level control
158
+ - **Presets:** Big Beat, Boom Box, Crunch, Lo-Fi, Punchy, Sub, Warm, Wide
159
+ - **Reach for this when:** processing drum groups or loops, you want instant punch and character, you need low-end enhancement on kicks, you want one device instead of a chain of compressor+saturator+transient shaper+EQ
160
+ - **Don't use when:** you need transparent compression (use Compressor), you're processing non-drum material (though it can work on bass and synths), you need precise per-parameter control (use dedicated devices)
161
+ - **Pairs well with:** Glue Compressor after for bus cohesion, EQ Eight after for surgical fixes, Reverb send for processed drum ambience
162
+ - **vs Compressor + Saturator chain:** Drum Buss is faster to dial in but less flexible. The dedicated chain gives more control. Use Drum Buss for "good enough fast", the chain for surgical mixing.
163
+
164
+ ---
165
+
166
+ ## Creative Extensions (M4L Stock)
167
+
168
+ ---
169
+
170
+ ### Color Limiter
171
+
172
+ - **Type:** M4L Stock (Creative Extensions pack — free with Live Suite)
173
+ - **Load via:** `find_and_load_device("Color Limiter")` or `search_browser("Color Limiter", category="Audio Effects")`
174
+ - **What it does:** Hardware-inspired limiter that adds saturation and harmonic coloration while limiting. Unlike the clean native Limiter, Color Limiter is designed to add grit, pressure, and vintage character. Think: tube limiter behavior in a digital box.
175
+ - **Signal flow:** Input -> Loudness (input gain) -> Lookahead Detection -> Ceiling Limiting + Saturation/Color Processing -> Release Recovery -> Output
176
+ - **Key parameters:**
177
+ - **Loudness** -> input amplification before limiting -> push harder for more color and compression
178
+ - **Ceiling** -> maximum output threshold -> same concept as Limiter but with colored limiting behavior
179
+ - **Lookahead** -> anticipation time for peak detection -> longer = cleaner, shorter = more character
180
+ - **Release** -> recovery time after limiting -> short for aggressive pumping, long for transparent
181
+ - **Saturation** -> amount of harmonic distortion -> 0% for clean limiting, 30-50% for warmth, 80%+ for aggressive crunch
182
+ - **Color** -> selects saturation type/character -> the "flavor" knob — experiment per source
183
+ - **Presets:** Various, explore the Creative Extensions presets
184
+ - **Reach for this when:** you want limiting WITH character, processing breaks and beats that need pressure, putting a vintage stamp on drum loops, lo-fi mastering, when the native Limiter sounds too clean
185
+ - **Don't use when:** you need transparent mastering (use Limiter), you need True Peak compliance (use Limiter in True Peak mode), you need precise metering
186
+ - **Pairs well with:** Drum Buss before for drum processing chains, EQ Eight after for tonal cleanup, Saturator before for stacking coloration
187
+ - **vs Limiter:** Limiter is surgical transparency; Color Limiter is musical coloration. Never use Color Limiter for final mastering delivery — use it for creative processing and intermediate bus limiting.
188
+
189
+ ---
190
+
191
+ ### Re-Enveloper
192
+
193
+ - **Type:** M4L Stock (Creative Extensions pack — free with Live Suite)
194
+ - **Load via:** `find_and_load_device("Re-Enveloper")` or `search_browser("Re-Enveloper", category="Audio Effects")`
195
+ - **What it does:** Multiband envelope reshaper. Splits audio into three adjustable frequency bands and lets you compress OR expand the amplitude envelope of each independently. Goes far beyond gating — it literally redraws the volume shape of the sound per frequency band. Can highlight transients, extend sustain, destroy dynamics, or surgically carve elements.
196
+ - **Signal flow:** Input -> 3-Band Frequency Split -> Per-Band Envelope Detection -> Per-Band C/E (Compression/Expansion) Processing -> Per-Band Gain -> Output
197
+ - **Key parameters:**
198
+ - **Crossover Frequencies** (2 points) -> split into Low/Mid/High bands
199
+ - **C/E Factor** (per band) -> Compression/Expansion control -> positive values = compress envelope (reduce dynamics), negative values = expand envelope (exaggerate dynamics)
200
+ - **Attack** (per band) -> envelope follower attack time
201
+ - **Release** (per band) -> envelope follower release time
202
+ - **Gain** (per band) -> output level per band
203
+ - **Sensitivity** -> how responsive the envelope follower is
204
+ - **Reach for this when:** you need to reshape transients per frequency band, cleaning up frequency-specific dynamics (e.g., tighten low-end sustain while keeping high-end snap), creative envelope destruction, making sustained sounds percussive or percussive sounds sustained
205
+ - **Don't use when:** you need standard compression ratios (use Compressor), you need simple gating (use Gate), the task is basic level control
206
+ - **Pairs well with:** Compressor after for overall dynamics control, Reverb before for creative envelope reshaping of ambience, Multiband Dynamics for combined approach
207
+ - **vs Gate:** Gate is binary on/off; Re-Enveloper continuously reshapes the envelope. Re-Enveloper for creative work, Gate for cleanup.
208
+ - **vs Multiband Dynamics:** Multiband Dynamics uses traditional threshold/ratio; Re-Enveloper uses envelope compression/expansion factor. Different mental models, complementary tools.
209
+
210
+ ---
211
+
212
+ ## Transient Machines Pack (M4L)
213
+
214
+ ---
215
+
216
+ ### Crack
217
+
218
+ - **Type:** M4L (Transient Machines pack by Surreal Machines)
219
+ - **Load via:** `find_and_load_device("Crack")` or `search_browser("Crack", category="Audio Effects")`
220
+ - **What it does:** Compact single-band transient shaper designed for individual sounds and loops. The "contrast dial for your sound" — makes transients pop or fade, and tails extend or shrink. Includes analog-modeled output processing (limiter, soft clip, maximizer) tuned specifically for transient material.
221
+ - **Signal flow:** Input -> Transient Detection -> Attack/Sustain Shaping -> Dry/Wet Mix -> Output Stage (Clipper/Limiter/Maximizer selectable)
222
+ - **Key parameters:**
223
+ - **Attack** -> transient emphasis/reduction -> positive = more punch, negative = softer
224
+ - **Sustain** -> tail emphasis/reduction -> positive = longer sustain, negative = tighter
225
+ - **Dry/Wet** -> blend processed with original
226
+ - **Output Mode:** Custom Limiter (peak reduction), Soft Clip (analog-modeled clipping), Maximizer (tuned for transients)
227
+ - **Reach for this when:** shaping individual drum hits, loop processing, adding punch to a single element, quick "more/less attack" adjustments
228
+ - **Don't use when:** you need multiband transient control (use Impact), you need frequency-specific processing (use Re-Enveloper), you need compression rather than transient shaping
229
+ - **Pairs well with:** EQ Eight before to focus source, Compressor after for overall dynamics, Drum Buss for combined character
230
+ - **vs Carver:** Crack is simpler (fewer controls, single-band). Carver has more features (curve types, sensitivity, M/S, distortion routing). Crack for quick utility, Carver for detailed sculpting.
231
+
232
+ ---
233
+
234
+ ### Impact
235
+
236
+ - **Type:** M4L (Transient Machines pack by Surreal Machines)
237
+ - **Load via:** `find_and_load_device("Impact")` or `search_browser("Impact", category="Audio Effects")`
238
+ - **What it does:** Multi-band drum processing channel strip combining up to 3 bands of transient shaping, 4-band EQ, 4 saturation types, and output processing (clipper/limiter/maximizer). The "big brother" of Crack — a complete drum dynamics workstation in one device.
239
+ - **Signal flow:** Input -> 1/2/3 Band Split -> Per-Band Attack + Sustain Shaping -> 4-Band EQ -> Saturation (4 types) -> Output Stage (Clipper/Limiter/Maximizer)
240
+ - **Key parameters:**
241
+ - **Band Count** (1, 2, or 3) -> independent frequency bands for transient processing
242
+ - **Attack** (per band) -> transient emphasis/reduction per frequency range
243
+ - **Sustain** (per band) -> tail control per frequency range
244
+ - **EQ** (4 bands) -> tonal shaping integrated into processing chain
245
+ - **Saturation Type** (4 analog-modeled styles) -> selectable harmonic character
246
+ - **Output Stage:** Clipper, Limiter, or Maximizer -> final peak management
247
+ - **Reach for this when:** processing drum groups that need frequency-specific transient control, you want a complete drum processing chain in one device, multiband transient shaping with integrated saturation and EQ
248
+ - **Don't use when:** processing simple single hits (use Crack), you need transparent compression (use Compressor), the processing chain is already complex and you need a single-purpose tool
249
+ - **Pairs well with:** Glue Compressor after for bus cohesion, Reverb send for processed ambience, Drum Buss for additional coloration (use sparingly — both are opinionated)
250
+ - **vs Drum Buss:** Impact is transient-focused with multiband precision; Drum Buss is saturation-focused with resonant bass enhancement. Impact for surgical drum work, Drum Buss for quick vibe.
251
+
252
+ ---
253
+
254
+ ## User M4L (CLX_02 Collection)
255
+
256
+ ---
257
+
258
+ ### doomCompressor_v1.0
259
+
260
+ - **Type:** M4L User (CLX_02) — by poulhoi
261
+ - **Load via:** `search_browser("doomCompressor", category="Audio Effects")`
262
+ - **What it does:** Extreme upward compressor inspired by Mick Gordon's DOOM soundtrack technique. Instead of reducing loud signals, it amplifies quiet ones to near 0 dBFS. Makes everything audible — even the faintest noise floor becomes as loud as the transients. Creates a hyper-compressed, "everything is at maximum volume" effect. Used for aggressive sound design, industrial textures, and extreme effects.
263
+ - **Signal flow:** Input -> Envelope Follower -> Compare to Threshold -> Calculate normalization factor -> Apply multiplication to bring signal to 0 dBFS -> Attack/Release Smoothing -> Output
264
+ - **Key parameters:**
265
+ - **Threshold** -> sets the level above which compression is calculated -> lower = more extreme, brings up more quiet detail
266
+ - **Attack** -> smoothing time for compression onset
267
+ - **Release** -> smoothing time for compression release
268
+ - **Reach for this when:** DOOM-style industrial sound design, extreme effect processing, making reverb tails and noise floors as loud as transients, aggressive experimental music, creating "wall of sound" textures
269
+ - **Don't use when:** you want musical compression (use Compressor), you want dynamics preservation (this destroys ALL dynamics), mixing or mastering conventional music
270
+ - **Pairs well with:** Reverb/Delay before (gets amplified dramatically), Saturator before (harmonics get pushed up), Limiter after (tame the chaos), EQ Eight after (surgical cleanup of amplified noise)
271
+ - **vs Raw Doom Compressor:** doomCompressor has adjustable attack/release (more control). Raw Doom Compressor has hard-coded timing but adds Floor and Output controls. doomCompressor for tweakability, Raw Doom for "set and destroy."
272
+ - **vs Squeeze:** Both do upward compression. Doom is extreme single-band normalization. Squeeze is multiband with more musical range. Doom for destruction, Squeeze for enhancement.
273
+
274
+ ---
275
+
276
+ ### RawDoomCompressor_v1.0.0
277
+
278
+ - **Type:** M4L User (CLX_02) — by geoffreyday
279
+ - **Load via:** `search_browser("RawDoomCompressor", category="Audio Effects")`
280
+ - **What it does:** Stripped-down DOOM compressor with hard-coded attack/release. Single-band extreme upward compressor designed as a building block for creating custom multiband doom compression chains. The raw, no-frills version.
281
+ - **Signal flow:** Input -> Hard-coded Envelope Detection -> Upward Normalization -> Floor Gate -> Output Level
282
+ - **Key parameters:**
283
+ - **Dynamics Removed** -> intensifies compression amount -> higher = more extreme, can introduce distortion (non-mappable by design)
284
+ - **Floor** (-200 dB to -30 dB) -> boost threshold -> signals below this are not amplified -> higher values create abrupt cutoff when source drops below threshold, effectively adding a gate
285
+ - **Output** (0 dB to -30 dB) -> output volume control -> essential for taming the extreme levels
286
+ - **Reach for this when:** building custom multiband doom compression chains (use multiple instances with band-splitting), sound design where you need the simplest doom compressor as a building block, quick extreme upward compression without fiddling with attack/release
287
+ - **Don't use when:** you need adjustable timing (use doomCompressor), you want musical compression, you need multiband in a single device (use Squeeze)
288
+ - **Pairs well with:** EQ Eight before for band-splitting into multiple instances, Limiter after, Saturator before for harmonics to amplify
289
+ - **vs doomCompressor:** Raw has hard-coded timing (less control, but "tested for optimal doom compression"). doomCompressor has adjustable attack/release. Raw is simpler and better as a chain building block.
290
+
291
+ ---
292
+
293
+ ### Carver 1.2
294
+
295
+ - **Type:** M4L User (CLX_02) — by Noir Labs
296
+ - **Load via:** `search_browser("Carver", category="Audio Effects")`
297
+ - **What it does:** Advanced transient shaper with the most accurate real-time transient detection on the market. Shapes attacks and sustain without changing perceived volume. Features three curve types, M/S processing, and the unique ability to apply distortion only to the transient or only to the body of the sound. Shows detected transient in real-time waveform display.
298
+ - **Signal flow:** Input -> Transient Detection (with Sensitivity control) -> Attack/Sustain Shaping (with Curve selection) -> Distortion (routable to full/transient/body) -> Input/Output Clipping (anti-aliased) -> Output
299
+ - **Key parameters:**
300
+ - **Attack** (-100 to +100) -> transient emphasis/reduction -> +50 for punchy drums, -30 for softer, smoother attacks
301
+ - **Attack Length** (slider) -> defines how long the "transient" portion lasts -> short for snappy, long for more of the initial hit
302
+ - **Sustain** (-100 to +100) -> tail emphasis/reduction -> +30 for fuller sound, -50 for tighter, gated feel
303
+ - **Sustain Length** (slider) -> defines sustain window duration
304
+ - **Presence** -> transient-driven high-frequency boost -> adds air and sparkle without static EQ
305
+ - **Sensitivity** (0-100) -> detection sensitivity -> 100 captures even the quietest transients, lower values only process louder hits
306
+ - **Curve Type:** Natural (smooth, transparent), Punchy (aggressive, more impact), Classic (traditional transient shaper behavior)
307
+ - **Processing Mode:** Stereo, Mid/Side, Mid only, Side only
308
+ - **Distortion Routing:** Full signal, Transient only, Body only -> unique creative control
309
+ - **Reach for this when:** detailed transient sculpting with visual feedback, M/S transient processing, adding punch without volume change, applying distortion only to attack portion, precise drum and loop shaping
310
+ - **Don't use when:** you need multiband transient control (use Impact), you want compression rather than transient shaping, simple one-knob processing (use Crack or Drum Buss transient knob)
311
+ - **Pairs well with:** Compressor after for dynamics control, EQ Eight for tonal shaping, Reverb (transient-shape before reverb for cleaner tails)
312
+ - **vs Crack:** Carver has curves, sensitivity, M/S, presence, distortion routing — much more detailed. Crack is simpler and faster. Carver for surgical work, Crack for utility.
313
+ - **vs Impact:** Impact is multiband with integrated EQ/saturation. Carver is single-band but with more transient detection options and distortion routing. Impact for drum buses, Carver for individual elements.
314
+
315
+ ---
316
+
317
+ ### Gain Rider
318
+
319
+ - **Type:** M4L User (CLX_02) — by John Darque
320
+ - **Load via:** `search_browser("Gain Rider", category="Audio Effects")`
321
+ - **What it does:** Automatic gain riding plugin that continuously adjusts volume to maintain a target level. Like having an assistant moving the fader in real-time. Unlike compression, it uses slower, more natural-sounding level adjustment — no attack/release artifacts, no transient modification. Just smooth, consistent level.
322
+ - **Signal flow:** Input -> Level Detection (LUFS or Peak) -> Calculate Compensation -> Apply Gain Adjustment -> Output
323
+ - **Key parameters:**
324
+ - **Target** -> desired output level to ride toward
325
+ - **Range** (6 dB to 24 dB) -> maximum gain adjustment range -> ±3 dB at 6 dB setting, ±12 dB at 24 dB -> start with 6-12 dB
326
+ - **Threshold** -> ignore signals below this level (fader returns to 0 dB) -> prevents riding up noise floor during silence
327
+ - **Speed** (ms) -> time to reach compensated values -> slow for transparent riding, fast for tighter control
328
+ - **Mode:** LUFS (perceptual loudness, recommended for most uses) vs Peak (signal peaks)
329
+ - **Rider Fader** -> visual feedback of current gain adjustment
330
+ - **Reach for this when:** vocal level consistency without compression artifacts, maintaining consistent dialog levels, smoothing out dynamic performances, gain staging before compression (even out levels first, then compress), any source with wide dynamic range that needs transparent leveling
331
+ - **Don't use when:** you need fast transient control (use Compressor), you want coloration/character (use Glue Compressor), the source is already consistent
332
+ - **Pairs well with:** Compressor after (Gain Rider first for leveling, then gentle compression for character), EQ Eight before for tonal prep, De-esser after for vocals
333
+ - **vs Compressor:** Gain Rider moves the fader slowly and naturally — no transient modification, no pumping, no artifacts. Compressor shapes dynamics faster but introduces its own character. Use Gain Rider BEFORE Compressor for best results on vocals.
334
+
335
+ ---
336
+
337
+ ### GMaudio Ducker 1.2
338
+
339
+ - **Type:** M4L User (CLX_02) — by Groov Mekanik / Fixation Studios
340
+ - **Load via:** `search_browser("GMaudio Ducker", category="Audio Effects")`
341
+ - **What it does:** Sample-accurate sidechain ducking tool specifically designed for bass/kick interaction. Uses transient detection (not traditional sidechain compression) to trigger an envelope that ducks bass during kick hits. Completely mutes bass during the kick transient for maximum clarity, then crossfades back. The precision tool for low-end management.
342
+ - **Signal flow:** Input (Bass) -> Transient Detection (from Kick via sidechain or self) -> Envelope Generation -> Volume Duck with Adjustable Curve -> Release Crossfade -> Output
343
+ - **Key parameters:**
344
+ - **Attack Curve** -> fixed by design to prevent pops/clicks
345
+ - **Release Curve** -> adjustable from logarithmic to exponential -> logarithmic for smooth bass return, exponential for tighter/snappier transitions
346
+ - **Hold** -> duration of bass muting during kick transient
347
+ - **Invert Signal** -> flips polarity of bass signal
348
+ - **Scope** -> visual display with freeze, zoom, position controls
349
+ - **Absolute Envelope Mode** -> visualizes combined envelope of both signals
350
+ - **Reach for this when:** kick/bass separation is the #1 problem, you need sample-accurate ducking (standard sidechain compression is too sloppy), the low end needs to be pristine and clear, electronic music with prominent kick and bass
351
+ - **Don't use when:** you need general sidechain compression (use Compressor sidechain), the bass and kick don't compete (no need), you want the pumping character of sidechain compression (Ducker is transparent)
352
+ - **Pairs well with:** EQ Eight on kick/bass for pre-shaping, Compressor on bass for additional dynamics, Glue Compressor on the combined bus after
353
+ - **Note:** Does not work nested inside Drum Racks (Ableton API limitation). Place on a regular track.
354
+ - **vs Compressor sidechain:** Ducker uses transient detection for sample-accurate timing. Compressor sidechain has inherent attack/release lag. Ducker for surgical precision, Compressor sidechain for musical pumping.
355
+
356
+ ---
357
+
358
+ ### GMaudio PentaComp 1.0
359
+
360
+ - **Type:** M4L User (CLX_02) — by Groov Mekanik / Fixation Studios
361
+ - **Load via:** `search_browser("GMaudio PentaComp", category="Audio Effects")`
362
+ - **What it does:** 5-band adaptive multiband compressor with 24 dB Linkwitz-Riley crossover network. Program-dependent algorithm automatically adjusts attack/release based on signal dynamics. Designed for transparent gain reduction across the full frequency spectrum. The precision multiband tool for mixing and mastering.
363
+ - **Signal flow:** Input -> 5-Band Linkwitz-Riley Crossover (160 Hz, 800 Hz, 4 kHz, 11 kHz) -> Per-Band Program-Dependent Compression -> Per-Band Output Gain -> Sum -> Output
364
+ - **Key parameters:**
365
+ - **Input/Output** (linked control available) -> global gain staging
366
+ - **Ratio** (per band) -> compression intensity per frequency range
367
+ - **Speed Multiply** -> scales program-dependent attack/release -> lower = faster response, higher = slower/smoother
368
+ - **Peak/RMS** -> detection method -> Peak for transient control, RMS for level averaging
369
+ - **Band Linking** -> reduces phase artifacts between bands
370
+ - **Stereo Linking** -> reduces stereo image steering from unequal compression
371
+ - **Knee** -> 10 dB fixed soft knee on all bands -> always smooth, never harsh
372
+ - **Metering:** green = input, red = gain reduction (simplified to save CPU)
373
+ - **Reach for this when:** multiband compression for mixing buses and mastering, you need more than 3 bands (vs Multiband Dynamics), transparent frequency balancing, taming resonances across the spectrum, demo mastering
374
+ - **Don't use when:** you need upward compression (use Squeeze or Multiband Dynamics), you need extreme OTT-style processing (use Multiband Dynamics), you need parallel processing (v1 limitation, v2 will fix)
375
+ - **Pairs well with:** EQ Eight before for surgical fixes, Limiter after for final peak control, Glue Compressor before for bus glue then PentaComp for frequency balance
376
+ - **vs Multiband Dynamics:** PentaComp has 5 bands (vs 3), Linkwitz-Riley crossovers (cleaner), program-dependent timing (less tweaking), but lacks upward compression. Multiband Dynamics has OTT/upward compression but only 3 bands with simpler crossovers. PentaComp for transparent mixing, Multiband Dynamics for creative processing.
377
+
378
+ ---
379
+
380
+ ### GMaudio Squeeze 1.1
381
+
382
+ - **Type:** M4L User (CLX_02) — by Groov Mekanik / Fixation Studios
383
+ - **Load via:** `search_browser("GMaudio Squeeze", category="Audio Effects")`
384
+ - **What it does:** Multiband upward compressor/limiter. Normalizes audio by dividing incoming signals by detected peak levels. Ranges from subtle loudness enhancement to complete sonic destruction. Uses 6 dB dynamic phase crossovers for in-phase parallel processing. The "detail enhancer" — reveals hidden textures and micro-dynamics in any source.
385
+ - **Signal flow:** Input -> 3-Band Split (6 dB crossovers at 300 Hz and 5 kHz) -> Per-Band Peak Detection -> Per-Band Upward Normalization (Floor to Ceiling) -> Style blending (single vs multiband) -> Mix (dry/wet) -> Output
386
+ - **Key parameters:**
387
+ - **Floor** -> threshold below which signals are not processed -> prevents amplifying silence/noise -> set above noise floor
388
+ - **Squeeze** -> amount of upward compression (ratio equivalent) -> 0 = none, max = extreme squashing
389
+ - **Ceiling** -> target normalization level -> signals are pushed toward this level
390
+ - **Style** -> morphs between single-band and multiband operation -> single-band for uniform processing, multiband for frequency-aware enhancement
391
+ - **Time** -> compression window/release -> high = normalization (smooth), low = extreme upward compression (sausage)
392
+ - **Mix** (0-100%) -> dry/wet blend -> 20-40% for subtle enhancement, 50-70% for obvious effect, 100% for destruction
393
+ - **Reach for this when:** revealing hidden details in sounds, enhancing time-based effects (reverb tails, delay feedback), sound design exploration, making virtual analog synths sound more alive, adding loudness and presence without traditional compression, DOOM-style processing but more controllable
394
+ - **Don't use when:** you need transparent level control (use Compressor), the source is already loud and dense, you want to preserve dynamics (this specifically destroys them in a controlled way)
395
+ - **Pairs well with:** Saturator/Distortion before (harmonics get amplified), Reverb/Delay before (tails become huge), Limiter or Clipper after (tame the output), should be LAST in the effects chain before limiting
396
+ - **vs Multiband Dynamics (OTT):** Both do multiband upward compression. Squeeze is simpler (6 controls vs many) and has in-phase crossovers for better parallel processing. OTT has per-band control and downward compression too. Squeeze for quick vibe, OTT for detailed control.
397
+ - **vs doomCompressor:** Both amplify quiet signals. Squeeze is multiband and more controllable. Doom is single-band and more extreme. Squeeze for musical enhancement, Doom for destruction.
398
+
399
+ ---
400
+
401
+ ### jL3v3ll3r v1.2
402
+
403
+ - **Type:** M4L User (CLX_02) — by jaspermarsalis (based on Dan Worrall's L3V3LL3R)
404
+ - **Load via:** `search_browser("jL3v3ll3r", category="Audio Effects")`
405
+ - **What it does:** Recreation of a rare 1960s "Leveller" compressor. A leveling amplifier that works nearly all the time — not just when a threshold is reached. Offers two distinct response curves: logarithmic (standard) and opto/vactrol (photo-resistor simulation). Produces smooth, musical compression with vintage character. The "always-on, always-smoothing" compressor.
406
+ - **Signal flow:** Input -> Highpass Filter (optional) -> Level Detection -> Response Curve (Log or Opto) -> Gain Reduction -> Output
407
+ - **Key parameters:**
408
+ - **Compression Amount** -> how much leveling is applied
409
+ - **Response Curve:** Logarithmic (standard mathematical compression, predictable) vs Opto/Vactrol (simulates photo-resistor behavior with nonlinear, program-dependent response — slower release on sustained signals, faster on transients)
410
+ - **Highpass Filter** -> removes low frequencies from detection path -> prevents bass from triggering excessive compression (similar to sidechain HP on other compressors)
411
+ - **Mode I** -> standard stereo compression
412
+ - **Mode II** -> routes left channel into right channel (creative/experimental)
413
+ - **Reach for this when:** you want smooth, vintage-style leveling on vocals, bass, or full mixes; you want opto-style compression character; subtle "always-on" dynamics smoothing; the source needs to be evened out without aggressive pumping
414
+ - **Don't use when:** you need fast transient control (use Compressor with fast attack), you need precise ratio/threshold control (use Compressor), you need multiband processing
415
+ - **Pairs well with:** EQ Eight before for tonal prep, Compressor after for additional shaping, Gain Rider before for pre-leveling, Reverb after for vintage vocal chain
416
+ - **vs Compressor (RMS mode):** jL3v3ll3r is always compressing (leveling amplifier behavior) and has vintage character. Compressor only engages above threshold. jL3v3ll3r for vintage vibe, Compressor for precision.
417
+ - **vs LA2A:** Both are opto-style compressors. jL3v3ll3r is a native M4L implementation; LA2A is a wrapper for an external VST. jL3v3ll3r is simpler and more reliable.
418
+
419
+ ---
420
+
421
+ ### LA2A
422
+
423
+ - **Type:** M4L User (CLX_02) — by OspreyInstruments
424
+ - **Load via:** `search_browser("LA2A", category="Audio Effects")`
425
+ - **What it does:** M4L wrapper for the BPB Dirty LA optical compressor VST3 plugin. Emulates the classic Teletronix LA-2A leveling amplifier with its program-dependent opto compression behavior. Includes an approximate VU meter with realistic ballistics and deliberate harmonic distortion. Requires the free BPB Dirty LA plugin to be installed separately.
426
+ - **Signal flow:** Input -> BPB Dirty LA VST3 (opto compression + tube saturation) -> Approximate VU Metering -> Output
427
+ - **Key parameters:**
428
+ - **Gain** -> output level / makeup gain (like the original LA-2A)
429
+ - **Peak Reduction** -> compression amount (like the original LA-2A)
430
+ - **Compress/Limit** mode switch -> Compress for gentle leveling, Limit for more aggressive peak control
431
+ - **VU Meter** -> approximate, not scientifically precise — use as rough guide only
432
+ - **Reach for this when:** you specifically want LA-2A character (smooth opto compression with tube warmth), vocal processing that needs that "classic" sound, bass leveling with harmonic enhancement
433
+ - **Don't use when:** you don't have BPB Dirty LA installed (will not work), you need precise metering (VU is approximate), you need reliable cross-platform behavior (tested primarily on Mac)
434
+ - **Pairs well with:** EQ Eight before for pre-compression tonal shaping, Compressor after for additional peak control (LA-2A first for leveling, then surgical compression), De-esser before for vocals
435
+ - **vs jL3v3ll3r:** Both are opto-style compressors. LA2A requires external VST dependency; jL3v3ll3r is self-contained. LA2A has tube saturation character from the VST; jL3v3ll3r is cleaner. Use jL3v3ll3r for reliability, LA2A for the specific Dirty LA sound.
436
+ - **IMPORTANT:** Requires BPB Dirty LA VST3 installed from bedroomproducersblog.com. Mac-tested only.
437
+
438
+ ---
439
+
440
+ ### N-CLIP
441
+
442
+ - **Type:** M4L User (CLX_02) — by Nasko
443
+ - **Load via:** `search_browser("N-CLIP", category="Audio Effects")`
444
+ - **What it does:** Lightweight variable soft clipper with adjustable ceiling. Shaves off transient peaks using soft clipping rather than limiting — faster than a limiter, more transparent on transients, adds subtle harmonic content. The "invisible loudness" tool that lets you clip peaks before they hit a limiter, reducing the limiter's workload and preserving transient punch.
445
+ - **Signal flow:** Input -> Drive -> Soft Clipping at Ceiling Threshold (variable knee) -> Output
446
+ - **Key parameters:**
447
+ - **Ceiling/Threshold** (+6 dB to -inf dB) -> sets the clipping point -> -1 to -0.5 dB for mastering chain before limiter, -3 dB for more aggressive clipping
448
+ - **Soft Knee** (adjustable) -> controls how gradually clipping engages -> soft for transparent, hard for more aggressive harmonic content
449
+ - **Drive** (-32 dB to +32 dB, bipolar) -> input gain before clipping -> positive for louder into clipper, negative for gentler clipping
450
+ - **Reach for this when:** pre-limiter clipping to reduce limiter workload, getting extra loudness without limiter pumping, taming drum transients transparently (clipping is faster than limiting), mixing into a clipper for "hot" mixes
451
+ - **Don't use when:** you need True Peak compliance (clipping can create inter-sample peaks), you want completely clean/transparent processing, the source has no transient peaks to clip
452
+ - **Pairs well with:** Limiter after (clip peaks first, then limit — less work for the limiter = cleaner result), Compressor before for dynamics shaping, Drum Buss before for combined processing
453
+ - **vs Limiter:** Clipper is instantaneous (zero attack); Limiter has lookahead and shaped release. Clipper adds harmonics; Limiter is transparent. Use clipper BEFORE limiter in mastering chain for best results.
454
+ - **vs Color Limiter:** Both add harmonic character. N-CLIP is a pure clipper; Color Limiter is a full limiter with saturation. N-CLIP for transparent peak shaving, Color Limiter for characterful limiting.
455
+
456
+ ---
457
+
458
+ ### Thomash Amplitude Receiver/Sender
459
+
460
+ - **Type:** M4L User (CLX_02) — by voodoohop (thomash)
461
+ - **Load via:** `search_browser("Thomash Amplitude", category="Audio Effects")` (load both Sender and Receiver)
462
+ - **What it does:** Two-device system that preserves the original amplitude envelope across an effects chain. The Sender captures the volume at one point; the Receiver (placed downstream after effects) adjusts gain to match the original level. Eliminates volume changes caused by effects — you can process audio through filters, delays, and EQs while maintaining the original dynamics. Like having an automatic "undo" for volume changes from effects.
463
+ - **Signal flow:** [Sender captures level] -> Effects Chain (any number of effects) -> [Receiver restores original level with 512-sample latency]
464
+ - **Key parameters:**
465
+ - **Channel ID** (both devices) -> must match between Sender and Receiver pairs -> unique per instance
466
+ - **Latency:** Fixed 512 samples — the Receiver anticipates by receiving events 512 samples early
467
+ - **Reach for this when:** you want to apply heavy EQ/filter processing without volume changes, maintaining vocal dynamics through a complex effects chain, ensuring reverb/delay effects don't change the overall level, any time you want "the effect but not the volume change"
468
+ - **Don't use when:** you WANT the volume changes from effects (most of the time, level changes are part of the effect's character), the 512-sample latency is unacceptable, you need to use it with other M4L devices in the chain (only works reliably with native Ableton effects)
469
+ - **Pairs well with:** Any native Ableton effects between the Sender and Receiver — EQ Eight, Auto Filter, delays, reverbs
470
+ - **IMPORTANT:** Only works with native Ableton effects. Does NOT work reliably with other M4L devices in between. Requires unique Channel IDs when using multiple instances.
471
+
472
+ ---
473
+
474
+ ## Quick Decision Matrix
475
+
476
+ | Scenario | First Choice | Why | Second Choice |
477
+ |---|---|---|---|
478
+ | **Bus glue (drums, music, master)** | Glue Compressor | SSL character, musical fixed steps, Soft Clip | Compressor (Dry/Wet for parallel) |
479
+ | **Surgical single-track compression** | Compressor | Maximum flexibility, all modes | jL3v3ll3r (if vintage leveling wanted) |
480
+ | **Drum group instant punch** | Drum Buss | All-in-one: comp + saturation + transients + boom | Impact (if multiband transient control needed) |
481
+ | **Transient shaping (single element)** | Carver 1.2 | Precise detection, curves, M/S, distortion routing | Crack (simpler, faster) |
482
+ | **Transient shaping (drum bus)** | Impact | Multiband, EQ, saturation, output stage | Drum Buss (simpler, more coloration) |
483
+ | **Kick/bass separation** | GMaudio Ducker | Sample-accurate ducking, purpose-built | Compressor sidechain (if pumping character wanted) |
484
+ | **Multiband compression (mixing)** | PentaComp | 5 bands, Linkwitz-Riley, program-dependent | Multiband Dynamics (if 3 bands sufficient) |
485
+ | **Multiband compression (creative/OTT)** | Multiband Dynamics | OTT preset, upward+downward, per-band control | Squeeze (simpler, more extreme) |
486
+ | **Upward compression (detail reveal)** | GMaudio Squeeze | Multiband, controllable, musical range | Multiband Dynamics Below threshold |
487
+ | **Extreme upward compression (destruction)** | doomCompressor | Infinite upward ratio, adjustable timing | RawDoomCompressor (simpler, hard-coded) |
488
+ | **Vocal leveling (transparent)** | Gain Rider | No transient artifacts, LUFS mode, natural | jL3v3ll3r (if vintage character wanted) |
489
+ | **Vintage opto compression** | jL3v3ll3r | Self-contained, vactrol curve, reliable | LA2A (if BPB Dirty LA installed, tube character) |
490
+ | **Pre-limiter peak clipping** | N-CLIP | Fast, transparent, adjustable knee | Color Limiter (if saturation character wanted) |
491
+ | **Mastering limiter (transparent)** | Limiter | True Peak, Maximize, clinical precision | Glue Compressor -> Limiter chain |
492
+ | **Mastering limiter (colored)** | Color Limiter | Saturation + Color parameters, vintage vibe | Limiter in Soft Clip mode (12.1+) |
493
+ | **Noise/bleed cleanup** | Gate | Purpose-built, sidechain EQ, Flip mode | Re-Enveloper (if frequency-selective needed) |
494
+ | **Envelope reshaping (creative)** | Re-Enveloper | Multiband C/E factor, beyond gating | Multiband Dynamics (if ratio-based control preferred) |
495
+ | **Preserve dynamics through FX chain** | Thomash Amplitude Sender/Receiver | Automatic level restoration, 512-sample latency | Utility (manual gain compensation) |
496
+ | **Sidechain pumping (musical)** | Compressor (sidechain) | Classic pump, adjustable attack/release/ratio | Glue Compressor sidechain (SSL pump character) |
497
+ | **Loudness maximizing** | Limiter (Maximize mode) | Single-knob loudness, True Peak safe | N-CLIP -> Limiter chain (clip then limit) |
498
+
499
+ ---
500
+
501
+ ## Signal Chain Recipes
502
+
503
+ **Clean Mastering Chain:**
504
+ EQ Eight -> Glue Compressor (gentle bus glue) -> N-CLIP (peak shaving) -> Limiter (True Peak, Ceiling -1 dB)
505
+
506
+ **Aggressive Drum Bus:**
507
+ Drum Buss (Comp ON, Medium distortion, Transients +40, Boom 30%) -> Glue Compressor (4:1, Soft Clip ON)
508
+
509
+ **Vocal Chain (Natural):**
510
+ Gain Rider (LUFS, 12 dB range) -> Compressor (RMS, 3:1, 10 ms attack, 50 ms release) -> EQ Eight
511
+
512
+ **Vocal Chain (Vintage):**
513
+ jL3v3ll3r (Opto mode) -> Compressor (gentle 2:1) -> Color Limiter (subtle Saturation)
514
+
515
+ **Sound Design (Extreme):**
516
+ Reverb -> doomCompressor -> Saturator -> Limiter
517
+
518
+ **Electronic Low-End (Kick + Bass):**
519
+ GMaudio Ducker on Bass track (sidechained to Kick) -> Compressor on Bass -> Glue Compressor on Low-End Bus
520
+
521
+ **Detail Enhancement:**
522
+ GMaudio Squeeze (Style multiband, Squeeze 50%, Time medium, Mix 30-50%) -> Limiter
523
+
524
+ **Drum Transient Sculpting:**
525
+ Carver (Punchy curve, Attack +50, Sensitivity 80) -> Compressor (fast attack to catch shaped transients) -> N-CLIP