livepilot 1.9.23 → 1.10.0

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

@@ -0,0 +1,141 @@
+id: grain_delay
+name: Grain Delay
+sonic_description: >
+  Granular delay that chops the delayed signal into tiny grains and can pitch-shift,
+  time-scatter, and randomize them. Creates shimmering, otherworldly textures from any
+  input — from subtle shimmer effects to extreme glitch scatter and frozen soundscapes.
+effect_type: delay
+character_tags: [granular, shimmering, textural, glitchy, ethereal]
+use_cases: [shimmer, glitch, ambient_texture, pitch_delay, creative_effects]
+genre_affinity:
+  primary: [ambient, experimental, electronic]
+  secondary: [shoegaze, post_rock, idm, sound_design]
+complexity: intermediate
+signal_type: audio
+introduced_in: "1.0"
+
+key_parameters:
+  - name: "Frequency"
+    description: "Grain rate — how many grains per second are generated"
+    range: [1.0, 150.0]
+    unit: Hz
+    type: float
+    sweet_spots:
+      slow_grains: 10.0
+      moderate: 40.0
+      fast_smooth: 100.0
+
+  - name: "Pitch"
+    description: "Pitch transposition of the grains in semitones"
+    range: [-48, 48]
+    unit: st
+    type: int
+    sweet_spots:
+      octave_down: -12
+      fifth_up: 7
+      octave_up: 12
+      two_octaves_up: 24
+
+  - name: "Spray"
+    description: "Randomizes grain playback position — scatters grains in time"
+    range: [0.0, 500.0]
+    unit: ms
+    type: float
+    sweet_spots:
+      tight: 0.0
+      subtle: 10.0
+      scattered: 50.0
+      extreme: 200.0
+
+  - name: "Random Pitch"
+    description: "Randomizes the pitch of individual grains"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      off: 0.0
+      subtle: 10.0
+      wild: 50.0
+
+  - name: "Feedback"
+    description: "Amount of granulated signal fed back for layered textures"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      single: 0.0
+      moderate: 40.0
+      dense: 70.0
+      runaway: 95.0
+
+  - name: "Delay Time"
+    description: "Base delay time before granulation"
+    range: [1.0, 1000.0]
+    unit: ms
+    type: float
+    sweet_spots:
+      short: 50.0
+      moderate: 200.0
+      long: 500.0
+
+  - name: "Dry/Wet"
+    description: "Mix between dry and granulated signal"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      subtle: 15.0
+      blend: 30.0
+      heavy: 50.0
+      return_track: 100.0
+
+pairs_well_with:
+  - device: "Reverb"
+    reason: "Long reverb on granulated output creates vast, evolving textures"
+  - device: "Auto Filter"
+    reason: "Filter the granular output for tonal control"
+  - device: "Echo"
+    reason: "Layer conventional echoes with granular textures"
+  - device: "EQ Eight"
+    reason: "Tame harsh frequencies from pitch-shifted grains"
+
+starter_recipes:
+  - name: "Shimmer"
+    description: "Ethereal octave-up granular delay for ambient guitar or pads"
+    genre: ambient
+    params:
+      Pitch: 12
+      Frequency: 80.0
+      Spray: 5.0
+      "Random Pitch": 5.0
+      Feedback: 45.0
+      "Dry/Wet": 25.0
+
+  - name: "Glitch Scatter"
+    description: "Chaotic, scattered grains for glitch and IDM textures"
+    genre: idm
+    params:
+      Pitch: 0
+      Frequency: 20.0
+      Spray: 150.0
+      "Random Pitch": 40.0
+      Feedback: 30.0
+      "Dry/Wet": 35.0
+
+  - name: "Frozen Texture"
+    description: "Dense, sustained granular cloud from any input"
+    genre: ambient
+    params:
+      Pitch: 7
+      Frequency: 100.0
+      Spray: 30.0
+      "Random Pitch": 15.0
+      Feedback: 80.0
+      "Dry/Wet": 40.0
+
+gotchas:
+  - "High Feedback + Pitch shift creates ever-rising or falling pitch cascades — intentional but can overwhelm"
+  - "Spray at high values with slow Frequency creates sparse, unpredictable textures"
+  - "Pitch is in semitones, not cents — +12 = octave up, -12 = octave down"
+  - "Low Frequency values create rhythmic, audible grain pulses; high values sound smoother"
+  - "CPU usage increases with high Feedback and Frequency settings"

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

