livepilot 1.16.1 → 1.17.0

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

@@ -31,6 +31,23 @@ 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/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"

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

@@ -0,0 +1,118 @@
+id: utility
+name: Utility
+sonic_description: >
+  The universal gain / pan / width / DC-offset / mid-side / phase-invert /
+  mute-left-right toolbox. Lives everywhere in a serious mix — gain-stage
+  before a compressor, narrow stereo into mono on a sub, flip the phase on
+  a snare bottom mic, extract the sides of a stereo source for parallel
+  processing. Not an "effect" so much as surgical infrastructure.
+effect_type: utility
+character_tags: [transparent, surgical, infrastructure, mix_bus, gain_staging]
+use_cases:
+  - gain_staging_before_compression
+  - stereo_width_control
+  - mono_compatibility_check
+  - phase_inversion_on_drum_bottom_mic
+  - mid_side_separation
+  - dc_offset_removal
+  - silencing_one_channel_of_a_stereo_source
+genre_affinity:
+  primary: [all]
+  secondary: []
+complexity: beginner
+self_contained: true
+introduced_in: "1.0"
+pack: Core Library
+
+key_parameters:
+  - name: "Gain"
+    description: "Precise level adjustment — essential for gain staging"
+    range: [-35.0, 35.0]
+    unit: "dB"
+    type: float
+    sweet_spots:
+      trim: -3.0
+      boost: 3.0
+      match_source: 0.0
+
+  - name: "Width"
+    description: "Stereo field width — 0% is mono, 100% original, >100% phase-exaggerated"
+    range: [0.0, 400.0]
+    unit: "%"
+    type: float
+    sweet_spots:
+      mono: 0.0
+      narrow_bass: 30.0
+      natural: 100.0
+      wide: 140.0
+
+  - name: "Left/Right Balance"
+    description: "Pan the stereo field"
+    range: [-1.0, 1.0]
+    type: float
+
+  - name: "Phase L"
+    description: "Invert left channel phase"
+    range: [0, 1]
+    type: int
+
+  - name: "Phase R"
+    description: "Invert right channel phase"
+    range: [0, 1]
+    type: int
+
+  - name: "Mute L"
+    description: "Silence left channel only — useful for checking mono"
+    range: [0, 1]
+    type: int
+
+  - name: "Mute R"
+    description: "Silence right channel only"
+    range: [0, 1]
+    type: int
+
+  - name: "Mid/Side"
+    description: "Enable mid-side mode — Width now controls mid-vs-side balance"
+    range: [0, 1]
+    type: int
+
+  - name: "DC"
+    description: "Remove DC offset from the signal"
+    range: [0, 1]
+    type: int
+
+pairs_well_with:
+  - device: "Compressor"
+    reason: "Put a Utility before a compressor to hit the exact level the compressor expects"
+  - device: "EQ Eight"
+    reason: "Utility first for gain staging, EQ Eight for tonal shaping — the order matters"
+  - device: "Saturator"
+    reason: "Utility to trim level before saturation so you can predict the harmonic generation"
+
+starter_recipes:
+  - name: "Mono Sub Bass"
+    description: "Collapse low-end stereo for phase-coherent sub"
+    genre: techno
+    params:
+      "Width": 0.0
+
+  - name: "Phase-Invert Snare Bottom"
+    description: "Flip phase of bottom-mic'd snare against top for fatter snare"
+    genre: all
+    params:
+      "Phase L": 1
+      "Phase R": 1
+
+  - name: "Mid/Side Extract Sides"
+    description: "Get only the stereo difference for parallel processing"
+    genre: all
+    params:
+      "Mid/Side": 1
+      "Width": 100.0
+
+gotchas:
+  - "Width at 0% collapses the signal to mono — the standard move for sub-bass and kick where stereo phase issues matter"
+  - "Mid/Side mode changes what Width controls — read carefully before adjusting"
+  - "Phase invert is per-channel — inverting both L and R re-inverts to original"
+  - "Gain is post-pan — if you're trying to compensate a pan with gain, check the order"
+  - "Utility is ALWAYS at the bottom of the master chain in LivePilot setups — AFTER LivePilot_Analyzer would break analyzer readings"

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

