livepilot 1.9.23 → 1.10.0

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

@@ -0,0 +1,159 @@
+id: roar
+name: Roar
+sonic_description: >
+  Multi-stage distortion and saturation processor with parallel routing options introduced
+  in Live 12. Features multiple distortion algorithms that can be chained or run in parallel,
+  offering everything from subtle warming to extreme textural destruction with sophisticated
+  routing and feedback options.
+effect_type: distortion
+character_tags: [aggressive, textural, parallel, multi_stage, destructive]
+use_cases: [aggressive_distortion, parallel_saturation, textural_destruction, creative_sound_design, warm_parallel]
+genre_affinity:
+  primary: [industrial, electronic, experimental, techno]
+  secondary: [rock, hip_hop, sound_design]
+complexity: advanced
+signal_type: audio
+introduced_in: "12.0"
+
+key_parameters:
+  - name: "Drive"
+    description: "Primary distortion drive amount"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      subtle: 15.0
+      moderate: 40.0
+      heavy: 70.0
+      extreme: 100.0
+
+  - name: "Routing"
+    description: "Signal flow between distortion stages — serial, parallel, or feedback"
+    range: ["Serial", "Parallel", "Feedback"]
+    type: enum
+    sweet_spots:
+      stacked: "Serial"
+      blended: "Parallel"
+      chaotic: "Feedback"
+
+  - name: "Stage 1 Type"
+    description: "Distortion algorithm for the first stage"
+    range: ["Saturate", "Fold", "Clip", "Squeeze", "Erode"]
+    type: enum
+    sweet_spots:
+      warm: "Saturate"
+      complex: "Fold"
+      hard: "Clip"
+
+  - name: "Stage 2 Type"
+    description: "Distortion algorithm for the second stage"
+    range: ["Saturate", "Fold", "Clip", "Squeeze", "Erode"]
+    type: enum
+    sweet_spots:
+      complement: "Fold"
+      texture: "Erode"
+
+  - name: "Tone"
+    description: "Brightness/darkness control for the overall distortion"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      dark: 20.0
+      neutral: 50.0
+      bright: 80.0
+
+  - name: "Feedback"
+    description: "Internal feedback amount — creates self-oscillation at high values"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      off: 0.0
+      subtle: 20.0
+      chaotic: 60.0
+      screaming: 90.0
+
+  - name: "Comp"
+    description: "Built-in compression before or after distortion"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      off: 0.0
+      gentle: 30.0
+      heavy: 70.0
+
+  - name: "Body"
+    description: "Low-frequency emphasis — adds weight to the distortion"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      thin: 0.0
+      warm: 40.0
+      heavy: 70.0
+
+  - name: "Dry/Wet"
+    description: "Mix between clean and distorted signal"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      parallel_subtle: 30.0
+      blend: 50.0
+      full: 100.0
+
+pairs_well_with:
+  - device: "EQ Eight"
+    reason: "Surgical frequency control before and after multi-stage distortion"
+  - device: "Compressor"
+    reason: "Tame dynamics after aggressive distortion"
+  - device: "Reverb"
+    reason: "Space and depth after textural distortion for soundscape design"
+  - device: "Auto Filter"
+    reason: "Dynamic filtering on the distorted output for movement"
+
+starter_recipes:
+  - name: "Aggressive Parallel Distortion"
+    description: "Hard-clipped distortion blended with clean signal for impact without mush"
+    genre: electronic
+    params:
+      Drive: 70.0
+      Routing: "Parallel"
+      "Stage 1 Type": "Clip"
+      "Stage 2 Type": "Fold"
+      Tone: 55.0
+      "Dry/Wet": 45.0
+
+  - name: "Textural Destruction"
+    description: "Extreme distortion with feedback for industrial textures"
+    genre: industrial
+    params:
+      Drive: 85.0
+      Routing: "Feedback"
+      "Stage 1 Type": "Fold"
+      "Stage 2 Type": "Erode"
+      Feedback: 50.0
+      Tone: 40.0
+      "Dry/Wet": 80.0
+
+  - name: "Warm Parallel Saturation"
+    description: "Subtle multi-stage warmth for bus or master processing"
+    genre: all
+    params:
+      Drive: 25.0
+      Routing: "Parallel"
+      "Stage 1 Type": "Saturate"
+      "Stage 2 Type": "Saturate"
+      Body: 40.0
+      Comp: 30.0
+      "Dry/Wet": 35.0
+
+gotchas:
+  - "Feedback routing can self-oscillate unpredictably — start with low Feedback values"
+  - "Multiple stages compound the distortion — Drive at 50% with two stages is much heavier than a single stage at 50%"
+  - "Different stage type combinations create very different results — experiment methodically"
+  - "The built-in Comp interacts with the distortion character — try pre and post positions"
+  - "Body adds sub content that can overpower monitors — check on full-range systems"
+  - "New in Live 12 — no equivalent in earlier versions"

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

