livepilot 1.9.23 → 1.10.0

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

@@ -0,0 +1,162 @@
+id: wavetable
+name: Wavetable
+sonic_description: >
+  Powerful wavetable synthesizer with two oscillators that morph continuously through
+  wavetable positions, a sub oscillator, multimode filter, unison engine, and a deep
+  modulation matrix. Excels at everything from massive supersaws to evolving cinematic textures.
+synthesis_type: wavetable
+character_tags: [modern, versatile, lush, massive, evolving]
+use_cases: [leads, pads, bass, textures, plucks]
+genre_affinity:
+  primary: [edm, pop, future_bass]
+  secondary: [synthwave, cinematic, ambient, dnb]
+complexity: intermediate
+self_contained: true
+introduced_in: "10.0"
+
+key_parameters:
+  - name: "Osc 1 Pos"
+    description: "Wavetable position — morphs through the waveform set for timbral change"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      bright: 0.8
+      mellow: 0.2
+      mid_morph: 0.5
+
+  - name: "Osc 1 Effect"
+    description: "Processing effect applied to the wavetable oscillator"
+    range: ["None", "FM", "Classic", "Modern", "Formant"]
+    type: enum
+    sweet_spots:
+      clean: "None"
+      harsh_digital: "FM"
+      vintage: "Classic"
+      vocal: "Formant"
+
+  - name: "Osc 2 Pos"
+    description: "Wavetable position for oscillator 2"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      contrast_layer: 0.6
+
+  - name: "Sub Osc"
+    description: "Sub oscillator level — adds low-end foundation"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      subtle_weight: 0.3
+      heavy_sub: 0.7
+      off: 0.0
+
+  - name: "Filter Type"
+    description: "Filter topology — LP, HP, BP with various slopes"
+    range: ["LP12", "LP24", "HP12", "HP24", "BP"]
+    type: enum
+    sweet_spots:
+      warm: "LP12"
+      aggressive: "LP24"
+      thin: "HP12"
+
+  - name: "Filter Freq"
+    description: "Filter cutoff frequency"
+    range: [20.0, 20000.0]
+    unit: "Hz"
+    type: float
+    sweet_spots:
+      dark_pad: 1500.0
+      open: 12000.0
+      bass: 500.0
+
+  - name: "Filter Res"
+    description: "Filter resonance — peak at cutoff"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      clean: 0.0
+      character: 0.25
+      aggressive: 0.6
+
+  - name: "Unison Voices"
+    description: "Number of unison voices per note — stacks detuned copies"
+    range: [1, 8]
+    type: int
+    sweet_spots:
+      mono: 1
+      subtle_thicken: 2
+      supersaw: 7
+      maximum: 8
+
+  - name: "Unison Amount"
+    description: "Detune spread between unison voices"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      tight: 0.15
+      wide_supersaw: 0.5
+      extreme: 0.8
+
+  - name: "Mod Matrix"
+    description: "Flexible modulation routing — map any source (LFO, envelope, velocity, aftertouch) to any parameter"
+    range: ["Matrix routing"]
+    type: enum
+
+pairs_well_with:
+  - device: "Reverb"
+    reason: "Pads and textures come alive with long reverb tails and high diffusion"
+  - device: "Delay"
+    reason: "Dotted eighth delays on leads create rhythmic movement and width"
+  - device: "Chorus-Ensemble"
+    reason: "Extra stereo width and shimmer on top of unison voices"
+  - device: "Saturator"
+    reason: "Adds analog warmth to the inherently digital wavetable sound"
+  - device: "EQ Eight"
+    reason: "Surgical control of the complex harmonic content wavetables generate"
+  - device: "Compressor"
+    reason: "Tames dynamics from wavetable position modulation"
+
+starter_recipes:
+  - name: "Supersaw Lead"
+    description: "Classic EDM/trance supersaw with massive unison spread"
+    genre: edm
+    params:
+      "Osc 1 Pos": 0.0
+      "Unison Voices": 7
+      "Unison Amount": 0.45
+      "Filter Type": "LP12"
+      "Filter Freq": 8000.0
+      "Filter Res": 0.1
+      "Sub Osc": 0.3
+
+  - name: "Glassy Pad"
+    description: "Shimmering, evolving pad with slow wavetable modulation"
+    genre: ambient
+    params:
+      "Osc 1 Pos": 0.3
+      "Osc 1 Effect": "None"
+      "Unison Voices": 4
+      "Unison Amount": 0.25
+      "Filter Type": "LP12"
+      "Filter Freq": 3000.0
+      "Filter Res": 0.15
+
+  - name: "Digital Bass"
+    description: "Tight, modern bass with wavetable character and sub weight"
+    genre: future_bass
+    params:
+      "Osc 1 Pos": 0.6
+      "Osc 1 Effect": "Modern"
+      "Sub Osc": 0.6
+      "Unison Voices": 2
+      "Unison Amount": 0.1
+      "Filter Type": "LP24"
+      "Filter Freq": 600.0
+      "Filter Res": 0.2
+
+gotchas:
+  - "Wavetable position is the primary timbre control — automate it for evolving textures"
+  - "High unison voice counts are CPU-intensive — use 4+ voices sparingly on multiple tracks"
+  - "The mod matrix is extremely powerful but has many slots — get_device_parameters to see all available targets"
+  - "Sub oscillator adds significant low-end energy — may need high-pass on the sub for mixing clarity"
+  - "Effect type dramatically changes character even at the same wavetable position"

