livepilot 1.9.23 → 1.10.0

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

@@ -0,0 +1,156 @@
+id: tension
+name: Tension
+sonic_description: >
+  Physical modeling instrument that simulates vibrating strings excited by bowing,
+  plucking, or hammering. Models the full signal chain from exciter through string
+  to resonant body, producing everything from realistic bowed drones to otherworldly
+  plucked textures that evolve organically over time.
+synthesis_type: physical_modeling
+character_tags: [stringy, organic, resonant, expressive, physical]
+use_cases: [drones, bass, plucked_sounds, textures, bowed_strings]
+genre_affinity:
+  primary: [ambient, classical, experimental]
+  secondary: [cinematic, world, downtempo, post_rock]
+complexity: advanced
+self_contained: true
+introduced_in: "8.0"
+
+key_parameters:
+  - name: "Exciter Type"
+    description: "How the string is activated — bow for sustained tones, pluck for percussive, hammer for piano-like"
+    range: ["Bow", "Pluck", "Hammer"]
+    type: enum
+    sweet_spots:
+      drone: "Bow"
+      bass: "Pluck"
+      keys: "Hammer"
+
+  - name: "Bow Force"
+    description: "Pressure of the bow on the string (bow exciter only)"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      gentle: 0.2
+      normal: 0.5
+      aggressive: 0.8
+
+  - name: "String Decay"
+    description: "How long the string vibrates after excitation"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      short_pluck: 0.2
+      natural: 0.5
+      long_sustain: 0.85
+
+  - name: "String Damping"
+    description: "High-frequency loss over time — simulates string material and age"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      bright_new: 0.1
+      warm: 0.4
+      dull_old: 0.7
+
+  - name: "String Inharmonicity"
+    description: "Degree to which overtones deviate from perfect harmonics — adds stiffness character"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      pure_string: 0.0
+      piano_like: 0.3
+      metallic: 0.7
+
+  - name: "Body Type"
+    description: "Resonant body that colors the string output"
+    range: ["None", "Guitar", "Violin", "Viola", "Cello"]
+    type: enum
+    sweet_spots:
+      raw: "None"
+      small: "Guitar"
+      expressive: "Violin"
+      deep: "Cello"
+
+  - name: "Body Size"
+    description: "Size of the resonant body — larger bodies have more low-frequency resonance"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      small_bright: 0.2
+      medium: 0.5
+      large_boomy: 0.8
+
+  - name: "Vibrato Rate"
+    description: "Speed of pitch vibrato"
+    range: [0.0, 20.0]
+    unit: "Hz"
+    type: float
+    sweet_spots:
+      slow_expressive: 4.5
+      fast_nervous: 7.0
+
+  - name: "Vibrato Amount"
+    description: "Depth of pitch vibrato"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      subtle: 0.1
+      expressive: 0.3
+
+pairs_well_with:
+  - device: "Reverb"
+    reason: "Bowed strings and plucks sound natural in reverberant spaces — essential for realism"
+  - device: "EQ Eight"
+    reason: "Body resonances can create unwanted peaks that need surgical EQ"
+  - device: "Compressor"
+    reason: "Bowed exciter produces very dynamic output — compression helps in a mix"
+  - device: "Chorus-Ensemble"
+    reason: "Adds section-like ensemble width to solo string sounds"
+  - device: "Saturator"
+    reason: "Light saturation adds rosin-like character to bowed sounds"
+
+starter_recipes:
+  - name: "Bowed Drone"
+    description: "Sustained, evolving bowed string drone with warm body resonance"
+    genre: ambient
+    params:
+      "Exciter Type": "Bow"
+      "Bow Force": 0.5
+      "String Decay": 0.9
+      "String Damping": 0.3
+      "String Inharmonicity": 0.1
+      "Body Type": "Cello"
+      "Body Size": 0.7
+      "Vibrato Rate": 4.5
+      "Vibrato Amount": 0.15
+
+  - name: "Plucked Bass"
+    description: "Deep, organic plucked bass with natural damping"
+    genre: downtempo
+    params:
+      "Exciter Type": "Pluck"
+      "String Decay": 0.4
+      "String Damping": 0.35
+      "String Inharmonicity": 0.05
+      "Body Type": "Guitar"
+      "Body Size": 0.6
+
+  - name: "Harp Textures"
+    description: "Bright, shimmering plucked harp-like sound with long decay"
+    genre: cinematic
+    params:
+      "Exciter Type": "Pluck"
+      "String Decay": 0.75
+      "String Damping": 0.15
+      "String Inharmonicity": 0.0
+      "Body Type": "None"
+      "Body Size": 0.5
+      "Vibrato Amount": 0.0
+
+gotchas:
+  - "Exciter Type fundamentally changes the interaction model — Bow gives sustained sound, Pluck and Hammer are percussive"
+  - "Bowed sounds require careful Force settings — too high creates harsh, unrealistic screeching"
+  - "String Inharmonicity at high values sounds metallic/bell-like, not string-like"
+  - "Body Type 'None' gives a raw string sound without coloring — useful when adding external reverb/IR"
+  - "CPU-intensive instrument — limit polyphony if using in dense arrangements"
+  - "Vibrato on bowed sounds is essential for realism — without it, bowed patches sound static and synthetic"

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

