livepilot 1.9.23 → 1.10.0

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

@@ -0,0 +1,112 @@
+id: step_arp
+name: Step Arp
+sonic_description: >
+  Step-based arpeggiator combining the chord-cycling behavior of Arpeggiator with
+  per-step control over pitch offset, velocity, gate, and probability. Offers more
+  granular control than the classic Arpeggiator for complex, evolving arp patterns.
+effect_type: midi_processor
+character_tags: [arpeggiator, sequencer, stepped, complex, programmable]
+use_cases: [complex_arpeggios, per_step_arp, custom_sequences, evolving_patterns, hybrid_sequencing]
+genre_affinity:
+  primary: [trance, edm, synthwave]
+  secondary: [ambient, techno, pop]
+complexity: advanced
+introduced_in: "12.0"
+
+key_parameters:
+  - name: "Steps"
+    description: "Number of active steps in the arpeggiator pattern"
+    range: [1, 16]
+    type: int
+    sweet_spots:
+      minimal: 4
+      standard: 8
+      extended: 16
+
+  - name: "Rate"
+    description: "Arpeggio speed — tempo-synced"
+    range: ["1/1", "1/2", "1/4", "1/8", "1/16", "1/32"]
+    type: enum
+    sweet_spots:
+      moderate: "1/8"
+      fast: "1/16"
+
+  - name: "Pitch Offset (per step)"
+    description: "Semitone offset from the current arp note for each step"
+    range: [-24, 24]
+    unit: "st"
+    type: int
+
+  - name: "Velocity (per step)"
+    description: "Velocity override for each step"
+    range: [0, 127]
+    type: int
+
+  - name: "Gate (per step)"
+    description: "Note length as percentage of step duration for each step"
+    range: [0, 200]
+    unit: "%"
+    type: int
+
+  - name: "Probability (per step)"
+    description: "Trigger probability for each step"
+    range: [0, 100]
+    unit: "%"
+    type: int
+
+  - name: "Style"
+    description: "Base arpeggio direction before per-step modifications"
+    range: ["Up", "Down", "UpDown", "Random"]
+    type: enum
+
+  - name: "Octave Range"
+    description: "Number of octaves the arpeggio spans"
+    range: [1, 4]
+    type: int
+
+pairs_well_with:
+  - device: "Scale"
+    reason: "Corrects per-step pitch offsets to stay in key"
+  - device: "Wavetable"
+    reason: "Complex arpeggiated patterns with evolving wavetable timbres"
+  - device: "Chorus-Ensemble"
+    reason: "Widens and thickens arpeggiated output"
+  - device: "Delay"
+    reason: "Echo on complex arp patterns creates intricate rhythmic webs"
+  - device: "Reverb"
+    reason: "Spatializes complex arp sequences into immersive soundscapes"
+
+starter_recipes:
+  - name: "Complex Arp"
+    description: "8-step arp with varying velocities and gates for dynamic movement"
+    genre: trance
+    params:
+      "Steps": 8
+      "Rate": "1/16"
+      "Style": "Up"
+      "Octave Range": 2
+
+  - name: "Step Sequence Arp"
+    description: "Hybrid sequencer-arpeggiator with per-step pitch offsets"
+    genre: synthwave
+    params:
+      "Steps": 16
+      "Rate": "1/16"
+      "Style": "Up"
+      "Octave Range": 1
+
+  - name: "Probability Arp"
+    description: "Random-direction arp with per-step probability for generative evolution"
+    genre: ambient
+    params:
+      "Steps": 12
+      "Rate": "1/8"
+      "Style": "Random"
+      "Octave Range": 3
+
+gotchas:
+  - "New in Live 12 — not available in earlier versions"
+  - "Per-step Pitch Offset stacks on top of the arpeggio's chord-tone cycling — the final pitch is chord note + offset"
+  - "More CPU-intensive than the classic Arpeggiator due to per-step processing"
+  - "Steps with Gate at 0% are silent — different from Probability at 0% which is a deterministic rest"
+  - "Differs from Melodic Steps: Step Arp cycles through held chord tones, Melodic Steps applies a fixed pitch pattern"

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

