livepilot 1.9.23 → 1.10.0

package/mcp_server/atlas/enrichments/audio_effects/chorus_ensemble.yaml

@@ -0,0 +1,149 @@
+id: chorus_ensemble
+name: Chorus-Ensemble
+sonic_description: >
+  Classic chorus and ensemble effect that thickens sound by layering modulated copies
+  of the input. Three modes — Classic (standard chorus), Ensemble (multi-voice shimmer),
+  and Vibrato (pitch modulation without dry signal). Adds stereo width, depth, and
+  warmth to any source.
+effect_type: modulation
+character_tags: [lush, thick, wide, warm, shimmering]
+use_cases: [thickening, stereo_width, vocal_doubling, synth_lush, guitar_chorus]
+genre_affinity:
+  primary: [pop, indie, shoegaze, new_wave]
+  secondary: [electronic, ambient, jazz, rock]
+complexity: beginner
+signal_type: audio
+introduced_in: "11.0"
+
+key_parameters:
+  - name: "Mode"
+    description: "Chorus algorithm — Classic, Ensemble, or Vibrato"
+    range: ["Classic", "Ensemble", "Vibrato"]
+    type: enum
+    sweet_spots:
+      standard: "Classic"
+      lush: "Ensemble"
+      pitch_mod: "Vibrato"
+
+  - name: "Rate 1"
+    description: "Speed of the primary modulation LFO"
+    range: [0.01, 20.0]
+    unit: Hz
+    type: float
+    sweet_spots:
+      slow: 0.3
+      moderate: 1.0
+      fast: 4.0
+
+  - name: "Rate 2"
+    description: "Speed of the secondary modulation LFO — creates complex movement"
+    range: [0.01, 20.0]
+    unit: Hz
+    type: float
+    sweet_spots:
+      slow: 0.5
+      moderate: 1.5
+      fast: 5.0
+
+  - name: "Amount 1"
+    description: "Depth of the primary modulation"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      subtle: 15.0
+      moderate: 35.0
+      deep: 60.0
+
+  - name: "Amount 2"
+    description: "Depth of the secondary modulation"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      subtle: 10.0
+      moderate: 25.0
+      deep: 50.0
+
+  - name: "Feedback"
+    description: "Feeds output back to input — adds flanging character at high values"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      off: 0.0
+      subtle: 15.0
+      flanging: 50.0
+      metallic: 80.0
+
+  - name: "Width"
+    description: "Stereo spread of the chorus effect"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      narrow: 30.0
+      moderate: 60.0
+      wide: 100.0
+
+  - name: "Dry/Wet"
+    description: "Mix between dry and chorused signal"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      subtle: 20.0
+      moderate: 40.0
+      heavy: 60.0
+      vibrato: 100.0
+
+pairs_well_with:
+  - device: "Reverb"
+    reason: "Chorus into reverb creates vast, shimmering spaces"
+  - device: "Delay"
+    reason: "Chorused delays add width and depth"
+  - device: "Compressor"
+    reason: "Tame dynamic fluctuations from the modulation"
+  - device: "EQ Eight"
+    reason: "Shape the chorused signal — cut lows to prevent mud from doubled bass"
+
+starter_recipes:
+  - name: "Subtle Thickening"
+    description: "Gentle chorus to add width and body without obvious modulation"
+    genre: all
+    params:
+      Mode: "Classic"
+      "Rate 1": 0.5
+      "Amount 1": 20.0
+      Feedback: 0.0
+      Width: 80.0
+      "Dry/Wet": 25.0
+
+  - name: "Lush Ensemble"
+    description: "Rich, multi-voice ensemble for pads and strings"
+    genre: ambient
+    params:
+      Mode: "Ensemble"
+      "Rate 1": 0.8
+      "Rate 2": 1.2
+      "Amount 1": 35.0
+      "Amount 2": 25.0
+      Width: 100.0
+      "Dry/Wet": 45.0
+
+  - name: "Vibrato"
+    description: "Classic pitch vibrato without dry signal mixing"
+    genre: pop
+    params:
+      Mode: "Vibrato"
+      "Rate 1": 4.5
+      "Amount 1": 25.0
+      "Dry/Wet": 100.0
+
+gotchas:
+  - "Ensemble mode uses more CPU than Classic — it processes multiple modulation voices"
+  - "Vibrato mode at 100% wet removes the dry signal entirely — this is intentional for pitch vibrato"
+  - "High Feedback values push toward flanging territory — can overwhelm the chorus character"
+  - "Check in mono — heavy chorus can cause phase cancellation issues when summed to mono"
+  - "Two LFO rates create more complex, less predictable movement than one"
+  - "Width at 100% sounds great in stereo but can lose energy in mono — use 60-80% for safe mixes"

