livepilot 1.9.23 → 1.10.0

package/mcp_server/atlas/enrichments/instruments/bass.yaml

@@ -0,0 +1,202 @@
+id: bass
+name: Bass
+sonic_description: >
+  Purpose-built bass synthesizer with focused controls optimized for low-end production.
+  Features a streamlined signal path with oscillator, integrated distortion, compression,
+  and filter designed specifically for bass frequencies. Delivers everything from clean
+  sub-bass to aggressive, distorted bass lines with less tweaking than general-purpose synths.
+synthesis_type: subtractive
+character_tags: [deep, powerful, focused, punchy, low_end]
+use_cases: [sub_bass, distorted_bass, funk_bass, bass_lines, low_end]
+genre_affinity:
+  primary: [hip_hop, house, dnb, pop]
+  secondary: [techno, trap, r_and_b, funk, dubstep]
+complexity: beginner
+self_contained: true
+introduced_in: "12.0"
+
+key_parameters:
+  - name: "Osc Shape"
+    description: "Oscillator waveform shape — determines the harmonic foundation of the bass"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      pure_sub: 0.0
+      warm_saw: 0.5
+      buzzy_square: 1.0
+
+  - name: "Sub Level"
+    description: "Sub-harmonic oscillator level — adds pure low-end weight below the main oscillator"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      off: 0.0
+      subtle_weight: 0.3
+      heavy_sub: 0.7
+      dominant: 1.0
+
+  - name: "Filter Freq"
+    description: "Low-pass filter cutoff — controls how much harmonic content passes through"
+    range: [20.0, 20000.0]
+    unit: "Hz"
+    type: float
+    sweet_spots:
+      deep_sub: 120.0
+      warm_bass: 400.0
+      mid_bass: 1000.0
+      open: 5000.0
+
+  - name: "Filter Res"
+    description: "Filter resonance — adds emphasis at the cutoff frequency"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      clean: 0.0
+      warm: 0.15
+      squelchy: 0.5
+      acid: 0.75
+
+  - name: "Filter Env"
+    description: "Filter envelope amount — how much the envelope shapes the filter over time"
+    range: [-1.0, 1.0]
+    type: float
+    sweet_spots:
+      static: 0.0
+      pluck: 0.4
+      aggressive: 0.7
+
+  - name: "Drive"
+    description: "Built-in distortion amount — from subtle warmth to aggressive grit"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      clean: 0.0
+      warm: 0.2
+      gritty: 0.5
+      aggressive: 0.8
+
+  - name: "Compress"
+    description: "Built-in compressor amount — tightens dynamics and adds punch"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      off: 0.0
+      subtle: 0.25
+      punchy: 0.5
+      squashed: 0.8
+
+  - name: "Attack"
+    description: "Amplitude envelope attack"
+    range: [0.0, 10000.0]
+    unit: "ms"
+    type: float
+    sweet_spots:
+      instant: 0.0
+      soft_click: 5.0
+
+  - name: "Decay"
+    description: "Amplitude envelope decay"
+    range: [0.0, 10000.0]
+    unit: "ms"
+    type: float
+    sweet_spots:
+      short: 100.0
+      medium: 400.0
+      long_808: 2000.0
+
+  - name: "Sustain"
+    description: "Amplitude envelope sustain level"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      pluck: 0.0
+      held: 0.7
+      sustained: 1.0
+
+  - name: "Release"
+    description: "Amplitude envelope release"
+    range: [0.0, 10000.0]
+    unit: "ms"
+    type: float
+    sweet_spots:
+      tight: 20.0
+      natural: 100.0
+      smooth: 300.0
+
+  - name: "Glide"
+    description: "Portamento time between notes — essential for sliding bass lines"
+    range: [0.0, 1000.0]
+    unit: "ms"
+    type: float
+    sweet_spots:
+      off: 0.0
+      fast_slide: 30.0
+      medium: 80.0
+      slow_glide: 200.0
+
+pairs_well_with:
+  - device: "EQ Eight"
+    reason: "Surgical low-end shaping — roll off sub-rumble and shape the bass presence"
+  - device: "Compressor"
+    reason: "Additional dynamics control beyond the built-in compressor — sidechain from kick for pumping"
+  - device: "Saturator"
+    reason: "Additional harmonic generation for bass to cut through on small speakers"
+  - device: "Utility"
+    reason: "Bass Mono ensures low frequencies stay centered — essential for club mixes"
+  - device: "Limiter"
+    reason: "Prevents bass peaks from clipping the mix bus"
+
+starter_recipes:
+  - name: "Deep Sub"
+    description: "Clean, powerful sub-bass for modern production — felt more than heard"
+    genre: hip_hop
+    params:
+      "Osc Shape": 0.0
+      "Sub Level": 0.6
+      "Filter Freq": 150.0
+      "Filter Res": 0.0
+      "Drive": 0.0
+      "Compress": 0.3
+      "Attack": 0.0
+      "Sustain": 1.0
+      "Release": 80.0
+
+  - name: "Distorted Bass"
+    description: "Aggressive, gritty bass with drive and compression for energy"
+    genre: dnb
+    params:
+      "Osc Shape": 0.5
+      "Sub Level": 0.3
+      "Filter Freq": 800.0
+      "Filter Res": 0.2
+      "Drive": 0.6
+      "Compress": 0.5
+      "Glide": 40.0
+      "Attack": 0.0
+      "Sustain": 0.8
+      "Release": 50.0
+
+  - name: "Funk Bass"
+    description: "Bouncy, articulate bass with filter envelope and subtle drive"
+    genre: pop
+    params:
+      "Osc Shape": 0.3
+      "Sub Level": 0.2
+      "Filter Freq": 600.0
+      "Filter Res": 0.3
+      "Filter Env": 0.5
+      "Drive": 0.15
+      "Compress": 0.3
+      "Glide": 20.0
+      "Attack": 0.0
+      "Decay": 200.0
+      "Sustain": 0.4
+      "Release": 60.0
+
+gotchas:
+  - "New in Live 12 — exact parameter names may differ. Use get_device_parameters to verify actual parameters"
+  - "Built-in Drive and Compress mean you may not need external Saturator/Compressor — check the built-in processing first"
+  - "Sub Level adds significant low-end energy — use Utility's Bass Mono after Bass to keep subs centered"
+  - "Designed specifically for bass frequencies — using it for midrange or treble leads won't sound right"
+  - "Glide is essential for 808-style sliding bass patterns — enable for legato playing"
+  - "Filter Freq below 200 Hz cuts harmonics that help bass translate to small speakers — keep some mids for presence"

