livepilot 1.10.7 → 1.10.8

package/livepilot/skills/livepilot-core/references/device-knowledge/instruments-synths.md

@@ -1,243 +0,0 @@
-# Synthesizer Instruments — Deep Parameter Knowledge
-
-## Wavetable
-
-Wavetable is Live's most versatile synth. Two oscillators scan through wavetable positions, each with independent effects, filtered through two analog-modeled filters, modulated by three envelopes, two LFOs, and MIDI sources.
-
-### Core Sound Design Parameters
-
-**Osc Position (Osc 1 Pos / Osc 2 Pos):** The most important parameter. Sweeping through the wavetable creates timbral evolution — this IS the sound design. Automate this with a slow LFO (0.05-0.3 Hz) for evolving pads. For aggressive sounds, use fast LFO (2-8 Hz) with high depth.
-
-**Osc Effect 1 / Effect 2:** These transform the wavetable in real-time:
-- **FM (Frequency Modulation):** Adds harmonics and metallic overtones. Low values (5-15%) add subtle complexity. High values (50%+) create aggressive, digital textures. Modulate with an envelope for plucky FM bass.
-- **Classic:** Phase distortion — fattens the sound without adding harsh harmonics. Good for warm pads (10-30%).
-- **Modern:** Waveshaping distortion — more aggressive than Classic. Good for leads and bass (20-50%).
-- **Sync:** Hard sync effect — creates screaming, tearing overtones when swept. Classic for aggressive leads.
-
-**Filter 1 Freq / Filter 2 Freq:** Lowpass is the default. Key insight: use Filter 1 as lowpass and Filter 2 as highpass simultaneously (parallel routing) for bandpass-like resonant sounds. Or use split mode to send each oscillator through its own filter.
-
-**Filter Circuit types:** Each emulates specific analog hardware:
-- **Clean:** Transparent, precise. Good for surgical work.
-- **OSR:** Emulates an MS-20 style filter — aggressive, screamy when resonance is high. Great for acid-style sounds.
-- **MS2:** Another MS-20 variant, slightly different character.
-- **SMP:** Sallen-Key topology — warm, rounded. Classic for pads.
-- **PRD:** Ladder filter emulation — creamy, musical. Classic for bass.
-
-**Unison modes:** Six types, each dramatically different:
-- **Classic:** Standard detuned voices — instant width and fatness.
-- **Shimmer:** Subtle pitch randomization — ethereal, glassy quality.
-- **Noise:** Adds noise to each voice — gritty, textured.
-- **Phase Sync:** Voices sync phases — hollow, metallic.
-- **Position Spread:** Each voice reads a different wavetable position — creates a choir-like spread. VERY powerful for evolving textures.
-- **Random:** Each note has slightly different characteristics — organic, alive.
-
-### Creative Applications
-
-**Evolving dub pad (Villalobos style):**
-- Osc 1: "Basic Shapes" wavetable, Position 25%, Effect 1 = Classic at 15%
-- Osc 2: "Vintage" wavetable, Position 60%, Effect 1 = FM at 8%
-- Filter 1: Lowpass, Freq 35-45%, Res 15-25%, Circuit = SMP
-- LFO 1 → Osc 1 Pos at 20%, Rate 0.15 Hz (breathing wavetable)
-- LFO 2 → Filter 1 Freq at 10%, Rate 0.08 Hz (filter drift)
-- Unison: Position Spread, Amount 30-40%
-- Env 1 attack: 500ms-2s for slow pad entrance
-
-**SOPHIE-style metallic bass:**
-- Osc 1: "Digital" wavetable, Position 80%+, Effect 1 = Sync at 70%
-- Filter 1: Lowpass, Freq 55%, Res 70%+, Circuit = OSR
-- Short attack, medium decay, low sustain — plucky character
-- Pitch envelope: +12 to +24 semitones, 30-60ms decay — the "zap"
-- Post-processing: Saturator (Sinoid Fold at 60%) → Erosion (Wide Noise)
-
-**Aphex Twin glitch texture:**
-- Osc 1: "Noise" wavetable category, random position
-- Effect 1 = FM at 40-60%, modulated by Env 2 with fast decay
-- Filter: Bandpass, high resonance (70%+), freq modulated by fast LFO (4-12 Hz)
-- Very short notes (32nd, 64th) with random velocity
-- Unison: Noise mode, Amount 50%+
-
----
-
-## Drift
-
-Drift is designed for organic, analog-sounding synthesis. Its standout feature is the **Drift** parameter — built-in oscillator instability that adds analog warmth automatically. Two oscillators, one noise generator, one filter, one LFO, one cyclic envelope, two standard envelopes.
-
-### Core Sound Design Parameters
-
-**Drift (0-100%):** The signature parameter. At 0% it's perfectly digital. At 25-35% it sounds like a well-maintained analog synth. At 50-70% it sounds like a temperamental vintage unit. At 100% it's beautifully unstable — each note is slightly different. For minimal techno, 35-55% is the sweet spot.
-
-**Osc 1 Wave:** Sine, Triangle, Saw, Square, Pulse, PWM (pulse width modulation), Noise. The Saw and Pulse waves are the bread and butter. PWM with slow shape modulation creates classic analog pad movement.
-
-**Osc 1 Shape (0-100%):** Morphs the wave shape continuously. For Saw, it adds even harmonics (warmer). For Pulse, it changes pulse width. Automate this with the cyclic envelope for timbral evolution.
-
-**Shape Mod Amt:** How much the LFO or cyclic envelope modulates the shape. At 5-15%, it's subtle organic movement. At 30-50%, it's obvious PWM-style modulation. At 70%+, it's aggressive waveshaping.
-
-**LP Freq / LP Reso:** Single lowpass filter. Key insight: Drift's filter has two "types" (I and II) that sound quite different. Type I is smoother, Type II has more resonance character. For dub techno, Type I at medium-low freq (200-500 Hz) with moderate resonance (25-40%).
-
-**LP Mod Amt 1 / LP Mod Amt 2:** How much Env 2 and the LFO modulate the filter. This is where the character lives. High Env 2 modulation = plucky, percussive. High LFO modulation = rhythmic filter movement.
-
-**Cyclic Envelope:** A unique feature — a looping envelope that creates rhythmic or pseudo-random modulation. At low rates (0.1-1 Hz) it adds slow organic movement. At higher rates (2-20 Hz) it creates tremolo or rhythmic pulsing.
-
-**Thickness / Strength / Spread:** Voice stacking parameters:
-- **Thickness:** Adds detuned copies — instant fatness (20-40% for pads)
-- **Strength:** How aggressively the thickness voices detune (10-25% for subtle, 40%+ for aggressive)
-- **Spread:** Stereo width of the thickness voices (30-60% for natural width)
-
-**Noise Gain:** Adding noise at very low levels (-30 to -40 dB) creates the impression of "air" and vintage character without muddying the mix.
-
-### Creative Applications
-
-**Deep minimal techno stab:**
-- Osc 1: Saw, Shape 20%, Drift 40%
-- Osc 2: Sine, -1 octave, slight detune (+2-3 cents) for sub weight
-- Filter: Type I, Freq 400 Hz, Reso 30%
-- Env 2: Fast attack, short decay (80-150ms), low sustain → LP Mod Amt 1 at 50%
-- Result: Short, dark, characterful stab that changes slightly every time (thanks to Drift)
-
-**Organic atmospheric pad:**
-- Osc 1: PWM wave, Shape 40%, Shape Mod 20%
-- Osc 2: Triangle, -1 octave for depth
-- Drift: 55% (very analog, each note is unique)
-- LFO: 0.12 Hz, Amount 35% → filter
-- Cyclic Env: 0.3 Hz, Tilt 60% → shape mod
-- Noise: -35 dB (barely there, adds air)
-- Thickness 30%, Spread 50%
-
----
-
-## Analog
-
-Two oscillators, two filters, two amplifiers, two LFOs — a classic subtractive architecture that mirrors real analog polysynths. Each section (osc/filter/amp) has its own envelope.
-
-### Core Sound Design Parameters
-
-**Oscillator Shapes:** Sine, Saw, Square/Pulse, Noise per oscillator. Key insight: enabling **both** oscillators and setting them to slightly different tunings creates instant width and depth. Classic technique: Osc 1 = Saw, Osc 2 = Saw detuned +3-7 cents.
-
-**Sub/Sync modes:**
-- **Sub:** Osc 2 generates a sub-octave — instant bass weight
-- **Sync:** Osc 1 hard-syncs to Osc 2 — classic screaming sync sound when you sweep Osc 1's coarse frequency
-
-**Filter (F1/F2):** Each has 10 types including LP12, LP24, HP12, HP24, BP, Notch, and various drive types (Sym1, Sym2, Asym). The drive types add different saturation characters:
-- **Off:** Clean, transparent
-- **Sym1:** Gentle soft clipping — warm
-- **Sym2:** Harder clipping — crunchy
-- **Asym:** Asymmetric clipping — even harmonics, tube-like warmth
-
-**F1 Freq < Env / F1 Freq < LFO:** Filter modulation sources. Key: the filter envelope amount goes from -1 to +1. Negative values make the filter close on attack (unusual but useful for reversed-sounding plucks).
-
-**Glide:** Portamento between notes. Essential for 808-style bass slides. 10-20% for subtle, 30-50% for obvious glide. Enable **Legato** so glide only happens when notes overlap.
-
-### Creative Applications
-
-**808 bass from scratch:**
-- Osc 1: Sine, Octave -1 (or -2 for very deep sub)
-- Osc 2: Sine, Octave -2, Mode = Sub
-- F1: LP24, Sym2 drive, Freq 28% (≈190 Hz)
-- F1 Freq < Env: 30-40% (pluck character)
-- FEG: Fast attack, short decay (150-250ms), low sustain
-- AEG: Fast attack, long decay (1.5-3s), medium sustain
-- Voices: 1 (mono), Glide ON at 15%
-- Post: Saturator → Pedal (Fuzz at 30%) for harmonics and grit
-
-**Acid bass (303 style):**
-- Osc 1: Saw (or Square for hollow variant)
-- F1: LP24, OSR circuit if available (or Sym2 for aggressive), Freq 30%, Reso 65%+
-- F1 Freq < Env: 60-80% (the acid squelch)
-- FEG: Zero attack, very short decay (30-80ms), zero sustain
-- Accent via velocity → filter cutoff mapping
-- Voices: 1 (mono), Legato ON, Glide 20%
-
----
-
-## Operator
-
-Four-oscillator FM synth. Each oscillator can be a carrier (audible) or modulator (shapes another oscillator). 11 algorithms determine the routing. Also includes a filter and LFO.
-
-### Core Concept: FM Synthesis
-
-FM synthesis creates complex timbres from simple waveforms by modulating one oscillator's frequency with another. The **ratio** between modulator and carrier determines the harmonic content:
-- Integer ratios (1:1, 2:1, 3:1) = harmonic, musical sounds
-- Non-integer ratios (1:1.41, 3:2.7) = inharmonic, metallic, bell-like sounds
-
-The **modulator level** (Osc B/C/D Level when they modulate Osc A) determines intensity:
-- 0-20%: Subtle timbral coloring
-- 20-50%: Clear FM character, metallic harmonics
-- 50-80%: Aggressive, complex, potentially harsh
-- 80-100%: Extreme, noisy, glitchy
-
-### Core Sound Design Parameters
-
-**Algorithm:** Determines which oscillators modulate which. Key algorithms:
-- **Alg 1:** D→C→B→A (serial) — maximum complexity, each modulator stacks
-- **Alg 7:** All four independent carriers — additive synthesis, organ-like
-- **Alg 3:** Two pairs (C→A, D→B) — two independent FM voices, good for layering
-- **Alg 11:** Three modulators into one carrier — most extreme FM
-
-**Osc Coarse/Fine tuning:** The ratio control. Setting Osc B Coarse to 2, 3, 4 creates harmonic FM. Setting it to 1.41 or 7.13 creates metallic/bell timbres. The Fine tune (0-1000) allows micro-detuning for beating and organic quality.
-
-**Feedback (per oscillator):** Self-modulation — the oscillator modulates itself. Low values (5-15%) add warmth and body. High values (30-50%) add noise and grit. Very high values (70%+) create noise generators.
-
-**Pitch Envelope:** Essential for electronic sounds. A pitch drop on the carrier creates kick drums (Amount 100%, Peak +24st, Decay 15-50ms). A pitch rise on a modulator creates zaps and laser sounds.
-
-**Filter:** Operator's filter is the same engine as Wavetable's — Clean, OSR, MS2, SMP, PRD circuits. Using it after FM synthesis tames harsh harmonics while keeping character.
-
-**Tone:** Global brightness control (0-100%). At 50% it's neutral. Below 50% it progressively filters high harmonics (warmer). Above 50% it boosts presence. Quick way to shape without touching the filter.
-
-### Creative Applications
-
-**Glitch percussion (Autechre style):**
-- Algorithm 1 (serial): D→C→B→A
-- Osc A: Sine 8bit wave, Coarse 1, Feedback 15%, Short decay (30ms)
-- Osc B: Sine, Coarse 7, Fine 130 (inharmonic), Level 70%, Short decay (47ms)
-- Osc C: Sine, Coarse 3, Fine 50, Level 50%, Very short decay (27ms)
-- Osc D: Sine, Coarse 1, Level 0% (inactive but available for modulation)
-- Pitch Env: +24st, Decay 15ms (click/zap transient)
-- LFO: SwDown wave, High range, Rate 100 → filter for rhythmic gating
-- Shaper: Hard at 60% drive for digital crunch
-
-**FM bell/metallic hit:**
-- Algorithm 3 (two pairs)
-- Osc A: Sine, Coarse 1 (fundamental)
-- Osc B: Sine, Coarse 3.51 (inharmonic), Level 45%, Decay 800ms
-- Osc C: Sine, Coarse 1 (second fundamental, detuned +5 Fine)
-- Osc D: Sine, Coarse 7.03 (inharmonic), Level 30%, Decay 400ms
-- Long release on carriers (2-4s) for sustaining bell tone
-- Post: Reverb with long decay for shimmering bell
-
-**Sub bass with character:**
-- Algorithm 7 (all carriers — additive)
-- Osc A: Sine, Coarse 1, Level 85% (fundamental)
-- Osc B: Sine, Coarse 2, Level 30% (first harmonic — adds audibility on small speakers)
-- Osc C: Off
-- Osc D: Sine, Coarse 1, Feedback 40% (noise-like, level 15% for sub rumble)
-- Filter: LP24, Freq 65% (cuts harsh harmonics), Drive 6dB
-
----
-
-## Meld
-
-Two "macro oscillators" with multiple synthesis methods per oscillator. The oscillators are named "engines" and each provides a different synthesis approach. Extensive modulation matrix.
-
-### Core Concept
-
-Meld's power is in combining two different synthesis engines. Each oscillator slot can be:
-- **Swarm:** Multiple detuned voices — supersaw-like
-- **Noise:** Filtered noise with tonal character
-- **Sub:** Clean sub oscillator
-- **FM:** Frequency modulation
-- **Virtual Analog:** Classic waveforms
-- **Grain:** Granular-like texture
-
-### Creative Applications
-
-**Wall of sound chords (from Ableton's tutorial):**
-- Engine 1: Swarm with high voice count, moderate detune
-- Engine 2: FM with subtle modulation
-- Matrix: LFO → Engine 1 detune amount for slow chorus movement
-- Post-processing: Roar (parallel mode, gentle saturation) → Hybrid Reverb
-
-**Sub bass with harmonics:**
-- Engine 1: Sub (clean sine)
-- Engine 2: Virtual Analog (saw, heavily filtered) for harmonic content
-- Matrix: Velocity → Engine 2 filter cutoff (harder hits = brighter harmonics)
-- Post: Saturator (Soft Sine curve) for gentle warmth

package/livepilot/skills/livepilot-core/references/m4l-devices.md

@@ -1,352 +0,0 @@
-# Devices, Browser & Racks — Stock Instruments, Effects & MIDI Tools
-
-Complete reference for Ableton Live's device ecosystem: browser organization, MIDI effects, rack systems, and how to find/load devices through LivePilot.
-
-## Browser Organization
-
-Ableton's browser is the source for all devices, presets, and samples. The `search_browser` and `get_browser_tree` tools navigate this structure.
-
-### Top-Level Categories
-
-| Category | Contains | Use with LivePilot |
-|----------|---------|-------------------|
-| **Sounds** | Instrument presets organized by character (Bass, Keys, Lead, Pad, etc.) | `search_browser("warm pad")` |
-| **Drums** | Drum Rack presets (kits, single hits, percussion) | `search_browser("808 kit")` |
-| **Instruments** | Raw instruments without presets (Analog, Wavetable, Operator, etc.) | `find_and_load_device(track_index, "Wavetable")` |
-| **Audio Effects** | All audio effects (Compressor, Reverb, EQ Eight, etc.) | `find_and_load_device(track_index, "Compressor")` |
-| **MIDI Effects** | MIDI processors (Arpeggiator, Chord, Scale, etc.) | `find_and_load_device(track_index, "Arpeggiator")` |
-| **Max for Live** | M4L instruments, effects, and tools | `search_browser("LFO max")` |
-| **Plug-ins** | VST/AU plugins installed on the system | `search_browser("Serum")` |
-| **Clips** | Pre-made clips (MIDI patterns, audio loops) | `search_browser("house beat")` |
-| **Samples** | Audio samples organized by category | `search_browser("kick one shot")` |
-| **Packs** | Content from installed Packs | `get_browser_items("Packs")` |
-| **User Library** | User's saved presets, clips, samples | `get_browser_items("User Library")` |
-
-### Audio Effects Sub-Categories
-
-| Sub-Category | Devices |
-|-------------|---------|
-| **Dynamics** | Compressor, Glue Compressor, Limiter, Gate, Multiband Dynamics, Drum Buss |
-| **EQ** | EQ Eight, EQ Three, Channel EQ |
-| **Filter** | Auto Filter, Spectral Resonator |
-| **Delay** | Delay, Echo, Grain Delay, Beat Repeat, Spectral Time |
-| **Reverb** | Reverb, Convolution Reverb (M4L), Hybrid Reverb |
-| **Distortion** | Saturator, Overdrive, Erosion, Redux, Pedal, Amp, Cabinet |
-| **Modulation** | Chorus-Ensemble, Phaser-Flanger, Shifter, Ring Mod |
-| **Utility** | Utility, Tuner, Spectrum, External Audio Effect |
-| **Spatial** | Surround Panner (if available) |
-
-### Instrument Sub-Categories
-
-| Sub-Category | Devices |
-|-------------|---------|
-| **Synths** | Analog, Wavetable, Operator, Drift, Meld |
-| **Samplers** | Simpler, Sampler |
-| **Physical Modeling** | Tension, Collision, Electric |
-| **Drums** | Drum Rack (container) |
-| **Other** | Instrument Rack, External Instrument |
-
-## MIDI Effects
-
-MIDI effects go *before* the instrument in the device chain. They transform MIDI data before it reaches the sound generator.
-
-### Arpeggiator
-Transforms held chords into arpeggiated note sequences.
-
-**Key parameters:**
-- `Style` — Up, Down, UpDown, DownUp, Converge, Diverge, Con&Diverge, PinkyUp, PinkyUpDown, ThumbUp, ThumbUpDown, Random, Custom
-- `Rate` — Speed of arpeggiation (1/1 to 1/32, including triplets and dotted)
-- `Gate` — Note length as percentage of step length (1%-200%)
-- `Steps` — Number of steps (1-8) for custom patterns
-- `Offset` — Shift the start of the arpeggio pattern
-- `Groove` — Amount of groove/swing applied
-- `Transpose` — Pitch shift per octave repetition
-- `Distance` — Interval distance for Transpose
-- `Repeats` — Number of octave repetitions (1-inf)
-- `Velocity` — Fixed velocity or follows input
-
-**Common settings:**
-- Basic up arp: Style=Up, Rate=1/8, Gate=80%, Repeats=2
-- Trance arp: Style=UpDown, Rate=1/16, Gate=50%, Repeats=3
-- Random generative: Style=Random, Rate=1/16, Gate=60%, Repeats=2
-
-### Chord
-Adds parallel intervals to incoming notes to build chords.
-
-**Key parameters:**
-- `Shift 1-6` — Semitone offset for each additional note (-36 to +36)
-- `Velocity 1-6` — Velocity for each added note (1-127 or 0=off)
-
-**Common settings:**
-- Power chord (5th): Shift1=+7
-- Major chord: Shift1=+4, Shift2=+7
-- Minor chord: Shift1=+3, Shift2=+7
-- Octave double: Shift1=+12
-- Major 7th: Shift1=+4, Shift2=+7, Shift3=+11
-
-### Note Length
-Controls the duration and timing of MIDI notes.
-
-**Key parameters:**
-- `Mode` — Time-based (set fixed length) or Trigger (note-on generates fixed note)
-- `Length` — Note duration (in ms or synced divisions)
-- `Gate` — Percentage of original length
-- `Timing` — Time delay or advance
-
-**Use cases:**
-- Force all notes to equal length (staccato patterns)
-- Create gated synth effects
-- Trigger one-shot samples consistently
-
-### Pitch
-Simple pitch transposition.
-
-**Key parameters:**
-- `Pitch` — Semitone offset (-48 to +48)
-- `Range` — Limit the affected pitch range
-- `Lowest` — Lower bound of affected range
-
-### Random
-Adds randomization to MIDI notes.
-
-**Key parameters:**
-- `Chance` — Probability that randomization occurs (0-100%)
-- `Choices` — Number of possible random values (1-24)
-- `Scale` — Semitone range of randomization
-- `Mode` — Add (adds random offset), Toggle (randomly enables/disables notes), Randomize (random pitch within range)
-- `Sign` — Bi (both directions), Add (only up), Sub (only down)
-
-**Use cases:**
-- Generative melody: moderate Chance, Scale=12 (octave), Choices=7 (diatonic)
-- Humanize velocity: small random velocity offset
-- Probability gates: Chance=50% creates evolving patterns
-
-### Scale
-Forces incoming MIDI to a specific musical scale.
-
-**Key parameters:**
-- `Base` — Root note (C, C#, D, etc.)
-- `Scale Type` — Major, Minor, Dorian, Mixolydian, Pentatonic, Blues, Chromatic, etc.
-- Per-note mapping grid — shows which notes map to which scale degrees
-
-**Common scales:**
-| Scale | Intervals (semitones from root) |
-|-------|-------------------------------|
-| Major | 0, 2, 4, 5, 7, 9, 11 |
-| Minor (Natural) | 0, 2, 3, 5, 7, 8, 10 |
-| Dorian | 0, 2, 3, 5, 7, 9, 10 |
-| Mixolydian | 0, 2, 4, 5, 7, 9, 10 |
-| Pentatonic Major | 0, 2, 4, 7, 9 |
-| Pentatonic Minor | 0, 3, 5, 7, 10 |
-| Blues | 0, 3, 5, 6, 7, 10 |
-| Harmonic Minor | 0, 2, 3, 5, 7, 8, 11 |
-| Whole Tone | 0, 2, 4, 6, 8, 10 |
-
-**Tip:** Place Scale after Arpeggiator or Random to ensure generated notes stay in key.
-
-### Velocity
-Modifies note velocity.
-
-**Key parameters:**
-- `Drive` — Amplifies velocity curve
-- `Compand` — Compresses (negative) or expands (positive) velocity range
-- `Out Hi` / `Out Low` — Output velocity range limits
-- `Random` — Adds random velocity offset
-- `Operation` — Clip, Gate, Fixed
-
-**Use cases:**
-- Consistent velocity: Fixed at 100
-- Dynamic compression: Compand negative, narrows velocity range
-- Humanize: small Random value (5-15)
-
-### CC Control (Live 12)
-Sends MIDI CC messages based on note input. New in Live 12.
-
-**Key parameters:**
-- `CC Number` — Which CC to send (0-127)
-- `Value` — Fixed CC value or mapped from velocity/pitch
-
-**Use case:** Automate hardware synth parameters from MIDI clips.
-
-**Note:** All pitch-based MIDI effects in Live 12 support a "Use Current Scale" toggle that constrains output to the clip's scale setting.
-
-## Max for Live Devices (Stock with Suite)
-
-### M4L Instruments
-- **Drift** — Analog-modeled synth with character and instability
-- **Meld** — MPE-capable dual-engine synth
-- **Granulator III** — Granular synthesis instrument (updated from Granulator II)
-- **Vector Grain** — Vector synthesis + granular engine
-- **FlexGroove** — Groove-based instrument (from Packs)
-
-### M4L Audio Effects
-- **Align Delay** — Phase-aligned delay for mixing
-- **Color Limiter** — Colorful limiter with character
-- **Convolution Reverb** — Impulse response reverb using real space recordings
-- **Convolution Reverb Pro** — Extended version with EQ and modulation
-- **Envelope Follower** — Generates control signal from audio amplitude
-- **Gated Delay** — Rhythmically gated delay effect
-- **LFO** — Free-running LFO that maps to any parameter
-- **PitchLoop89** — Creative pitch-shifting looper
-- **Shaper** — Custom waveshaping LFO/envelope
-- **Spectral Resonator** — Spectral processing with pitched resonance
-- **Spectral Time** — Spectral delay and freeze effects
-
-### M4L Drum Synths (Drum Rack compatible)
-- **DS Kick** — Synthesized kick drum
-- **DS Snare** — Synthesized snare
-- **DS Clap** — Synthesized clap
-- **DS HH** — Synthesized hi-hat
-- **DS Cymbal** — Synthesized cymbal
-- **DS Tom** — Synthesized tom
-- **DS FM** — FM-synthesized percussion
-- **DS Clang** — Metallic percussion
-- **DS Sampler** — Sample-based drum voice
-
-### M4L MIDI Effects
-- **Envelope MIDI** — Custom velocity/CC envelopes
-- **Expression Control** — MPE expression mapping
-- **Melodic Steps** — Step sequencer for melodies
-- **MIDI Monitor** — Displays incoming MIDI data (debugging)
-
-### M4L Tools & Utilities
-- **LFO** — Free-running LFO that maps to any parameter
-- **Envelope Follower** — Generates control signal from audio amplitude
-- **Shaper** — Custom waveshaping LFO/envelope
-- **DS Kick/Snare/HH/Clap/Cymbal** — Drum synthesis (drum rack compatible)
-- **Instant Haus** — Auto-generates house beats
-
-### M4L Control Surface Tools
-- **Connection Kit** — OSC/MIDI routing tools
-- **Max API** — Direct access to Live's API from Max
-
-## Rack Systems
-
-### Instrument Rack
-- **Purpose**: Layer multiple instruments, create splits, build complex presets
-- **Structure**: Multiple chains, each containing instruments and effects
-- **Key features**:
-  - **Chain selector** — Map MIDI velocity, note, or a selector value to different chains
-  - **Key zones** — Different instruments for different pitch ranges (keyboard splits)
-  - **Velocity zones** — Different instruments triggered by different velocity ranges
-  - **Macros** — 8 (or 16 in Live 12) knobs that control parameters across all chains
-- **Use case**: Layer a pad and a pluck — pad responds to low velocity, pluck to high
-
-### Audio Effect Rack
-- **Purpose**: Parallel processing, multi-band processing, A/B comparison
-- **Structure**: Multiple chains, each with its own effect chain
-- **Key features**:
-  - **Parallel processing**: Audio splits to all chains simultaneously
-  - **Chain selector**: Fade between different effect chains
-  - **Macros**: Map to parameters across chains for unified control
-- **Common patterns**:
-  - Parallel compression (dry chain + compressed chain)
-  - Multi-band processing (LP chain + BP chain + HP chain)
-  - Wet/dry blend with effects
-  - A/B comparison of different processing
-
-### Drum Rack
-- **Purpose**: Map samples/instruments to MIDI notes (pads)
-- **Structure**: 128 pads (MIDI notes 0-127), each pad is a chain
-- **Key features**:
-  - **Choke groups**: Assign pads to groups — triggering one silences others (open/closed hi-hat)
-  - **Send/return within rack**: Internal send effects shared between pads
-  - **Pad chains**: Each pad has its own chain — sample + effects per pad
-  - **Layering**: Multiple samples per pad by layering chains
-  - **Receive note**: Each pad maps to a MIDI note
-- **Standard mapping**: C1 (36) = Kick, D1 (38) = Snare, F#1 (42) = Closed HH (see midi-recipes.md)
-
-### MIDI Effect Rack
-- **Purpose**: Process MIDI in parallel or with velocity/key splitting
-- **Structure**: Multiple chains of MIDI effects
-- **Key features**:
-  - Key zones for different MIDI processing per range
-  - Velocity zones for velocity-dependent MIDI transformation
-- **Common pattern**: Arpeggiator on high notes, Chord on low notes
-
-### Macro Mapping
-All rack types support macros:
-- **Live 11 and earlier**: 8 macro knobs
-- **Live 12**: Up to 16 macro knobs (expandable)
-- **Mapping**: Right-click any parameter inside the rack → "Map to Macro X"
-- **Ranges**: Each mapping has min/max values — macros can invert or limit parameter range
-- **Use case**: One "Brightness" macro controlling filter cutoff, EQ, and reverb tone simultaneously
-
-## Loading Devices with LivePilot
-
-### `find_and_load_device` — Search by Name
-Best for stock devices — searches browser and loads first match:
-```
-find_and_load_device(track_index=0, name="Wavetable")
-find_and_load_device(track_index=0, name="Compressor")
-find_and_load_device(track_index=0, name="Arpeggiator")
-```
-
-**Common device names** (exact search strings):
-| Category | Device Names |
-|----------|-------------|
-| Synths | `Analog`, `Wavetable`, `Operator`, `Drift`, `Meld` |
-| Samplers | `Simpler`, `Sampler` |
-| Physical | `Tension`, `Collision`, `Electric` |
-| Drums | `Drum Rack` |
-| Dynamics | `Compressor`, `Glue Compressor`, `Limiter`, `Gate`, `Multiband Dynamics` |
-| EQ | `EQ Eight`, `EQ Three`, `Channel EQ` |
-| Filter | `Auto Filter` |
-| Delay | `Delay`, `Echo`, `Grain Delay`, `Beat Repeat` |
-| Reverb | `Reverb`, `Hybrid Reverb` |
-| Distortion | `Saturator`, `Overdrive`, `Erosion`, `Redux`, `Pedal`, `Amp`, `Cabinet` |
-| Modulation | `Chorus-Ensemble`, `Phaser-Flanger`, `Shifter` |
-| Utility | `Utility`, `Tuner`, `Spectrum` |
-| MIDI FX | `Arpeggiator`, `Chord`, `Note Length`, `Pitch`, `Random`, `Scale`, `Velocity`, `CC Control` |
-| Racks | `Instrument Rack`, `Audio Effect Rack`, `MIDI Effect Rack` |
-| Drum | `Drum Buss` (audio effect, not Drum Rack) |
-
-### `load_device_by_uri` — Load by URI
-For specific presets or when you know the exact browser path:
-```
-load_device_by_uri(track_index=0, uri="...")
-```
-Get URIs by browsing with `search_browser` or `get_browser_items`.
-
-**Important:** Device URIs are opaque strings — they cannot be constructed manually. You must discover them by walking the browser tree (`get_browser_tree` → `get_browser_items`) or searching (`search_browser`). Each `BrowserItem` has a `uri`, `name`, and `is_loadable` property.
-
-### `search_browser` — Find Presets
-Search for presets, sounds, and samples:
-```
-search_browser(query="warm pad")
-search_browser(query="808 kick")
-search_browser(query="techno lead")
-```
-
-### Device Chain Order
-When loading multiple devices on a track, they're added in sequence. The order matters:
-
-**MIDI Track chain:**
-```
-MIDI Effects → Instrument → Audio Effects
-(Arpeggiator → Scale → Wavetable → Compressor → Reverb)
-```
-
-**Audio Track chain:**
-```
-Audio Effects only
-(EQ Eight → Compressor → Saturator → Delay → Reverb)
-```
-
-Devices are indexed by position: first device = index 0, second = index 1, etc.
-
-## Device Parameter Inspection
-
-Always inspect parameters before setting them — parameter names and indices vary by device:
-
-```
-# Get all parameters for a device
-get_device_parameters(track_index=0, device_index=0)
-
-# Returns list of: name, value, min, max, is_quantized
-# Use the exact name or index to set parameters
-```
-
-**Quantized parameters** (is_quantized=True) have discrete steps — set to integers or specific values from the allowed list. Examples: filter type selectors, waveform selectors, on/off toggles.
-
-**Continuous parameters** (is_quantized=False) accept any float within min-max range. Examples: cutoff frequency, volume, drive amount.