package/mcp_server/atlas/enrichments/audio_effects/color_limiter.yaml

@@ -0,0 +1,109 @@
+id: color_limiter
+name: Color Limiter
+sonic_description: >
+  Limiter with built-in coloration and saturation options that adds character while
+  controlling peaks. Unlike the transparent Limiter, Color Limiter intentionally
+  introduces harmonic warmth, grit, or color to the limiting process.
+effect_type: dynamics
+character_tags: [warm, colored, characterful, saturated]
+use_cases: [mastering, creative_limiting, bus_processing, loudness]
+genre_affinity:
+  primary: [hip_hop, electronic, lo_fi]
+  secondary: [pop, rock, indie]
+complexity: intermediate
+signal_type: audio
+introduced_in: "12.0"
+m4l_device: true
+
+key_parameters:
+  - name: "Gain"
+    description: "Input gain driving into the limiter/saturation stage"
+    range: [0.0, 24.0]
+    unit: dB
+    type: float
+    sweet_spots:
+      subtle: 3.0
+      moderate: 6.0
+      aggressive: 12.0
+
+  - name: "Ceiling"
+    description: "Maximum output level"
+    range: [-inf, 0.0]
+    unit: dB
+    type: float
+    sweet_spots:
+      streaming: -1.0
+      mastering: -0.3
+
+  - name: "Color"
+    description: "Amount of harmonic coloration added to the limiting"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      subtle_warmth: 20.0
+      moderate: 50.0
+      aggressive: 80.0
+
+  - name: "Release"
+    description: "Release time after limiting"
+    range: [0.01, 1000.0]
+    unit: ms
+    type: float
+    sweet_spots:
+      fast: 10.0
+      auto: -1
+      slow: 100.0
+
+  - name: "Dry/Wet"
+    description: "Mix between clean and colored/limited signal"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      full: 100.0
+      parallel: 60.0
+
+pairs_well_with:
+  - device: "EQ Eight"
+    reason: "Shape frequency content before coloring to control harmonic balance"
+  - device: "Compressor"
+    reason: "Stage dynamics before Color Limiter for smoother limiting"
+  - device: "Utility"
+    reason: "Precise level control before and after"
+  - device: "Saturator"
+    reason: "Stack with different saturation character for complex harmonic layering"
+
+starter_recipes:
+  - name: "Warm Limiting"
+    description: "Gentle loudness with analog-style warmth"
+    genre: all
+    params:
+      Gain: 4.0
+      Ceiling: -1.0
+      Color: 30.0
+      Release: -1
+
+  - name: "Aggressive Color"
+    description: "Driven, characterful limiting for lo-fi or hip-hop"
+    genre: hip_hop
+    params:
+      Gain: 8.0
+      Ceiling: -1.0
+      Color: 70.0
+      Release: 10.0
+
+  - name: "Subtle Gloss"
+    description: "Light coloration that adds sheen without obvious distortion"
+    genre: pop
+    params:
+      Gain: 3.0
+      Ceiling: -0.5
+      Color: 15.0
+      Release: -1
+
+gotchas:
+  - "This is a Max for Live device — requires Suite or M4L license"
+  - "High Color values add noticeable harmonic distortion — may not suit acoustic or classical material"
+  - "Compare with the stock Limiter to decide whether coloration is actually improving the mix"
+  - "Gain staging before this device matters more than with transparent limiters due to saturation interaction"

package/mcp_server/atlas/enrichments/audio_effects/compressor.yaml