@@ -0,0 +1,119 @@
+id: velocity
+name: Velocity
+sonic_description: >
+  Processes and reshapes MIDI note velocity, offering compression, expansion, limiting,
+  randomization, and fixed-value output. Controls dynamic expression and can flatten,
+  exaggerate, or humanize the velocity range of incoming MIDI data.
+effect_type: midi_processor
+character_tags: [dynamics, expression, compression, humanizing, limiting]
+use_cases: [velocity_compression, dynamic_control, humanization, fixed_velocity, velocity_mapping]
+genre_affinity:
+  primary: [edm, pop, hip_hop]
+  secondary: [jazz, ambient, techno]
+complexity: beginner
+introduced_in: "1.0"
+
+key_parameters:
+  - name: "Drive"
+    description: "Amplifies the velocity curve — boosts or attenuates velocity values"
+    range: [-1.0, 1.0]
+    type: float
+    sweet_spots:
+      attenuate: -0.5
+      neutral: 0.0
+      boost: 0.5
+      aggressive: 0.9
+
+  - name: "Compand"
+    description: "Compresses (negative) or expands (positive) the velocity range"
+    range: [-1.0, 1.0]
+    type: float
+    sweet_spots:
+      compress: -0.5
+      neutral: 0.0
+      expand: 0.5
+
+  - name: "Out Hi"
+    description: "Maximum output velocity — caps the highest velocity value"
+    range: [1, 127]
+    type: int
+    sweet_spots:
+      limited: 100
+      full: 127
+
+  - name: "Out Low"
+    description: "Minimum output velocity — sets the floor for velocity values"
+    range: [1, 127]
+    type: int
+    sweet_spots:
+      quiet: 30
+      moderate: 64
+      loud: 100
+
+  - name: "Random"
+    description: "Adds random velocity offset to each note — humanizes mechanical input"
+    range: [0, 64]
+    type: int
+    sweet_spots:
+      subtle: 5
+      moderate: 15
+      wild: 40
+
+  - name: "Operation"
+    description: "How velocity is processed — Clip, Gate, or Fixed"
+    range: ["Clip", "Gate", "Fixed"]
+    type: enum
+    sweet_spots:
+      normal: "Clip"
+      gated: "Gate"
+      uniform: "Fixed"
+
+pairs_well_with:
+  - device: "Arpeggiator"
+    reason: "Normalizes velocity across arpeggiated notes for even dynamics"
+  - device: "Drum Rack"
+    reason: "Controls hit dynamics for consistent drum patterns"
+  - device: "Compressor"
+    reason: "MIDI velocity compression before audio compression for maximum control"
+  - device: "Random"
+    reason: "Random pitch combined with random velocity for organic generative output"
+
+starter_recipes:
+  - name: "Flatten Velocity"
+    description: "Force all notes to the same velocity for mechanical, consistent output"
+    genre: techno
+    params:
+      "Out Hi": 64
+      "Out Low": 64
+      "Operation": "Fixed"
+
+  - name: "Expand Dynamics"
+    description: "Exaggerate velocity differences for more expressive playing"
+    genre: jazz
+    params:
+      "Compand": 0.6
+      "Out Hi": 127
+      "Out Low": 1
+
+  - name: "Random Humanize"
+    description: "Add subtle random velocity variation to mechanical MIDI for human feel"
+    genre: pop
+    params:
+      "Random": 10
+      "Out Hi": 120
+      "Out Low": 60
+
+  - name: "Soft Limiter"
+    description: "Cap maximum velocity to prevent harsh hits while preserving dynamics"
+    genre: ambient
+    params:
+      "Out Hi": 90
+      "Out Low": 30
+      "Compand": -0.3
+
+gotchas:
+  - "Fixed operation mode ignores input velocity entirely — all notes output at (Out Hi + Out Low) / 2"
+  - "Gate mode silences notes below Out Low — notes either pass or are killed, no middle ground"
+  - "Random offset is bidirectional — it can push notes above Out Hi or below Out Low before clipping"
+  - "Compand at extreme negative values squashes all velocities to a narrow band — check the curve display"
+  - "Drive and Compand interact — set one at a time to understand the combined curve shape"

package/mcp_server/atlas/enrichments/utility/amp.yaml