package/mcp_server/atlas/enrichments/midi_effects/arpeggiator.yaml

@@ -0,0 +1,156 @@
+id: arpeggiator
+name: Arpeggiator
+sonic_description: >
+  Transforms held chords into rhythmic arpeggiated note sequences, cycling through
+  chord tones in configurable patterns. Essential for creating pulsing synth lines,
+  trance leads, and generative melodic movement from static chord input.
+effect_type: midi_processor
+character_tags: [rhythmic, pattern, generative, pulsing, melodic]
+use_cases: [arpeggios, synth_sequences, trance_leads, generative_melody, chord_animation]
+genre_affinity:
+  primary: [trance, edm, synthwave]
+  secondary: [ambient, pop, techno, house]
+complexity: beginner
+introduced_in: "1.0"
+
+key_parameters:
+  - name: "Style"
+    description: "Arpeggio pattern direction — determines note traversal order"
+    range: ["Up", "Down", "UpDown", "DownUp", "Converge", "Diverge", "Con&Diverge", "PinkyUp", "PinkyUpDown", "ThumbUp", "ThumbUpDown", "Random", "Custom"]
+    type: enum
+    sweet_spots:
+      classic_arp: "Up"
+      bouncy: "UpDown"
+      generative: "Random"
+      dramatic: "Converge"
+
+  - name: "Rate"
+    description: "Speed of arpeggiation — synced to tempo"
+    range: ["1/1", "1/2", "1/2T", "1/4", "1/4T", "1/8", "1/8T", "1/16", "1/16T", "1/32"]
+    type: enum
+    sweet_spots:
+      driving: "1/16"
+      relaxed: "1/8"
+      fast_trance: "1/32"
+      triplet_groove: "1/8T"
+
+  - name: "Gate"
+    description: "Note length as percentage of step length — controls staccato vs legato"
+    range: [1, 200]
+    unit: "%"
+    type: int
+    sweet_spots:
+      staccato: 20
+      normal: 80
+      legato: 130
+      overlapping: 200
+
+  - name: "Steps"
+    description: "Number of steps for custom pattern mode"
+    range: [1, 8]
+    type: int
+
+  - name: "Offset"
+    description: "Shift the start position of the arpeggio pattern"
+    range: [0, 7]
+    type: int
+
+  - name: "Groove"
+    description: "Amount of swing applied to the arpeggio rhythm"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      straight: 0.0
+      subtle_swing: 0.2
+      heavy_groove: 0.6
+
+  - name: "Transpose"
+    description: "Pitch shift per octave repetition in semitones"
+    range: [-36, 36]
+    unit: "st"
+    type: int
+    sweet_spots:
+      octave_up: 12
+      fifth_up: 7
+
+  - name: "Distance"
+    description: "Interval distance for transpose repetitions"
+    range: [1, 12]
+    type: int
+
+  - name: "Repeats"
+    description: "Number of octave repetitions before pattern restarts"
+    range: [1, 16]
+    type: int
+    sweet_spots:
+      single: 1
+      two_octave: 2
+      wide_range: 4
+
+  - name: "Retrigger"
+    description: "Whether to restart the pattern on new note input"
+    range: ["On", "Off"]
+    type: enum
+
+  - name: "Velocity"
+    description: "Fixed velocity or follows input velocity"
+    range: [0, 127]
+    type: int
+
+pairs_well_with:
+  - device: "Drift"
+    reason: "Warm arpeggiated lines with analog character and gentle instability"
+  - device: "Wavetable"
+    reason: "Evolving timbres animated by rhythmic arpeggiation"
+  - device: "Scale"
+    reason: "Place after Arpeggiator to force generated notes into key"
+  - device: "Reverb"
+    reason: "Long tails blend arp notes into shimmering textures"
+  - device: "Delay"
+    reason: "Rhythmic delays compound with arp patterns for complex polyrhythms"
+  - device: "Auto Filter"
+    reason: "Envelope-following filter adds timbral movement to arp sequences"
+
+starter_recipes:
+  - name: "Classic Trance Arp"
+    description: "Driving 16th-note upward arpeggio for trance and EDM"
+    genre: trance
+    params:
+      "Style": "Up"
+      "Rate": "1/16"
+      "Gate": 80
+      "Repeats": 3
+
+  - name: "Random Ambient"
+    description: "Slow random arpeggiation for evolving ambient textures"
+    genre: ambient
+    params:
+      "Style": "Random"
+      "Rate": "1/4"
+      "Gate": 130
+      "Repeats": 2
+
+  - name: "Staccato Pulse"
+    description: "Short, punchy 8th-note pulses for rhythmic synth parts"
+    genre: synthwave
+    params:
+      "Style": "Up"
+      "Rate": "1/8"
+      "Gate": 20
+      "Repeats": 1
+
+  - name: "Converging Drama"
+    description: "Notes converge from extremes for cinematic builds"
+    genre: cinematic
+    params:
+      "Style": "Converge"
+      "Rate": "1/16"
+      "Gate": 60
+      "Repeats": 2
+
+gotchas:
+  - "Arpeggiator must be placed BEFORE the instrument in the device chain — it is a MIDI effect"
+  - "Gate values above 100% create overlapping notes which can cause polyphony issues on mono synths"
+  - "Retrigger mode resets the pattern on every new note — disable for continuous flowing arps"
+  - "Random mode is truly random per cycle, not a fixed random sequence — each repetition differs"
+  - "Transpose stacks with Repeats — 3 repeats with +12 transpose covers 3 octaves"