@@ -0,0 +1,146 @@
+id: saturator
+name: Saturator
+sonic_description: >
+  Versatile waveshaping saturation with six curve types ranging from warm analog clipping
+  to aggressive digital distortion and wavefold synthesis. Adds harmonics, warmth, and
+  edge to any source with precise control over the distortion character.
+effect_type: distortion
+character_tags: [warm, harmonics, analog, versatile, colorful]
+use_cases: [warmth, harmonic_saturation, bass_grit, subtle_drive, aggressive_distortion, tape_emulation]
+genre_affinity:
+  primary: [all]
+  secondary: []
+complexity: beginner
+signal_type: audio
+introduced_in: "1.0"
+
+key_parameters:
+  - name: "Drive"
+    description: "Amount of saturation applied — higher values = more harmonics and distortion"
+    range: [-inf, 24.0]
+    unit: dB
+    type: float
+    sweet_spots:
+      subtle: 3.0
+      warm: 8.0
+      driven: 15.0
+      extreme: 24.0
+
+  - name: "Type"
+    description: "Waveshaping curve — defines the character of the distortion"
+    range: ["Analog Clip", "Soft Sine", "Medium Curve", "Hard Curve", "Sinoid Fold", "Digital Clip"]
+    type: enum
+    sweet_spots:
+      tape_warmth: "Analog Clip"
+      gentle: "Soft Sine"
+      moderate: "Medium Curve"
+      aggressive: "Hard Curve"
+      folding: "Sinoid Fold"
+      harsh: "Digital Clip"
+
+  - name: "Color"
+    description: "Pre-saturation tone shaping — adds brightness before the waveshaper"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      dark: 0.0
+      neutral: 50.0
+      bright: 80.0
+
+  - name: "Base"
+    description: "Pre-saturation low-frequency boost — adds bass weight before clipping"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      flat: 0.0
+      warm: 30.0
+      fat: 60.0
+
+  - name: "Output"
+    description: "Output level for gain compensation after saturation"
+    range: [-inf, 0.0]
+    unit: dB
+    type: float
+    sweet_spots:
+      compensate: -6.0
+      unity: 0.0
+
+  - name: "Dry/Wet"
+    description: "Parallel blend — mix saturated and clean signal"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      full: 100.0
+      parallel: 50.0
+      subtle_blend: 30.0
+
+  - name: "Soft Clip"
+    description: "Additional soft clipping on the output for rounded peaks"
+    type: toggle
+    range: [0, 1]
+    sweet_spots:
+      off: 0
+      on: 1
+
+pairs_well_with:
+  - device: "EQ Eight"
+    reason: "Shape frequency content before and after saturation"
+  - device: "Compressor"
+    reason: "Compress before saturating for more even harmonic generation"
+  - device: "Utility"
+    reason: "Precise level control after saturation"
+  - device: "Auto Filter"
+    reason: "Filter after saturation to control harsh harmonics"
+
+starter_recipes:
+  - name: "Warm Analog Saturation"
+    description: "Subtle tape-like warmth for any source"
+    genre: all
+    params:
+      Drive: 5.0
+      Type: "Analog Clip"
+      Color: 40.0
+      Output: -3.0
+      "Dry/Wet": 100.0
+
+  - name: "Aggressive Digital Clip"
+    description: "Hard, edgy distortion for industrial or aggressive sounds"
+    genre: industrial
+    params:
+      Drive: 18.0
+      Type: "Digital Clip"
+      Color: 60.0
+      Output: -8.0
+      "Dry/Wet": 100.0
+
+  - name: "Subtle Harmonics"
+    description: "Gentle parallel saturation to add life without obvious distortion"
+    genre: all
+    params:
+      Drive: 10.0
+      Type: "Soft Sine"
+      Color: 50.0
+      Output: -4.0
+      "Dry/Wet": 40.0
+
+  - name: "Bass Grit"
+    description: "Add upper harmonics to bass for speaker presence"
+    genre: electronic
+    params:
+      Drive: 12.0
+      Type: "Medium Curve"
+      Base: 40.0
+      Color: 30.0
+      Output: -5.0
+      "Dry/Wet": 60.0
+
+gotchas:
+  - "Soft Sine is the most transparent curve type — start here for mixing contexts"
+  - "Sinoid Fold creates wavefold distortion — extreme harmonics at high Drive values"
+  - "Digital Clip is harsh and unforgiving — use intentionally for industrial or lo-fi sounds"
+  - "Color boosts high frequencies before saturation — can create harsh artifacts at high values"
+  - "Always compensate output level when adding Drive — saturation increases perceived loudness"
+  - "Dry/Wet is key for parallel saturation — 30-50% often sounds better than 100%"

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