package/mcp_server/atlas/enrichments/instruments/collision.yaml

@@ -0,0 +1,150 @@
+id: collision
+name: Collision
+sonic_description: >
+  Physical modeling instrument that simulates a mallet or noise exciter striking
+  a resonating body (beam, membrane, plate, pipe, or tube). Produces realistic
+  tuned percussion from marimbas to metallic gongs, and can be pushed into
+  otherworldly resonant textures impossible with sampling.
+synthesis_type: physical_modeling
+character_tags: [metallic, resonant, percussive, organic, physical]
+use_cases: [percussion, bells, tuned_percussion, textures, sound_design]
+genre_affinity:
+  primary: [ambient, world, experimental]
+  secondary: [cinematic, minimal, techno, idm]
+complexity: intermediate
+self_contained: true
+introduced_in: "8.0"
+
+key_parameters:
+  - name: "Mallet Stiffness"
+    description: "Hardness of the striking mallet — soft produces warm tones, hard produces bright attack"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      soft_mallet: 0.2
+      medium: 0.5
+      hard_mallet: 0.85
+
+  - name: "Mallet Noise"
+    description: "Amount of noise in the excitation — adds realism and attack character"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      clean: 0.0
+      realistic: 0.3
+      noisy: 0.7
+
+  - name: "Res 1 Type"
+    description: "Resonator 1 body type — determines the fundamental character of resonance"
+    range: ["Beam", "Membrane", "Plate", "Pipe", "Tube"]
+    type: enum
+    sweet_spots:
+      marimba: "Beam"
+      drum: "Membrane"
+      gong: "Plate"
+      wind: "Pipe"
+
+  - name: "Res 1 Decay"
+    description: "How long the resonator rings after excitation"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      short_percussion: 0.2
+      medium_ring: 0.5
+      long_sustain: 0.85
+
+  - name: "Res 1 Material"
+    description: "Material dampening character — affects how harmonics decay over time"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      wood: 0.3
+      metal: 0.7
+      glass: 0.9
+
+  - name: "Res 1 Tune"
+    description: "Resonator tuning — pitch of the resonating body"
+    range: [-48.0, 48.0]
+    unit: "st"
+    type: float
+    sweet_spots:
+      center: 0.0
+      octave_up: 12.0
+      octave_down: -12.0
+
+  - name: "Res 1 Quality"
+    description: "Resonance quality factor — higher values ring more clearly"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      dull: 0.2
+      clear: 0.6
+      ringing: 0.9
+
+  - name: "Res 2 Type"
+    description: "Resonator 2 body type — for layered or coupled resonance"
+    range: ["Beam", "Membrane", "Plate", "Pipe", "Tube"]
+    type: enum
+
+  - name: "Res 2 Tune"
+    description: "Resonator 2 tuning — set relative to Res 1 for harmonic or inharmonic relationships"
+    range: [-48.0, 48.0]
+    unit: "st"
+    type: float
+    sweet_spots:
+      unison: 0.0
+      fifth: 7.0
+      octave: 12.0
+
+pairs_well_with:
+  - device: "Reverb"
+    reason: "Physical modeling sounds bloom in reverberant spaces — adds room context"
+  - device: "EQ Eight"
+    reason: "Resonant peaks from physical modeling often need surgical taming"
+  - device: "Compressor"
+    reason: "Percussive transients from mallets can be very dynamic — compression evens levels"
+  - device: "Delay"
+    reason: "Rhythmic delays on tuned percussion create gamelan-like patterns"
+  - device: "Saturator"
+    reason: "Adds warmth and harmonic density to thin resonator tones"
+
+starter_recipes:
+  - name: "Tuned Metallic Percussion"
+    description: "Bright, ringing metallic hit for melodic percussion parts"
+    genre: experimental
+    params:
+      "Mallet Stiffness": 0.7
+      "Mallet Noise": 0.2
+      "Res 1 Type": "Plate"
+      "Res 1 Decay": 0.6
+      "Res 1 Material": 0.7
+      "Res 1 Quality": 0.7
+
+  - name: "Wooden Marimba"
+    description: "Warm, natural-sounding marimba with soft mallet and beam resonator"
+    genre: world
+    params:
+      "Mallet Stiffness": 0.3
+      "Mallet Noise": 0.15
+      "Res 1 Type": "Beam"
+      "Res 1 Decay": 0.4
+      "Res 1 Material": 0.3
+      "Res 1 Quality": 0.5
+
+  - name: "Glass Bells"
+    description: "Crystalline bell tones with long sustain and high material brightness"
+    genre: ambient
+    params:
+      "Mallet Stiffness": 0.8
+      "Mallet Noise": 0.05
+      "Res 1 Type": "Beam"
+      "Res 1 Decay": 0.85
+      "Res 1 Material": 0.9
+      "Res 1 Quality": 0.85
+
+gotchas:
+  - "Resonator Type is the most impactful parameter — always choose this first as it defines the fundamental character"
+  - "High Quality + high Decay can create very long ringing tones that build up and mask other instruments"
+  - "Material controls harmonic damping, not the literal material — higher values mean brighter, longer-ringing upper partials"
+  - "Two coupled resonators can create very complex timbres — tune Res 2 to a harmonic interval (5th, octave) for musical results"
+  - "Mallet Noise adds realistic transient character but can be harsh at high settings — blend carefully"