@@ -0,0 +1,159 @@
+id: amp
+name: Amp
+sonic_description: >
+  Guitar and bass amplifier modeling with seven distinct amp types ranging from
+  pristine clean to crushing heavy distortion. Models the preamp gain stage, tone
+  stack (bass/mid/treble), presence, and output level of classic amplifier designs.
+  Best paired with Cabinet for complete amp simulation.
+effect_type: distortion
+character_tags: [guitar, amp, distortion, warm, crunchy, heavy]
+use_cases: [guitar_amp, bass_amp, synth_distortion, amp_modeling, overdrive]
+genre_affinity:
+  primary: [rock, metal, blues]
+  secondary: [indie, funk, jazz, pop]
+complexity: beginner
+introduced_in: "9.0"
+
+key_parameters:
+  - name: "Amp Type"
+    description: "Amplifier model — each models a different classic amp character"
+    range: ["Clean", "Boost", "Blues", "Rock", "Lead", "Heavy", "Bass"]
+    type: enum
+    sweet_spots:
+      jazz: "Clean"
+      blues: "Blues"
+      classic_rock: "Rock"
+      metal: "Heavy"
+      bass_guitar: "Bass"
+
+  - name: "Gain"
+    description: "Preamp gain — controls distortion amount"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      clean: 0.2
+      crunch: 0.5
+      overdrive: 0.7
+      saturated: 0.9
+
+  - name: "Bass"
+    description: "Low frequency tone control"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      thin: 0.2
+      balanced: 0.5
+      warm: 0.7
+      heavy: 0.9
+
+  - name: "Middle"
+    description: "Midrange tone control — scooped vs present"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      scooped: 0.2
+      balanced: 0.5
+      honky: 0.7
+      nasal: 0.9
+
+  - name: "Treble"
+    description: "High frequency tone control"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      dark: 0.2
+      balanced: 0.5
+      bright: 0.7
+      ice: 0.9
+
+  - name: "Presence"
+    description: "Upper harmonic emphasis — adds air and bite above the treble range"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      smooth: 0.2
+      normal: 0.5
+      cutting: 0.8
+
+  - name: "Output"
+    description: "Master output level after the amp stage"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      quiet: 0.3
+      normal: 0.5
+      loud: 0.8
+
+  - name: "Dry/Wet"
+    description: "Mix between dry input and amp-processed signal"
+    range: [0, 100]
+    unit: "%"
+    type: int
+
+pairs_well_with:
+  - device: "Cabinet"
+    reason: "Essential pairing — Amp provides preamp/tone, Cabinet adds speaker simulation"
+  - device: "Pedal"
+    reason: "Place Pedal before Amp for stompbox-into-amp signal chain"
+  - device: "Reverb"
+    reason: "Spring or plate reverb after amp for classic guitar tones"
+  - device: "Delay"
+    reason: "Echo after amp for spacious guitar sounds"
+  - device: "EQ Eight"
+    reason: "Surgical EQ after amp to tame resonances"
+
+starter_recipes:
+  - name: "Clean Jazz Amp"
+    description: "Pristine clean tone with warm bass and smooth highs"
+    genre: jazz
+    params:
+      "Amp Type": "Clean"
+      "Gain": 0.3
+      "Bass": 0.6
+      "Middle": 0.5
+      "Treble": 0.4
+      "Presence": 0.3
+      "Output": 0.5
+
+  - name: "Overdriven Rock"
+    description: "Classic crunchy rock tone with mid-focused bite"
+    genre: rock
+    params:
+      "Amp Type": "Rock"
+      "Gain": 0.7
+      "Bass": 0.5
+      "Middle": 0.6
+      "Treble": 0.6
+      "Presence": 0.5
+      "Output": 0.5
+
+  - name: "Bass Amp Warmth"
+    description: "Warm, fat bass guitar tone with controlled low end"
+    genre: rock
+    params:
+      "Amp Type": "Bass"
+      "Gain": 0.4
+      "Bass": 0.7
+      "Middle": 0.4
+      "Treble": 0.3
+      "Presence": 0.2
+      "Output": 0.6
+
+  - name: "Heavy Metal"
+    description: "High-gain saturated tone for metal and hard rock"
+    genre: metal
+    params:
+      "Amp Type": "Heavy"
+      "Gain": 0.9
+      "Bass": 0.6
+      "Middle": 0.3
+      "Treble": 0.7
+      "Presence": 0.7
+      "Output": 0.5
+
+gotchas:
+  - "Amp without Cabinet sounds harsh and buzzy — always pair with Cabinet for realistic speaker simulation"
+  - "High Gain settings can dramatically increase output level — watch for clipping downstream"
+  - "The Bass amp type has a different tone stack optimized for bass guitar frequencies"
+  - "Dry/Wet allows parallel distortion — useful for bass guitar to preserve low-end clarity"
+  - "Presence control affects frequencies above the Treble control — subtle but important for cut"

package/mcp_server/atlas/enrichments/utility/cabinet.yaml