@@ -0,0 +1,159 @@
+id: compressor
+name: Compressor
+sonic_description: >
+  Transparent dynamics processor that reduces the dynamic range of audio by attenuating
+  signals above a threshold. Clean and surgical — from invisible gain riding to aggressive
+  pumping, it shapes transients and sustain without adding coloration.
+effect_type: dynamics
+character_tags: [transparent, clean, surgical, versatile]
+use_cases: [mixing, mastering, sidechain, bus_glue, vocal_taming, transient_shaping]
+genre_affinity:
+  primary: [all]
+  secondary: []
+complexity: beginner
+signal_type: audio
+introduced_in: "1.0"
+
+key_parameters:
+  - name: "Threshold"
+    description: "Level above which compression engages"
+    range: [-inf, 0.0]
+    unit: dB
+    type: float
+    sweet_spots:
+      gentle: -20.0
+      moderate: -28.0
+      heavy: -35.0
+
+  - name: "Ratio"
+    description: "Compression ratio — how much gain reduction per dB above threshold"
+    range: [1.0, inf]
+    type: float
+    sweet_spots:
+      subtle: 2.0
+      vocal: 4.0
+      limiting: 10.0
+      brick_wall: inf
+
+  - name: "Attack"
+    description: "How quickly compression engages after signal exceeds threshold"
+    range: [0.01, 1000.0]
+    unit: ms
+    type: float
+    sweet_spots:
+      fast_transient_kill: 0.1
+      punch_preserve: 10.0
+      slow_natural: 30.0
+
+  - name: "Release"
+    description: "How quickly compression releases after signal falls below threshold"
+    range: [1.0, 3000.0]
+    unit: ms
+    type: float
+    sweet_spots:
+      fast_pumping: 50.0
+      musical: 100.0
+      slow_smooth: 300.0
+      auto: -1
+
+  - name: "Knee"
+    description: "Transition sharpness at threshold — soft knee gives gradual onset"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      hard: 0.0
+      medium: 0.5
+      soft: 1.0
+
+  - name: "Makeup"
+    description: "Output gain to compensate for gain reduction"
+    range: [-inf, 15.0]
+    unit: dB
+    type: float
+    sweet_spots:
+      compensate: 6.0
+
+  - name: "Dry/Wet"
+    description: "Blend between dry and compressed signal for parallel compression"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      full: 100.0
+      parallel: 50.0
+
+  - name: "Model"
+    description: "Detection model — Peak responds to transients, RMS to average level"
+    range: ["Peak", "RMS", "Expand"]
+    type: enum
+    sweet_spots:
+      transient_control: "Peak"
+      bus_glue: "RMS"
+
+  - name: "Sidechain"
+    description: "External sidechain input for ducking and pumping effects"
+    type: toggle
+    range: [0, 1]
+
+pairs_well_with:
+  - device: "EQ Eight"
+    reason: "Shape tone before compressing to avoid pumping from low-end energy"
+  - device: "Saturator"
+    reason: "Add harmonic warmth after compression for analog-like processing"
+  - device: "Utility"
+    reason: "Final volume trim and mono-bass after dynamics processing"
+  - device: "Limiter"
+    reason: "Catch peaks after compression for safe output levels"
+
+starter_recipes:
+  - name: "Gentle Bus Glue"
+    description: "Subtle cohesion for a mix bus — barely noticeable but adds coherence"
+    genre: all
+    params:
+      Threshold: -20.0
+      Ratio: 2.0
+      Attack: 10.0
+      Release: 100.0
+      Knee: 0.5
+      Model: "RMS"
+
+  - name: "Vocal Taming"
+    description: "Even out vocal dynamics while preserving natural feel"
+    genre: all
+    params:
+      Threshold: -25.0
+      Ratio: 4.0
+      Attack: 5.0
+      Release: 80.0
+      Knee: 0.3
+      Model: "RMS"
+
+  - name: "Sidechain Pump"
+    description: "Classic EDM pumping effect — duck bass/pads from kick"
+    genre: house
+    params:
+      Threshold: -30.0
+      Ratio: 10.0
+      Attack: 0.1
+      Release: 150.0
+      Knee: 0.0
+      Model: "Peak"
+      Sidechain: 1
+
+  - name: "Parallel Smash"
+    description: "Heavy compression blended with dry signal for power without squash"
+    genre: rock
+    params:
+      Threshold: -35.0
+      Ratio: 10.0
+      Attack: 0.5
+      Release: 50.0
+      "Dry/Wet": 40.0
+      Model: "Peak"
+
+gotchas:
+  - "Attack at 0.01ms kills transients completely — use 5-15ms to preserve punch"
+  - "RMS mode is better for bus/group compression; Peak mode for individual transient control"
+  - "Makeup gain should roughly equal the gain reduction shown on the meter for level-matched A/B"
+  - "Sidechain input must be configured in the routing section — just enabling the toggle is not enough"
+  - "Very fast release times cause audible distortion on low-frequency material"

package/mcp_server/atlas/enrichments/audio_effects/convolution_reverb.yaml