@@ -0,0 +1,94 @@
+id: vocoder
+name: Vocoder
+sonic_description: >
+  Classic channel-vocoder — carrier signal (synth/noise) modulated by a
+  modulator signal's spectral envelope (voice/drums). Converts your voice
+  into a robot singing the synth's notes. Up to 40 bands, adjustable formant
+  shift, noise/pitch tracking modes. Essentiel for Imogen Heap / Daft Punk
+  vocal, robotic speech, and pitched noise/drum transformations.
+effect_type: vocoder
+character_tags: [vocal, robotic, synthesized, formant, classic]
+use_cases:
+  - robot_voice
+  - synth_speaks_words
+  - pitched_drum_transformation
+  - noise_to_harmonic_texture
+  - talk_box_emulation
+genre_affinity:
+  primary: [electronic, hip_hop, pop, synthwave]
+  secondary: [experimental, ambient, dub]
+complexity: intermediate
+self_contained: false
+introduced_in: "8.0"
+pack: Core Library
+
+key_parameters:
+  - name: "Bands"
+    description: "Number of analysis/synthesis bands — more bands = more speech-intelligible"
+    range: [4, 40]
+    type: int
+    sweet_spots:
+      abstract: 8
+      classic_robot: 16
+      speech_clarity: 32
+
+  - name: "Carrier Source"
+    description: "Where the synthesizing signal comes from"
+    range: ["Noise", "External", "Modulator"]
+    type: enum
+
+  - name: "Formant"
+    description: "Shift the formant frequencies up or down"
+    range: [-24, 24]
+    unit: "st"
+    type: int
+    sweet_spots:
+      deeper: -6
+      original: 0
+      chipmunk: 8
+
+  - name: "Depth"
+    description: "Intensity of the vocoding effect"
+    range: [0.0, 1.0]
+    type: float
+
+  - name: "Gate"
+    description: "Silence vocoder output below a threshold — reduces background hiss"
+    range: [-80.0, 0.0]
+    unit: "dB"
+    type: float
+
+pairs_well_with:
+  - device: "Reverb"
+    reason: "Long reverb on vocoded voice creates ethereal robot atmospheres"
+  - device: "Chorus-Ensemble"
+    reason: "Thickens the synthetic voice"
+  - device: "EQ Eight"
+    reason: "Post-vocoder high-pass at 200 Hz cleans up the rumble"
+  - device: "Utility"
+    reason: "Width control for stereo vocoded voices"
+
+starter_recipes:
+  - name: "Classic Robot Voice"
+    description: "Voice modulator, saw-wave carrier"
+    genre: electronic
+    params:
+      "Bands": 16
+      "Carrier Source": "External"
+      "Formant": 0
+      "Depth": 1.0
+
+  - name: "Noise-Carried Drums"
+    description: "Drums as modulator, internal noise carrier — whispering pitched drums"
+    genre: experimental
+    params:
+      "Bands": 12
+      "Carrier Source": "Noise"
+      "Depth": 1.0
+
+gotchas:
+  - "The carrier signal must be harmonically rich (saw, square, noise) — a sine wave carrier produces no vocoded sound"
+  - "External carrier mode requires audio-from routing on the track — most people miss this on first try"
+  - "Very low Bands count (4-8) is abstract, not speech-intelligible — pick Bands based on whether you want words understood"
+  - "Formant shift is in semitones but changes character, not pitch — useful for gender/age effects"
+  - "Gate is essential — without it, even silence outputs noise"

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

@@ -154,6 +154,17 @@ key_parameters:
       moderate: 0.35
       extreme: 0.8
 
+signature_techniques:
+  - name: "Reese bass (drum & bass)"
+    description: "Two detuned saws at different octaves, LP24 filter with slight resonance, no LFO — let the beat frequency between the oscillators do the modulation."
+    aesthetic: ['dnb', 'neurofunk', 'jungle']
+  - name: "Hawtin subtractive pad"
+    description: "Single saw, slow filter sweep from dark to bright across 32 bars, filter env amount slight negative so attack is dark — the pad evolves by unfolding, not by adding."
+    aesthetic: ['minimal_techno', 'deep_minimal']
+  - name: "303 acid bass"
+    description: "Osc1 saw, octave down, LP24 with high resonance (0.8+), env amount 0.9, amp decay short. Use Filter1 Freq + Res as performance controls — the acid line IS the filter gesture."
+    aesthetic: ['acid_house', 'acid_techno']
+
 pairs_well_with:
   - device: "Auto Filter"
     reason: "Adds rhythmic filter movement and envelope-following beyond the built-in filters"

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

@@ -134,6 +134,17 @@ key_parameters:
       medium: 80.0
       slow_glide: 200.0
 
+signature_techniques:
+  - name: "808 sub replacement"
+    description: "Sine+triangle, fundamental C1, amp envelope long decay, subtle pitch envelope down 1 semitone over 100ms. Cleaner than sampled 808s, and tunable in-key."
+    aesthetic: ['trap', 'hip_hop', 'dubstep']
+  - name: "Reese-style bass"
+    description: "Two detuned oscillators octave apart, LP filter resonant, saturation on output. The sum-of-beats IS the movement — no LFO needed."
+    aesthetic: ['dnb', 'jungle', 'bass_music']
+  - name: "Dub sub-bass"
+    description: "Pure sine at fundamental, very long release, no transient. The bass is felt not heard — pair with a short percussive layer (click at 2-5kHz) for attack."
+    aesthetic: ['dub', 'dub_techno', 'deep_minimal']
+
 pairs_well_with:
   - device: "EQ Eight"
     reason: "Surgical low-end shaping — roll off sub-rumble and shape the bass presence"

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