package/mcp_server/atlas/enrichments/midi_effects/bouncy_notes.yaml

@@ -0,0 +1,93 @@
+id: bouncy_notes
+name: Bouncy Notes
+sonic_description: >
+  Physics-based MIDI note repetition inspired by a bouncing ball — notes repeat with
+  decreasing intervals and velocity, simulating gravity and friction. Creates organic,
+  naturally decaying rhythmic patterns impossible to program manually.
+effect_type: midi_processor
+character_tags: [physics, rhythmic, organic, percussive, decaying]
+use_cases: [bouncing_ball_rhythm, percussive_repeats, organic_decay, creative_echo, physics_patterns]
+genre_affinity:
+  primary: [edm, experimental, idm]
+  secondary: [pop, hip_hop, glitch]
+complexity: intermediate
+introduced_in: "12.0"
+
+key_parameters:
+  - name: "Gravity"
+    description: "Strength of the gravity simulation — higher values create faster bounces"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      light: 0.2
+      moderate: 0.5
+      heavy: 0.8
+
+  - name: "Friction"
+    description: "Energy loss per bounce — higher values make bounces decay faster"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      sustained: 0.1
+      natural: 0.4
+      damped: 0.8
+
+  - name: "Bounce"
+    description: "Elasticity of the bounce — affects how high the ball rebounds"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      dead: 0.2
+      rubber: 0.5
+      super_ball: 0.9
+
+  - name: "Velocity Sensitivity"
+    description: "How much input velocity affects the initial bounce height"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      fixed: 0.0
+      responsive: 0.5
+      dramatic: 1.0
+
+pairs_well_with:
+  - device: "Drum Rack"
+    reason: "Bouncing percussion hits create organic fill patterns"
+  - device: "Simpler"
+    reason: "Bouncing one-shot samples for creative percussive textures"
+  - device: "Reverb"
+    reason: "Reverb tail on bouncing notes creates immersive spatial effects"
+  - device: "Auto Filter"
+    reason: "Filter sweep across bouncing repeats for timbral decay"
+
+starter_recipes:
+  - name: "Bouncing Ball"
+    description: "Classic bouncing ball effect — fast decay, natural physics feel"
+    genre: edm
+    params:
+      "Gravity": 0.7
+      "Friction": 0.3
+      "Bounce": 0.7
+
+  - name: "Long Decay Bounce"
+    description: "Sustained bouncing with low friction for extended rhythmic patterns"
+    genre: ambient
+    params:
+      "Gravity": 0.4
+      "Friction": 0.1
+      "Bounce": 0.8
+
+  - name: "Staccato Bounce"
+    description: "Tight, damped bounces for percussive accents"
+    genre: techno
+    params:
+      "Gravity": 0.9
+      "Friction": 0.7
+      "Bounce": 0.4
+
+gotchas:
+  - "New in Live 12 — not available in earlier versions"
+  - "High Bounce + low Friction creates very long note tails — can cause MIDI overload on dense parts"
+  - "The physics simulation is real-time — bounces are not quantized to the grid"
+  - "Velocity Sensitivity at 0 means all notes bounce the same regardless of how hard you play"
+  - "Works best with percussive, short sounds — sustained pads can become muddy with overlapping bounces"

