livepilot 1.9.23 → 1.10.0

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

@@ -0,0 +1,108 @@
+id: note_echo
+name: Note Echo
+sonic_description: >
+  Creates delayed repetitions of incoming MIDI notes, functioning as a MIDI-domain
+  delay effect. Each repeat can shift in pitch, creating cascading melodic echoes
+  that rise, fall, or stay constant. Produces effects impossible with audio delay.
+effect_type: midi_processor
+character_tags: [delay, cascading, melodic, echoing, layering]
+use_cases: [midi_delay, cascading_echoes, pitch_shifted_repeats, melodic_canon, rhythmic_buildup]
+genre_affinity:
+  primary: [ambient, trance, cinematic]
+  secondary: [techno, idm, pop]
+complexity: intermediate
+introduced_in: "1.0"
+
+key_parameters:
+  - name: "Time"
+    description: "Delay time between repeats — synced to tempo or free-running"
+    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:
+      slow_echo: "1/4"
+      rhythmic: "1/8"
+      fast_cascade: "1/16"
+      triplet_bounce: "1/8T"
+
+  - name: "Feedback"
+    description: "Number of echo repetitions"
+    range: [1, 16]
+    type: int
+    sweet_spots:
+      single_echo: 1
+      fading: 3
+      long_tail: 8
+      infinite_feel: 16
+
+  - name: "Pitch Delta"
+    description: "Semitone pitch shift applied to each successive repeat"
+    range: [-24, 24]
+    unit: "st"
+    type: int
+    sweet_spots:
+      octave_rise: 12
+      fifth_climb: 7
+      descending: -7
+      chromatic_fall: -1
+      no_shift: 0
+
+  - name: "Velocity Decay"
+    description: "Velocity reduction per repeat — lower values fade echoes out"
+    range: [0, 127]
+    type: int
+    sweet_spots:
+      natural_fade: 90
+      rapid_decay: 60
+      even_volume: 127
+
+pairs_well_with:
+  - device: "Scale"
+    reason: "Corrects pitch-shifted echoes to stay in key"
+  - device: "Reverb"
+    reason: "Blurs echo tails into ambient washes"
+  - device: "Drift"
+    reason: "Warm analog tones make cascading echoes sound organic"
+  - device: "Auto Filter"
+    reason: "Filter envelope on each echo repeat creates timbral movement"
+  - device: "Delay"
+    reason: "Audio delay on top of MIDI echo creates layered rhythmic complexity"
+
+starter_recipes:
+  - name: "Cascading Octaves"
+    description: "Each echo jumps up an octave for shimmering upward cascades"
+    genre: ambient
+    params:
+      "Time": "1/8"
+      "Feedback": 3
+      "Pitch Delta": 12
+
+  - name: "Simple MIDI Delay"
+    description: "Straightforward note echoes without pitch change"
+    genre: pop
+    params:
+      "Time": "1/4"
+      "Feedback": 2
+      "Pitch Delta": 0
+
+  - name: "Descending Cascade"
+    description: "Echoes descend by a fifth each repeat for dramatic falling lines"
+    genre: cinematic
+    params:
+      "Time": "1/8"
+      "Feedback": 4
+      "Pitch Delta": -7
+
+  - name: "Chromatic Waterfall"
+    description: "Rapid echoes falling one semitone each for glassy descending runs"
+    genre: experimental
+    params:
+      "Time": "1/16"
+      "Feedback": 8
+      "Pitch Delta": -1
+
+gotchas:
+  - "Pitch Delta accumulates across repeats — 3 repeats at +12 means the third echo is 36 semitones up"
+  - "High Feedback with Pitch Delta can push notes outside audible MIDI range (0-127)"
+  - "Unlike audio delay, MIDI echo creates distinct new note events — each echo triggers the synth independently"
+  - "Long Feedback values with fast Time can create very dense note output — watch polyphony limits"
+  - "Place Scale after Note Echo if using Pitch Delta to keep all echoes in key"

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

