livepilot 1.9.24 → 1.10.1

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

@@ -0,0 +1,145 @@
+id: pedal
+name: Pedal
+sonic_description: >
+  Guitar pedal emulation with three distinct modes — Overdrive (warm tube breakup),
+  Distortion (aggressive clipping), and Fuzz (thick, woolly saturation). Includes a
+  three-band tone stack (Bass/Mid/Treble) for shaping the distortion character like
+  a real guitar pedalboard.
+effect_type: distortion
+character_tags: [guitar, crunchy, warm, aggressive, fuzzy]
+use_cases: [guitar_tone, fuzz_bass, distortion_lead, overdrive_crunch, creative_destruction]
+genre_affinity:
+  primary: [rock, indie, stoner, garage]
+  secondary: [electronic, lo_fi, shoegaze]
+complexity: beginner
+signal_type: audio
+introduced_in: "10.0"
+
+key_parameters:
+  - name: "Type"
+    description: "Pedal emulation type — each has a distinct distortion character"
+    range: ["Overdrive", "Distortion", "Fuzz"]
+    type: enum
+    sweet_spots:
+      warm_crunch: "Overdrive"
+      aggressive: "Distortion"
+      thick: "Fuzz"
+
+  - name: "Gain"
+    description: "Amount of distortion — higher values increase clipping and harmonics"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      edge_of_breakup: 20.0
+      crunch: 45.0
+      heavy: 70.0
+      maxed: 100.0
+
+  - name: "Output"
+    description: "Output volume after distortion"
+    range: [-inf, 0.0]
+    unit: dB
+    type: float
+    sweet_spots:
+      compensate: -6.0
+      quiet: -12.0
+
+  - name: "Bass"
+    description: "Low-frequency tone control"
+    range: [-1.0, 1.0]
+    type: float
+    sweet_spots:
+      cut: -0.5
+      flat: 0.0
+      boost: 0.5
+
+  - name: "Mid"
+    description: "Mid-frequency tone control — critical for cut-through"
+    range: [-1.0, 1.0]
+    type: float
+    sweet_spots:
+      scooped: -0.6
+      flat: 0.0
+      honky: 0.5
+
+  - name: "Treble"
+    description: "High-frequency tone control"
+    range: [-1.0, 1.0]
+    type: float
+    sweet_spots:
+      dark: -0.5
+      flat: 0.0
+      bright: 0.5
+
+  - name: "Sub"
+    description: "Sub-bass emphasis below the tone stack"
+    type: toggle
+    range: [0, 1]
+    sweet_spots:
+      off: 0
+      bass_heavy: 1
+
+  - name: "Dry/Wet"
+    description: "Mix between clean and distorted signal"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      full: 100.0
+      blend: 60.0
+
+pairs_well_with:
+  - device: "Cabinet"
+    reason: "Speaker cabinet emulation completes the amp simulation chain"
+  - device: "EQ Eight"
+    reason: "Detailed EQ shaping after the pedal for precise tonal control"
+  - device: "Reverb"
+    reason: "Spring or room reverb after pedal for realistic guitar tones"
+  - device: "Delay"
+    reason: "Classic guitar delay after distortion pedal"
+  - device: "Chorus-Ensemble"
+    reason: "Chorus after overdrive for 80s clean-crunch tone"
+
+starter_recipes:
+  - name: "Fuzz Bass"
+    description: "Thick, fuzzy bass distortion for stoner or psychedelic music"
+    genre: stoner
+    params:
+      Type: "Fuzz"
+      Gain: 60.0
+      Bass: 0.3
+      Mid: -0.2
+      Treble: -0.3
+      Sub: 1
+      Output: -8.0
+
+  - name: "Distortion Lead"
+    description: "Aggressive lead guitar distortion with mid presence"
+    genre: rock
+    params:
+      Type: "Distortion"
+      Gain: 65.0
+      Bass: 0.0
+      Mid: 0.3
+      Treble: 0.2
+      Output: -6.0
+
+  - name: "Overdrive Crunch"
+    description: "Warm, responsive crunch that cleans up with playing dynamics"
+    genre: blues
+    params:
+      Type: "Overdrive"
+      Gain: 35.0
+      Bass: 0.1
+      Mid: 0.1
+      Treble: 0.0
+      Output: -4.0
+
+gotchas:
+  - "Each Type sounds dramatically different — Overdrive is subtle, Fuzz is extreme"
+  - "Gain interacts strongly with input level — hotter inputs drive harder into clipping"
+  - "Mid control is crucial for guitars — boosted mids cut through a mix, scooped mids sit behind"
+  - "Sub toggle adds significant low-end energy — watch for muddiness, especially with Fuzz"
+  - "Output level needs compensation — high Gain settings significantly increase volume"
+  - "Works on synths and drums too, not just guitar — Fuzz on drums is a classic technique"

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

