livepilot 1.9.23 → 1.10.0

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

@@ -0,0 +1,192 @@
+id: poli
+name: Poli
+sonic_description: >
+  Warm polyphonic synthesizer inspired by classic analog polysynths of the late 1970s
+  and early 1980s, with modern MPE expression support. Delivers lush chord pads, thick
+  stacked sounds, and expressive leads with the immediate playability and warm character
+  of vintage Roland and Sequential Circuits hardware.
+synthesis_type: analog_modeling
+character_tags: [warm, polyphonic, vintage, lush, expressive]
+use_cases: [pads, chords, leads, stabs, keys]
+genre_affinity:
+  primary: [synthwave, pop, ambient]
+  secondary: [house, lo_fi, new_wave, indie_electronic]
+complexity: intermediate
+self_contained: true
+introduced_in: "12.0"
+
+key_parameters:
+  - name: "Osc Shape"
+    description: "Oscillator waveform shape with continuous morphing"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      saw: 0.0
+      hybrid: 0.5
+      square: 1.0
+
+  - name: "Osc Detune"
+    description: "Detuning between oscillator copies for analog-style thickness"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      clean: 0.0
+      subtle_chorus: 0.15
+      thick_vintage: 0.35
+      extreme: 0.6
+
+  - name: "Filter Freq"
+    description: "Low-pass filter cutoff frequency"
+    range: [20.0, 20000.0]
+    unit: "Hz"
+    type: float
+    sweet_spots:
+      warm_pad: 1500.0
+      bright: 8000.0
+      closed: 400.0
+
+  - name: "Filter Res"
+    description: "Filter resonance with vintage-style self-oscillation character"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      clean: 0.0
+      warm: 0.2
+      squelchy: 0.55
+
+  - name: "Filter Env"
+    description: "Filter envelope amount — how much the envelope opens the filter"
+    range: [-1.0, 1.0]
+    type: float
+    sweet_spots:
+      pluck: 0.6
+      subtle: 0.2
+      negative_sweep: -0.3
+
+  - name: "Chorus"
+    description: "Built-in vintage-style chorus effect for instant width and warmth"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      off: 0.0
+      subtle: 0.3
+      full_juno: 0.7
+      extreme: 1.0
+
+  - name: "Attack"
+    description: "Amplitude envelope attack"
+    range: [0.0, 10000.0]
+    unit: "ms"
+    type: float
+    sweet_spots:
+      percussive: 0.0
+      soft: 100.0
+      pad: 500.0
+
+  - name: "Decay"
+    description: "Amplitude envelope decay"
+    range: [0.0, 10000.0]
+    unit: "ms"
+    type: float
+    sweet_spots:
+      stab: 150.0
+      natural: 500.0
+
+  - name: "Sustain"
+    description: "Amplitude envelope sustain level"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      stab: 0.0
+      held: 0.7
+      pad: 1.0
+
+  - name: "Release"
+    description: "Amplitude envelope release"
+    range: [0.0, 10000.0]
+    unit: "ms"
+    type: float
+    sweet_spots:
+      tight: 50.0
+      natural: 300.0
+      pad: 1500.0
+
+  - name: "MPE Press"
+    description: "MPE pressure response amount — how aftertouch affects sound"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      subtle: 0.2
+      responsive: 0.6
+
+  - name: "Voices"
+    description: "Polyphony count"
+    range: [1, 16]
+    type: int
+    sweet_spots:
+      mono: 1
+      standard: 6
+      full: 12
+
+pairs_well_with:
+  - device: "Reverb"
+    reason: "Lush pads benefit from plate or hall reverb for depth"
+  - device: "Delay"
+    reason: "Rhythmic delays on chord stabs create movement and space"
+  - device: "Phaser-Flanger"
+    reason: "Classic 80s polysynth processing — phaser sweeps on pads"
+  - device: "Compressor"
+    reason: "Evens out dynamics for consistent chord pads in a mix"
+  - device: "EQ Eight"
+    reason: "Roll off low-end mud from thick detuned poly patches"
+
+starter_recipes:
+  - name: "Vintage Poly Pad"
+    description: "Classic Juno-style warm pad with chorus and gentle filter"
+    genre: synthwave
+    params:
+      "Osc Shape": 0.0
+      "Osc Detune": 0.25
+      "Filter Freq": 2500.0
+      "Filter Res": 0.15
+      "Chorus": 0.65
+      "Attack": 300.0
+      "Sustain": 1.0
+      "Release": 1200.0
+
+  - name: "Stacked Chord"
+    description: "Thick, detuned polysynth chord stab with fast envelope"
+    genre: house
+    params:
+      "Osc Shape": 0.0
+      "Osc Detune": 0.3
+      "Filter Freq": 4000.0
+      "Filter Res": 0.1
+      "Filter Env": 0.3
+      "Chorus": 0.4
+      "Attack": 2.0
+      "Decay": 200.0
+      "Sustain": 0.5
+      "Release": 200.0
+
+  - name: "Expression Lead"
+    description: "Monophonic lead with MPE expression for live performance"
+    genre: pop
+    params:
+      "Osc Shape": 0.5
+      "Osc Detune": 0.1
+      "Filter Freq": 5000.0
+      "Filter Res": 0.3
+      "MPE Press": 0.6
+      "Voices": 1
+      "Attack": 5.0
+      "Decay": 300.0
+      "Sustain": 0.7
+      "Release": 200.0
+
+gotchas:
+  - "New in Live 12 — exact parameter names may differ. Use get_device_parameters to discover the actual parameters"
+  - "The built-in Chorus is key to the vintage polysynth sound — enable it before reaching for external chorus"
+  - "Osc Detune interacts with voice count — higher voice counts with detune can phase-cancel at certain settings"
+  - "MPE features require an MPE controller to take full advantage — without one it still works as a great polysynth"
+  - "Filter self-oscillation behavior is modeled after vintage analog circuits — character varies with note pitch"

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

