livepilot 1.9.23 → 1.10.0

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

@@ -0,0 +1,131 @@
+id: resonators
+name: Resonators
+sonic_description: >
+  Five parallel tuned resonators, each individually tunable by note, fine pitch,
+  gain, and decay time. Creates pitched resonances from incoming audio, turning
+  noise, drums, or any sound into tuned harmonic content. Can produce drone-like
+  sustains, harmonic series, and chord-based resonant effects.
+effect_type: resonator
+character_tags: [tuned, harmonic, resonant, drone, pitched]
+use_cases: [harmonic_resonance, drone_generator, pitched_noise, chord_resonance, creative_tuning]
+genre_affinity:
+  primary: [ambient, experimental, drone]
+  secondary: [techno, idm, sound_design, cinematic]
+complexity: intermediate
+introduced_in: "1.0"
+
+key_parameters:
+  - name: "Mode"
+    description: "Overall resonance character — affects overtone structure"
+    range: ["A", "B"]
+    type: enum
+
+  - name: "Note (I-V)"
+    description: "Pitch of each resonator as a MIDI note — sets the fundamental frequency"
+    range: ["C-2", "G8"]
+    type: note
+    sweet_spots:
+      sub_bass: "C2"
+      middle: "C4"
+      high: "C6"
+
+  - name: "Fine (I-V)"
+    description: "Fine tuning in cents for each resonator"
+    range: [-50.0, 50.0]
+    unit: "cents"
+    type: float
+
+  - name: "Gain (I-V)"
+    description: "Volume of each resonator — balance the harmonic blend"
+    range: [-30.0, 0.0]
+    unit: "dB"
+    type: float
+    sweet_spots:
+      soft: -20.0
+      medium: -10.0
+      full: 0.0
+
+  - name: "Decay (I-V)"
+    description: "How long each resonator sustains after excitation"
+    range: [0.0, 20.0]
+    unit: "s"
+    type: float
+    sweet_spots:
+      tight: 0.5
+      medium: 2.0
+      long: 8.0
+      drone: 20.0
+
+  - name: "Brightness"
+    description: "High-frequency content of all resonators"
+    range: [0.0, 1.0]
+    type: float
+
+  - name: "Color"
+    description: "Tonal color of the resonance — interacts with overtone structure"
+    range: [0.0, 1.0]
+    type: float
+
+  - name: "Dry/Wet"
+    description: "Mix between dry signal and resonator output"
+    range: [0, 100]
+    unit: "%"
+    type: int
+
+  - name: "Width"
+    description: "Stereo spread of the resonators"
+    range: [0.0, 1.0]
+    type: float
+
+pairs_well_with:
+  - device: "Drum Rack"
+    reason: "Drum hits excite resonators to create pitched percussion"
+  - device: "Reverb"
+    reason: "Spatializes resonator output for immersive drone textures"
+  - device: "Auto Filter"
+    reason: "Filter sweeps over resonator harmonics for movement"
+  - device: "Compressor"
+    reason: "Controls resonance dynamics and prevents buildup"
+  - device: "Utility"
+    reason: "Gain staging to manage resonator output levels"
+
+starter_recipes:
+  - name: "Harmonic Series"
+    description: "Tune five resonators to the harmonic series (fundamental, octave, fifth, octave, major third)"
+    genre: ambient
+    params:
+      "Decay (I-V)": 5.0
+      "Brightness": 0.5
+      "Dry/Wet": 50
+
+  - name: "Chord Resonance"
+    description: "Tune resonators to a chord — incoming audio excites the chord"
+    genre: experimental
+    params:
+      "Decay (I-V)": 3.0
+      "Brightness": 0.6
+      "Dry/Wet": 60
+
+  - name: "Drone Generator"
+    description: "Very long decay resonators fed by any audio — creates sustained drones"
+    genre: drone
+    params:
+      "Decay (I-V)": 20.0
+      "Brightness": 0.3
+      "Dry/Wet": 80
+
+  - name: "Percussive Resonance"
+    description: "Short decay resonators tuned to a scale for melodic percussion"
+    genre: techno
+    params:
+      "Decay (I-V)": 0.5
+      "Brightness": 0.7
+      "Dry/Wet": 40
+
+gotchas:
+  - "Each resonator has its own Note, Fine, Gain, and Decay — set all five independently"
+  - "Very long Decay values with loud input can cause resonance buildup and volume spikes"
+  - "Resonators respond to ANY input — even silence with noise floor can excite long-decay resonators"
+  - "The five resonators are parallel, not serial — they all process the same input simultaneously"
+  - "Low Note values (bass) with long Decay can cause low-frequency buildup — use with Utility for gain control"
+  - "Width spreads the five resonators across the stereo field — 0 is mono, 1 is full spread"

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

