livepilot 1.16.0 → 1.17.0

package/mcp_server/atlas/enrichments/audio_effects/pitch_hack.yaml

@@ -0,0 +1,61 @@
+id: pitch_hack
+name: Pitch Hack
+sonic_description: >
+  Versatile pitch-shifting delay for Creative Extensions. Combines
+  transposition, reverse, feedback, and randomization on a single delay
+  line. Lighter-weight companion to PitchLoop89 — less of a spatial
+  architect, more of a per-sound treatment for pitched echoes and random
+  reversal textures. The go-to for Akufen-style micro-stutter on hats and
+  the random-reverse pitched ghosts that Villalobos uses on every track.
+category: pitch_delay
+character_tags: [pitched, glitchy, reversed, randomized, micro_stutter]
+use_cases: [akufen_stutter, pitched_ghost, reverse_echo, textural_delay]
+genre_affinity:
+  primary: [microhouse, deep_minimal, idm, experimental]
+  secondary: [dub_techno, electronica]
+complexity: beginner
+introduced_in: "10.0"
+pack: Creative Extensions
+creator: Ableton + Amazing Noises
+class_name: PluginDevice
+
+key_parameters:
+  - name: "Transpose"
+    description: "Pitch shift in semitones + cents on the delayed signal."
+    range: [-24, 24]
+    unit: "st"
+    type: int
+  - name: "Delay Time"
+    description: "Delay in ms or tempo-synced subdivisions."
+  - name: "Feedback"
+    description: "Pitched echo feedback. Cascading when transpose is non-zero."
+    range: [0.0, 1.0]
+    type: float
+  - name: "Reverse"
+    description: "Reverse-plays the delay buffer."
+    type: boolean
+  - name: "Randomize"
+    description: "Randomizes pitch and/or reverse per repeat. The Villalobos-texture parameter."
+    range: [0.0, 1.0]
+    type: float
+
+signature_techniques:
+  - name: "Akufen micro-stutter on hats"
+    description: "Short delay (~50ms), Feedback 0.4, Randomize 0.6 → every hi-hat hit gets 2-3 unpredictable pitched ghost echoes."
+    aesthetic: [microhouse]
+  - name: "Ghost chord tails"
+    description: "Chord stab → Reverse on, Transpose +3st, Feedback 0.5 → pitched reverse ghost trails fade out after each stab."
+    aesthetic: [deep_minimal]
+  - name: "Random pitched percussion"
+    description: "Put on a clave or click → Randomize full → each hit decays into a different pitched echo pattern."
+    aesthetic: [microhouse, idm]
+
+pairings:
+  - device: spectral_blur
+    rationale: "Feed Pitch Hack's random-pitched output into Spectral Blur's halo for ghost atmospheres under the kick."
+
+gotchas:
+  - "Randomize above 0.8 can produce notes wildly out of key — gate with key-detection first if harmony matters."
+
+learn_more:
+  official: "https://www.ableton.com/en/packs/creative-extensions/"

package/mcp_server/atlas/enrichments/audio_effects/pitchloop89.yaml