@@ -0,0 +1,218 @@
+id: sampler
+name: Sampler
+sonic_description: >
+  Full-featured multi-zone sampler with velocity layers, key zones, round-robin
+  selection, and a deep modulation matrix. The most powerful sampling instrument
+  in Live, designed for building realistic multi-sampled instruments with complex
+  modulation routing, multiple filter types, and three LFOs.
+synthesis_type: sampling
+character_tags: [deep, powerful, realistic, multi_layered, professional]
+use_cases: [multi_velocity_instruments, layered_pads, orchestral, chromatic_samples, realistic_instruments]
+genre_affinity:
+  primary: [cinematic, orchestral, pop]
+  secondary: [electronic, hip_hop, ambient, jazz, all]
+complexity: advanced
+self_contained: false
+introduced_in: "1.0"
+
+key_parameters:
+  - name: "Filter Type"
+    description: "Filter topology — extensive selection of LP, HP, BP, Notch, and morphing filters"
+    range: ["LP12", "LP24", "HP12", "HP24", "BP", "Notch", "Morph"]
+    type: enum
+    sweet_spots:
+      warm: "LP12"
+      aggressive: "LP24"
+      morph: "Morph"
+
+  - name: "Filter Freq"
+    description: "Filter cutoff frequency"
+    range: [20.0, 20000.0]
+    unit: "Hz"
+    type: float
+    sweet_spots:
+      dark: 1000.0
+      warm: 4000.0
+      open: 18000.0
+
+  - name: "Filter Res"
+    description: "Filter resonance"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      clean: 0.0
+      subtle: 0.2
+      resonant: 0.5
+
+  - name: "Amp Attack"
+    description: "Amplitude envelope attack time"
+    range: [0.0, 10000.0]
+    unit: "ms"
+    type: float
+    sweet_spots:
+      instant: 0.0
+      natural: 10.0
+      pad: 500.0
+
+  - name: "Amp Decay"
+    description: "Amplitude envelope decay time"
+    range: [0.0, 10000.0]
+    unit: "ms"
+    type: float
+    sweet_spots:
+      short: 100.0
+      medium: 500.0
+
+  - name: "Amp Sustain"
+    description: "Amplitude envelope sustain level"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      percussive: 0.0
+      natural: 0.7
+      sustained: 1.0
+
+  - name: "Amp Release"
+    description: "Amplitude envelope release time"
+    range: [0.0, 10000.0]
+    unit: "ms"
+    type: float
+    sweet_spots:
+      tight: 30.0
+      natural: 300.0
+      ambient: 2000.0
+
+  - name: "Filter Env Amount"
+    description: "Filter envelope modulation depth"
+    range: [-1.0, 1.0]
+    type: float
+    sweet_spots:
+      subtle: 0.15
+      pluck: 0.5
+      dramatic: 0.8
+
+  - name: "Filter Attack"
+    description: "Filter envelope attack time"
+    range: [0.0, 10000.0]
+    unit: "ms"
+    type: float
+    sweet_spots:
+      instant: 0.0
+      medium: 200.0
+
+  - name: "Filter Decay"
+    description: "Filter envelope decay time"
+    range: [0.0, 10000.0]
+    unit: "ms"
+    type: float
+    sweet_spots:
+      short: 100.0
+      medium: 400.0
+
+  - name: "Pitch Env Amount"
+    description: "Pitch envelope modulation depth"
+    range: [-48.0, 48.0]
+    unit: "st"
+    type: float
+    sweet_spots:
+      none: 0.0
+      subtle: 2.0
+      kick_pitch: 12.0
+
+  - name: "LFO 1 Rate"
+    description: "LFO 1 speed"
+    range: [0.01, 30.0]
+    unit: "Hz"
+    type: float
+    sweet_spots:
+      slow: 0.2
+      vibrato: 5.5
+
+  - name: "LFO 1 Amount"
+    description: "LFO 1 modulation depth"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      subtle: 0.1
+      moderate: 0.3
+
+  - name: "Mod Matrix"
+    description: "Modulation matrix — route any source to any destination with scaled amount"
+    range: ["Matrix routing"]
+    type: enum
+
+  - name: "Vel > Filter"
+    description: "Velocity sensitivity of filter cutoff — higher velocity opens the filter"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      fixed: 0.0
+      subtle: 0.3
+      expressive: 0.7
+
+  - name: "Vel > Volume"
+    description: "Velocity sensitivity of output volume"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      fixed: 0.0
+      natural: 0.5
+      full_range: 1.0
+
+pairs_well_with:
+  - device: "EQ Eight"
+    reason: "Surgical frequency shaping for multi-sampled instruments in a mix context"
+  - device: "Compressor"
+    reason: "Evens dynamics across velocity layers and key zones"
+  - device: "Reverb"
+    reason: "Places sampled instruments in a convincing acoustic space"
+  - device: "Saturator"
+    reason: "Adds warmth and harmonics to sterile or thin samples"
+  - device: "Utility"
+    reason: "Width and gain management for large multi-sample instruments"
+
+starter_recipes:
+  - name: "Multi-Velocity Instrument"
+    description: "Expressive sampled instrument with velocity controlling both volume and brightness"
+    genre: cinematic
+    params:
+      "Filter Type": "LP12"
+      "Filter Freq": 8000.0
+      "Filter Res": 0.1
+      "Vel > Filter": 0.5
+      "Vel > Volume": 0.7
+      "Amp Attack": 5.0
+      "Amp Release": 400.0
+
+  - name: "Layered Pad"
+    description: "Thick pad from layered samples with slow envelopes and filtering"
+    genre: ambient
+    params:
+      "Filter Type": "LP12"
+      "Filter Freq": 3000.0
+      "Filter Res": 0.15
+      "Amp Attack": 800.0
+      "Amp Sustain": 1.0
+      "Amp Release": 2000.0
+      "LFO 1 Rate": 0.3
+      "LFO 1 Amount": 0.1
+
+  - name: "Chromatic Sample Spread"
+    description: "Sample spread across the keyboard with pitch tracking and natural dynamics"
+    genre: pop
+    params:
+      "Filter Type": "LP12"
+      "Filter Freq": 12000.0
+      "Vel > Volume": 0.6
+      "Amp Attack": 2.0
+      "Amp Decay": 500.0
+      "Amp Sustain": 0.7
+      "Amp Release": 300.0
+
+gotchas:
+  - "Sampler requires samples loaded into zones — bare Sampler produces no sound. Always load a preset or configure zone maps"
+  - "Zone Map editing (key ranges, velocity layers) is GUI-only in Live — cannot be fully programmed via MCP"
+  - "Much more CPU-intensive than Simpler — use Simpler when you only need single-sample playback"
+  - "The modulation matrix is very deep — use get_device_parameters to discover all available routing options"
+  - "Round-robin and random sample selection are zone-level settings, not global — configure per zone"
+  - "Velocity layers should overlap slightly for smooth crossfading between dynamic levels"

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