@@ -0,0 +1,63 @@
+id: spectrum
+name: Spectrum
+sonic_description: >
+  Real-time frequency spectrum analyzer that displays the spectral content of audio
+  passing through it. Purely visual — it does not alter the audio signal. Essential
+  for identifying frequency buildups, monitoring bass content, and making informed
+  EQ decisions.
+effect_type: analyzer
+character_tags: [analysis, visual, diagnostic, frequency, metering]
+use_cases: [frequency_analysis, mix_monitoring, eq_guidance, bass_monitoring, spectral_comparison]
+genre_affinity:
+  primary: [all]
+  secondary: []
+complexity: beginner
+introduced_in: "1.0"
+
+key_parameters:
+  - name: "Block Size"
+    description: "FFT analysis window size — larger = more frequency resolution, less time resolution"
+    range: [256, 512, 1024, 2048, 4096, 8192, 16384]
+    type: enum
+    sweet_spots:
+      fast_response: 1024
+      balanced: 4096
+      high_resolution: 8192
+
+  - name: "Channel"
+    description: "Which channel to analyze"
+    range: ["L/R", "Left", "Right", "Mid", "Side"]
+    type: enum
+
+  - name: "Range"
+    description: "Display range in dB"
+    range: [30, 60, 80]
+    unit: "dB"
+    type: enum
+
+  - name: "Refresh Rate"
+    description: "How frequently the display updates"
+    range: ["Slow", "Mid", "Fast"]
+    type: enum
+
+  - name: "Average"
+    description: "Averaging mode — smooths the display for easier reading"
+    range: ["Off", "Slow", "Mid", "Fast"]
+    type: enum
+
+pairs_well_with:
+  - device: "EQ Eight"
+    reason: "Use Spectrum to identify problems, EQ Eight to fix them"
+  - device: "Utility"
+    reason: "Solo channels with Utility, analyze with Spectrum"
+  - device: "Compressor"
+    reason: "Monitor spectral changes caused by compression"
+
+starter_recipes: []
+
+gotchas:
+  - "Spectrum is purely visual — it passes audio through unchanged"
+  - "Larger Block Size shows more frequency detail but reacts more slowly to transients"
+  - "Place at the END of the device chain to see the final processed output"
+  - "Mid/Side mode is invaluable for checking stereo width distribution across frequencies"
+  - "CPU usage increases with Block Size — use 4096 for normal work, 8192+ only when needed"

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