@@ -0,0 +1,109 @@
+id: cabinet
+name: Cabinet
+sonic_description: >
+  Speaker cabinet simulation modeling the frequency response and spatial characteristics
+  of classic guitar and bass speaker cabinets with selectable microphone type and position.
+  Transforms raw amp signal into realistic speaker output. Essential companion to the
+  Amp device.
+effect_type: distortion
+character_tags: [speaker, cabinet, guitar, modeling, warm]
+use_cases: [speaker_simulation, guitar_cabinet, bass_cabinet, amp_completion, tone_shaping]
+genre_affinity:
+  primary: [rock, metal, blues]
+  secondary: [indie, funk, jazz, pop]
+complexity: beginner
+introduced_in: "9.0"
+
+key_parameters:
+  - name: "Speaker"
+    description: "Speaker configuration — size and number of speakers"
+    range: ["1x12", "2x12", "4x10", "4x12"]
+    type: enum
+    sweet_spots:
+      combo: "1x12"
+      twin: "2x12"
+      bass: "4x10"
+      full_stack: "4x12"
+
+  - name: "Microphone"
+    description: "Microphone type used to capture the speaker"
+    range: ["Dynamic", "Condenser", "Ribbon"]
+    type: enum
+    sweet_spots:
+      rock: "Dynamic"
+      detailed: "Condenser"
+      warm: "Ribbon"
+
+  - name: "Mic Position"
+    description: "Microphone placement relative to the speaker — near to far"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      close: 0.1
+      medium: 0.4
+      room: 0.8
+
+  - name: "Dry/Wet"
+    description: "Mix between dry input and cabinet-processed signal"
+    range: [0, 100]
+    unit: "%"
+    type: int
+
+  - name: "Output"
+    description: "Output level after cabinet processing"
+    range: [0.0, 1.0]
+    type: float
+
+pairs_well_with:
+  - device: "Amp"
+    reason: "Essential pairing — Amp before Cabinet recreates a complete amplifier rig"
+  - device: "Pedal"
+    reason: "Pedal before Amp before Cabinet for classic pedalboard-to-amp chain"
+  - device: "Reverb"
+    reason: "Room or spring reverb after Cabinet for spacious amp tones"
+  - device: "EQ Eight"
+    reason: "Post-cabinet EQ to fine-tune the speaker response"
+
+starter_recipes:
+  - name: "Classic Combo"
+    description: "Small combo amp feel — 1x12 with close dynamic mic"
+    genre: blues
+    params:
+      "Speaker": "1x12"
+      "Microphone": "Dynamic"
+      "Mic Position": 0.2
+      "Dry/Wet": 100
+
+  - name: "4x12 Full Stack"
+    description: "Big rock/metal cabinet with tight low end and aggressive midrange"
+    genre: rock
+    params:
+      "Speaker": "4x12"
+      "Microphone": "Dynamic"
+      "Mic Position": 0.15
+      "Dry/Wet": 100
+
+  - name: "Warm Ribbon Capture"
+    description: "Smooth, warm tone using ribbon mic at medium distance"
+    genre: jazz
+    params:
+      "Speaker": "2x12"
+      "Microphone": "Ribbon"
+      "Mic Position": 0.5
+      "Dry/Wet": 100
+
+  - name: "Bass Cabinet"
+    description: "4x10 bass cabinet with condenser mic for full frequency response"
+    genre: rock
+    params:
+      "Speaker": "4x10"
+      "Microphone": "Condenser"
+      "Mic Position": 0.3
+      "Dry/Wet": 100
+
+gotchas:
+  - "Cabinet without Amp sounds very different — Cabinet applies speaker coloring to whatever signal enters"
+  - "Mic Position dramatically changes tone — close is bright and focused, far is roomy and darker"
+  - "4x12 has more low end than 1x12 — match the cabinet size to your musical context"
+  - "Ribbon mic type rolls off highs naturally — good for taming harsh distortion"
+  - "Can be used on non-guitar sources (synths, drums) for creative speaker coloring"

package/mcp_server/atlas/enrichments/utility/corpus.yaml