@@ -0,0 +1,154 @@
+id: shifter
+name: Shifter
+sonic_description: >
+  Pitch shifter, frequency shifter, and ring modulator in one device. Pitch Shift mode
+  transposes in semitones (harmonic). Frequency Shift mode shifts in Hz (inharmonic,
+  metallic). Ring Mod mode multiplies the input with an oscillator for bell-like,
+  metallic timbres. Renamed from Frequency Shifter in Live 12.
+effect_type: modulation
+character_tags: [metallic, inharmonic, creative, otherworldly, experimental]
+use_cases: [pitch_shifting, ring_modulation, metallic_textures, detuning, frequency_shifting]
+genre_affinity:
+  primary: [experimental, electronic, sound_design]
+  secondary: [ambient, idm, industrial]
+complexity: intermediate
+signal_type: audio
+introduced_in: "8.0"
+
+key_parameters:
+  - name: "Mode"
+    description: "Processing mode — Shift (pitch), Ring (ring mod), or Freq Shift (Hz-based)"
+    range: ["Shift", "Ring", "Freq Shift"]
+    type: enum
+    sweet_spots:
+      pitch: "Shift"
+      metallic: "Ring"
+      inharmonic: "Freq Shift"
+
+  - name: "Coarse"
+    description: "Coarse pitch shift in semitones (Shift mode)"
+    range: [-48, 48]
+    unit: st
+    type: int
+    sweet_spots:
+      octave_down: -12
+      fifth: 7
+      octave_up: 12
+
+  - name: "Fine"
+    description: "Fine pitch shift in cents (Shift mode)"
+    range: [-100, 100]
+    unit: cents
+    type: int
+    sweet_spots:
+      subtle_detune: -10
+      chorus_like: 7
+      quarter_tone: 50
+
+  - name: "Frequency"
+    description: "Shift amount in Hz (Freq Shift mode) or ring mod frequency (Ring mode)"
+    range: [-5000.0, 5000.0]
+    unit: Hz
+    type: float
+    sweet_spots:
+      subtle_shift: 2.0
+      metallic: 200.0
+      extreme: 1000.0
+
+  - name: "Ring Mod Freq"
+    description: "Ring modulator oscillator frequency (Ring mode)"
+    range: [0.1, 5000.0]
+    unit: Hz
+    type: float
+    sweet_spots:
+      tremolo: 5.0
+      metallic: 200.0
+      bell: 800.0
+      harsh: 2000.0
+
+  - name: "Drive"
+    description: "Input gain before processing"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      clean: 0.0
+      moderate: 30.0
+      hot: 60.0
+
+  - name: "Feedback"
+    description: "Feeds shifted signal back into the input for cascading pitch effects"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      off: 0.0
+      subtle: 20.0
+      shimmering: 50.0
+      runaway: 80.0
+
+  - name: "Dry/Wet"
+    description: "Mix between dry and shifted signal"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      subtle: 15.0
+      blend: 35.0
+      heavy: 60.0
+      full: 100.0
+
+pairs_well_with:
+  - device: "Reverb"
+    reason: "Reverb on shifted signal creates ethereal, otherworldly spaces"
+  - device: "Delay"
+    reason: "Delay + pitch shift = shimmer effect"
+  - device: "EQ Eight"
+    reason: "Tame harsh harmonics from ring mod or frequency shifting"
+  - device: "Auto Filter"
+    reason: "Filter the metallic artifacts for controlled texture"
+
+starter_recipes:
+  - name: "Octave Up Shimmer"
+    description: "Pitch shift up one octave blended with reverb for shimmer"
+    genre: ambient
+    params:
+      Mode: "Shift"
+      Coarse: 12
+      Fine: 0
+      Feedback: 30.0
+      "Dry/Wet": 25.0
+
+  - name: "Ring Mod Metallic"
+    description: "Classic ring modulation for metallic, bell-like textures"
+    genre: experimental
+    params:
+      Mode: "Ring"
+      "Ring Mod Freq": 300.0
+      Drive: 20.0
+      "Dry/Wet": 50.0
+
+  - name: "Subtle Detune"
+    description: "Gentle pitch offset for subtle thickening and unease"
+    genre: all
+    params:
+      Mode: "Shift"
+      Coarse: 0
+      Fine: -8
+      "Dry/Wet": 30.0
+
+  - name: "Frequency Shift Movement"
+    description: "Small Hz-based shift for subtle inharmonic movement"
+    genre: ambient
+    params:
+      Mode: "Freq Shift"
+      Frequency: 3.0
+      "Dry/Wet": 40.0
+
+gotchas:
+  - "Browser name is 'Shifter' (not 'Frequency Shifter') — use this with find_and_load_device"
+  - "Frequency Shift mode shifts in Hz, not semitones — even small values create inharmonic content"
+  - "Ring Mod at low frequencies (1-10 Hz) creates tremolo; at higher frequencies creates new sidebands"
+  - "Feedback with pitch shift creates ever-ascending or descending pitch cascades"
+  - "Frequency Shift at +/- 1-5 Hz creates subtle beating and movement without obvious pitch change"
+  - "Ring Mod produces sum and difference frequencies — the output contains frequencies not in the input"

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