package/mcp_server/atlas/enrichments/midi_effects/chord.yaml

@@ -0,0 +1,147 @@
+id: chord
+name: Chord
+sonic_description: >
+  Adds up to six parallel intervals to every incoming MIDI note, instantly building
+  chords from single-note input. Ideal for thickening melodic lines, creating
+  power chords, or harmonizing a monophonic source without writing polyphonic parts.
+effect_type: midi_processor
+character_tags: [harmonic, layering, thickening, chordal]
+use_cases: [chord_building, harmonization, octave_doubling, power_chords, parallel_harmony]
+genre_affinity:
+  primary: [edm, pop, rock]
+  secondary: [synthwave, ambient, hip_hop]
+complexity: beginner
+introduced_in: "1.0"
+
+key_parameters:
+  - name: "Shift 1"
+    description: "Semitone offset for the first added note"
+    range: [-36, 36]
+    unit: "st"
+    type: int
+    sweet_spots:
+      minor_third: 3
+      major_third: 4
+      fifth: 7
+      octave: 12
+
+  - name: "Shift 2"
+    description: "Semitone offset for the second added note"
+    range: [-36, 36]
+    unit: "st"
+    type: int
+    sweet_spots:
+      fifth: 7
+      octave: 12
+      ninth: 14
+
+  - name: "Shift 3"
+    description: "Semitone offset for the third added note"
+    range: [-36, 36]
+    unit: "st"
+    type: int
+    sweet_spots:
+      seventh: 10
+      major_seventh: 11
+      two_octaves: 24
+
+  - name: "Shift 4"
+    description: "Semitone offset for the fourth added note"
+    range: [-36, 36]
+    unit: "st"
+    type: int
+
+  - name: "Shift 5"
+    description: "Semitone offset for the fifth added note"
+    range: [-36, 36]
+    unit: "st"
+    type: int
+
+  - name: "Shift 6"
+    description: "Semitone offset for the sixth added note"
+    range: [-36, 36]
+    unit: "st"
+    type: int
+
+  - name: "Velocity 1"
+    description: "Velocity of the first added note (0 disables)"
+    range: [0, 127]
+    type: int
+
+  - name: "Velocity 2"
+    description: "Velocity of the second added note (0 disables)"
+    range: [0, 127]
+    type: int
+
+  - name: "Velocity 3"
+    description: "Velocity of the third added note (0 disables)"
+    range: [0, 127]
+    type: int
+
+  - name: "Velocity 4"
+    description: "Velocity of the fourth added note (0 disables)"
+    range: [0, 127]
+    type: int
+
+  - name: "Velocity 5"
+    description: "Velocity of the fifth added note (0 disables)"
+    range: [0, 127]
+    type: int
+
+  - name: "Velocity 6"
+    description: "Velocity of the sixth added note (0 disables)"
+    range: [0, 127]
+    type: int
+
+pairs_well_with:
+  - device: "Scale"
+    reason: "Place Scale after Chord to force all generated intervals into the correct key"
+  - device: "Arpeggiator"
+    reason: "Place Arpeggiator before Chord to arpeggiate then harmonize, or after for chord arpeggiation"
+  - device: "Drift"
+    reason: "Instant polyphonic chords from single notes into a warm synth"
+  - device: "Reverb"
+    reason: "Blends chord tones together into lush harmonic washes"
+
+starter_recipes:
+  - name: "Power Chord"
+    description: "Root + fifth + octave for rock and EDM power stabs"
+    genre: rock
+    params:
+      "Shift 1": 7
+      "Shift 2": 12
+
+  - name: "Major Triad"
+    description: "Root + major third + fifth for instant major chords"
+    genre: pop
+    params:
+      "Shift 1": 4
+      "Shift 2": 7
+
+  - name: "Minor Triad"
+    description: "Root + minor third + fifth for instant minor chords"
+    genre: pop
+    params:
+      "Shift 1": 3
+      "Shift 2": 7
+
+  - name: "Octave Stack"
+    description: "Doubled one and two octaves up for massive unison sounds"
+    genre: edm
+    params:
+      "Shift 1": 12
+      "Shift 2": 24
+
+  - name: "Major 7th Chord"
+    description: "Lush jazz-inflected major seventh voicing"
+    genre: jazz
+    params:
+      "Shift 1": 4
+      "Shift 2": 7
+      "Shift 3": 11
+
+gotchas:
+  - "Setting Velocity to 0 disables that shift slot — use this to selectively enable/disable intervals"
+  - "All intervals are fixed semitone offsets — the Chord device does NOT adapt to key or scale. Pair with Scale to correct dissonances"
+  - "Can quickly exceed polyphony limits on mono synths — ensure instrument supports enough voices"
+  - "Shift values stack from the root — Shift 1=4, Shift 2=7 gives a major triad, not an octave+fourth"