@@ -0,0 +1,51 @@
+id: tuner
+name: Tuner
+sonic_description: >
+  Chromatic tuner that detects the pitch of incoming audio and displays deviation
+  from the nearest note. Passes audio through unchanged. Essential for tuning
+  instruments before recording or checking pitch accuracy of audio material.
+effect_type: analyzer
+character_tags: [tuning, pitch_detection, utility, diagnostic]
+use_cases: [instrument_tuning, pitch_checking, intonation_verification]
+genre_affinity:
+  primary: [all]
+  secondary: []
+complexity: beginner
+introduced_in: "8.0"
+
+key_parameters:
+  - name: "Reference Pitch"
+    description: "Reference frequency for A4 — standard is 440Hz, adjustable for alternate tunings"
+    range: [410.0, 480.0]
+    unit: "Hz"
+    type: float
+    sweet_spots:
+      standard: 440.0
+      baroque: 415.0
+      concert_sharp: 442.0
+      orchestral: 443.0
+
+  - name: "Note Display"
+    description: "Shows the detected note name and octave"
+    type: display
+
+  - name: "Cents Display"
+    description: "Shows deviation from the nearest note in cents"
+    range: [-50, 50]
+    unit: "cents"
+    type: display
+
+pairs_well_with:
+  - device: "Utility"
+    reason: "Use Utility to isolate left or right channel before tuning"
+  - device: "EQ Eight"
+    reason: "High-pass filter to remove rumble that can confuse pitch detection"
+
+starter_recipes: []
+
+gotchas:
+  - "Tuner is purely visual — it passes audio through unchanged"
+  - "Works best with monophonic input — polyphonic audio (chords) will confuse the detection"
+  - "Place FIRST in the device chain before any pitch-altering effects"
+  - "Very low or very high frequencies may not detect reliably"
+  - "Reference pitch changes affect the displayed note name, not the audio itself"

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

@@ -0,0 +1,136 @@
+id: utility
+name: Utility
+sonic_description: >
+  Essential mixing and signal management tool providing gain adjustment, stereo width
+  control, channel mode selection, bass mono filtering, and DC offset correction.
+  The Swiss army knife of Ableton mixing — used on nearly every track for gain staging,
+  mono compatibility checks, and stereo field management.
+effect_type: utility
+character_tags: [mixing, gain, stereo, mono, essential]
+use_cases: [gain_staging, mono_check, stereo_width, bass_mono, channel_swap, dc_offset]
+genre_affinity:
+  primary: [all]
+  secondary: []
+complexity: beginner
+introduced_in: "1.0"
+
+key_parameters:
+  - name: "Gain"
+    description: "Volume adjustment in dB — primary gain staging tool"
+    range: [-35.0, 35.0]
+    unit: "dB"
+    type: float
+    sweet_spots:
+      cut_6: -6.0
+      unity: 0.0
+      boost_3: 3.0
+
+  - name: "Channel Mode"
+    description: "Channel routing and monitoring mode"
+    range: ["Stereo", "Left", "Right", "Swap", "Mono"]
+    type: enum
+    sweet_spots:
+      normal: "Stereo"
+      mono_check: "Mono"
+      side_isolation: "Right"
+
+  - name: "Width"
+    description: "Stereo width control — 0% is mono, 100% is normal, 400% is super-wide"
+    range: [0, 400]
+    unit: "%"
+    type: int
+    sweet_spots:
+      mono: 0
+      normal: 100
+      wide: 150
+      super_wide: 200
+
+  - name: "Bass Mono"
+    description: "Frequency below which the signal is summed to mono — essential for club mixes"
+    range: [50, 500]
+    unit: "Hz"
+    type: int
+    sweet_spots:
+      sub_only: 80
+      bass_region: 120
+      low_mid: 200
+
+  - name: "Bass Mono On/Off"
+    description: "Enables or disables bass mono filtering"
+    range: ["On", "Off"]
+    type: enum
+
+  - name: "Phono Filter"
+    description: "Applies high-pass and low-pass filtering for DJ-style frequency isolation"
+    range: ["Off", "On"]
+    type: enum
+
+  - name: "DC Offset"
+    description: "Removes DC offset from the signal — fixes asymmetric waveforms"
+    range: ["On", "Off"]
+    type: enum
+
+  - name: "Phase Invert (L)"
+    description: "Inverts the phase of the left channel"
+    range: ["On", "Off"]
+    type: enum
+
+  - name: "Phase Invert (R)"
+    description: "Inverts the phase of the right channel"
+    range: ["On", "Off"]
+    type: enum
+
+  - name: "Mute"
+    description: "Silences the output completely"
+    range: ["On", "Off"]
+    type: enum
+
+pairs_well_with:
+  - device: "EQ Eight"
+    reason: "Gain stage before EQ for optimal headroom management"
+  - device: "Compressor"
+    reason: "Set input level before compression for consistent threshold behavior"
+  - device: "Spectrum"
+    reason: "Use Utility to solo channels, then Spectrum to analyze"
+  - device: "Limiter"
+    reason: "Gain stage into limiter for predictable limiting behavior"
+
+starter_recipes:
+  - name: "Mono Bass Below 120Hz"
+    description: "Sum everything below 120Hz to mono for club-ready low end"
+    genre: edm
+    params:
+      "Bass Mono On/Off": "On"
+      "Bass Mono": 120
+
+  - name: "Gain Staging (-6dB)"
+    description: "Standard gain reduction for headroom management"
+    genre: all
+    params:
+      "Gain": -6.0
+
+  - name: "Stereo to Mono Check"
+    description: "Collapse to mono to check mix compatibility on mono systems"
+    genre: all
+    params:
+      "Channel Mode": "Mono"
+
+  - name: "Wide Stereo"
+    description: "Widen the stereo image for pads, ambient, or background elements"
+    genre: ambient
+    params:
+      "Width": 150
+
+  - name: "Phase Fix"
+    description: "Invert one channel's phase to correct phase cancellation issues"
+    genre: all
+    params:
+      "Phase Invert (L)": "On"
+
+gotchas:
+  - "Gain goes up to +35dB — extreme values can cause clipping downstream"
+  - "Width at 0% is not silence, it is mono — the mid signal is preserved"
+  - "Width above 100% boosts the side signal — can introduce phase issues on mono playback"
+  - "Bass Mono frequency is a crossover point, not a hard cutoff — there is a transition slope"
+  - "Place Utility BEFORE effects when gain staging, AFTER effects when checking output level"
+  - "Mute on Utility silences the track more cleanly than track mute — no tail from effects"

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