@@ -0,0 +1,141 @@
+id: spectral_resonator
+name: Spectral Resonator
+sonic_description: >
+  Spectral processing effect that creates pitched resonances from any input audio by
+  decomposing it into partials and resonating at specific frequencies. Can track MIDI input
+  for pitched resonance, creating tonal textures from noise, drums, or any sound source.
+effect_type: spectral
+character_tags: [ethereal, harmonic, tonal, creative, otherworldly]
+use_cases: [harmonic_resonance, spectral_freeze, pitched_noise, creative_sound_design, drone]
+genre_affinity:
+  primary: [ambient, experimental, electronic]
+  secondary: [sound_design, film_score, idm]
+complexity: advanced
+signal_type: audio
+introduced_in: "11.0"
+m4l_device: true
+
+key_parameters:
+  - name: "Frequency"
+    description: "Base frequency of the resonance — sets the fundamental pitch"
+    range: [20.0, 20000.0]
+    unit: Hz
+    type: float
+    sweet_spots:
+      low_drone: 60.0
+      mid_tone: 440.0
+      high_shimmer: 2000.0
+
+  - name: "Decay"
+    description: "How long the resonances ring out"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      short: 20.0
+      medium: 50.0
+      long_sustain: 80.0
+      infinite: 100.0
+
+  - name: "Mod Rate"
+    description: "Modulation speed of the spectral processing"
+    range: [0.01, 20.0]
+    unit: Hz
+    type: float
+    sweet_spots:
+      slow: 0.1
+      moderate: 1.0
+      fast: 5.0
+
+  - name: "Mod Amount"
+    description: "Depth of spectral modulation"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      subtle: 15.0
+      moderate: 40.0
+      extreme: 80.0
+
+  - name: "Unison"
+    description: "Number of unison voices for thickness"
+    range: [1, 8]
+    type: int
+    sweet_spots:
+      single: 1
+      thick: 4
+      massive: 8
+
+  - name: "Stretch"
+    description: "Stretches the harmonic series — creates inharmonic or bell-like tones"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      harmonic: 0.0
+      slight: 20.0
+      metallic: 50.0
+      bell: 80.0
+
+  - name: "MIDI Sidechain"
+    description: "Route MIDI to control the resonance pitch in real-time"
+    type: toggle
+    range: [0, 1]
+
+  - name: "Dry/Wet"
+    description: "Mix between dry input and resonated output"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      subtle: 20.0
+      blend: 50.0
+      wet: 100.0
+
+pairs_well_with:
+  - device: "Reverb"
+    reason: "Long reverb on resonated output creates vast, evolving spaces"
+  - device: "Delay"
+    reason: "Delays on resonances build complex, shimmering textures"
+  - device: "EQ Eight"
+    reason: "Shape the resonance frequency content to tame harsh harmonics"
+  - device: "Compressor"
+    reason: "Control dynamic surges from the resonance process"
+
+starter_recipes:
+  - name: "Harmonic Resonance"
+    description: "Turn drums or noise into pitched, harmonic drones"
+    genre: ambient
+    params:
+      Frequency: 220.0
+      Decay: 70.0
+      Stretch: 0.0
+      "Dry/Wet": 80.0
+      Unison: 4
+
+  - name: "Spectral Freeze"
+    description: "Sustain and freeze the spectral content of any input"
+    genre: experimental
+    params:
+      Decay: 100.0
+      "Mod Amount": 10.0
+      "Mod Rate": 0.1
+      "Dry/Wet": 100.0
+
+  - name: "Pitched Noise Texture"
+    description: "Create tonal textures from white noise or percussive input"
+    genre: sound_design
+    params:
+      Frequency: 440.0
+      Decay: 50.0
+      Stretch: 30.0
+      Unison: 6
+      "Dry/Wet": 60.0
+
+gotchas:
+  - "This is a Max for Live device — requires Suite or M4L license"
+  - "High Decay values with loud input can build up to very loud levels — watch output"
+  - "MIDI sidechain routing must be configured in Live's routing section, not just the device"
+  - "Stretch parameter makes the sound inharmonic — musical at low values, metallic at high values"
+  - "CPU-intensive with high Unison counts — use sparingly on weaker systems"
+  - "Works best with transient-rich or noisy input — sustained tones may not excite resonances effectively"