@@ -0,0 +1,111 @@
+id: pitchloop89
+name: PitchLoop89
+sonic_description: >
+  Robert Henke's emulation of the 1979 Publison DHM 89 B2 pitch-shifting delay.
+  Two independent pitch-shifting delay voices per stereo channel, each with
+  their own pitch (±24 semitones), fine detune (±1 semitone), feedback, pan,
+  and reverse capability. Sample rate selection, hold function, vibrato LFO
+  (sine/square), position modulation LFO with 7 waveforms. THE tool for
+  Monolake-style detuned delay clouds, Basic Channel spatial signatures,
+  and Arpiar-adjacent shimmered stabs.
+category: pitch_delay
+character_tags: [detuned, shimmering, glitchy, spatial, pitched, experimental, vintage_digital]
+use_cases: [stab_shimmer, detuned_echo, reverse_tail, infinite_feedback, glitched_texture]
+genre_affinity:
+  primary: [deep_minimal, dub_techno, ambient, experimental]
+  secondary: [microhouse, idm, drone, cinematic]
+complexity: intermediate
+introduced_in: "11.0"
+pack: PitchLoop89
+creator: Robert Henke
+class_name: PluginDevice
+
+key_parameters:
+  - name: "Pitch A / Pitch B"
+    description: "Coarse pitch shift per voice, in semitones. Two voices mean you can split: one +0.05 cents shimmer, one -0.07 cents detune for dual-detune clouds."
+    range: [-24, 24]
+    unit: "st"
+    type: int
+    sweet_spots:
+      dual_detune_cloud: "+0.05 / -0.07 cents"
+      octave_shimmer: "+12 / +0"
+      reverse_ambience: "+0 / +0 with reverse on"
+
+  - name: "Fine A / Fine B"
+    description: "Fine detune per voice in cents (±100)."
+    range: [-100, 100]
+    unit: "cents"
+    type: int
+    sweet_spots:
+      shimmer: "+5 / -7"
+      chorus_thick: "+15 / -15"
+
+  - name: "Feedback A / Feedback B"
+    description: "Per-voice feedback. High values (80-95%) produce infinite-ascending or descending pitch spirals. Shepard-tone territory."
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      subtle_echo: 0.35
+      pitched_spiral: 0.85
+      near_infinite: 0.97
+
+  - name: "Reverse"
+    description: "Per-voice reverse playback. Reverses the delay buffer before pitch shift — creates 'reverse swell' tails from any transient."
+    type: boolean
+    sweet_spots:
+      chord_swell_in: true
+
+  - name: "Mode"
+    description: "Signal routing: L/R (independent), Sum (both voices sum to mono), Cross (voice A to R out, voice B to L out, stereo ping-pong at different pitches)."
+    range: ["L/R", "Sum", "Cross"]
+    type: enum
+    sweet_spots:
+      stereo_ping_pong: "Cross"
+      mono_layer: "Sum"
+
+  - name: "Sample Rate"
+    description: "Buffer sample rate reduction. Lower values add characterful lo-fi grit — emulates the original Publison's digital artifacts."
+    range: [1, 44100]
+    unit: "Hz"
+    type: int
+    sweet_spots:
+      vintage_89: 12000
+      heavy_lofi: 4000
+
+  - name: "Vibrato LFO"
+    description: "Modulates pitch over time. Sine or square waveform; rate in Hz."
+    type: composite
+
+  - name: "Position LFO"
+    description: "Modulates the read position in the delay buffer. Seven waveforms including random. The source of the 'shuddering glitch' and 'fractured rhythm' textures Henke uses."
+    type: composite
+
+signature_techniques:
+  - name: "Shimmer on any stab"
+    description: "Put on a chord stab → Pitch A=0, Fine A=+5, Pitch B=0, Fine B=-7, Feedback both at 0.4 → instant detuned shimmer cloud that hangs after the stab."
+    aesthetic: [arpiar, microhouse, dub_techno]
+  - name: "Reverse-in on chords"
+    description: "Enable Reverse on both voices, short delay time → chord swells backwards in before the downbeat. Haunting Monolake effect."
+    aesthetic: [dub_techno, cinematic]
+  - name: "Infinite Shepard on clicks"
+    description: "Feed a single click → Feedback ~0.92, Pitch A=+12, Pitch B=0 → infinite ascending cascade. Classic Henke."
+    aesthetic: [experimental, idm]
+  - name: "Pitched ghost delay"
+    description: "Slow Position LFO with random waveform → delay buffer warps around, producing organic pitched ghosts that never repeat."
+    aesthetic: [deep_minimal, experimental]
+
+pairings:
+  - device: convolution_reverb
+    rationale: "PitchLoop89 feeding Convolution Reverb's Farfisa Spring IR = the Basic Channel / Monolake spatial chain."
+  - device: granulator_iii
+    rationale: "Layer after Granulator for detuned shimmer on top of grain clouds."
+  - device: utility
+    rationale: "Send a short-decay copy of the source to PitchLoop89 via a return track — leaves the original dry while the pitched tail trails."
+
+gotchas:
+  - "Feedback above 0.95 can self-oscillate into runaway loop — keep a hand on the mute"
+  - "Reverse mode introduces latency equal to the buffer length — sync-critical material needs delay compensation"
+  - "Sample Rate very low (<2000Hz) aliases heavily; character, not hi-fi"
+
+learn_more:
+  official: "https://www.ableton.com/en/packs/pitchloop89/"