@@ -32,6 +32,44 @@ signature_techniques:
   - name: "Arpiar bell through Convolution Reverb"
     description: "Short decay, subtle modulator depth, single hit per bar, through a long cathedral IR → the thin bell stab that recurs in Arpiar tracks."
     aesthetic: [arpiar, deep_minimal]
+  - name: "Inharmonic bell struck through PitchLoop89"
+    description: "Modulator ratio around 1.41 (irrational), short decay, through dual-detune PitchLoop89 (+5 / -7 cents) → phased bell cluster."
+    aesthetic: [arpiar, ambient]
+
+pairs_well_with:
+  - device: "Convolution Reverb"
+    reason: "Essential — Bell Tower raw is too dry. Long cathedral or hall IR transforms it into the signature bell-stab"
+  - device: "PitchLoop89"
+    reason: "Dual-detune smears the bell transient into a phased cluster — Henke bell territory"
+  - device: "Utility"
+    reason: "Width control essential — Bell Tower is mono, Utility width at 140% gives headphone-scale spatialization"
+  - device: "Auto Filter"
+    reason: "Modulate cutoff slowly for evolving bell texture — 30-second LFO period"
+
+starter_recipes:
+  - name: "Arpiar Bell Stab"
+    description: "Single bell hit per bar, thin, through cathedral reverb"
+    genre: deep_minimal
+    params:
+      "Carrier Freq": 660.0
+      "Modulator Ratio": 1.41
+      "Modulator Depth": 0.35
+      "Decay": 0.3
+
+  - name: "Ambient Bell Cloud"
+    description: "Sustained bells through reverb — pad-adjacent atmosphere"
+    genre: ambient
+    params:
+      "Carrier Freq": 440.0
+      "Modulator Ratio": 3.0
+      "Modulator Depth": 0.2
+      "Decay": 1.0
+
+gotchas:
+  - "Modulator Ratio at integer values (2, 3, 4) gives pluck-like tones; irrational values (1.41, 2.71) give metallic bells. Small distinctions, big character shifts"
+  - "Modulator Depth at max is harsh — the FM index becomes over-rich. Stay under 0.7 unless you want noise-bell"
+  - "Bell Tower is monophonic by default — for chords, use multiple instances or layer with another FM instrument"
+  - "It's an M4L tutorial device — not as CPU-optimized as Operator in FM mode. Consider Operator for production final bounces"
 
 learn_more:
   pack: "Building Max Devices"

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

@@ -96,6 +96,17 @@ key_parameters:
       fifth: 7.0
       octave: 12.0
 
+signature_techniques:
+  - name: "Mallet percussion"
+    description: "Struck resonator, material=wood, partials=5-8, decay short. Marimba/vibraphone without sampling — the physical model responds to velocity like the real instrument."
+    aesthetic: ['ambient', 'cinematic', 'experimental']
+  - name: "Inharmonic bell drone"
+    description: "Struck bar, inharmonicity high, decay long, LFO modulating partial levels. The bell never settles — each strike reveals a different harmonic slice."
+    aesthetic: ['experimental', 'ambient', 'microhouse']
+  - name: "Struck prepared string"
+    description: "Bowed string exciter with mute on, low tension, short decay — prepared-piano territory. Pair with Convolution Reverb for Cage/Feldman atmosphere."
+    aesthetic: ['experimental', 'classical', 'cinematic']
+
 pairs_well_with:
   - device: "Reverb"
     reason: "Physical modeling sounds bloom in reverberant spaces — adds room context"

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

@@ -104,6 +104,17 @@ key_parameters:
       natural: 250.0
       ambient: 1500.0
 
+signature_techniques:
+  - name: "Neo-soul Rhodes-adjacent keys"
+    description: "Sine+triangle mix, short-attack amp, dark filter, gentle chorus send. Not trying to emulate Rhodes — trying to SIT where Rhodes sits in the mix."
+    aesthetic: ['neo_soul', 'r_and_b', 'lo_fi']
+  - name: "Minimal-techno bass anchor"
+    description: "Sine sub at C1, triangle octave up blended -6 dB, LP filter fixed open, no modulation. The bass doesn't move — the filter on the REVERB send does."
+    aesthetic: ['minimal_techno', 'deep_minimal', 'dub_techno']
+  - name: "Warm synthwave pad"
+    description: "Saw+triangle, detune 0.1, slow filter envelope, long amp release, subtle vibrato at 5 Hz. 80s pad territory without the period-drama cliché."
+    aesthetic: ['synthwave', '80s', 'vaporwave']
+
 pairs_well_with:
   - device: "Reverb"
     reason: "The organic drift character blooms beautifully in reverb space"