@@ -0,0 +1,97 @@
+id: note_length
+name: Note Length
+sonic_description: >
+  Controls the duration and triggering behavior of MIDI notes, forcing all notes
+  to a fixed length or converting note-on events into gated triggers. Essential for
+  creating uniform staccato patterns, consistent sample triggers, or legato sustains.
+effect_type: midi_processor
+character_tags: [rhythmic, gating, precise, uniform, triggering]
+use_cases: [staccato, legato, gate_conversion, uniform_length, sample_triggering]
+genre_affinity:
+  primary: [techno, house, edm]
+  secondary: [pop, ambient, experimental]
+complexity: beginner
+introduced_in: "1.0"
+
+key_parameters:
+  - name: "Mode"
+    description: "Operating mode — Time sets fixed duration, Trigger converts note-on to fixed output"
+    range: ["Time", "Trigger"]
+    type: enum
+
+  - name: "Length"
+    description: "Note duration when in Time mode — synced or milliseconds"
+    range: ["1/1", "1/2", "1/4", "1/8", "1/16", "1/32"]
+    type: enum
+    sweet_spots:
+      staccato: "1/32"
+      short: "1/16"
+      medium: "1/8"
+      sustained: "1/4"
+
+  - name: "Gate"
+    description: "Note length as percentage of original or set length"
+    range: [1, 200]
+    unit: "%"
+    type: int
+    sweet_spots:
+      very_short: 10
+      staccato: 30
+      normal: 80
+      legato: 130
+      overlapping: 200
+
+  - name: "Timing"
+    description: "Time offset — delays or advances note output"
+    range: [-200, 200]
+    unit: "ms"
+    type: int
+
+  - name: "Trigger"
+    description: "Trigger mode — Note On generates fixed note, Note Off is ignored"
+    range: ["Note On", "Note Off", "Both"]
+    type: enum
+
+pairs_well_with:
+  - device: "Arpeggiator"
+    reason: "Uniform note lengths after arpeggiation create tight rhythmic patterns"
+  - device: "Drum Rack"
+    reason: "Consistent trigger lengths for one-shot sample playback"
+  - device: "Simpler"
+    reason: "Fixed gate lengths for predictable sample triggering"
+  - device: "Gate"
+    reason: "Pair MIDI gating with audio gating for precise rhythmic effects"
+
+starter_recipes:
+  - name: "Staccato"
+    description: "Very short notes for tight, punchy rhythmic parts"
+    genre: techno
+    params:
+      "Gate": 10
+
+  - name: "Legato"
+    description: "Extended notes that overlap slightly for smooth connected lines"
+    genre: ambient
+    params:
+      "Gate": 200
+
+  - name: "Trigger to Gate"
+    description: "Convert any note input to fixed-length triggers for consistent sample hits"
+    genre: edm
+    params:
+      "Mode": "Trigger"
+      "Length": "1/16"
+      "Trigger": "Note On"
+
+  - name: "Uniform 8th Notes"
+    description: "Force all notes to exactly one eighth note in length"
+    genre: house
+    params:
+      "Length": "1/8"
+      "Gate": 80
+
+gotchas:
+  - "Gate values above 100% create overlapping notes — can cause issues with monophonic synths"
+  - "Trigger mode ignores the original note duration entirely — useful for drum triggers"
+  - "In Trigger mode, Note Off trigger fires a new note when you release — can create unintended double hits"
+  - "Timing offset can push notes ahead or behind the beat — small negative values add feel"

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