package/mcp_server/atlas/enrichments/instruments/drift.yaml

@@ -0,0 +1,167 @@
+id: drift
+name: Drift
+sonic_description: >
+  Characterful analog-modeled synthesizer with built-in pitch and filter instability
+  that emulates the organic imperfections of vintage hardware. A single oscillator
+  with continuous shape morphing, resonant filter, and streamlined modulation deliver
+  warm, slightly unpredictable tones with minimal parameter tweaking.
+synthesis_type: analog_modeling
+character_tags: [warm, organic, analog, unstable, characterful]
+use_cases: [bass, pads, leads, drones, textures]
+genre_affinity:
+  primary: [techno, ambient, minimal]
+  secondary: [house, lo-fi, experimental, downtempo]
+complexity: beginner
+self_contained: true
+introduced_in: "11.0"
+
+key_parameters:
+  - name: "Shape"
+    description: "Oscillator shape — continuously morphs between waveform types for fluid timbral control"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      sine_like: 0.0
+      saw_like: 0.5
+      square_like: 1.0
+      sweet_spot: 0.35
+
+  - name: "Drift"
+    description: "Amount of analog-style pitch and filter instability — the instrument's signature character"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      stable: 0.0
+      subtle_warmth: 0.2
+      vintage_feel: 0.45
+      wobbly: 0.7
+      extreme: 1.0
+
+  - name: "Filter Freq"
+    description: "Low-pass filter cutoff frequency"
+    range: [20.0, 20000.0]
+    unit: "Hz"
+    type: float
+    sweet_spots:
+      deep_sub: 150.0
+      warm: 1000.0
+      bright: 8000.0
+
+  - name: "Filter Res"
+    description: "Filter resonance — interacts with the drift parameter for organic movement"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      clean: 0.0
+      gentle: 0.2
+      character: 0.45
+      squelchy: 0.7
+
+  - name: "Voice Mode"
+    description: "Voice allocation — Mono for bass/leads, Poly for chords, Unison for thick textures"
+    range: ["Mono", "Poly", "Unison"]
+    type: enum
+    sweet_spots:
+      bass: "Mono"
+      pad: "Poly"
+      thick_lead: "Unison"
+
+  - name: "Attack"
+    description: "Amplitude envelope attack time"
+    range: [0.0, 10000.0]
+    unit: "ms"
+    type: float
+    sweet_spots:
+      percussive: 0.0
+      soft: 200.0
+      pad: 800.0
+
+  - name: "Decay"
+    description: "Amplitude envelope decay time"
+    range: [0.0, 10000.0]
+    unit: "ms"
+    type: float
+    sweet_spots:
+      pluck: 150.0
+      moderate: 500.0
+
+  - name: "Sustain"
+    description: "Amplitude envelope sustain level"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      pluck: 0.0
+      held: 0.8
+      pad: 1.0
+
+  - name: "Release"
+    description: "Amplitude envelope release time"
+    range: [0.0, 10000.0]
+    unit: "ms"
+    type: float
+    sweet_spots:
+      tight: 50.0
+      natural: 250.0
+      ambient: 1500.0
+
+pairs_well_with:
+  - device: "Reverb"
+    reason: "The organic drift character blooms beautifully in reverb space"
+  - device: "Delay"
+    reason: "Drifting pitch adds subtle variation to delay repeats — each echo is slightly different"
+  - device: "Saturator"
+    reason: "Light saturation enhances the analog warmth Drift is designed for"
+  - device: "Auto Filter"
+    reason: "Adds rhythmic movement that complements the random drift modulation"
+  - device: "Chorus-Ensemble"
+    reason: "Deepens the analog imperfection character with subtle detuning"
+
+starter_recipes:
+  - name: "Deep Sub Bass"
+    description: "Warm, slightly wobbly sub bass with organic character"
+    genre: techno
+    params:
+      "Shape": 0.0
+      "Drift": 0.15
+      "Voice Mode": "Mono"
+      "Filter Freq": 200.0
+      "Filter Res": 0.0
+      "Attack": 0.0
+      "Decay": 0.0
+      "Sustain": 1.0
+      "Release": 80.0
+
+  - name: "Drifting Pad"
+    description: "Evolving, dreamy pad where the drift creates gentle organic movement"
+    genre: ambient
+    params:
+      "Shape": 0.35
+      "Drift": 0.5
+      "Voice Mode": "Poly"
+      "Filter Freq": 2500.0
+      "Filter Res": 0.2
+      "Attack": 800.0
+      "Decay": 0.0
+      "Sustain": 1.0
+      "Release": 2000.0
+
+  - name: "Wonky Lead"
+    description: "Unstable, characterful mono lead with heavy drift and resonance"
+    genre: minimal
+    params:
+      "Shape": 0.6
+      "Drift": 0.7
+      "Voice Mode": "Mono"
+      "Filter Freq": 3500.0
+      "Filter Res": 0.45
+      "Attack": 5.0
+      "Decay": 300.0
+      "Sustain": 0.6
+      "Release": 200.0
+
+gotchas:
+  - "The Drift parameter affects pitch AND filter — high values make bass notes noticeably out of tune"
+  - "Drift is intentionally non-deterministic — the same patch will sound slightly different each time"
+  - "Simpler than Analog — fewer parameters means less flexibility but faster sound design"
+  - "Voice Mode changes dramatically affect CPU and polyphony — Unison is the most expensive"
+  - "Shape is continuous, not discrete waveform selection — automate it for morphing textures"