@@ -0,0 +1,160 @@
+id: vocoder
+name: Vocoder
+sonic_description: >
+  Classic analysis-synthesis vocoder that imposes the spectral envelope of one sound
+  (the modulator/carrier) onto another. Splits audio into frequency bands and uses
+  the amplitude envelope of the modulator to shape the carrier signal. Creates iconic
+  robot voice effects, talking instruments, and spectral transfer textures.
+effect_type: spectral
+character_tags: [vocoder, spectral, robotic, vocal, synthesis]
+use_cases: [robot_voice, talking_synth, spectral_transfer, vocal_processing, creative_filtering]
+genre_affinity:
+  primary: [edm, synthwave, electro]
+  secondary: [pop, funk, experimental, hip_hop]
+complexity: advanced
+introduced_in: "8.0"
+
+key_parameters:
+  - name: "Bands"
+    description: "Number of frequency analysis/synthesis bands — more = higher spectral resolution"
+    range: [4, 40]
+    type: int
+    sweet_spots:
+      lo_fi: 8
+      standard: 20
+      high_res: 40
+
+  - name: "Bandwidth"
+    description: "Width of each frequency band — affects spectral smearing"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      narrow: 0.3
+      normal: 0.6
+      wide: 0.9
+
+  - name: "Formant Shift"
+    description: "Shifts the spectral envelope up or down — changes perceived vowel character"
+    range: [-1.0, 1.0]
+    type: float
+    sweet_spots:
+      deeper: -0.5
+      natural: 0.0
+      higher: 0.5
+
+  - name: "Depth"
+    description: "How strongly the modulator's envelope shapes the carrier"
+    range: [0.0, 1.0]
+    type: float
+    sweet_spots:
+      subtle: 0.3
+      normal: 0.7
+      extreme: 1.0
+
+  - name: "Attack"
+    description: "How quickly the vocoder responds to changes in the modulator"
+    range: [0.1, 500.0]
+    unit: "ms"
+    type: float
+    sweet_spots:
+      fast: 1.0
+      medium: 10.0
+      slow: 100.0
+
+  - name: "Release"
+    description: "How quickly the vocoder releases after the modulator drops"
+    range: [0.1, 500.0]
+    unit: "ms"
+    type: float
+    sweet_spots:
+      fast: 5.0
+      medium: 30.0
+      slow: 200.0
+
+  - name: "Carrier"
+    description: "Source for the carrier signal — what gets shaped by the modulator"
+    range: ["External", "Noise", "Pitch Track", "Modulator"]
+    type: enum
+    sweet_spots:
+      classic: "External"
+      self_vocoder: "Noise"
+      monophonic: "Pitch Track"
+
+  - name: "Gate"
+    description: "Threshold below which bands are silenced — cleans up noise"
+    range: [-80.0, 0.0]
+    unit: "dB"
+    type: float
+
+  - name: "Level"
+    description: "Overall output level of the vocoder"
+    range: [-30.0, 30.0]
+    unit: "dB"
+    type: float
+
+  - name: "Dry/Wet"
+    description: "Mix between dry input and vocoder output"
+    range: [0, 100]
+    unit: "%"
+    type: int
+
+pairs_well_with:
+  - device: "Wavetable"
+    reason: "Rich carrier signal with evolving harmonics for detailed vocoding"
+  - device: "Analog"
+    reason: "Classic synth carrier for retro vocoder sounds"
+  - device: "Reverb"
+    reason: "Spatializes vocoder output for cinematic vocal processing"
+  - device: "Compressor"
+    reason: "Evens out the dynamic range of vocoder output"
+  - device: "EQ Eight"
+    reason: "Shapes the spectral balance after vocoding"
+  - device: "Chorus-Ensemble"
+    reason: "Thickens vocoder output for wider, richer vocal effects"
+
+starter_recipes:
+  - name: "Classic Vocoder"
+    description: "Traditional robot voice — send voice to modulator, synth pad to carrier"
+    genre: electro
+    params:
+      "Bands": 20
+      "Bandwidth": 0.6
+      "Depth": 0.8
+      "Carrier": "External"
+      "Attack": 5.0
+      "Release": 30.0
+      "Dry/Wet": 100
+
+  - name: "Robot Voice"
+    description: "Heavily processed robotic vocal effect with noise carrier"
+    genre: edm
+    params:
+      "Bands": 40
+      "Bandwidth": 0.4
+      "Depth": 1.0
+      "Carrier": "Noise"
+      "Attack": 1.0
+      "Release": 10.0
+      "Formant Shift": 0.0
+      "Dry/Wet": 100
+
+  - name: "Spectral Transfer"
+    description: "Subtle spectral imprint of one sound onto another — creative coloring"
+    genre: experimental
+    params:
+      "Bands": 30
+      "Bandwidth": 0.8
+      "Depth": 0.5
+      "Carrier": "External"
+      "Attack": 10.0
+      "Release": 50.0
+      "Dry/Wet": 60
+
+gotchas:
+  - "External carrier mode requires routing a sidechain input — the carrier audio must come from another track"
+  - "Noise carrier mode does not need external routing — it uses internal noise as the carrier"
+  - "More Bands = higher spectral resolution but more CPU and potential for artifacts"
+  - "Formant Shift changes perceived vowels — positive sounds smaller/higher, negative sounds larger/deeper"
+  - "Attack and Release values affect intelligibility — too slow loses consonants, too fast sounds glitchy"
+  - "Gate threshold helps clean up background noise between phrases — set just above the noise floor"
+  - "Pitch Track carrier mode works best with monophonic input and may track inaccurately on chords"