@@ -0,0 +1,143 @@
+id: convolution_reverb
+name: Convolution Reverb
+sonic_description: >
+  Impulse response reverb that uses real-world recordings of acoustic spaces to create
+  authentic, realistic reverberations. Each IR captures the exact reflections, frequency
+  response, and character of a physical space — from recording studios to cathedrals
+  to vintage spring and plate reverb units.
+effect_type: reverb
+character_tags: [realistic, authentic, detailed, natural, immersive]
+use_cases: [real_room_emulation, creative_ir, plate_reverb, spring_reverb, space_simulation]
+genre_affinity:
+  primary: [all]
+  secondary: []
+complexity: intermediate
+signal_type: audio
+introduced_in: "10.0"
+m4l_device: true
+
+key_parameters:
+  - name: "IR"
+    description: "Impulse response file — the recorded space character"
+    type: file
+    sweet_spots:
+      room: "Studio or Room IR"
+      plate: "Plate Reverb IR"
+      spring: "Spring Reverb IR"
+
+  - name: "Size"
+    description: "Scales the impulse response duration — stretches or shrinks the space"
+    range: [10.0, 400.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      small: 50.0
+      natural: 100.0
+      large: 200.0
+
+  - name: "Pre Delay"
+    description: "Delay before the impulse response begins"
+    range: [0.0, 500.0]
+    unit: ms
+    type: float
+    sweet_spots:
+      intimate: 0.0
+      separated: 20.0
+      distant: 50.0
+
+  - name: "Decay"
+    description: "Adjusts the decay envelope of the impulse response"
+    range: [0.1, 10.0]
+    unit: s
+    type: float
+    sweet_spots:
+      short: 0.5
+      medium: 1.5
+      long: 4.0
+
+  - name: "EQ Low"
+    description: "Low-frequency gain on the reverb output"
+    range: [-15.0, 15.0]
+    unit: dB
+    type: float
+    sweet_spots:
+      cut: -6.0
+      flat: 0.0
+
+  - name: "EQ Mid"
+    description: "Mid-frequency gain on the reverb output"
+    range: [-15.0, 15.0]
+    unit: dB
+    type: float
+    sweet_spots:
+      flat: 0.0
+      scoop: -3.0
+
+  - name: "EQ High"
+    description: "High-frequency gain on the reverb output"
+    range: [-15.0, 15.0]
+    unit: dB
+    type: float
+    sweet_spots:
+      dark: -6.0
+      flat: 0.0
+      bright: 3.0
+
+  - name: "Dry/Wet"
+    description: "Mix between dry and convolved signal"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      subtle: 15.0
+      moderate: 30.0
+      wet: 50.0
+      return_track: 100.0
+
+pairs_well_with:
+  - device: "EQ Eight"
+    reason: "Detailed frequency shaping of the reverb output beyond built-in EQ"
+  - device: "Compressor"
+    reason: "Control dynamics of the convolved signal"
+  - device: "Delay"
+    reason: "Add echo dimension to the convolved space"
+  - device: "Utility"
+    reason: "Width and level control on the reverb output"
+
+starter_recipes:
+  - name: "Real Room Emulation"
+    description: "Authentic room reverb using a studio IR for natural placement"
+    genre: all
+    params:
+      Size: 100.0
+      "Pre Delay": 10.0
+      Decay: 1.5
+      "EQ Low": -3.0
+      "Dry/Wet": 25.0
+
+  - name: "Creative Plate"
+    description: "Plate reverb IR for classic vocal and snare treatment"
+    genre: pop
+    params:
+      Size: 100.0
+      "Pre Delay": 15.0
+      Decay: 2.0
+      "EQ High": 2.0
+      "Dry/Wet": 20.0
+
+  - name: "Spring Character"
+    description: "Spring reverb IR for guitar or lo-fi vocal character"
+    genre: rock
+    params:
+      Size: 80.0
+      "Pre Delay": 0.0
+      Decay: 1.0
+      "Dry/Wet": 25.0
+
+gotchas:
+  - "This is a Max for Live device — requires Suite or M4L license"
+  - "IR files use memory — long IRs at high sample rates increase RAM usage significantly"
+  - "Size stretching above 200% can introduce artifacts — use for creative effects, not realism"
+  - "Cannot adjust room character as flexibly as algorithmic reverb — the IR defines the space"
+  - "Custom IRs can be loaded from WAV/AIFF files — record your own spaces with a balloon pop or starter pistol"
+  - "More CPU-intensive than Reverb — use on return tracks and freeze tracks when needed"