@@ -0,0 +1,150 @@
+id: corpus
+name: Corpus
+sonic_description: >
+  Physical modeling resonator that simulates the resonant properties of various
+  physical objects — beams, strings, membranes, plates, pipes, and tubes. Imposes
+  the harmonic character of a physical body onto incoming audio, adding tuned
+  metallic, woody, or hollow resonances.
+effect_type: resonator
+character_tags: [physical_modeling, resonant, metallic, woody, tuned]
+use_cases: [body_resonance, metallic_texture, tuned_resonance, physical_modeling, creative_coloring]
+genre_affinity:
+  primary: [experimental, ambient, sound_design]
+  secondary: [techno, idm, cinematic]
+complexity: advanced
+introduced_in: "8.0"
+
+key_parameters:
+  - name: "Resonance Type"
+    description: "Physical object being modeled — each has distinct harmonic characteristics"
+    range: ["Beam", "Marimba", "String", "Membrane", "Plate", "Pipe", "Tube"]
+    type: enum
+    sweet_spots:
+      metallic: "Beam"
+      woody: "Marimba"
+      tonal: "String"
+      deep: "Membrane"
+      bright: "Plate"
+      hollow: "Pipe"
+      breathy: "Tube"
+
+  - name: "Material"
+    description: "Damping characteristics — wood absorbs more than metal"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      wood: 0.2
+      mixed: 0.5
+      metal: 0.9
+
+  - name: "Decay"
+    description: "How long the resonance sustains after excitation"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      tight: 0.1
+      natural: 0.4
+      long: 0.8
+      infinite: 1.0
+
+  - name: "Tune"
+    description: "Pitch of the resonant body — tunes the fundamental resonance"
+    range: [-48.0, 48.0]
+    unit: "st"
+    type: float
+    sweet_spots:
+      bass: -12.0
+      middle: 0.0
+      high: 12.0
+
+  - name: "Fine Tune"
+    description: "Fine pitch adjustment in cents"
+    range: [-50.0, 50.0]
+    unit: "cents"
+    type: float
+
+  - name: "Listening Position (L)"
+    description: "Left channel listening position on the resonant body"
+    range: [0.0, 1.0]
+    type: float
+
+  - name: "Listening Position (R)"
+    description: "Right channel listening position on the resonant body"
+    range: [0.0, 1.0]
+    type: float
+
+  - name: "Brightness"
+    description: "High-frequency content of the resonance — higher is brighter"
+    range: [0.0, 1.0]
+    type: float
+
+  - name: "Inharm"
+    description: "Inharmonicity — how much the overtones deviate from pure harmonics"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      harmonic: 0.0
+      natural: 0.3
+      metallic: 0.7
+      bell_like: 1.0
+
+  - name: "Dry/Wet"
+    description: "Mix between dry signal and resonator output"
+    range: [0, 100]
+    unit: "%"
+    type: int
+
+pairs_well_with:
+  - device: "Drum Rack"
+    reason: "Adds body and tuned resonance to drum hits"
+  - device: "Compressor"
+    reason: "Controls the dynamics of resonance tails"
+  - device: "Reverb"
+    reason: "Spatializes the resonance for immersive textures"
+  - device: "EQ Eight"
+    reason: "Tames specific resonant peaks that can build up"
+  - device: "Saturator"
+    reason: "Adds warmth and harmonics to the resonant tone"
+
+starter_recipes:
+  - name: "Metallic Resonance"
+    description: "Bright, ringing metallic body resonance on percussion or synths"
+    genre: experimental
+    params:
+      "Resonance Type": "Plate"
+      "Material": 0.8
+      "Decay": 0.5
+      "Brightness": 0.7
+      "Inharm": 0.5
+      "Dry/Wet": 40
+
+  - name: "Body Resonator"
+    description: "Warm wooden body resonance for acoustic character"
+    genre: ambient
+    params:
+      "Resonance Type": "Marimba"
+      "Material": 0.3
+      "Decay": 0.3
+      "Brightness": 0.4
+      "Inharm": 0.1
+      "Dry/Wet": 30
+
+  - name: "Tuned Surface"
+    description: "Tuned membrane resonance that pitches the input to a specific note"
+    genre: sound_design
+    params:
+      "Resonance Type": "Membrane"
+      "Material": 0.5
+      "Decay": 0.6
+      "Tune": 0.0
+      "Brightness": 0.5
+      "Inharm": 0.2
+      "Dry/Wet": 60
+
+gotchas:
+  - "High Decay + high Material (metal) can create very long resonances that build up — watch levels"
+  - "Tune parameter dramatically changes the character — a few semitones makes a big difference"
+  - "Inharm at high values creates bell-like, non-harmonic overtones that may not track pitch musically"
+  - "Listening Position affects stereo image — different L/R positions create natural stereo spread"
+  - "Works best with transient-rich input (drums, plucks) — sustained input can cause runaway resonance"
+  - "CPU usage increases with long Decay times — monitor CPU on dense sessions"