@@ -0,0 +1,160 @@
+id: hybrid_reverb
+name: Hybrid Reverb
+sonic_description: >
+  Hybrid reverb combining convolution (impulse response) early reflections with an
+  algorithmic tail. Uses real-world IR recordings for authentic room character while the
+  algorithmic component provides flexible, adjustable decay. Best of both worlds — realism
+  plus tunability.
+effect_type: reverb
+character_tags: [realistic, lush, detailed, flexible, cinematic]
+use_cases: [realistic_room, stadium_reverb, morphing_space, cinematic, vocal_reverb]
+genre_affinity:
+  primary: [all]
+  secondary: []
+complexity: intermediate
+signal_type: audio
+introduced_in: "11.0"
+
+key_parameters:
+  - name: "IR Category"
+    description: "Category of impulse response — Real Spaces, Studios, Plates, Springs, etc."
+    type: enum
+    range: ["Real Spaces", "Studios", "Plates", "Springs", "Vintage", "Experimental"]
+    sweet_spots:
+      room: "Real Spaces"
+      plate: "Plates"
+      creative: "Experimental"
+
+  - name: "Blend"
+    description: "Balance between convolution (IR) and algorithmic reverb"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      full_convolution: 0.0
+      balanced: 50.0
+      full_algorithmic: 100.0
+
+  - name: "Size"
+    description: "Size scaling of the convolution/algorithmic space"
+    range: [0.0, 500.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      small: 50.0
+      natural: 100.0
+      large: 200.0
+      huge: 400.0
+
+  - name: "Decay"
+    description: "Algorithmic tail decay time"
+    range: [0.2, 60.0]
+    unit: s
+    type: float
+    sweet_spots:
+      short: 1.0
+      medium: 2.5
+      long: 5.0
+      infinite: 60.0
+
+  - name: "Pre Delay"
+    description: "Delay before reverb onset"
+    range: [0.0, 500.0]
+    unit: ms
+    type: float
+    sweet_spots:
+      intimate: 0.0
+      vocal: 20.0
+      large: 50.0
+
+  - name: "Damping"
+    description: "High-frequency absorption in the algorithmic tail"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      bright: 20.0
+      natural: 50.0
+      dark: 80.0
+
+  - name: "EQ Low"
+    description: "Low-frequency EQ on the reverb output"
+    range: [-15.0, 15.0]
+    unit: dB
+    type: float
+    sweet_spots:
+      cut: -6.0
+      flat: 0.0
+
+  - name: "EQ High"
+    description: "High-frequency EQ 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 reverb signal"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      subtle: 15.0
+      moderate: 30.0
+      heavy: 50.0
+      return_track: 100.0
+
+pairs_well_with:
+  - device: "EQ Eight"
+    reason: "Additional frequency shaping before or after the hybrid reverb"
+  - device: "Compressor"
+    reason: "Control reverb dynamics on a return track"
+  - device: "Delay"
+    reason: "Delay into Hybrid Reverb for depth and dimension"
+  - device: "Utility"
+    reason: "Stereo width control on the reverb output"
+
+starter_recipes:
+  - name: "Realistic Room + Long Tail"
+    description: "Authentic room character fading into a smooth algorithmic tail"
+    genre: all
+    params:
+      Blend: 40.0
+      Size: 100.0
+      Decay: 2.5
+      "Pre Delay": 15.0
+      Damping: 50.0
+      "Dry/Wet": 25.0
+
+  - name: "Stadium Verb"
+    description: "Massive, wide reverb for big cinematic moments"
+    genre: cinematic
+    params:
+      Blend: 30.0
+      Size: 350.0
+      Decay: 5.0
+      "Pre Delay": 40.0
+      Damping: 40.0
+      "EQ Low": -3.0
+      "Dry/Wet": 35.0
+
+  - name: "Morphing Space"
+    description: "Automate Blend to morph from convolution room to algorithmic wash"
+    genre: ambient
+    params:
+      Blend: 50.0
+      Size: 200.0
+      Decay: 8.0
+      Damping: 60.0
+      "Dry/Wet": 40.0
+
+gotchas:
+  - "Convolution IRs use memory — long IRs at high quality settings increase RAM usage"
+  - "Blend parameter is key — automate it for evolving room-to-hall transitions"
+  - "Size affects both convolution and algorithmic components"
+  - "The IR library is extensive — browse categories to find the right starting point"
+  - "More CPU-intensive than the stock Reverb — use on return tracks for efficiency"
+  - "Damping only affects the algorithmic tail, not the convolution early reflections"

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

@@ -0,0 +1,97 @@
+id: limiter
+name: Limiter
+sonic_description: >
+  Brick-wall peak limiter that prevents audio from exceeding a ceiling level. Transparent
+  at gentle settings, it catches transient peaks without audible compression artifacts.
+  Essential for mastering and output protection.
+effect_type: dynamics
+character_tags: [transparent, protective, loud, clean]
+use_cases: [mastering, output_protection, loudness, live_safety]
+genre_affinity:
+  primary: [all]
+  secondary: []
+complexity: beginner
+signal_type: audio
+introduced_in: "1.0"
+
+key_parameters:
+  - name: "Gain"
+    description: "Input gain before limiting — push into the limiter for loudness"
+    range: [0.0, 16.0]
+    unit: dB
+    type: float
+    sweet_spots:
+      safety: 0.0
+      subtle_loudness: 3.0
+      moderate: 6.0
+      loud: 10.0
+
+  - name: "Ceiling"
+    description: "Maximum output level — nothing passes above this"
+    range: [-inf, 0.0]
+    unit: dB
+    type: float
+    sweet_spots:
+      streaming: -1.0
+      mastering: -0.3
+      safe: -0.5
+
+  - name: "Release"
+    description: "How fast the limiter releases after clamping a peak"
+    range: [0.01, 1000.0]
+    unit: ms
+    type: float
+    sweet_spots:
+      fast: 1.0
+      auto: -1
+      slow: 100.0
+
+  - name: "Stereo Link"
+    description: "Whether limiting is applied to L/R together or independently"
+    type: toggle
+    range: [0, 1]
+    sweet_spots:
+      linked: 1
+      independent: 0
+
+pairs_well_with:
+  - device: "EQ Eight"
+    reason: "Shape frequency balance before limiting to avoid low-end pumping"
+  - device: "Compressor"
+    reason: "Stage compression before limiting for transparent loudness"
+  - device: "Utility"
+    reason: "Set precise gain staging before the limiter"
+  - device: "Glue Compressor"
+    reason: "Bus compression before limiting gives more headroom"
+
+starter_recipes:
+  - name: "Mastering Limiter"
+    description: "Transparent loudness maximizing for final output"
+    genre: all
+    params:
+      Gain: 4.0
+      Ceiling: -1.0
+      Release: -1
+
+  - name: "Safety Limiter"
+    description: "Output protection for live performance — catches unexpected peaks"
+    genre: all
+    params:
+      Gain: 0.0
+      Ceiling: -0.3
+      Release: 1.0
+
+  - name: "Loud Master"
+    description: "Aggressive loudness for competitive levels — use with care"
+    genre: pop
+    params:
+      Gain: 8.0
+      Ceiling: -1.0
+      Release: -1
+
+gotchas:
+  - "More than 3-4 dB of gain reduction usually means you need compression before the limiter"
+  - "Ceiling of -1.0 dB is recommended for streaming platforms (Spotify, Apple Music) to avoid codec artifacts"
+  - "Fast release can cause audible distortion on bass-heavy material"
+  - "Pushing Gain too hard causes audible pumping and loss of dynamics — check with meters"
+  - "Always monitor in mono after limiting to catch phase issues"

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

@@ -0,0 +1,174 @@
+id: multiband_dynamics
+name: Multiband Dynamics
+sonic_description: >
+  Three-band dynamics processor that splits audio into low, mid, and high frequency
+  bands with independent compression and expansion per band. Allows surgical frequency-specific
+  dynamics control without affecting other ranges — essential for mastering and de-essing.
+effect_type: dynamics
+character_tags: [surgical, precise, powerful, transparent]
+use_cases: [mastering, de_essing, multiband_compression, frequency_specific_dynamics, bass_control]
+genre_affinity:
+  primary: [all]
+  secondary: []
+complexity: advanced
+signal_type: audio
+introduced_in: "8.0"
+
+key_parameters:
+  - name: "Low Crossover"
+    description: "Frequency dividing Low and Mid bands"
+    range: [20.0, 20000.0]
+    unit: Hz
+    type: float
+    sweet_spots:
+      standard: 120.0
+      deep_bass_split: 80.0
+      wide_low: 200.0
+
+  - name: "High Crossover"
+    description: "Frequency dividing Mid and High bands"
+    range: [20.0, 20000.0]
+    unit: Hz
+    type: float
+    sweet_spots:
+      standard: 4500.0
+      sibilance_target: 6000.0
+      bright_split: 8000.0
+
+  - name: "Low Above Threshold"
+    description: "Compression threshold for the Low band"
+    range: [-inf, 0.0]
+    unit: dB
+    type: float
+    sweet_spots:
+      gentle: -15.0
+      moderate: -25.0
+
+  - name: "Low Above Ratio"
+    description: "Compression ratio for the Low band"
+    range: [1.0, inf]
+    type: float
+    sweet_spots:
+      gentle: 2.0
+      tight: 4.0
+
+  - name: "Mid Above Threshold"
+    description: "Compression threshold for the Mid band"
+    range: [-inf, 0.0]
+    unit: dB
+    type: float
+    sweet_spots:
+      gentle: -15.0
+      moderate: -20.0
+
+  - name: "Mid Above Ratio"
+    description: "Compression ratio for the Mid band"
+    range: [1.0, inf]
+    type: float
+    sweet_spots:
+      gentle: 2.0
+      moderate: 3.0
+
+  - name: "High Above Threshold"
+    description: "Compression threshold for the High band"
+    range: [-inf, 0.0]
+    unit: dB
+    type: float
+    sweet_spots:
+      gentle: -15.0
+      de_ess: -25.0
+
+  - name: "High Above Ratio"
+    description: "Compression ratio for the High band"
+    range: [1.0, inf]
+    type: float
+    sweet_spots:
+      gentle: 2.0
+      de_ess: 4.0
+
+  - name: "Low Below Threshold"
+    description: "Expansion threshold for the Low band — expands/gates below this level"
+    range: [-inf, 0.0]
+    unit: dB
+    type: float
+    sweet_spots:
+      noise_gate: -40.0
+
+  - name: "Low Attack"
+    description: "Attack time for Low band dynamics"
+    range: [0.01, 1000.0]
+    unit: ms
+    type: float
+    sweet_spots:
+      fast: 1.0
+      slow: 30.0
+
+  - name: "Low Release"
+    description: "Release time for Low band dynamics"
+    range: [1.0, 3000.0]
+    unit: ms
+    type: float
+    sweet_spots:
+      fast: 50.0
+      slow: 200.0
+
+  - name: "Output Gain"
+    description: "Per-band output gain for rebalancing after processing"
+    range: [-inf, 12.0]
+    unit: dB
+    type: float
+    sweet_spots:
+      unity: 0.0
+
+pairs_well_with:
+  - device: "EQ Eight"
+    reason: "Use before for broad EQ moves, after for fine tonal adjustments"
+  - device: "Limiter"
+    reason: "Final peak protection after multiband processing"
+  - device: "Compressor"
+    reason: "Gentle broadband compression before or after for overall dynamics"
+  - device: "Utility"
+    reason: "Level matching and mono-bass after multiband processing"
+
+starter_recipes:
+  - name: "Multiband Mastering"
+    description: "Gentle multiband compression for a balanced, controlled master"
+    genre: all
+    params:
+      "Low Crossover": 120.0
+      "High Crossover": 4500.0
+      "Low Above Threshold": -18.0
+      "Low Above Ratio": 2.0
+      "Mid Above Threshold": -15.0
+      "Mid Above Ratio": 2.0
+      "High Above Threshold": -18.0
+      "High Above Ratio": 2.0
+
+  - name: "De-Esser"
+    description: "Tame sibilance by compressing only the high frequencies"
+    genre: all
+    params:
+      "High Crossover": 6000.0
+      "High Above Threshold": -25.0
+      "High Above Ratio": 4.0
+      "Low Above Threshold": 0.0
+      "Mid Above Threshold": 0.0
+
+  - name: "Bass-Only Compression"
+    description: "Tighten only the low end without affecting mids and highs"
+    genre: electronic
+    params:
+      "Low Crossover": 150.0
+      "Low Above Threshold": -20.0
+      "Low Above Ratio": 3.0
+      "Low Attack": 5.0
+      "Low Release": 100.0
+      "Mid Above Threshold": 0.0
+      "High Above Threshold": 0.0
+
+gotchas:
+  - "Each band has BOTH compression (Above) and expansion (Below) — set unused thresholds to 0 dB (Above) or -inf (Below)"
+  - "Crossover frequencies cause phase shifts — avoid narrow bands unless necessary"
+  - "Easy to over-process — use the solo buttons to listen to each band individually"
+  - "For de-essing, solo the High band and adjust crossover until you isolate the sibilance"
+  - "Heavy processing on all three bands simultaneously can sound unnatural — less is more"

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

@@ -0,0 +1,119 @@
+id: overdrive
+name: Overdrive
+sonic_description: >
+  Amp-style overdrive distortion that emulates the warm breakup of a tube amplifier
+  being pushed into clipping. More focused and characterful than Saturator, with a Tone
+  control that shapes the brightness of the distortion and a Dynamics parameter that
+  preserves or flattens the dynamic range.
+effect_type: distortion
+character_tags: [warm, crunchy, amp_like, musical, dynamic]
+use_cases: [guitar_crunch, synth_warmth, bass_grit, lo_fi_character, subtle_edge]
+genre_affinity:
+  primary: [rock, indie, blues]
+  secondary: [electronic, lo_fi, pop]
+complexity: beginner
+signal_type: audio
+introduced_in: "1.0"
+
+key_parameters:
+  - name: "Drive"
+    description: "Amount of overdrive distortion"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      subtle: 15.0
+      crunch: 40.0
+      heavy: 70.0
+      maxed: 100.0
+
+  - name: "Tone"
+    description: "Brightness of the overdrive — low values are darker, high values are brighter"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      dark: 20.0
+      warm: 40.0
+      neutral: 50.0
+      bright: 75.0
+
+  - name: "Dynamics"
+    description: "Preserves or compresses dynamics — 0% = heavily compressed, 100% = fully dynamic"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      compressed: 20.0
+      moderate: 50.0
+      dynamic: 80.0
+      full: 100.0
+
+  - name: "Bandwidth"
+    description: "Frequency range affected by the overdrive"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      narrow: 20.0
+      moderate: 50.0
+      wide: 80.0
+      full: 100.0
+
+  - name: "Dry/Wet"
+    description: "Mix between clean and overdriven signal"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      full: 100.0
+      parallel: 50.0
+      subtle: 30.0
+
+pairs_well_with:
+  - device: "EQ Eight"
+    reason: "Shape tone before and after overdrive for precise tonal control"
+  - device: "Compressor"
+    reason: "Compress before for consistent overdrive, after for taming peaks"
+  - device: "Cabinet"
+    reason: "Speaker cabinet emulation after overdrive for realistic guitar tone"
+  - device: "Reverb"
+    reason: "Room reverb after overdrive for guitar-in-a-room feel"
+
+starter_recipes:
+  - name: "Guitar Crunch"
+    description: "Classic rock crunch overdrive for guitar"
+    genre: rock
+    params:
+      Drive: 45.0
+      Tone: 55.0
+      Dynamics: 60.0
+      Bandwidth: 70.0
+      "Dry/Wet": 100.0
+
+  - name: "Synth Warmth"
+    description: "Subtle warmth and harmonics on synthesizers"
+    genre: electronic
+    params:
+      Drive: 20.0
+      Tone: 40.0
+      Dynamics: 70.0
+      Bandwidth: 60.0
+      "Dry/Wet": 60.0
+
+  - name: "Lo-Fi Character"
+    description: "Dark, compressed overdrive for lo-fi aesthetics"
+    genre: lo_fi
+    params:
+      Drive: 50.0
+      Tone: 25.0
+      Dynamics: 30.0
+      Bandwidth: 50.0
+      "Dry/Wet": 80.0
+
+gotchas:
+  - "Dynamics at 0% means maximum compression — the overdrive output is very consistent but lifeless"
+  - "Bandwidth narrows the affected frequency range — use to target mids for guitar-like breakup"
+  - "Less versatile than Saturator for mixing saturation — more suited to creative distortion"
+  - "Tone control interacts with Drive — high Tone + high Drive can be very harsh"
+  - "No waveshaping curve selection like Saturator — the character is fixed (tube-style)"