@@ -0,0 +1,161 @@
+id: phaser_flanger
+name: Phaser-Flanger
+sonic_description: >
+  Combined phaser and flanger effect with three modes — Phaser (sweeping notch filters),
+  Flanger (short modulated delay), and Doubler (subtle stereo widening). Creates everything
+  from subtle movement to dramatic jet-engine sweeps and metallic textures.
+effect_type: modulation
+character_tags: [sweeping, metallic, jet, wide, psychedelic]
+use_cases: [phaser_sweep, jet_flanger, stereo_doubling, metallic_texture, psychedelic_effect]
+genre_affinity:
+  primary: [psychedelic, electronic, funk, rock]
+  secondary: [synthwave, ambient, pop, progressive]
+complexity: beginner
+signal_type: audio
+introduced_in: "11.0"
+
+key_parameters:
+  - name: "Mode"
+    description: "Effect type — Phaser, Flanger, or Doubler"
+    range: ["Phaser", "Flanger", "Doubler"]
+    type: enum
+    sweet_spots:
+      notch_sweep: "Phaser"
+      jet_whoosh: "Flanger"
+      width: "Doubler"
+
+  - name: "Rate"
+    description: "LFO speed controlling the sweep"
+    range: [0.01, 20.0]
+    unit: Hz
+    type: float
+    sweet_spots:
+      slow_sweep: 0.2
+      moderate: 1.0
+      fast: 5.0
+
+  - name: "Amount"
+    description: "Depth of the modulation sweep"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      subtle: 20.0
+      moderate: 45.0
+      deep: 75.0
+      extreme: 100.0
+
+  - name: "Feedback"
+    description: "Intensity of the effect — higher values create more pronounced resonances"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      subtle: 15.0
+      moderate: 40.0
+      intense: 70.0
+      metallic: 90.0
+
+  - name: "Center"
+    description: "Center frequency of the modulation sweep"
+    range: [20.0, 20000.0]
+    unit: Hz
+    type: float
+    sweet_spots:
+      low: 200.0
+      mid: 1000.0
+      high: 4000.0
+
+  - name: "Spread"
+    description: "Stereo spread of the modulation — creates wide sweeps"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      mono: 0.0
+      moderate: 50.0
+      wide: 100.0
+
+  - name: "Width"
+    description: "Stereo width of the output"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      narrow: 30.0
+      normal: 70.0
+      wide: 100.0
+
+  - name: "Dry/Wet"
+    description: "Mix between dry and effected signal"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      subtle: 20.0
+      moderate: 40.0
+      heavy: 60.0
+
+pairs_well_with:
+  - device: "Overdrive"
+    reason: "Distortion before phaser for classic psychedelic guitar tone"
+  - device: "Reverb"
+    reason: "Reverb after flanger smears the metallic sweeps into a wash"
+  - device: "Delay"
+    reason: "Echo after phaser for spacious, evolving repeats"
+  - device: "Auto Filter"
+    reason: "Layer filter sweep with phaser for complex modulation"
+
+starter_recipes:
+  - name: "Jet Flanger"
+    description: "Classic jet engine flanging effect"
+    genre: rock
+    params:
+      Mode: "Flanger"
+      Rate: 0.3
+      Amount: 60.0
+      Feedback: 65.0
+      Center: 800.0
+      "Dry/Wet": 50.0
+
+  - name: "Subtle Phase"
+    description: "Gentle phaser movement for synth pads or clean guitar"
+    genre: pop
+    params:
+      Mode: "Phaser"
+      Rate: 0.5
+      Amount: 30.0
+      Feedback: 25.0
+      Center: 1500.0
+      "Dry/Wet": 35.0
+
+  - name: "Metallic Sweep"
+    description: "Intense, resonant phaser sweep for psychedelic textures"
+    genre: psychedelic
+    params:
+      Mode: "Phaser"
+      Rate: 0.15
+      Amount: 80.0
+      Feedback: 80.0
+      Center: 1000.0
+      Spread: 80.0
+      "Dry/Wet": 55.0
+
+  - name: "Stereo Doubler"
+    description: "Subtle stereo widening without obvious modulation"
+    genre: all
+    params:
+      Mode: "Doubler"
+      Rate: 0.8
+      Amount: 20.0
+      Feedback: 0.0
+      Width: 100.0
+      "Dry/Wet": 30.0
+
+gotchas:
+  - "Phaser creates notches in the spectrum; Flanger uses a short delay — they sound fundamentally different"
+  - "High Feedback in Flanger mode creates metallic, resonant sounds — can be harsh"
+  - "Doubler mode is designed for subtle widening — don't push Amount or Feedback too high"
+  - "Check mono compatibility — phaser and flanger can cause significant phase cancellation"
+  - "Center frequency determines where in the spectrum the sweep occurs — low Center for bass-heavy sweeps"
+  - "Spread creates left/right phase offset in the sweep — increases stereo width but can thin mono sum"

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