@@ -0,0 +1,76 @@
+id: pitch
+name: Pitch
+sonic_description: >
+  Simple, transparent MIDI pitch transposition that shifts all incoming notes by a
+  fixed semitone interval. Can also limit transposition to a specific note range.
+  The most direct way to change the key of MIDI input without editing notes.
+effect_type: midi_processor
+character_tags: [transposition, simple, utility, transparent]
+use_cases: [transposition, octave_shifting, key_change, range_limiting, layered_transposition]
+genre_affinity:
+  primary: [pop, edm, rock]
+  secondary: [jazz, classical, ambient]
+complexity: beginner
+introduced_in: "1.0"
+
+key_parameters:
+  - name: "Pitch"
+    description: "Semitone offset applied to all incoming notes"
+    range: [-48, 48]
+    unit: "st"
+    type: int
+    sweet_spots:
+      octave_down: -12
+      fifth_down: -7
+      no_change: 0
+      fifth_up: 7
+      octave_up: 12
+      two_octaves_up: 24
+
+  - name: "Range"
+    description: "Whether to limit the affected pitch range"
+    range: ["On", "Off"]
+    type: enum
+
+  - name: "Lowest"
+    description: "Lower bound of the affected MIDI note range (when Range is On)"
+    range: [0, 127]
+    type: int
+
+  - name: "Highest"
+    description: "Upper bound of the affected MIDI note range (when Range is On)"
+    range: [0, 127]
+    type: int
+
+pairs_well_with:
+  - device: "Chord"
+    reason: "Transpose the output of Chord to shift entire chord structures"
+  - device: "Arpeggiator"
+    reason: "Shift arpeggiated output up or down without changing the arp pattern"
+  - device: "Scale"
+    reason: "Transpose then snap to scale for key-aware transposition"
+
+starter_recipes:
+  - name: "Octave Up"
+    description: "Shift all notes up one octave"
+    genre: pop
+    params:
+      "Pitch": 12
+
+  - name: "Octave Down"
+    description: "Shift all notes down one octave for bass register"
+    genre: edm
+    params:
+      "Pitch": -12
+
+  - name: "Transpose to Key"
+    description: "Shift up a fifth — useful for quick harmonic layering"
+    genre: pop
+    params:
+      "Pitch": 7
+
+gotchas:
+  - "Pitch is a static offset — it does not adapt to key or scale. Notes shifted out of scale will sound wrong without a Scale device"
+  - "Range mode only transposes notes within the specified range — notes outside pass through unchanged"
+  - "Values beyond +/-48 semitones can push notes outside the audible MIDI range (0-127)"
+  - "Multiple Pitch devices stack additively — two +7 Pitch devices = +14 semitones total"

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

@@ -0,0 +1,117 @@
+id: random
+name: Random
+sonic_description: >
+  Adds controlled randomization to MIDI note properties — pitch, velocity, or timing.
+  Creates evolving, non-repeating patterns from static input, ranging from subtle
+  humanization to full generative chaos depending on parameter settings.
+effect_type: midi_processor
+character_tags: [generative, chaotic, evolving, unpredictable, humanizing]
+use_cases: [generative_melody, humanization, probability_gates, evolving_patterns, controlled_chaos]
+genre_affinity:
+  primary: [ambient, experimental, generative]
+  secondary: [techno, idm, glitch]
+complexity: intermediate
+introduced_in: "1.0"
+
+key_parameters:
+  - name: "Chance"
+    description: "Probability that randomization occurs on each note (0 = never, 100 = always)"
+    range: [0, 100]
+    unit: "%"
+    type: int
+    sweet_spots:
+      subtle: 25
+      moderate: 50
+      frequent: 75
+      always: 100
+
+  - name: "Choices"
+    description: "Number of possible random values — higher = more variation"
+    range: [1, 24]
+    type: int
+    sweet_spots:
+      binary: 2
+      diatonic: 7
+      chromatic: 12
+      wide: 24
+
+  - name: "Scale"
+    description: "Semitone range of randomization"
+    range: [1, 24]
+    unit: "st"
+    type: int
+    sweet_spots:
+      subtle: 2
+      octave: 12
+      two_octave: 24
+
+  - name: "Mode"
+    description: "How randomization is applied"
+    range: ["Add", "Toggle", "Randomize"]
+    type: enum
+    sweet_spots:
+      humanize: "Add"
+      probability: "Toggle"
+      generative: "Randomize"
+
+  - name: "Sign"
+    description: "Direction of random offset"
+    range: ["Bi", "Add", "Sub"]
+    type: enum
+
+pairs_well_with:
+  - device: "Scale"
+    reason: "Corrects random pitch output to stay in key — essential for musical results"
+  - device: "Arpeggiator"
+    reason: "Randomizes arpeggiated patterns for evolving sequences"
+  - device: "Wavetable"
+    reason: "Evolving timbres pair well with unpredictable melodic input"
+  - device: "Delay"
+    reason: "Delay smears random variations into complex evolving textures"
+  - device: "Reverb"
+    reason: "Reverb tail blends randomized notes into atmospheric washes"
+
+starter_recipes:
+  - name: "Subtle Pitch Variation"
+    description: "Gentle random pitch offsets for organic, human feel"
+    genre: ambient
+    params:
+      "Chance": 30
+      "Choices": 3
+      "Scale": 2
+      "Mode": "Add"
+      "Sign": "Bi"
+
+  - name: "Generative Melody"
+    description: "Full random pitch within an octave — pair with Scale for musicality"
+    genre: generative
+    params:
+      "Chance": 100
+      "Choices": 12
+      "Scale": 12
+      "Mode": "Randomize"
+      "Sign": "Bi"
+
+  - name: "Controlled Chaos"
+    description: "High chance, wide range randomization for experimental textures"
+    genre: experimental
+    params:
+      "Chance": 80
+      "Choices": 24
+      "Scale": 24
+      "Mode": "Randomize"
+      "Sign": "Bi"
+
+  - name: "Probability Gate"
+    description: "50% chance each note plays — creates evolving rhythmic patterns"
+    genre: techno
+    params:
+      "Chance": 50
+      "Mode": "Toggle"
+
+gotchas:
+  - "Without a Scale device after Random, output will be chromatic and likely dissonant"
+  - "Chance at 100% means every note is affected — lower values create a mix of original and randomized notes"
+  - "Toggle mode does not change pitch — it randomly enables or disables notes, acting as a probability gate"
+  - "Choices and Scale interact — Choices subdivides the Scale range into equal steps"
+  - "Sign=Add only offsets upward, Sign=Sub only downward — use Bi for balanced randomization"

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