package/mcp_server/atlas/enrichments/instruments/electric.yaml

@@ -0,0 +1,137 @@
+id: electric
+name: Electric
+sonic_description: >
+  Physical modeling instrument that recreates classic electric piano sounds by simulating
+  a mallet striking a fork (tine or tone bar) with electromagnetic pickup and damper
+  mechanics. Delivers authentic Rhodes, Wurlitzer, and clavinet-style tones with
+  the playability and tonal variation that only physical modeling can provide.
+synthesis_type: physical_modeling
+character_tags: [warm, vintage, keys, expressive, smooth]
+use_cases: [keys, chords, comping, bass, melodic_lines]
+genre_affinity:
+  primary: [jazz, soul, neo_soul, lo_fi]
+  secondary: [r_and_b, funk, pop, downtempo, hip_hop]
+complexity: intermediate
+self_contained: true
+introduced_in: "8.0"
+
+key_parameters:
+  - name: "Mallet Stiffness"
+    description: "Hardness of the striking mallet — soft for mellow Rhodes, hard for bright bark"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      mellow_rhodes: 0.25
+      balanced: 0.5
+      bright_attack: 0.8
+
+  - name: "Mallet Noise"
+    description: "Mechanical noise of the mallet mechanism — adds realistic key-click"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      clean: 0.0
+      subtle_click: 0.2
+      clicky: 0.5
+
+  - name: "Fork Tine Color"
+    description: "Brightness of the fork tine — controls the fundamental vs overtone balance"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      dark_warm: 0.2
+      balanced: 0.5
+      bright_bell: 0.8
+
+  - name: "Fork Tine Decay"
+    description: "How long the tine rings after being struck"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      short_staccato: 0.2
+      medium: 0.5
+      long_sustain: 0.8
+
+  - name: "Damper"
+    description: "Damper engagement — simulates the felt damper pressing against the tine"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      fully_damped: 0.0
+      half_damped: 0.5
+      undamped: 1.0
+
+  - name: "Pickup Position"
+    description: "Electromagnetic pickup position along the tine — changes harmonic emphasis"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      mellow: 0.2
+      balanced: 0.5
+      nasal: 0.8
+
+  - name: "Pickup Symmetry"
+    description: "Pickup coil symmetry — affects distortion character at high velocities"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      clean: 0.5
+      asymmetric_bark: 0.3
+
+pairs_well_with:
+  - device: "Chorus-Ensemble"
+    reason: "Classic electric piano chorus — essential for the Juno-Rhodes sound"
+  - device: "Phaser-Flanger"
+    reason: "Classic phaser on electric piano creates the iconic 70s soul sound"
+  - device: "Reverb"
+    reason: "Plate reverb on electric piano is a timeless combination"
+  - device: "Compressor"
+    reason: "Evens out the velocity-dependent dynamics for consistent level"
+  - device: "Saturator"
+    reason: "Adds the warm amp-like overdrive character of a driven Rhodes"
+  - device: "Auto Filter"
+    reason: "Wah-like filter sweeps on electric piano for funk styles"
+
+starter_recipes:
+  - name: "Classic Rhodes"
+    description: "Warm, bell-like Rhodes electric piano with gentle bark on hard hits"
+    genre: jazz
+    params:
+      "Mallet Stiffness": 0.35
+      "Mallet Noise": 0.15
+      "Fork Tine Color": 0.4
+      "Fork Tine Decay": 0.6
+      "Damper": 0.8
+      "Pickup Position": 0.4
+      "Pickup Symmetry": 0.4
+
+  - name: "Bright Wurlitzer"
+    description: "Punchy, bright electric piano with nasal character and pronounced attack"
+    genre: funk
+    params:
+      "Mallet Stiffness": 0.7
+      "Mallet Noise": 0.3
+      "Fork Tine Color": 0.7
+      "Fork Tine Decay": 0.4
+      "Damper": 0.6
+      "Pickup Position": 0.7
+      "Pickup Symmetry": 0.5
+
+  - name: "Crunchy Keys"
+    description: "Overdriven electric piano with aggressive attack and harmonic distortion"
+    genre: neo_soul
+    params:
+      "Mallet Stiffness": 0.8
+      "Mallet Noise": 0.4
+      "Fork Tine Color": 0.6
+      "Fork Tine Decay": 0.5
+      "Damper": 0.7
+      "Pickup Position": 0.5
+      "Pickup Symmetry": 0.25
+
+gotchas:
+  - "Velocity is critical for Electric — it controls not just volume but timbral bark and distortion character"
+  - "Pickup Symmetry away from center creates asymmetric clipping — this is the source of the 'bark' on hard hits"
+  - "Damper at 0 cuts notes very short — great for staccato funk but unnatural for ballads"
+  - "Fork Tine Color and Pickup Position interact — both affect brightness, so adjust together"
+  - "Best played with a velocity-sensitive keyboard — flat velocity loses the instrument's main expressive dimension"