@@ -0,0 +1,217 @@
+id: simpler
+name: Simpler
+sonic_description: >
+  Streamlined sample-based instrument with three playback modes: Classic for chromatic
+  pitched playback, One-Shot for triggered samples, and Slicing for beat chopping.
+  The workhorse sampler for quick sample loading and manipulation with built-in filter,
+  envelope, and LFO — faster and simpler than Sampler for most tasks.
+synthesis_type: sampling
+character_tags: [versatile, immediate, sample_based, flexible, quick]
+use_cases: [vocal_chops, drums, bass, pads, one_shots, sliced_beats]
+genre_affinity:
+  primary: [hip_hop, electronic, pop, house]
+  secondary: [dnb, ambient, lo_fi, techno, trap]
+complexity: beginner
+self_contained: false
+introduced_in: "1.0"
+
+key_parameters:
+  - name: "Mode"
+    description: "Playback mode — Classic (pitched chromatic), One-Shot (triggered, ignores note-off), Slicing (auto-chop by transient/beat)"
+    range: ["Classic", "One-Shot", "Slicing"]
+    type: enum
+    sweet_spots:
+      pitched_instrument: "Classic"
+      drums_and_hits: "One-Shot"
+      beat_chopping: "Slicing"
+
+  - name: "Start"
+    description: "Sample playback start point"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      beginning: 0.0
+      skip_transient: 0.05
+
+  - name: "End"
+    description: "Sample playback end point"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      full_sample: 1.0
+      trimmed: 0.8
+
+  - name: "Loop On"
+    description: "Enable sample looping for sustained playback"
+    range: [0, 1]
+    type: int
+    sweet_spots:
+      one_shot: 0
+      sustained: 1
+
+  - name: "Loop Mode"
+    description: "Loop direction when looping is enabled"
+    range: ["Forward", "Back-Forth"]
+    type: enum
+    sweet_spots:
+      standard: "Forward"
+      smooth: "Back-Forth"
+
+  - name: "Filter Type"
+    description: "Filter topology for sample processing"
+    range: ["LP12", "LP24", "HP12", "HP24", "BP"]
+    type: enum
+    sweet_spots:
+      warmth: "LP12"
+      aggressive: "LP24"
+      thin: "HP12"
+
+  - name: "Filter Freq"
+    description: "Filter cutoff frequency"
+    range: [20.0, 20000.0]
+    unit: "Hz"
+    type: float
+    sweet_spots:
+      dark: 500.0
+      warm: 2000.0
+      bright: 12000.0
+
+  - name: "Filter Res"
+    description: "Filter resonance"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      clean: 0.0
+      colored: 0.3
+      resonant: 0.6
+
+  - name: "Amp Attack"
+    description: "Amplitude envelope attack time"
+    range: [0.0, 10000.0]
+    unit: "ms"
+    type: float
+    sweet_spots:
+      instant: 0.0
+      soft: 50.0
+      pad: 500.0
+
+  - name: "Amp Decay"
+    description: "Amplitude envelope decay time"
+    range: [0.0, 10000.0]
+    unit: "ms"
+    type: float
+    sweet_spots:
+      short_hit: 100.0
+      natural: 500.0
+
+  - name: "Amp Sustain"
+    description: "Amplitude envelope sustain level"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      percussive: 0.0
+      held: 0.8
+      full: 1.0
+
+  - name: "Amp Release"
+    description: "Amplitude envelope release time"
+    range: [0.0, 10000.0]
+    unit: "ms"
+    type: float
+    sweet_spots:
+      tight: 20.0
+      natural: 200.0
+      ambient: 1500.0
+
+  - name: "Warp"
+    description: "Enable time-stretching to lock sample to session tempo"
+    range: [0, 1]
+    type: int
+    sweet_spots:
+      off: 0
+      on: 1
+
+  - name: "Transpose"
+    description: "Sample pitch transposition"
+    range: [-48, 48]
+    unit: "st"
+    type: int
+    sweet_spots:
+      original: 0
+      octave_down: -12
+      octave_up: 12
+
+  - name: "Voices"
+    description: "Polyphony count — how many simultaneous notes"
+    range: [1, 32]
+    type: int
+    sweet_spots:
+      mono: 1
+      standard: 8
+      generous: 16
+
+  - name: "Spread"
+    description: "Stereo spread for polyphonic voices"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      mono: 0.0
+      subtle: 0.3
+      wide: 0.7
+
+pairs_well_with:
+  - device: "Auto Filter"
+    reason: "Adds rhythmic filter movement and envelope following to sampled material"
+  - device: "Saturator"
+    reason: "Adds warmth and harmonics to thin or digital samples"
+  - device: "Reverb"
+    reason: "Places samples in a space — essential for one-shot vocals and atmospheric use"
+  - device: "Delay"
+    reason: "Creates rhythmic patterns from single one-shot samples"
+  - device: "Compressor"
+    reason: "Evens dynamics across the sample's playback range"
+  - device: "EQ Eight"
+    reason: "Shapes the sample's frequency content beyond what the built-in filter offers"
+
+starter_recipes:
+  - name: "One-Shot Vocal Chop"
+    description: "Quick vocal chop triggered by MIDI with filter and reverb-ready output"
+    genre: pop
+    params:
+      "Mode": "One-Shot"
+      "Filter Type": "LP12"
+      "Filter Freq": 6000.0
+      "Filter Res": 0.1
+      "Amp Attack": 0.0
+      "Amp Release": 200.0
+
+  - name: "Looped Pad from Sample"
+    description: "Sustained pad created by looping a textural sample region"
+    genre: ambient
+    params:
+      "Mode": "Classic"
+      "Loop On": 1
+      "Loop Mode": "Back-Forth"
+      "Filter Type": "LP12"
+      "Filter Freq": 3000.0
+      "Amp Attack": 500.0
+      "Amp Sustain": 1.0
+      "Amp Release": 1500.0
+      "Voices": 8
+      "Spread": 0.5
+
+  - name: "Sliced Break"
+    description: "Drum break auto-sliced by transients for rearrangement and programming"
+    genre: dnb
+    params:
+      "Mode": "Slicing"
+      "Warp": 1
+
+gotchas:
+  - "A bare Simpler (loaded empty) has NO sample — it produces silence. Always load a preset or use load_sample_to_simpler"
+  - "One-Shot mode ignores note-off — the sample always plays to the end (or until envelope release)"
+  - "Slicing mode changes the UI and parameter set significantly — some standard parameters are unavailable"
+  - "Warp must be ON for the sample to follow session tempo — off by default for pitched samples"
+  - "Transpose shifts pitch in semitones, not time — use Warp for time-stretching without pitch change"
+  - "crop_simpler and reverse_simpler are available as LivePilot tools for destructive sample editing"
+  - "replace_simpler_sample only works if a sample is already loaded — cannot replace an empty Simpler"