package/mcp_server/atlas/enrichments/audio_effects/re_enveloper.yaml

@@ -0,0 +1,51 @@
+id: re_enveloper
+name: Re-Enveloper
+sonic_description: >
+  Multiband envelope processor with three adjustable frequency bands. Unlike
+  compression (which reduces amplitude when over threshold), Re-Enveloper
+  reshapes envelope character itself — attack, sustain, decay — independently
+  per band. The right tool for 'shorten the decay of this sustained sound so
+  it behaves like a stab' or 'expand the transient on the highs only'.
+category: dynamics
+character_tags: [multiband, envelope_shaping, transient, sculpted]
+use_cases: [transient_shape, decay_control, per_band_dynamics, micro_stab]
+genre_affinity:
+  primary: [minimal, dub_techno, electronica]
+  secondary: [all_genres]
+complexity: intermediate
+introduced_in: "10.0"
+pack: Creative Extensions
+creator: Ableton + Amazing Noises
+class_name: PluginDevice
+
+key_parameters:
+  - name: "Band Split Frequencies"
+    description: "Low/Mid and Mid/High crossover points in Hz."
+    range: [20, 20000]
+    unit: "Hz"
+    type: float
+  - name: "C/E Factor (per band)"
+    description: "Compression (positive) or Expansion (negative) factor per band."
+    range: [-5.0, 5.0]
+    type: float
+    sweet_spots:
+      subtle_expand: 1.5
+      aggressive_stab: 3.0
+      decay_tightening: -2.0
+  - name: "Attack / Release (per band)"
+    description: "Envelope-shape time constants for each band independently."
+
+signature_techniques:
+  - name: "Turn sustained chord into stab"
+    description: "Low + mid bands at -3.0 C/E (expansion toward short decay), short release → 4-bar pad becomes punchy 1/4-note stab."
+    aesthetic: [deep_minimal]
+  - name: "Expand only the snare transient"
+    description: "High band 2.5 expansion, slow release → snare crack pops out without affecting kick or toms."
+    aesthetic: [all]
+
+gotchas:
+  - "Expansion factors above 4.0 can cause clipping — compensate output gain."
+  - "Crossover bands overlap by ~6dB — not a surgical splitter."
+
+learn_more:
+  official: "https://www.ableton.com/en/packs/creative-extensions/"

package/mcp_server/atlas/enrichments/audio_effects/resonators.yaml