package/mcp_server/atlas/enrichments/midi_effects/melodic_steps.yaml

@@ -0,0 +1,97 @@
+id: melodic_steps
+name: Melodic Steps
+sonic_description: >
+  Step sequencer designed for creating melodic patterns with per-step control over
+  pitch, velocity, gate length, and more. Generates repeating melodic phrases from
+  a configurable step grid, turning held notes into evolving melodic sequences.
+effect_type: midi_processor
+character_tags: [sequencer, melodic, pattern, generative, stepped]
+use_cases: [melody_sequencing, bassline_patterns, lead_sequences, generative_melody, step_composition]
+genre_affinity:
+  primary: [techno, house, synthwave]
+  secondary: [ambient, idm, trance]
+complexity: intermediate
+introduced_in: "12.0"
+
+key_parameters:
+  - name: "Steps"
+    description: "Number of active steps in the sequence"
+    range: [1, 16]
+    type: int
+    sweet_spots:
+      short: 4
+      standard: 8
+      extended: 16
+
+  - name: "Rate"
+    description: "Playback speed of the step sequence"
+    range: ["1/1", "1/2", "1/4", "1/8", "1/16", "1/32"]
+    type: enum
+    sweet_spots:
+      slow: "1/4"
+      standard: "1/8"
+      fast: "1/16"
+
+  - name: "Pitch (per step)"
+    description: "Pitch offset in semitones for each step"
+    range: [-24, 24]
+    unit: "st"
+    type: int
+
+  - name: "Velocity (per step)"
+    description: "Velocity value for each step"
+    range: [0, 127]
+    type: int
+
+  - name: "Gate (per step)"
+    description: "Note length as percentage of step duration"
+    range: [1, 200]
+    unit: "%"
+    type: int
+
+  - name: "Probability (per step)"
+    description: "Probability that each step triggers"
+    range: [0, 100]
+    unit: "%"
+    type: int
+
+pairs_well_with:
+  - device: "Scale"
+    reason: "Corrects step pitches to stay in key"
+  - device: "Drift"
+    reason: "Warm analog character on stepped melodic sequences"
+  - device: "Wavetable"
+    reason: "Evolving timbres animated by melodic step patterns"
+  - device: "Delay"
+    reason: "Echo on stepped sequences creates polyrhythmic complexity"
+  - device: "Reverb"
+    reason: "Blends stepped notes into flowing melodic textures"
+
+starter_recipes:
+  - name: "Melodic Sequence"
+    description: "8-step ascending melodic pattern for synth leads"
+    genre: synthwave
+    params:
+      "Steps": 8
+      "Rate": "1/8"
+
+  - name: "Accent Pattern"
+    description: "4-step sequence with velocity accents on beats 1 and 3"
+    genre: techno
+    params:
+      "Steps": 4
+      "Rate": "1/16"
+
+  - name: "Generative Melody"
+    description: "16-step sequence with probability variation for evolving patterns"
+    genre: ambient
+    params:
+      "Steps": 16
+      "Rate": "1/8"
+
+gotchas:
+  - "New in Live 12 — this is a Max for Live MIDI effect included with Suite"
+  - "Per-step pitch offsets are relative to the held note — the base pitch changes with your input"
+  - "Steps with 0% probability are effectively muted — use for creating rests in the sequence"
+  - "Gate values above 100% create tied/overlapping notes between steps"
+  - "Unlike Arpeggiator, Melodic Steps does not cycle through chord tones — it applies a fixed pitch pattern"