@@ -0,0 +1,162 @@
+id: tree_tone
+name: Tree Tone
+sonic_description: >
+  Multi-layer tonal synthesis instrument that generates evolving timbres through
+  branching harmonic structures. Produces organic, tree-like growth of sound where
+  multiple tonal layers bloom and interact, creating rich textures that evolve
+  naturally over time with an almost living quality.
+synthesis_type: additive
+character_tags: [organic, evolving, layered, textural, lush]
+use_cases: [textures, pads, drones, atmospheric, sound_design]
+genre_affinity:
+  primary: [ambient, cinematic, experimental]
+  secondary: [electronic, post_rock, new_age, downtempo]
+complexity: intermediate
+self_contained: true
+introduced_in: "12.0"
+
+key_parameters:
+  - name: "Layer 1 Tone"
+    description: "Tonal character of the first synthesis layer"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      fundamental: 0.0
+      mid_tone: 0.5
+      bright: 1.0
+
+  - name: "Layer 2 Tone"
+    description: "Tonal character of the second synthesis layer"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      complementary: 0.3
+      contrasting: 0.7
+
+  - name: "Layer Mix"
+    description: "Balance between the tonal layers"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      layer_1_heavy: 0.2
+      balanced: 0.5
+      layer_2_heavy: 0.8
+
+  - name: "Evolution Rate"
+    description: "Speed at which timbral changes unfold over time"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      static: 0.0
+      glacial: 0.15
+      moderate: 0.4
+      fast_morph: 0.75
+
+  - name: "Evolution Depth"
+    description: "How far the timbre evolves from its starting point"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      subtle: 0.2
+      organic: 0.5
+      dramatic: 0.8
+
+  - name: "Brightness"
+    description: "Overall high-frequency content and harmonic brightness"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      dark: 0.15
+      warm: 0.4
+      bright: 0.75
+
+  - name: "Spread"
+    description: "Stereo spread of the layered tones"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      mono: 0.0
+      natural: 0.5
+      wide: 0.85
+
+  - name: "Attack"
+    description: "Amplitude envelope attack time"
+    range: [0.0, 10000.0]
+    unit: "ms"
+    type: float
+    sweet_spots:
+      immediate: 0.0
+      soft: 300.0
+      slow_bloom: 1500.0
+
+  - name: "Release"
+    description: "Amplitude envelope release time"
+    range: [0.0, 10000.0]
+    unit: "ms"
+    type: float
+    sweet_spots:
+      tight: 100.0
+      natural: 800.0
+      ambient: 4000.0
+
+pairs_well_with:
+  - device: "Reverb"
+    reason: "Evolving tonal layers merge beautifully with long reverb for immersive atmospheres"
+  - device: "Delay"
+    reason: "Evolving timbres create naturally varied delay repetitions that build complexity"
+  - device: "Chorus-Ensemble"
+    reason: "Extra stereo depth enhances the layered quality"
+  - device: "Auto Filter"
+    reason: "Slow filter sweeps add another dimension of movement to the tonal evolution"
+  - device: "Utility"
+    reason: "Width management is important — layered sounds can be very wide"
+
+starter_recipes:
+  - name: "Organic Texture"
+    description: "Slowly evolving multi-layer texture with natural movement"
+    genre: ambient
+    params:
+      "Layer 1 Tone": 0.3
+      "Layer 2 Tone": 0.6
+      "Layer Mix": 0.45
+      "Evolution Rate": 0.2
+      "Evolution Depth": 0.5
+      "Brightness": 0.5
+      "Spread": 0.6
+      "Attack": 800.0
+      "Release": 3000.0
+
+  - name: "Tonal Drone"
+    description: "Rich, sustained drone with multiple tonal layers blending together"
+    genre: cinematic
+    params:
+      "Layer 1 Tone": 0.1
+      "Layer 2 Tone": 0.4
+      "Layer Mix": 0.5
+      "Evolution Rate": 0.1
+      "Evolution Depth": 0.3
+      "Brightness": 0.35
+      "Spread": 0.7
+      "Attack": 2000.0
+      "Release": 5000.0
+
+  - name: "Evolving Atmosphere"
+    description: "Dynamic, shifting atmosphere with fast evolution and wide spread"
+    genre: experimental
+    params:
+      "Layer 1 Tone": 0.5
+      "Layer 2 Tone": 0.8
+      "Layer Mix": 0.5
+      "Evolution Rate": 0.6
+      "Evolution Depth": 0.7
+      "Brightness": 0.6
+      "Spread": 0.85
+      "Attack": 500.0
+      "Release": 2500.0
+
+gotchas:
+  - "New in Live 12 — exact parameter names may differ from descriptions here. Always verify with get_device_parameters"
+  - "High Evolution Rate + Depth can make the sound unpredictable for melodic use — reduce both for pitched parts"
+  - "Wide Spread settings can cause phase issues in mono — check mono compatibility with Utility"
+  - "Layer interaction creates emergent timbres — the combined sound may differ significantly from either layer alone"
+  - "CPU usage scales with the number of active layers and evolution complexity"

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