@@ -0,0 +1,114 @@
+id: redux
+name: Redux
+sonic_description: >
+  Bit reduction and downsampling effect that reduces audio fidelity by quantizing
+  amplitude (bit depth) and reducing sample rate. Creates classic retro digital sounds,
+  from subtle lo-fi warmth at mild settings to extreme 1-bit crunchy noise at
+  aggressive settings.
+effect_type: distortion
+character_tags: [lo_fi, retro, crushed, digital, 8_bit]
+use_cases: [lo_fi, bitcrush, retro_gaming, downsample, creative_destruction]
+genre_affinity:
+  primary: [lo_fi, chiptune, electronic, hip_hop]
+  secondary: [glitch, experimental, idm]
+complexity: beginner
+signal_type: audio
+introduced_in: "1.0"
+
+key_parameters:
+  - name: "Bit Depth"
+    description: "Reduces the number of amplitude levels — lower values = more quantization noise"
+    range: [1, 16]
+    type: int
+    sweet_spots:
+      subtle: 12
+      lo_fi: 8
+      crushed: 4
+      extreme: 2
+      one_bit: 1
+
+  - name: "Downsample"
+    description: "Reduces the effective sample rate — creates aliasing and frequency folding"
+    range: [1, 200]
+    type: int
+    sweet_spots:
+      subtle: 2
+      lo_fi: 8
+      crushed: 20
+      extreme: 50
+      destroyed: 200
+
+  - name: "Downsample Mode"
+    description: "How downsampling is applied — Soft is smoother, Hard is more aliased"
+    range: ["Soft", "Hard"]
+    type: enum
+    sweet_spots:
+      smooth: "Soft"
+      aliased: "Hard"
+
+  - name: "Jitter"
+    description: "Randomizes the sample rate reduction for noisy, unstable character"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      off: 0.0
+      subtle: 10.0
+      noisy: 40.0
+
+  - name: "Dry/Wet"
+    description: "Mix between clean and reduced signal"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      full: 100.0
+      parallel: 50.0
+      subtle: 30.0
+
+pairs_well_with:
+  - device: "Erosion"
+    reason: "Layer Redux with Erosion for full digital degradation"
+  - device: "Saturator"
+    reason: "Warm saturation before Redux softens the harsh digital artifacts"
+  - device: "Auto Filter"
+    reason: "Filter after Redux to tame harsh aliasing frequencies"
+  - device: "EQ Eight"
+    reason: "Cut high frequencies after downsampling to control aliasing"
+
+starter_recipes:
+  - name: "Lo-Fi 12-Bit"
+    description: "Subtle quality reduction for lo-fi hip-hop or chillwave aesthetics"
+    genre: lo_fi
+    params:
+      "Bit Depth": 12
+      Downsample: 3
+      "Downsample Mode": "Soft"
+      "Dry/Wet": 100.0
+
+  - name: "Extreme Bitcrush"
+    description: "Heavy bit and sample rate reduction for glitch and experimental"
+    genre: glitch
+    params:
+      "Bit Depth": 4
+      Downsample: 20
+      "Downsample Mode": "Hard"
+      "Dry/Wet": 80.0
+
+  - name: "Retro Gaming"
+    description: "8-bit chiptune character for retro game-style sounds"
+    genre: chiptune
+    params:
+      "Bit Depth": 8
+      Downsample: 10
+      "Downsample Mode": "Hard"
+      Jitter: 5.0
+      "Dry/Wet": 100.0
+
+gotchas:
+  - "Bit Depth of 1 is extreme — the signal becomes a square wave at the input frequency"
+  - "Downsampling creates aliasing that folds frequencies back down — can produce unexpected tones"
+  - "Hard mode produces more aliasing artifacts; Soft mode smooths the downsampling"
+  - "Very heavy settings can make the audio unrecognizable — use Dry/Wet for parallel blending"
+  - "Low Bit Depth adds significant noise floor — compensate with a noise gate if needed"
+  - "Jitter adds randomness to the sample rate — creates a more organic, unstable character"

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