@@ -0,0 +1,103 @@
+id: rhythmic_steps
+name: Rhythmic Steps
+sonic_description: >
+  Rhythmic step sequencer focused on gate patterns, velocity accents, and per-step
+  probability. Transforms held notes into complex rhythmic patterns without changing
+  pitch, ideal for creating drum-like rhythmic figures from melodic input.
+effect_type: midi_processor
+character_tags: [rhythmic, sequencer, percussive, pattern, probability]
+use_cases: [rhythm_programming, gate_patterns, accent_sequences, probability_rhythms, euclidean_style]
+genre_affinity:
+  primary: [techno, house, edm]
+  secondary: [hip_hop, experimental, idm]
+complexity: intermediate
+introduced_in: "12.0"
+
+key_parameters:
+  - name: "Steps"
+    description: "Number of active steps in the rhythmic pattern"
+    range: [1, 16]
+    type: int
+    sweet_spots:
+      minimal: 4
+      standard: 8
+      complex: 16
+
+  - name: "Rate"
+    description: "Playback speed of the step pattern"
+    range: ["1/1", "1/2", "1/4", "1/8", "1/16", "1/32"]
+    type: enum
+    sweet_spots:
+      quarter: "1/4"
+      eighth: "1/8"
+      sixteenth: "1/16"
+
+  - name: "Gate (per step)"
+    description: "Whether each step triggers a note and for how long"
+    range: [0, 200]
+    unit: "%"
+    type: int
+    sweet_spots:
+      off: 0
+      short: 20
+      normal: 80
+      tied: 200
+
+  - name: "Velocity (per step)"
+    description: "Velocity for each step — creates accent patterns"
+    range: [0, 127]
+    type: int
+    sweet_spots:
+      ghost: 40
+      normal: 90
+      accent: 127
+
+  - name: "Probability (per step)"
+    description: "Chance each step fires — creates evolving, non-repeating patterns"
+    range: [0, 100]
+    unit: "%"
+    type: int
+    sweet_spots:
+      always: 100
+      likely: 75
+      coin_flip: 50
+      rare: 25
+
+pairs_well_with:
+  - device: "Drum Rack"
+    reason: "Rhythmic gating on drum hits for complex beat programming"
+  - device: "Analog"
+    reason: "Rhythmic gate patterns on synth drones for sequenced synth lines"
+  - device: "Auto Filter"
+    reason: "Timbral movement synchronized to rhythmic step triggers"
+  - device: "Compressor"
+    reason: "Sidechain-style pumping aligned with rhythmic patterns"
+
+starter_recipes:
+  - name: "Euclidean-Style Pattern"
+    description: "Evenly distributed hits across 16 steps for polyrhythmic feel"
+    genre: techno
+    params:
+      "Steps": 16
+      "Rate": "1/16"
+
+  - name: "Probability Rhythm"
+    description: "8-step pattern with varying probabilities for evolving beats"
+    genre: idm
+    params:
+      "Steps": 8
+      "Rate": "1/16"
+
+  - name: "Four on the Floor with Ghost Notes"
+    description: "Strong accents on beats with quiet ghost notes between"
+    genre: house
+    params:
+      "Steps": 8
+      "Rate": "1/8"
+
+gotchas:
+  - "New in Live 12 — this is a Max for Live MIDI effect included with Suite"
+  - "Rhythmic Steps does not change pitch — it only controls rhythm, velocity, and gate"
+  - "Steps with Gate at 0 are silent rests — different from Probability at 0 which is deterministically off"
+  - "Probability creates variation on each cycle — the pattern is never exactly the same twice"
+  - "Combine with Melodic Steps for full melodic+rhythmic sequencing capability"

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