@@ -0,0 +1,121 @@
+id: resonators
+name: Resonators
+sonic_description: >
+  Five parallel tuned comb-filter resonators. Imposes a chord onto any
+  signal — drums become pitched, noise becomes a tone, speech becomes a
+  harmonized choir. Each of 5 resonators has its own note, gain, decay,
+  and width. Signature of Radiohead-style glitch, minimal sound design,
+  and tonal-from-atonal transformations.
+effect_type: resonator
+character_tags: [pitched, tonal, harmonizing, comb_filter, experimental]
+use_cases:
+  - pitch_atonal_percussion
+  - harmonize_noise_or_speech
+  - tonal_drone_from_any_source
+  - chord_imprint_on_drums
+  - dub_style_pitched_echo_alternative
+genre_affinity:
+  primary: [experimental, ambient, idm, dub]
+  secondary: [minimal, techno, sound_design]
+complexity: advanced
+self_contained: true
+introduced_in: "8.0"
+pack: Core Library
+
+key_parameters:
+  - name: "Mode"
+    description: "Shape of the resonator (different comb topologies for different characters)"
+    range: ["Mode I", "Mode II", "Mode III", "Mode IV", "Mode V"]
+    type: enum
+    sweet_spots:
+      standard: "Mode I"
+      metallic: "Mode III"
+      smooth: "Mode V"
+
+  - name: "Root"
+    description: "Base note for the 5 resonators"
+    range: [0, 127]
+    type: int
+    sweet_spots:
+      low_hum: 36
+      standard_bass: 48
+      mid_tone: 60
+
+  - name: "Note 1-5"
+    description: "Semitone offset from Root for each of the 5 resonators"
+    range: [-24, 24]
+    unit: "st"
+    type: int
+    sweet_spots:
+      major_chord: "[0, 4, 7, 12, 19]"
+      minor_chord: "[0, 3, 7, 12, 15]"
+      detune_unison: "[0, 0.1, -0.1, 0.2, -0.2]"
+
+  - name: "Decay 1-5"
+    description: "Per-resonator sustain time"
+    range: [0.0, 1.0]
+    type: float
+
+  - name: "Gain 1-5"
+    description: "Per-resonator level"
+    range: [-24.0, 24.0]
+    unit: "dB"
+    type: float
+
+  - name: "Input"
+    description: "Input filter — shapes what hits the resonators"
+    range: ["LP", "BP", "HP"]
+    type: enum
+
+  - name: "Width"
+    description: "Stereo spread of the 5 resonators"
+    range: [0.0, 1.0]
+    type: float
+
+  - name: "Dry/Wet"
+    description: "Mix of original vs resonated"
+    range: [0.0, 1.0]
+    type: float
+
+pairs_well_with:
+  - device: "Reverb"
+    reason: "Resonators + long reverb = infinite tonal drone from any excitation"
+  - device: "Gate"
+    reason: "Gate before Resonators controls when the chord imprint triggers"
+  - device: "Compressor"
+    reason: "After Resonators to balance the varying-level tonal output"
+  - device: "Auto Filter"
+    reason: "Filter the resonated output for evolving timbre on a static chord"
+
+starter_recipes:
+  - name: "Noise Minor Chord"
+    description: "White noise imprinted with a low minor chord — ambient drone"
+    genre: ambient
+    params:
+      "Root": 36
+      "Note 1": 0
+      "Note 2": 3
+      "Note 3": 7
+      "Note 4": 12
+      "Note 5": 15
+      "Decay 1": 0.9
+      "Dry/Wet": 1.0
+
+  - name: "Pitched Drums"
+    description: "Drums forced to a root note, chord imprint from kit"
+    genre: experimental
+    params:
+      "Root": 48
+      "Note 1": 0
+      "Note 2": 7
+      "Note 3": 12
+      "Note 4": 16
+      "Decay 1": 0.4
+      "Dry/Wet": 0.5
+
+gotchas:
+  - "Resonators forces a pitch — make sure Root matches the track's key or the chord will clash"
+  - "All 5 resonators at max Decay self-feedback — combined output can clip. Watch peak level"
+  - "Input filter affects which frequencies resonate — low-pass input preserves only low-mid resonance, HP emphasizes brightness"
+  - "Very short Decay values (<0.2) produce comb-filtered ghost tones rather than sustained pitched output"
+  - "For stringed-instrument-style resonance, try Corpus instead — Resonators is about chord imprinting"

package/mcp_server/atlas/enrichments/audio_effects/snipper.yaml

@@ -0,0 +1,53 @@
+id: snipper
+name: Snipper
+sonic_description: >
+  Audio snippet replayer with pitch modulation (Building Max Devices
+  tutorial pack). Re-plays snippets of incoming audio at modulated
+  pitches. Small tool, surprisingly aesthetic-critical for microhouse —
+  the 'replay this hat with a slightly different pitch each bar' pattern.
+category: audio_rearranger
+character_tags: [replay, pitched, micro_chop, glitch]
+use_cases: [micro_chop, pitched_replay, vocal_stutter]
+genre_affinity:
+  primary: [microhouse, deep_minimal, glitch]
+  secondary: [idm]
+complexity: intermediate
+introduced_in: "11.0"
+pack: Building Max Devices
+creator: Ableton
+class_name: PluginDevice
+
+key_parameters:
+  - name: "Snippet Length"
+    description: "Duration of the captured snippet."
+  - name: "Replay Rate"
+    description: "How often the snippet re-triggers."
+  - name: "Pitch Modulation"
+    description: "Per-replay pitch shift."
+  - name: "Randomize"
+    description: "Random variation on pitch/replay timing."
+
+signature_techniques:
+  - name: "Vocal micro-chop"
+    description: "Route vocal → Snipper → short snippet, fast replay, pitch mod → instant Akufen-adjacent micro-vocal pattern."
+    aesthetic: [microhouse]
+  - name: "Hat replay pitch drift"
+    description: "Closed hat → Snipper with tiny snippet length, pitch mod ±3 semitones, randomize on → every hat is pitched differently. Microhouse signature."
+    aesthetic: [microhouse, deep_minimal]
+
+pairs_well_with:
+  - device: "Convolution Reverb"
+    reason: "Short reverb IR tail on the snipper output blurs the micro-chop into a texture instead of pointillistic hits"
+  - device: "PitchLoop89"
+    reason: "Stack Snipper into PitchLoop89 for dual-pitch staggered micro-chops — the Henke-style signature"
+  - device: "Gate"
+    reason: "Gate after Snipper to carve silence between snippets for rhythmic precision"
+
+gotchas:
+  - "Snipper's snippet window can end up shorter than audible grain — at very short lengths it becomes comb-filter territory, not chopping"
+  - "Randomize at max with long snippets sounds chaotic rather than musical — pair random intensity with snippet length"
+  - "It's an M4L device — first-hit audio buffers aren't pre-filled. Expect silence for the first bar on a fresh load"
+  - "Not automatable from MCP beyond the top-level parameters — internal state is private to the Max patcher"
+
+learn_more:
+  pack: "Building Max Devices"