@@ -0,0 +1,190 @@
+id: reverb
+name: Reverb
+sonic_description: >
+  Algorithmic reverb that simulates acoustic spaces from small rooms to infinite drones.
+  Features independent early reflection and diffuse tail controls, input filtering, chorus
+  modulation, and a Freeze function that infinitely sustains the current reverb cloud.
+effect_type: reverb
+character_tags: [spacious, atmospheric, versatile, lush, ambient]
+use_cases: [room_simulation, spatial_depth, ambient_wash, vocal_reverb, drum_room, infinite_drone]
+genre_affinity:
+  primary: [all]
+  secondary: []
+complexity: beginner
+signal_type: audio
+introduced_in: "1.0"
+
+key_parameters:
+  - name: "Decay Time"
+    description: "Length of the reverb tail in seconds"
+    range: [0.2, 60.0]
+    unit: s
+    type: float
+    sweet_spots:
+      tight_room: 0.5
+      small_room: 1.2
+      hall: 3.0
+      cathedral: 6.0
+      infinite: 60.0
+
+  - name: "Pre Delay"
+    description: "Delay before reverb onset — separates dry signal from reverb"
+    range: [0.0, 500.0]
+    unit: ms
+    type: float
+    sweet_spots:
+      intimate: 0.0
+      vocal: 20.0
+      large_space: 50.0
+      separated: 100.0
+
+  - name: "Room Size"
+    description: "Size of the simulated space — affects early reflection pattern"
+    range: [0.0, 500.0]
+    type: float
+    sweet_spots:
+      small: 50.0
+      medium: 150.0
+      large: 300.0
+      huge: 500.0
+
+  - name: "Diffusion"
+    description: "Density of reflections — higher values sound smoother"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      sparse: 30.0
+      moderate: 60.0
+      dense: 90.0
+
+  - name: "ER Level"
+    description: "Early reflections level — provides room character and spatial cues"
+    range: [-inf, 6.0]
+    unit: dB
+    type: float
+    sweet_spots:
+      off: -inf
+      subtle: -6.0
+      present: 0.0
+
+  - name: "Diffuse Level"
+    description: "Diffuse tail level — the main body of the reverb"
+    range: [-inf, 6.0]
+    unit: dB
+    type: float
+    sweet_spots:
+      subtle: -6.0
+      normal: 0.0
+
+  - name: "High Cut"
+    description: "Low-pass filter on the reverb — darkens the tail"
+    range: [20.0, 20000.0]
+    unit: Hz
+    type: float
+    sweet_spots:
+      dark: 2000.0
+      warm: 4000.0
+      natural: 8000.0
+      bright: 15000.0
+
+  - name: "Low Cut"
+    description: "High-pass filter on the reverb — removes muddy low frequencies"
+    range: [20.0, 20000.0]
+    unit: Hz
+    type: float
+    sweet_spots:
+      off: 20.0
+      clean: 100.0
+      thin: 300.0
+
+  - name: "Chorus Amount"
+    description: "Chorus modulation on the reverb tail — adds movement"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      off: 0.0
+      subtle: 20.0
+      lush: 50.0
+
+  - name: "Freeze"
+    description: "Infinitely sustains the current reverb — great for drones and transitions"
+    type: toggle
+    range: [0, 1]
+
+  - name: "Dry/Wet"
+    description: "Mix between dry and reverb signal"
+    range: [0.0, 100.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      touch: 10.0
+      subtle: 20.0
+      moderate: 35.0
+      lush: 50.0
+      return_track: 100.0
+
+pairs_well_with:
+  - device: "EQ Eight"
+    reason: "Cut low-end before reverb to prevent muddiness; shape reverb tone after"
+  - device: "Delay"
+    reason: "Delay before reverb for depth, or reverb before delay for washy echoes"
+  - device: "Compressor"
+    reason: "Compress the reverb return for controlled, even tails"
+  - device: "Utility"
+    reason: "Width control on the reverb return — mono reverb sits tighter in the mix"
+
+starter_recipes:
+  - name: "Small Room"
+    description: "Tight, natural-sounding room for drums or guitars"
+    genre: all
+    params:
+      "Decay Time": 0.8
+      "Pre Delay": 5.0
+      "Room Size": 80.0
+      Diffusion: 70.0
+      "High Cut": 6000.0
+      "Dry/Wet": 20.0
+
+  - name: "Large Hall"
+    description: "Spacious concert hall for orchestral or cinematic sounds"
+    genre: cinematic
+    params:
+      "Decay Time": 3.5
+      "Pre Delay": 30.0
+      "Room Size": 300.0
+      Diffusion: 85.0
+      "High Cut": 8000.0
+      "Low Cut": 100.0
+      "Dry/Wet": 30.0
+
+  - name: "Infinite Drone"
+    description: "Sustained reverb cloud for ambient and drone textures"
+    genre: ambient
+    params:
+      "Decay Time": 60.0
+      "Pre Delay": 0.0
+      Diffusion: 100.0
+      "Chorus Amount": 40.0
+      "Dry/Wet": 80.0
+
+  - name: "Vocal Plate"
+    description: "Bright, clear reverb for vocals with pre-delay separation"
+    genre: pop
+    params:
+      "Decay Time": 1.5
+      "Pre Delay": 25.0
+      "Room Size": 120.0
+      Diffusion: 90.0
+      "High Cut": 10000.0
+      "Low Cut": 200.0
+      "Dry/Wet": 20.0
+
+gotchas:
+  - "On return tracks, set Dry/Wet to 100% — control the reverb amount with the send level"
+  - "Always cut low frequencies (Low Cut at 100-200 Hz) to prevent muddy reverb buildup"
+  - "Freeze captures whatever is currently in the reverb buffer — automate it for transitions"
+  - "Pre Delay above 20ms helps keep the dry signal distinct from the reverb, crucial for clarity"
+  - "Chorus Amount adds modulation but also subtle pitch variation — turn off for surgical reverb"
+  - "Very long Decay Times with high Diffusion can mask rhythmic detail — match decay to tempo"