livepilot 1.9.23 → 1.10.0

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

@@ -0,0 +1,167 @@
+id: echo
+name: Echo
+sonic_description: >
+  Character-rich delay combining echo, modulation, reverb, ducking, and gate in one device.
+  More colorful than Delay — the built-in modulation adds chorus-like movement, the reverb
+  smears echoes, and ducking automatically lowers repeats when new audio arrives.
+effect_type: delay
+character_tags: [warm, modulated, characterful, musical, dub]
+use_cases: [dub_echo, modulated_delay, ducking_delay, creative_echo, ambient]
+genre_affinity:
+  primary: [dub, ambient, electronic, indie]
+  secondary: [pop, rock, shoegaze]
+complexity: intermediate
+signal_type: audio
+introduced_in: "10.0"
+
+key_parameters:
+  - name: "Left Time"
+    description: "Delay time for left channel — tempo-synced or free"
+    range: ["1/16", "1/8T", "1/8", "3/16", "1/4T", "1/4", "3/8", "1/2", "1"]
+    type: enum
+    sweet_spots:
+      eighth: "1/8"
+      dotted_eighth: "3/16"
+      quarter: "1/4"
+
+  - name: "Right Time"
+    description: "Delay time for right channel"
+    range: ["1/16", "1/8T", "1/8", "3/16", "1/4T", "1/4", "3/8", "1/2", "1"]
+    type: enum
+    sweet_spots:
+      eighth: "1/8"
+      dotted_eighth: "3/16"
+      quarter: "1/4"
+
+  - name: "Feedback"
+    description: "Amount of echo fed back — controls repeat count and buildup"
+    range: [0.0, 110.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      few_taps: 30.0
+      dub: 60.0
+      self_oscillate: 100.0
+
+  - name: "Mod Rate"
+    description: "Speed of chorus/modulation on the delay taps"
+    range: [0.01, 20.0]
+    unit: Hz
+    type: float
+    sweet_spots:
+      slow: 0.5
+      moderate: 2.0
+      fast: 6.0
+
+  - name: "Mod Depth"
+    description: "Depth of pitch modulation on echoes"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      subtle: 10.0
+      tape: 30.0
+      heavy: 60.0
+
+  - name: "Reverb Level"
+    description: "Built-in reverb amount on the echo signal"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      off: 0.0
+      subtle: 20.0
+      washy: 50.0
+
+  - name: "Reverb Decay"
+    description: "Reverb tail length"
+    range: [0.1, 10.0]
+    unit: s
+    type: float
+    sweet_spots:
+      short: 0.5
+      medium: 1.5
+      long: 4.0
+
+  - name: "Duck Amount"
+    description: "How much the echo ducks when new input arrives — keeps echoes out of the way"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      off: 0.0
+      subtle: 30.0
+      heavy: 70.0
+      full: 100.0
+
+  - name: "Gate"
+    description: "Gate threshold for rhythmic chopping of the echo tail"
+    range: [-inf, 0.0]
+    unit: dB
+    type: float
+    sweet_spots:
+      off: -inf
+      gate: -20.0
+
+  - name: "Dry/Wet"
+    description: "Mix between dry and echoed signal"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      subtle: 15.0
+      moderate: 25.0
+      heavy: 40.0
+      return_track: 100.0
+
+pairs_well_with:
+  - device: "EQ Eight"
+    reason: "Shape echo tone — cut lows before to prevent muddiness"
+  - device: "Saturator"
+    reason: "Warm saturation on Echo's output for tape-delay character"
+  - device: "Auto Filter"
+    reason: "Dynamic filtering of the echo trail for movement"
+  - device: "Compressor"
+    reason: "Tame echo dynamics on return tracks"
+
+starter_recipes:
+  - name: "Dub Echo"
+    description: "Classic dub delay with modulation and reverb wash"
+    genre: dub
+    params:
+      "Left Time": "3/16"
+      "Right Time": "1/4"
+      Feedback: 55.0
+      "Mod Rate": 1.5
+      "Mod Depth": 25.0
+      "Reverb Level": 30.0
+      "Dry/Wet": 30.0
+
+  - name: "Modulated Tape"
+    description: "Warm, wobbly tape-delay character with pitch variation"
+    genre: indie
+    params:
+      "Left Time": "1/8"
+      "Right Time": "1/8"
+      Feedback: 40.0
+      "Mod Rate": 0.8
+      "Mod Depth": 45.0
+      "Dry/Wet": 25.0
+
+  - name: "Ducking Delay"
+    description: "Echo that stays out of the way during performance, fills gaps"
+    genre: pop
+    params:
+      "Left Time": "1/4"
+      "Right Time": "1/4"
+      Feedback: 35.0
+      "Duck Amount": 60.0
+      "Reverb Level": 15.0
+      "Dry/Wet": 30.0
+
+gotchas:
+  - "Feedback above 100% causes intentional self-oscillation — use for buildup effects, reduce quickly"
+  - "Ducking is key for keeping echoes musical — set Duck Amount to 50-70% for clean performances"
+  - "Mod Depth at high values causes noticeable pitch wobble — can be a feature or a problem"
+  - "The built-in reverb is basic — for complex reverb tails, chain a dedicated Reverb after Echo"
+  - "Gate parameter is separate from the Gate device — it chops the echo tail rhythmically"

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

@@ -0,0 +1,148 @@
+id: eq_eight
+name: EQ Eight
+sonic_description: >
+  Eight-band fully parametric equalizer — the workhorse of Ableton's mixing toolkit.
+  Each band offers selectable filter types with adjustable frequency, gain, and Q. Supports
+  oversampling for cleaner high-frequency processing and adaptive Q for natural-sounding boosts.
+effect_type: eq
+character_tags: [transparent, surgical, precise, clean, versatile]
+use_cases: [mixing, mastering, surgical_eq, tonal_shaping, highpass, problem_solving]
+genre_affinity:
+  primary: [all]
+  secondary: []
+complexity: beginner
+signal_type: audio
+introduced_in: "8.0"
+
+key_parameters:
+  - name: "Band 1 Type"
+    description: "Filter type for band 1"
+    range: ["HP 12", "HP 24", "HP 48", "Low Shelf", "Bell", "Notch", "High Shelf", "LP 12", "LP 24", "LP 48"]
+    type: enum
+    sweet_spots:
+      highpass: "HP 48"
+      low_shelf: "Low Shelf"
+
+  - name: "Band 1 Freq"
+    description: "Center/cutoff frequency for band 1"
+    range: [20.0, 20000.0]
+    unit: Hz
+    type: float
+    sweet_spots:
+      rumble_filter: 30.0
+      vocal_hp: 80.0
+      mud_cut: 300.0
+
+  - name: "Band 1 Gain"
+    description: "Gain for band 1 (bell/shelf types)"
+    range: [-15.0, 15.0]
+    unit: dB
+    type: float
+    sweet_spots:
+      subtle_cut: -3.0
+      moderate_boost: 3.0
+
+  - name: "Band 1 Q"
+    description: "Bandwidth/resonance — higher Q = narrower band"
+    range: [0.1, 18.0]
+    type: float
+    sweet_spots:
+      broad: 0.7
+      moderate: 1.4
+      surgical: 5.0
+      notch: 12.0
+
+  - name: "Band 4 Freq"
+    description: "Center frequency for band 4 — often used for presence"
+    range: [20.0, 20000.0]
+    unit: Hz
+    type: float
+    sweet_spots:
+      presence: 3000.0
+      vocal_clarity: 5000.0
+
+  - name: "Band 4 Gain"
+    description: "Gain for band 4"
+    range: [-15.0, 15.0]
+    unit: dB
+    type: float
+    sweet_spots:
+      presence_boost: 2.0
+      honk_cut: -3.0
+
+  - name: "Band 8 Type"
+    description: "Filter type for band 8 — commonly used as low-pass"
+    range: ["HP 12", "HP 24", "HP 48", "Low Shelf", "Bell", "Notch", "High Shelf", "LP 12", "LP 24", "LP 48"]
+    type: enum
+    sweet_spots:
+      lowpass: "LP 24"
+      high_shelf: "High Shelf"
+
+  - name: "Oversampling"
+    description: "Reduces aliasing at high frequencies — use for mastering"
+    type: toggle
+    range: [0, 1]
+    sweet_spots:
+      off: 0
+      mastering: 1
+
+  - name: "Scale"
+    description: "Scales all band gains proportionally — useful for A/B comparison"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      full: 100.0
+      bypassed: 0.0
+
+pairs_well_with:
+  - device: "Compressor"
+    reason: "EQ before compression to prevent low-end pumping"
+  - device: "Saturator"
+    reason: "Shape tone before saturation to control harmonic content"
+  - device: "Reverb"
+    reason: "Cut low-end before reverb to prevent muddy tails"
+  - device: "Utility"
+    reason: "EQ for tone, Utility for level — complete channel strip"
+
+starter_recipes:
+  - name: "Surgical Mud Cut"
+    description: "Remove boxy mud frequencies to clean up any source"
+    genre: all
+    params:
+      "Band 1 Type": "Bell"
+      "Band 1 Freq": 400.0
+      "Band 1 Gain": -3.0
+      "Band 1 Q": 1.4
+
+  - name: "Presence Boost"
+    description: "Add clarity and presence to vocals or leads"
+    genre: all
+    params:
+      "Band 4 Type": "Bell"
+      "Band 4 Freq": 3000.0
+      "Band 4 Gain": 2.0
+      "Band 4 Q": 1.0
+
+  - name: "High-Pass Everything"
+    description: "Remove subsonic rumble from any non-bass track"
+    genre: all
+    params:
+      "Band 1 Type": "HP 48"
+      "Band 1 Freq": 30.0
+
+  - name: "Air Shelf"
+    description: "Add brightness and air to the top end"
+    genre: pop
+    params:
+      "Band 8 Type": "High Shelf"
+      "Band 8 Freq": 10000.0
+      "Band 8 Gain": 2.5
+
+gotchas:
+  - "All 8 bands are off by default — enable each band individually with the power toggle"
+  - "Oversampling doubles CPU usage — use only when needed (mastering, high-frequency bell boosts)"
+  - "Cutting is almost always better than boosting — if something sounds dull, cut elsewhere rather than boosting"
+  - "The analyzer shows input (gray) and output (colored) — use it to verify your moves"
+  - "Very high Q values (>8) are for surgical notch cuts, not musical shaping"
+  - "HP filter on every non-bass track at 20-40 Hz is good practice to remove inaudible energy"

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

@@ -0,0 +1,121 @@
+id: eq_three
+name: EQ Three
+sonic_description: >
+  Simple three-band EQ with low, mid, and high gain controls plus crossover frequency
+  adjustment and per-band kill switches. Designed for quick tonal adjustments and DJ-style
+  frequency isolation rather than surgical precision.
+effect_type: eq
+character_tags: [simple, quick, dj_style, performable]
+use_cases: [dj_mixing, quick_eq, live_performance, frequency_kill]
+genre_affinity:
+  primary: [house, techno, dj]
+  secondary: [all]
+complexity: beginner
+signal_type: audio
+introduced_in: "1.0"
+
+key_parameters:
+  - name: "GainLo"
+    description: "Low band gain"
+    range: [-inf, 6.0]
+    unit: dB
+    type: float
+    sweet_spots:
+      cut: -6.0
+      unity: 0.0
+      boost: 3.0
+
+  - name: "GainMid"
+    description: "Mid band gain"
+    range: [-inf, 6.0]
+    unit: dB
+    type: float
+    sweet_spots:
+      cut: -6.0
+      unity: 0.0
+      boost: 3.0
+
+  - name: "GainHi"
+    description: "High band gain"
+    range: [-inf, 6.0]
+    unit: dB
+    type: float
+    sweet_spots:
+      cut: -6.0
+      unity: 0.0
+      boost: 3.0
+
+  - name: "FreqLo"
+    description: "Low/Mid crossover frequency"
+    range: [20.0, 20000.0]
+    unit: Hz
+    type: float
+    sweet_spots:
+      standard: 250.0
+      deep: 120.0
+
+  - name: "FreqHi"
+    description: "Mid/High crossover frequency"
+    range: [20.0, 20000.0]
+    unit: Hz
+    type: float
+    sweet_spots:
+      standard: 2500.0
+      bright: 4000.0
+
+  - name: "LowOn"
+    description: "Low band kill switch — instantly mutes the low band"
+    type: toggle
+    range: [0, 1]
+
+  - name: "MidOn"
+    description: "Mid band kill switch — instantly mutes the mid band"
+    type: toggle
+    range: [0, 1]
+
+  - name: "HighOn"
+    description: "High band kill switch — instantly mutes the high band"
+    type: toggle
+    range: [0, 1]
+
+pairs_well_with:
+  - device: "Utility"
+    reason: "Volume trim after EQ adjustments"
+  - device: "Auto Filter"
+    reason: "EQ Three for static shaping, Auto Filter for dynamic movement"
+  - device: "Beat Repeat"
+    reason: "EQ before Beat Repeat to control which frequencies get repeated"
+
+starter_recipes:
+  - name: "DJ-Style EQ"
+    description: "Standard DJ isolator setup — ready for live frequency kills"
+    genre: dj
+    params:
+      GainLo: 0.0
+      GainMid: 0.0
+      GainHi: 0.0
+      FreqLo: 250.0
+      FreqHi: 2500.0
+
+  - name: "Quick Mix Adjustment"
+    description: "Warm up a thin mix or thin out a boomy one"
+    genre: all
+    params:
+      GainLo: 2.0
+      GainMid: -1.5
+      GainHi: 1.0
+
+  - name: "Bass Kill Transition"
+    description: "Remove low end for build-up tension — automate LowOn"
+    genre: electronic
+    params:
+      LowOn: 0
+      GainMid: 0.0
+      GainHi: 0.0
+
+gotchas:
+  - "Kill switches create abrupt frequency changes — use gain knobs for smoother transitions"
+  - "Less precise than EQ Eight — use for quick adjustments, not surgical work"
+  - "The crossover slopes are relatively gentle — frequencies bleed between bands"
+  - "No Q control — each band has a fixed bandwidth"
+  - "Good for performance mapping to MIDI controllers due to simple parameter set"

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

@@ -0,0 +1,103 @@
+id: erosion
+name: Erosion
+sonic_description: >
+  Frequency-dependent degradation effect that modulates the input signal with a sine wave
+  or noise to create aliasing, digital artifacts, and spectral erosion. Produces digital
+  dirt, metallic textures, and lo-fi degradation that sounds distinctly different from
+  analog-style distortion.
+effect_type: distortion
+character_tags: [digital, gritty, metallic, lo_fi, degraded]
+use_cases: [digital_dirt, lo_fi_texture, aliasing, metallic_effects, subtle_degradation]
+genre_affinity:
+  primary: [electronic, glitch, lo_fi, experimental]
+  secondary: [idm, industrial, sound_design]
+complexity: beginner
+signal_type: audio
+introduced_in: "1.0"
+
+key_parameters:
+  - name: "Amount"
+    description: "Intensity of the erosion effect — how much degradation is applied"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      subtle: 10.0
+      moderate: 30.0
+      heavy: 60.0
+      extreme: 100.0
+
+  - name: "Frequency"
+    description: "Frequency of the modulation source — targets where the degradation occurs"
+    range: [20.0, 20000.0]
+    unit: Hz
+    type: float
+    sweet_spots:
+      low_rumble: 200.0
+      mid_grit: 2000.0
+      high_fizz: 8000.0
+      ultra_high: 15000.0
+
+  - name: "Mode"
+    description: "Type of modulation — Sine (tonal), Noise (broadband), Wide Noise (stereo)"
+    range: ["Sine", "Noise", "Wide Noise"]
+    type: enum
+    sweet_spots:
+      tonal_alias: "Sine"
+      broadband: "Noise"
+      stereo_noise: "Wide Noise"
+
+  - name: "Width"
+    description: "Bandwidth of the noise modulation (Noise modes only)"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      narrow: 20.0
+      moderate: 50.0
+      wide: 80.0
+
+pairs_well_with:
+  - device: "Saturator"
+    reason: "Layer digital erosion with analog saturation for complex texture"
+  - device: "Redux"
+    reason: "Combine with bit reduction for full lo-fi destruction"
+  - device: "EQ Eight"
+    reason: "Shape which frequencies reach the erosion for targeted degradation"
+  - device: "Auto Filter"
+    reason: "Dynamic filtering after erosion to control harsh artifacts"
+
+starter_recipes:
+  - name: "Subtle Digital Dirt"
+    description: "Light digital texture that adds edge without obvious distortion"
+    genre: electronic
+    params:
+      Amount: 12.0
+      Frequency: 5000.0
+      Mode: "Noise"
+      Width: 40.0
+
+  - name: "Harsh Noise"
+    description: "Aggressive noise erosion for industrial or experimental textures"
+    genre: industrial
+    params:
+      Amount: 60.0
+      Frequency: 3000.0
+      Mode: "Wide Noise"
+      Width: 80.0
+
+  - name: "Aliasing Effect"
+    description: "Sine-wave modulation for metallic, aliased textures"
+    genre: glitch
+    params:
+      Amount: 40.0
+      Frequency: 7000.0
+      Mode: "Sine"
+
+gotchas:
+  - "Sine mode creates tonal artifacts at the set Frequency — these can clash with musical content"
+  - "Very different from analog distortion — produces digital artifacts, not warm harmonics"
+  - "Amount at high values with high Frequency can be extremely harsh — start low"
+  - "Wide Noise mode creates stereo-decorrelated noise modulation — good for width but can sound phasey"
+  - "Works best as a subtle texture layer — a little goes a long way"
+  - "Frequency parameter determines the character more than Amount in many cases"