package/mcp_server/atlas/enrichments/audio_effects/spectral_blur.yaml

@@ -0,0 +1,64 @@
+id: spectral_blur
+name: Spectral Blur
+sonic_description: >
+  Spectral halo/reverb hybrid. Creates reverb-like textures by blurring
+  user-defined frequency ranges into dense clouds of delayed/smeared
+  harmonic content. Not a real reverb — no IR — but the result behaves
+  like one, with more control over which frequency ranges get haloed.
+  Freeze button holds the current spectral content indefinitely. The
+  tool for ethereal pads from sparse sources and alien textures that
+  don't sound like rooms.
+category: spectral_fx
+character_tags: [spectral, halo, reverb_like, ethereal, frozen, frequency_selective]
+use_cases: [halo_pad, ghost_atmosphere, frozen_texture, spectral_bed]
+genre_affinity:
+  primary: [ambient, deep_minimal, experimental, drone]
+  secondary: [dub_techno, cinematic]
+complexity: intermediate
+introduced_in: "10.0"
+pack: Creative Extensions
+creator: Ableton + Amazing Noises
+class_name: PluginDevice
+
+key_parameters:
+  - name: "Frequency Range"
+    description: "Low and high cutoff of the blurred band. Narrow ranges produce pitched halos; wide ranges produce reverb-like wash."
+  - name: "Halo (Grain Length)"
+    description: "How long each spectral grain lingers. Short = shimmer; long = sustained bed."
+    range: [50, 5000]
+    unit: "ms"
+    type: float
+    sweet_spots:
+      subtle_shimmer: 200
+      sustained_bed: 2000
+  - name: "Residual"
+    description: "Amount of dry signal that passes through. 0 = fully wet halo, 1 = hear the source clearly."
+    range: [0.0, 1.0]
+    type: float
+  - name: "Freeze"
+    description: "Holds the current spectral content. Manual or MIDI-triggered."
+    type: boolean
+
+signature_techniques:
+  - name: "Ghost atmosphere under the kick"
+    description: "Very short source (click), narrow mid band, Halo 3000ms, Residual 0 → continuous ghost bed at -30dB."
+    aesthetic: [deep_minimal, ambient]
+  - name: "Freeze-and-move"
+    description: "Play a chord → hit Freeze → automate frequency-range low/high up the spectrum → harmonic cloud morphs in pitch-space."
+    aesthetic: [experimental, drone]
+  - name: "Reverse reverb alternative"
+    description: "Apply to a short stab with long Halo → get reverse-reverb-like build-in without needing to flip the audio."
+    aesthetic: [cinematic, deep_minimal]
+
+pairings:
+  - device: pitchloop89
+    rationale: "PitchLoop89 feeding Spectral Blur = Basic Channel / Monolake ethereal space"
+  - device: convolution_reverb
+    rationale: "Spectral Blur before Conv Rev compounds the halo with real-space acoustics"
+
+gotchas:
+  - "Halo times above 3000ms accumulate CPU — freeze the track after print"
+  - "Narrow frequency ranges at high levels self-oscillate — keep Residual > 0 or compress"
+
+learn_more:
+  official: "https://www.ableton.com/en/packs/creative-extensions/"