@@ -0,0 +1,83 @@
+id: scale
+name: Scale
+sonic_description: >
+  Forces all incoming MIDI notes to conform to a selected musical scale, correcting
+  out-of-key notes by mapping them to the nearest scale degree. Essential for keeping
+  generative, randomized, or improvised MIDI output harmonically coherent.
+effect_type: midi_processor
+character_tags: [harmonic, corrective, constraining, tonal]
+use_cases: [scale_locking, key_correction, modal_constraint, generative_safety, improvisation_aid]
+genre_affinity:
+  primary: [edm, pop, ambient]
+  secondary: [jazz, world, classical, hip_hop]
+complexity: beginner
+introduced_in: "1.0"
+
+key_parameters:
+  - name: "Base"
+    description: "Root note of the scale"
+    range: ["C", "C#", "D", "D#", "E", "F", "F#", "G", "G#", "A", "A#", "B"]
+    type: enum
+
+  - name: "Scale Type"
+    description: "Musical scale or mode to enforce"
+    range: ["Major", "Minor", "Dorian", "Mixolydian", "Lydian", "Phrygian", "Locrian", "Harmonic Minor", "Melodic Minor", "Pentatonic Major", "Pentatonic Minor", "Blues", "Whole Tone", "Chromatic"]
+    type: enum
+    sweet_spots:
+      universal: "Minor"
+      bright: "Major"
+      jazzy: "Dorian"
+      eastern: "Phrygian"
+      dreamy: "Lydian"
+      minimal: "Pentatonic Minor"
+
+  - name: "Fold"
+    description: "Whether out-of-scale notes are folded to nearest scale degree or blocked"
+    range: ["On", "Off"]
+    type: enum
+
+pairs_well_with:
+  - device: "Arpeggiator"
+    reason: "Place Scale after Arpeggiator to ensure arpeggiated notes stay in key"
+  - device: "Random"
+    reason: "Scale corrects random pitch offsets to stay musically coherent"
+  - device: "Chord"
+    reason: "Corrects parallel intervals that fall outside the target scale"
+  - device: "Note Echo"
+    reason: "Ensures pitch-shifted echo repeats stay in key"
+
+starter_recipes:
+  - name: "Lock to Natural Minor"
+    description: "Constrain all input to A natural minor — safe for most melancholic productions"
+    genre: pop
+    params:
+      "Base": "A"
+      "Scale Type": "Minor"
+
+  - name: "Pentatonic Filter"
+    description: "Reduce to pentatonic for universally consonant generative output"
+    genre: ambient
+    params:
+      "Base": "C"
+      "Scale Type": "Pentatonic Minor"
+
+  - name: "Modal Constraint — Dorian"
+    description: "Force Dorian mode for jazzy, sophisticated minor tonality"
+    genre: jazz
+    params:
+      "Base": "D"
+      "Scale Type": "Dorian"
+
+  - name: "Blues Scale Lock"
+    description: "Constrain to blues scale for authentic blues/soul feel"
+    genre: blues
+    params:
+      "Base": "A"
+      "Scale Type": "Blues"
+
+gotchas:
+  - "Scale has a per-note mapping grid — you can customize individual note routing beyond the preset scales"
+  - "Place Scale AFTER pitch-generating MIDI effects (Arpeggiator, Random, Chord) so it corrects their output"
+  - "Chromatic scale type passes all notes through unchanged — useful as a bypass without removing the device"
+  - "Live 12 clips have their own scale setting — the Scale MIDI effect is independent and can conflict. Check both"
+  - "Fold mode determines whether notes snap to nearest scale tone or are silenced — Fold On is usually preferred"