@@ -0,0 +1,165 @@
+id: vector_fm
+name: Vector FM
+sonic_description: >
+  FM synthesis engine with an XY vector pad that enables real-time morphing between
+  four timbral snapshots. Combines the harmonic complexity of frequency modulation
+  with intuitive vector control for expressive, evolving sounds that shift character
+  fluidly during performance or automation.
+synthesis_type: fm
+character_tags: [morphing, dynamic, complex, digital, expressive]
+use_cases: [bass, leads, pads, textures, sound_design]
+genre_affinity:
+  primary: [edm, experimental, sound_design]
+  secondary: [techno, cinematic, dnb, pop]
+complexity: advanced
+self_contained: true
+introduced_in: "12.0"
+
+key_parameters:
+  - name: "Vector X"
+    description: "Horizontal position on the XY vector pad — morphs between left and right timbral snapshots"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      left: 0.0
+      center: 0.5
+      right: 1.0
+
+  - name: "Vector Y"
+    description: "Vertical position on the XY vector pad — morphs between top and bottom timbral snapshots"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      bottom: 0.0
+      center: 0.5
+      top: 1.0
+
+  - name: "FM Amount"
+    description: "Global FM modulation depth — controls overall harmonic complexity"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      subtle: 0.15
+      moderate: 0.4
+      aggressive: 0.75
+      extreme: 1.0
+
+  - name: "FM Ratio"
+    description: "Modulator to carrier frequency ratio — harmonic ratios (1:1, 2:1) sound tonal, non-integer ratios sound metallic"
+    range: [0.5, 16.0]
+    type: float
+    sweet_spots:
+      fundamental: 1.0
+      octave: 2.0
+      fifth: 3.0
+      metallic: 7.0
+
+  - name: "Filter Freq"
+    description: "Global filter cutoff frequency"
+    range: [20.0, 20000.0]
+    unit: "Hz"
+    type: float
+    sweet_spots:
+      dark: 800.0
+      balanced: 4000.0
+      open: 15000.0
+
+  - name: "Filter Res"
+    description: "Filter resonance"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      clean: 0.0
+      character: 0.3
+      aggressive: 0.6
+
+  - name: "Vector Motion Rate"
+    description: "Speed of automatic vector pad movement — for evolving timbres without manual control"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      static: 0.0
+      slow_morph: 0.15
+      moderate: 0.4
+      fast: 0.7
+
+  - name: "Attack"
+    description: "Amplitude envelope attack"
+    range: [0.0, 10000.0]
+    unit: "ms"
+    type: float
+    sweet_spots:
+      percussive: 0.0
+      soft: 100.0
+      pad: 600.0
+
+  - name: "Release"
+    description: "Amplitude envelope release"
+    range: [0.0, 10000.0]
+    unit: "ms"
+    type: float
+    sweet_spots:
+      tight: 50.0
+      natural: 300.0
+      ambient: 2000.0
+
+pairs_well_with:
+  - device: "Reverb"
+    reason: "FM timbres gain depth and space in reverb — morphing vector creates shifting reflections"
+  - device: "Chorus-Ensemble"
+    reason: "Softens the digital FM edges and adds width"
+  - device: "Saturator"
+    reason: "Adds analog warmth to counterbalance FM's digital character"
+  - device: "Delay"
+    reason: "Vector-driven timbral changes create unique variation in delay repeats"
+  - device: "EQ Eight"
+    reason: "FM harmonics are often unpredictable — surgical EQ tames resonant peaks"
+
+starter_recipes:
+  - name: "Morphing Bass"
+    description: "Bass that shifts character as you move through the vector space"
+    genre: edm
+    params:
+      "Vector X": 0.3
+      "Vector Y": 0.2
+      "FM Amount": 0.4
+      "FM Ratio": 1.0
+      "Filter Freq": 600.0
+      "Filter Res": 0.2
+      "Attack": 0.0
+      "Release": 100.0
+
+  - name: "Evolving Lead"
+    description: "Lead sound that morphs timbre via vector automation"
+    genre: experimental
+    params:
+      "Vector X": 0.5
+      "Vector Y": 0.5
+      "FM Amount": 0.5
+      "FM Ratio": 2.0
+      "Vector Motion Rate": 0.2
+      "Filter Freq": 5000.0
+      "Filter Res": 0.15
+      "Attack": 5.0
+      "Release": 300.0
+
+  - name: "Vector Pad"
+    description: "Slowly morphing pad that drifts through four timbral zones"
+    genre: cinematic
+    params:
+      "Vector X": 0.5
+      "Vector Y": 0.5
+      "FM Amount": 0.3
+      "FM Ratio": 1.0
+      "Vector Motion Rate": 0.1
+      "Filter Freq": 3000.0
+      "Filter Res": 0.1
+      "Attack": 800.0
+      "Release": 2500.0
+
+gotchas:
+  - "New in Live 12 — exact parameter names may differ. Use get_device_parameters for the actual parameter list"
+  - "The vector pad is the primary control — automate Vector X and Y for evolving sounds in arrangements"
+  - "FM Amount creates dramatic timbral shifts — small changes have big sonic impact, especially at non-integer ratios"
+  - "Each corner of the vector pad stores a different FM snapshot — program all four corners before morphing"
+  - "High FM Amount at non-integer ratios creates inharmonic, metallic timbres — use intentionally for percussion or sound design"

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