package/mcp_server/atlas/enrichments/audio_effects/spectrum.yaml

@@ -0,0 +1,61 @@
+id: spectrum
+name: Spectrum
+sonic_description: >
+  Real-time FFT spectrum analyzer — shows frequency content vs amplitude
+  over time. Diagnostic only, no audio processing. Essential for mixing
+  decisions: frequency masking, bass extension, harmonic content, sibilance.
+  LivePilot's analyzer bridge captures a similar but more structured
+  readout via the M4L Analyzer device — use Spectrum for visual cross-check.
+effect_type: analyzer
+character_tags: [diagnostic, transparent, measurement, mix_tool]
+use_cases:
+  - identifying_frequency_masking
+  - checking_bass_extension
+  - spotting_harsh_harmonics
+  - mastering_reference_checking
+  - harmonic_analysis_of_a_synth_patch
+genre_affinity:
+  primary: [all]
+  secondary: []
+complexity: beginner
+self_contained: true
+introduced_in: "8.0"
+pack: Core Library
+
+key_parameters:
+  - name: "Block Size"
+    description: "FFT window — bigger = better frequency resolution, worse time resolution"
+    range: [64, 16384]
+    type: int
+    sweet_spots:
+      transient_focus: 512
+      balanced: 2048
+      mastering_detail: 8192
+
+  - name: "Range (Top)"
+    description: "Upper edge of displayed dB range"
+    range: [-60.0, 0.0]
+    unit: "dB"
+    type: float
+
+  - name: "Range (Bottom)"
+    description: "Lower edge of displayed dB range"
+    range: [-160.0, -60.0]
+    unit: "dB"
+    type: float
+
+  - name: "Channel"
+    description: "Display mode — L only, R only, L+R separate, or Mid/Side"
+    range: ["L", "R", "L+R", "Mid/Side"]
+    type: enum
+
+pairs_well_with:
+  - device: "EQ Eight"
+    reason: "EQ Eight has a built-in spectrum — Spectrum as a second analyzer post-EQ validates your moves"
+
+gotchas:
+  - "Spectrum is DIAGNOSTIC — no processing, audio passes through. Don't use as an effect"
+  - "Block size is a time/frequency tradeoff — mastering wants 4096+, drum-punch analysis wants 512 or less"
+  - "Very high FFT sizes can stress CPU on low-end hardware — remove when mixdown is final"
+  - "Does not measure LUFS, peak, or other broadcast meters — use dedicated metering for that"
+  - "For programmatic measurement, use LivePilot's analyze_spectrum_offline / get_master_spectrum tools — Spectrum is for visual human inspection only"

package/mcp_server/atlas/enrichments/audio_effects/tuner.yaml

@@ -0,0 +1,43 @@
+id: tuner
+name: Tuner
+sonic_description: >
+  Reference chromatic tuner — shows pitch / note / cent deviation from
+  equal temperament. Sits on a guitar/bass/vocal track as a tuning aid.
+  Passes signal through unchanged. Not an effect; a diagnostic tool.
+effect_type: analyzer
+character_tags: [diagnostic, transparent, pitch_reference, measurement]
+use_cases:
+  - tuning_a_guitar_or_bass
+  - checking_pitch_of_a_vocal
+  - reference_pitch_for_microtuning_experiments
+genre_affinity:
+  primary: [all]
+  secondary: []
+complexity: beginner
+self_contained: true
+introduced_in: "11.0"
+pack: Core Library
+
+key_parameters:
+  - name: "Reference (A)"
+    description: "Tuning reference — A440 standard, or shift for non-standard tuning"
+    range: [410.0, 480.0]
+    unit: "Hz"
+    type: float
+    sweet_spots:
+      standard: 440.0
+      baroque: 415.0
+      modern_orchestra: 442.0
+
+  - name: "Transpose"
+    description: "Shift the displayed pitch — useful for transposing instruments"
+    range: [-24, 24]
+    unit: "st"
+    type: int
+
+pairs_well_with: []
+
+gotchas:
+  - "Tuner is DIAGNOSTIC — the audio passes through unchanged. Don't use as an effect"
+  - "Requires a monophonic input for accurate reading — chords can't be tuned this way"
+  - "Low notes below E1 may display unreliably — fundamental frequency detection fails on very low fundamentals"