@@ -0,0 +1,166 @@
+id: vector_grain
+name: Vector Grain
+sonic_description: >
+  Granular synthesis engine with an XY vector pad for real-time morphing between
+  grain parameters. Deconstructs loaded audio samples into tiny grains that can be
+  scattered, pitched, and recombined into clouds of sound ranging from faithful
+  sample playback to completely abstract textures.
+synthesis_type: granular
+character_tags: [textural, abstract, evolving, scattered, atmospheric]
+use_cases: [textures, pads, atmospheric, glitch, sound_design]
+genre_affinity:
+  primary: [ambient, experimental, cinematic]
+  secondary: [idm, glitch, downtempo, sound_design]
+complexity: advanced
+self_contained: false
+introduced_in: "12.0"
+
+key_parameters:
+  - name: "Vector X"
+    description: "Horizontal vector pad position — morphs grain parameters between left and right snapshots"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      left: 0.0
+      center: 0.5
+      right: 1.0
+
+  - name: "Vector Y"
+    description: "Vertical vector pad position — morphs grain parameters between top and bottom snapshots"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      bottom: 0.0
+      center: 0.5
+      top: 1.0
+
+  - name: "Grain Size"
+    description: "Size of individual grains — small grains create buzzy textures, large grains preserve source character"
+    range: [1.0, 500.0]
+    unit: "ms"
+    type: float
+    sweet_spots:
+      micro_buzz: 5.0
+      small_texture: 20.0
+      medium: 60.0
+      large_faithful: 200.0
+
+  - name: "Grain Density"
+    description: "Number of overlapping grains — higher density creates smoother, denser clouds"
+    range: [1, 64]
+    type: int
+    sweet_spots:
+      sparse: 4
+      moderate: 12
+      dense_cloud: 32
+      maximum: 64
+
+  - name: "Position"
+    description: "Playback position in the loaded sample"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      start: 0.0
+      middle: 0.5
+      end: 0.9
+
+  - name: "Position Spread"
+    description: "Random scatter of grain start positions around the main position"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      focused: 0.0
+      moderate_scatter: 0.3
+      full_random: 1.0
+
+  - name: "Pitch"
+    description: "Grain pitch transposition"
+    range: [-24.0, 24.0]
+    unit: "st"
+    type: float
+    sweet_spots:
+      original: 0.0
+      octave_down: -12.0
+      octave_up: 12.0
+
+  - name: "Pitch Random"
+    description: "Random pitch variation per grain — creates detuned cloud effects"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      none: 0.0
+      subtle_shimmer: 0.1
+      wide_scatter: 0.5
+
+  - name: "Vector Motion Rate"
+    description: "Speed of automatic vector pad movement"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      static: 0.0
+      slow_drift: 0.1
+      moderate: 0.35
+
+  - name: "Filter Freq"
+    description: "Filter cutoff frequency for shaping the grain cloud"
+    range: [20.0, 20000.0]
+    unit: "Hz"
+    type: float
+    sweet_spots:
+      dark: 1000.0
+      balanced: 5000.0
+      open: 15000.0
+
+pairs_well_with:
+  - device: "Reverb"
+    reason: "Grain clouds dissolve beautifully into reverb — creates immersive washes"
+  - device: "Delay"
+    reason: "Scattered grains with delay create complex rhythmic textures"
+  - device: "Auto Filter"
+    reason: "Slow filter sweeps add movement to grain clouds"
+  - device: "Chorus-Ensemble"
+    reason: "Adds width and blurs individual grains into a cohesive texture"
+  - device: "Utility"
+    reason: "Essential for managing the wide stereo field granular synthesis often creates"
+
+starter_recipes:
+  - name: "Textural Cloud"
+    description: "Dense, floating grain cloud that abstracts the source sample into atmosphere"
+    genre: ambient
+    params:
+      "Grain Size": 40.0
+      "Grain Density": 24
+      "Position Spread": 0.4
+      "Pitch Random": 0.15
+      "Vector Motion Rate": 0.1
+      "Filter Freq": 4000.0
+
+  - name: "Granular Pad"
+    description: "Smooth, evolving pad created from a sustained sample with large grains"
+    genre: cinematic
+    params:
+      "Grain Size": 150.0
+      "Grain Density": 16
+      "Position Spread": 0.2
+      "Pitch Random": 0.05
+      "Vector Motion Rate": 0.15
+      "Filter Freq": 6000.0
+
+  - name: "Glitch Texture"
+    description: "Stuttering, scattered grains with extreme position randomization"
+    genre: experimental
+    params:
+      "Grain Size": 10.0
+      "Grain Density": 8
+      "Position Spread": 0.8
+      "Pitch Random": 0.3
+      "Vector Motion Rate": 0.4
+      "Filter Freq": 8000.0
+
+gotchas:
+  - "Requires an audio sample loaded — bare Vector Grain produces no sound without a sample"
+  - "New in Live 12 — exact parameter names may differ. Use get_device_parameters to discover the actual parameters"
+  - "Very small grain sizes (< 10ms) create buzzy, pitch-like artifacts — intentional for sound design, problematic for faithful playback"
+  - "High grain density is CPU-intensive — reduce for dense arrangements"
+  - "Position Spread at maximum scatters grains across the entire sample — the result may have no audible relationship to the original"
+  - "Automate Vector X and Y for evolving textures — each corner of the vector pad stores different grain parameter snapshots"