livepilot 1.9.21 → 1.9.23

package/livepilot/skills/livepilot-core/references/device-atlas/drums-and-percussion.md

@@ -12,7 +12,7 @@
 ### Drum Rack
 
 - **Type:** Native (Instrument Rack variant)
-- **Load via:** `find_and_load_device("Drum Rack")`
+- **Load via:** `find_and_load_device(track_index, "Drum Rack")`
 - **What it does:** The container system for all drum programming in Live. Each pad hosts an independent instrument chain with its own effects, mixer controls, and routing. Maps 128 MIDI notes to individual pads, supports layering, choke groups, and internal send/return processing. The backbone of every drum kit in Live.
 - **Signal flow:** MIDI In -> Pad Note Assignment (Receive) -> Per-Pad Instrument Chain (with per-chain FX) -> Per-Chain Mixer (Volume/Pan/Sends) -> Send/Return Chains (up to 6) -> Main Output
 - **Key concepts:**
@@ -27,7 +27,7 @@
   - **Individual Pad Routing:** Each chain has Volume, Pan, and Send sliders in the mixer section.
 - **Presets:** Every drum kit in the browser is a Drum Rack preset. See the Kit Guide below for the full 139-kit breakdown.
 - **LivePilot workflow:**
-  - Load a kit: `find_and_load_device("Kit Name")` on a MIDI track
+  - Load a kit: `find_and_load_device(track_index, "Kit Name")` on a MIDI track
   - Add device to specific pad: Load instrument into Drum Rack chain, set Receive note
   - Set choke groups: Access chain list, set Choke column value (1-16) for related pads
   - Layer sounds: Load multiple instruments on one pad chain via nested Instrument Rack
@@ -46,7 +46,7 @@
 ### DS Kick
 
 - **Type:** M4L Instrument (Drum Synth)
-- **Load via:** `find_and_load_device("DS Kick")`
+- **Load via:** `find_and_load_device(track_index, "DS Kick")`
 - **What it does:** Kick drum synth built on a modulated sine wave. Produces everything from deep sub-bass 808 kicks to punchy acoustic-style kicks. The OT (overtone) control adds a mid-range resonant tone reminiscent of a 909 kick.
 - **Signal flow:** Sine Oscillator -> Pitch Envelope (Env) -> Drive/Saturation -> Click Layer -> Volume -> Output
 - **Key parameters:**
@@ -68,7 +68,7 @@
 ### DS Snare
 
 - **Type:** M4L Instrument (Drum Synth)
-- **Load via:** `find_and_load_device("DS Snare")`
+- **Load via:** `find_and_load_device(track_index, "DS Snare")`
 - **What it does:** Snare synth combining a pitched oscillator with noise. Covers the range from traditional acoustic snare sounds to gated noise electronic snares common in EDM.
 - **Signal flow:** Pitched Oscillator + Noise Generator -> Filter (LP/HP/BP selectable) -> Decay Envelope -> Volume -> Output
 - **Key parameters:**
@@ -86,7 +86,7 @@
 ### DS Clap
 
 - **Type:** M4L Instrument (Drum Synth)
-- **Load via:** `find_and_load_device("DS Clap")`
+- **Load via:** `find_and_load_device(track_index, "DS Clap")`
 - **What it does:** Clap synth using filtered noise and impulses through panned delay lines. Creates everything from tight electronic claps to loose, humanized handclaps with natural spread.
 - **Signal flow:** Impulse + Filtered Noise (Tail) -> Panned Delay Lines (Sloppy) -> Stereo Spread -> Tone Filter -> Volume -> Output
 - **Key parameters:**
@@ -105,7 +105,7 @@
 ### DS HH (Hi-Hat)
 
 - **Type:** M4L Instrument (Drum Synth)
-- **Load via:** `find_and_load_device("DS HH")`
+- **Load via:** `find_and_load_device(track_index, "DS HH")`
 - **What it does:** Hi-hat synth blending noise and sine waveforms through a resonant high-pass filter. Produces sharp closed hats to sizzling open hats.
 - **Signal flow:** Noise Generator (White/Pink) + Sine Oscillator -> Resonant High-Pass Filter (12/24 dB) -> Attack Shaping -> Decay Envelope -> Volume -> Output
 - **Key parameters:**
@@ -125,7 +125,7 @@
 ### DS Cymbal
 
 - **Type:** M4L Instrument (Drum Synth)
-- **Load via:** `find_and_load_device("DS Cymbal")`
+- **Load via:** `find_and_load_device(track_index, "DS Cymbal")`
 - **What it does:** Electronic cymbal synth for splashes, crashes, and rides. Simple three-knob design for quick results.
 - **Signal flow:** Noise/Oscillator Core -> Tone Filter -> Decay Envelope -> Volume -> Output
 - **Key parameters:**
@@ -141,7 +141,7 @@
 ### DS Tom
 
 - **Type:** M4L Instrument (Drum Synth)
-- **Load via:** `find_and_load_device("DS Tom")`
+- **Load via:** `find_and_load_device(track_index, "DS Tom")`
 - **What it does:** Tom synth with pitched oscillator, noise layer, and pitch envelope. Fills the mid-range with resonant, punchy toms. Pitch displayed in both note name and Hz for diatonic tuning.
 - **Signal flow:** Pitched Oscillator -> Pitch Envelope (Bend) -> Resonant Band-Pass Filters (Tone) -> Color Filter -> Decay Envelope -> Volume -> Output
 - **Key parameters:**
@@ -159,7 +159,7 @@
 ### DS FM
 
 - **Type:** M4L Instrument (Drum Synth)
-- **Load via:** `find_and_load_device("DS FM")`
+- **Load via:** `find_and_load_device(track_index, "DS FM")`
 - **What it does:** FM synthesis percussion generator inspired by classic Japanese FM synthesizers (DX7/TX81Z). Creates everything from tuned claves and woodblocks to laser blasts and futuristic bleeps. Pitch displayed in note values for diatonic use.
 - **Signal flow:** FM Algorithm (Carrier + Modulator) -> Feedback -> Low-Pass Filter (Tone) -> Decay Envelope -> Volume -> Output
 - **Key parameters:**
@@ -179,7 +179,7 @@
 ### DS Clang
 
 - **Type:** M4L Instrument (Drum Synth)
-- **Load via:** `find_and_load_device("DS Clang")`
+- **Load via:** `find_and_load_device(track_index, "DS Clang")`
 - **What it does:** Metallic percussion synth with two independent tones, white noise, and a filter. Creates cowbells, claves, rimshots, and noise percussion. Has a dedicated Clave mode with repeats.
 - **Signal flow:** Tone A + Tone B + White Noise -> HP/BP Filter -> Clave Repeat (optional) -> Decay Envelope -> Volume -> Output
 - **Key parameters:**
@@ -199,7 +199,7 @@
 ### DS Sampler
 
 - **Type:** M4L Instrument (Drum Synth)
-- **Load via:** `find_and_load_device("DS Sampler")`
+- **Load via:** `find_and_load_device(track_index, "DS Sampler")`
 - **What it does:** Sample-based drum voice that fits the DS Drum Synth form factor. Drag and drop any sample into the display. Provides Start, Length, Tuning, Loop mode, and a Shaper for saturation. The bridge between synthesis and sampling within the DS ecosystem.
 - **Signal flow:** Sample Playback (Start/Length) -> Tuning -> Loop (optional) -> Shaper/Saturation -> Decay Envelope -> Volume -> Output
 - **Key parameters:**
@@ -223,7 +223,7 @@
 ### Drum Sampler
 
 - **Type:** Native Instrument (Live 12.1+, all editions)
-- **Load via:** `find_and_load_device("Drum Sampler")`
+- **Load via:** `find_and_load_device(track_index, "Drum Sampler")`
 - **What it does:** Purpose-built one-shot sample playback device for percussion. The modern replacement for dropping samples into Simpler in Slice mode. Features 9 playback effects with X/Y pad control, a filter section, AHD envelope, velocity/MPE modulation, and similarity-based sample swapping. Designed to be the default instrument on new Drum Rack pads (set via context menu: "Save as Default Pad").
 - **Signal flow:** Sample (Start/Length) -> Playback Effect -> Filter -> AHD Envelope -> Velocity-to-Volume -> Pan -> Output
 - **Key parameters:**
@@ -280,7 +280,7 @@
 ### Drum Buss
 
 - **Type:** Native Audio Effect
-- **Load via:** `find_and_load_device("Drum Buss")`
+- **Load via:** `find_and_load_device(track_index, "Drum Buss")`
 - **What it does:** Analog-style drum processor that adds body, character, and cohesion to drum groups. Combines distortion (3 types), mid-high transient shaping, and a resonant low-end enhancer in one device. Designed specifically for drum bus processing — does what would normally require 4-5 separate devices in a single, intuitive interface.
 - **Signal flow:** Input -> Trim -> Fixed Compressor (optional) -> Drive Distortion (Soft/Medium/Hard) -> Crunch (mid-high sine distortion) -> Damp (LP filter) -> Transient Shaping (>100 Hz) -> Boom (resonant bass filter + decay) -> Dry/Wet -> Output Gain
 - **Key parameters:**
@@ -317,7 +317,7 @@
 ### Impulse
 
 - **Type:** Native Instrument
-- **Load via:** `find_and_load_device("Impulse")`
+- **Load via:** `find_and_load_device(track_index, "Impulse")`
 - **What it does:** Classic 8-slot drum sampler with per-slot processing. Each slot has independent Stretch, Saturate, Filter, Pan, Volume, and envelope controls. Simpler than Drum Rack but faster for quick sketches. Samples auto-map to C3-C4 on the keyboard.
 - **Signal flow:** Per Slot: Sample -> Start Offset -> Time Stretch -> Filter -> Saturator -> Decay Envelope -> Pan -> Volume -> Global Output
 - **Key parameters (per slot):**
@@ -355,7 +355,7 @@
 ### AmenMachine (CLX_04)
 
 - **Type:** M4L Instrument (User Library — CLX_04 collection)
-- **Load via:** `find_and_load_device("AmenMachine")`
+- **Load via:** `find_and_load_device(track_index, "AmenMachine")`
 - **What it does:** Breakbeat slicer instrument designed for chopping and rearranging break loops, particularly the Amen break and similar breakbeats. Slices a loaded loop into segments and allows real-time rearrangement, stutter, and manipulation via MIDI triggering or internal sequencing.
 - **Key features:**
   - Automatic transient-based slicing of loaded breakbeat loops
@@ -371,7 +371,7 @@
 ### trnr.Hatster
 
 - **Type:** M4L Instrument (TRNR)
-- **Load via:** `find_and_load_device("Hatster")`
+- **Load via:** `find_and_load_device(track_index, "Hatster")`
 - **What it does:** Hi-hat synthesizer inspired by modular synthesizers. Uses a noise oscillator core fed into a modeled Low-Pass Gate (LPG) filter/VCA that reacts uniquely to each incoming hit, especially with velocity variation. All parameters can be modulated by integrated sine-wave LFOs for evolving hi-hat patterns.
 - **Key parameters:**
   - **Noise Oscillator** -> core sound source
@@ -388,7 +388,7 @@
 ### trnr.Kickster
 
 - **Type:** M4L Instrument (TRNR)
-- **Load via:** `find_and_load_device("Kickster")`
+- **Load via:** `find_and_load_device(track_index, "Kickster")`
 - **What it does:** 4-operator FM synthesis kick drum synth with a uniquely shaped integrated envelope generator. Optimized for short, snappy kicks that leave room for other elements, but the tail can be extended for experimentation. The "boom" and "click" portions of the kick are independently controllable.
 - **Key parameters:**
   - **Boom controls** -> shape the body/sub portion of the kick
@@ -403,7 +403,7 @@
 ### trnr.DmmG
 
 - **Type:** M4L Audio Effect (TRNR)
-- **Load via:** `find_and_load_device("DmmG")`
+- **Load via:** `find_and_load_device(track_index, "DmmG")`
 - **What it does:** Digital multi-mode gate audio effect. A logarithmic A/D envelope triggered by external MIDI opens the integrated VCA and VCF, letting you play an audio track like a subtractive synthesizer. Inspired by Vactrol filters/VCAs from modular synthesizers. Note: this is an audio effect, not an instrument — it processes existing audio.
 - **Key parameters:**
   - **Highpass / Lowpass Filters** -> multi-mode filtering
@@ -420,7 +420,7 @@
 ### drumk 2 (K-Devices)
 
 - **Type:** M4L Instrument (K-Devices)
-- **Load via:** `find_and_load_device("drumk 2")`
+- **Load via:** `find_and_load_device(track_index, "drumk 2")`
 - **What it does:** Grid-based sample manipulation instrument for beat-oriented sound design. Uses a multislider grid where each step has independent parameters and playback modes. Supports 2 simultaneous samples with crossfade, 8 snapshots per preset with gesture morphing, and step-sequenced effects.
 - **Key parameters:**
   - **Grid/Multislider System** -> per-step parameter editing for granular control over playback
@@ -439,7 +439,7 @@
 ### Drum Articulate (Max for Cats)
 
 - **Type:** M4L MIDI Effect
-- **Load via:** `find_and_load_device("Drum Articulate")`
+- **Load via:** `find_and_load_device(track_index, "Drum Articulate")`
 - **What it does:** MIDI effect for programming sophisticated drum articulations. Creates drum rolls, flams, random triggers, and complex rhythmic embellishments. Can be placed on individual Drum Rack pads for per-pad articulation, or globally on a whole kit. Also works with synths and effects.
 - **Key features:**
   - **4 Triggers** -> each with freely adjustable delay time between triggers
@@ -455,7 +455,7 @@
 
 ## Drum Kit Guide by Genre/Character
 
-> Complete catalog of the 139 drum kits available in this installation. Kits are grouped by sonic character and intended genre. All are Drum Rack presets loaded via `find_and_load_device("Kit Name")`.
+> Complete catalog of the 139 drum kits available in this installation. Kits are grouped by sonic character and intended genre. All are Drum Rack presets loaded via `find_and_load_device(track_index, "Kit Name")`.
 
 ---
 
@@ -702,15 +702,15 @@
 ### Loading Drums
 ```
 # Load a complete drum kit
-find_and_load_device("808 Core Kit")
+find_and_load_device(track_index, "808 Core Kit")
 
 # Load a DS synth onto a specific Drum Rack pad
 # First load Drum Rack, then load DS device into a pad chain
-find_and_load_device("Drum Rack")
-find_and_load_device("DS Kick")  # loads into selected pad
+find_and_load_device(track_index, "Drum Rack")
+find_and_load_device(track_index, "DS Kick")  # loads into selected pad
 
 # Load Drum Buss on the drum group bus
-find_and_load_device("Drum Buss")
+find_and_load_device(track_index, "Drum Buss")
 ```
 
 ### Programming Drums

package/livepilot/skills/livepilot-core/references/device-atlas/dynamics-and-punch.md

@@ -12,7 +12,7 @@
 ### Compressor
 
 - **Type:** Native
-- **Load via:** `find_and_load_device("Compressor")`
+- **Load via:** `find_and_load_device(track_index, "Compressor")`
 - **What it does:** General-purpose dynamics processor that attenuates signals above a threshold. Extremely versatile — can be transparent glue or aggressive pumping depending on settings. Clean, digital character with no inherent coloration.
 - **Signal flow:** Input -> Sidechain EQ (optional) -> Envelope Follower (Peak/RMS/Expand) -> Gain Reduction -> Makeup/Output -> Dry/Wet
 - **Key parameters:**
@@ -38,7 +38,7 @@
 ### Glue Compressor
 
 - **Type:** Native
-- **Load via:** `find_and_load_device("Glue Compressor")`
+- **Load via:** `find_and_load_device(track_index, "Glue Compressor")`
 - **What it does:** SSL 4000 G Bus Compressor emulation by Cytomic. Adds analog warmth, glues elements together on buses. Has inherent musical character — slightly rounds transients and adds subtle harmonic content. The "gel" compressor.
 - **Signal flow:** Input -> Sidechain EQ (optional) -> VCA-style Compression -> Soft Clip (optional) -> Makeup -> Dry/Wet
 - **Key parameters:**
@@ -63,7 +63,7 @@
 ### Limiter
 
 - **Type:** Native
-- **Load via:** `find_and_load_device("Limiter")`
+- **Load via:** `find_and_load_device(track_index, "Limiter")`
 - **What it does:** Brickwall limiter — no signal passes above the ceiling. Completely redesigned in Live 12.1 with True Peak, Soft Clip, and Maximize modes. The safety net. Ensures nothing clips, or pushes loudness when used as a maximizer.
 - **Signal flow:** Input -> Gain -> Lookahead Peak Detection -> Gain Reduction -> Ceiling -> Output
 - **Key parameters:**
@@ -85,7 +85,7 @@
 ### Gate
 
 - **Type:** Native
-- **Load via:** `find_and_load_device("Gate")`
+- **Load via:** `find_and_load_device(track_index, "Gate")`
 - **What it does:** Noise gate that silences audio below a threshold. Cleans up recordings, shapes drum tails, creates rhythmic effects via sidechain. The "bouncer" — only lets loud enough signals through.
 - **Signal flow:** Input -> Sidechain EQ (optional) -> Envelope Follower -> Gate Open/Close -> Floor Attenuation -> Output
 - **Key parameters:**
@@ -109,7 +109,7 @@
 ### Multiband Dynamics
 
 - **Type:** Native
-- **Load via:** `find_and_load_device("Multiband Dynamics")`
+- **Load via:** `find_and_load_device(track_index, "Multiband Dynamics")`
 - **What it does:** Three-band dynamics processor that can independently compress, expand, or gate each frequency band. The Swiss Army knife of dynamics — can do OTT, multiband compression, frequency-selective gating, and upward/downward processing. Home of the legendary OTT preset.
 - **Signal flow:** Input -> 3-Band Crossover -> Per-Band Above/Below Threshold Processing -> Per-Band Output Gain -> Output
 - **Key parameters:**
@@ -137,7 +137,7 @@
 ### Drum Buss
 
 - **Type:** Native
-- **Load via:** `find_and_load_device("Drum Buss")`
+- **Load via:** `find_and_load_device(track_index, "Drum Buss")`
 - **What it does:** All-in-one drum processor combining compression, distortion, transient shaping, and low-end enhancement. Designed to add body, punch, and character to drum groups. The "instant drums sound better" device. Analog-modeled throughout.
 - **Signal flow:** Input -> Trim -> Fixed Compressor (optional) -> Distortion (Soft/Medium/Hard) -> Drive -> Crunch (mid-high distortion) -> Damp (LP filter) -> Transients (above 100 Hz) -> Boom (resonant LP filter below 100 Hz) -> Dry/Wet -> Output
 - **Key parameters:**
@@ -170,7 +170,7 @@
 ### Color Limiter
 
 - **Type:** M4L Stock (Creative Extensions pack — free with Live Suite)
-- **Load via:** `find_and_load_device("Color Limiter")` or `search_browser("Color Limiter", category="Audio Effects")`
+- **Load via:** `find_and_load_device(track_index, "Color Limiter")` or `search_browser(path="audio_effects", name_filter="Color Limiter")`
 - **What it does:** Hardware-inspired limiter that adds saturation and harmonic coloration while limiting. Unlike the clean native Limiter, Color Limiter is designed to add grit, pressure, and vintage character. Think: tube limiter behavior in a digital box.
 - **Signal flow:** Input -> Loudness (input gain) -> Lookahead Detection -> Ceiling Limiting + Saturation/Color Processing -> Release Recovery -> Output
 - **Key parameters:**
@@ -191,7 +191,7 @@
 ### Re-Enveloper
 
 - **Type:** M4L Stock (Creative Extensions pack — free with Live Suite)
-- **Load via:** `find_and_load_device("Re-Enveloper")` or `search_browser("Re-Enveloper", category="Audio Effects")`
+- **Load via:** `find_and_load_device(track_index, "Re-Enveloper")` or `search_browser(path="audio_effects", name_filter="Re-Enveloper")`
 - **What it does:** Multiband envelope reshaper. Splits audio into three adjustable frequency bands and lets you compress OR expand the amplitude envelope of each independently. Goes far beyond gating — it literally redraws the volume shape of the sound per frequency band. Can highlight transients, extend sustain, destroy dynamics, or surgically carve elements.
 - **Signal flow:** Input -> 3-Band Frequency Split -> Per-Band Envelope Detection -> Per-Band C/E (Compression/Expansion) Processing -> Per-Band Gain -> Output
 - **Key parameters:**
@@ -216,7 +216,7 @@
 ### Crack
 
 - **Type:** M4L (Transient Machines pack by Surreal Machines)
-- **Load via:** `find_and_load_device("Crack")` or `search_browser("Crack", category="Audio Effects")`
+- **Load via:** `find_and_load_device(track_index, "Crack")` or `search_browser(path="audio_effects", name_filter="Crack")`
 - **What it does:** Compact single-band transient shaper designed for individual sounds and loops. The "contrast dial for your sound" — makes transients pop or fade, and tails extend or shrink. Includes analog-modeled output processing (limiter, soft clip, maximizer) tuned specifically for transient material.
 - **Signal flow:** Input -> Transient Detection -> Attack/Sustain Shaping -> Dry/Wet Mix -> Output Stage (Clipper/Limiter/Maximizer selectable)
 - **Key parameters:**
@@ -234,7 +234,7 @@
 ### Impact
 
 - **Type:** M4L (Transient Machines pack by Surreal Machines)
-- **Load via:** `find_and_load_device("Impact")` or `search_browser("Impact", category="Audio Effects")`
+- **Load via:** `find_and_load_device(track_index, "Impact")` or `search_browser(path="audio_effects", name_filter="Impact")`
 - **What it does:** Multi-band drum processing channel strip combining up to 3 bands of transient shaping, 4-band EQ, 4 saturation types, and output processing (clipper/limiter/maximizer). The "big brother" of Crack — a complete drum dynamics workstation in one device.
 - **Signal flow:** Input -> 1/2/3 Band Split -> Per-Band Attack + Sustain Shaping -> 4-Band EQ -> Saturation (4 types) -> Output Stage (Clipper/Limiter/Maximizer)
 - **Key parameters:**
@@ -258,7 +258,7 @@
 ### doomCompressor_v1.0
 
 - **Type:** M4L User (CLX_02) — by poulhoi
-- **Load via:** `search_browser("doomCompressor", category="Audio Effects")`
+- **Load via:** `search_browser(path="audio_effects", name_filter="doomCompressor")`
 - **What it does:** Extreme upward compressor inspired by Mick Gordon's DOOM soundtrack technique. Instead of reducing loud signals, it amplifies quiet ones to near 0 dBFS. Makes everything audible — even the faintest noise floor becomes as loud as the transients. Creates a hyper-compressed, "everything is at maximum volume" effect. Used for aggressive sound design, industrial textures, and extreme effects.
 - **Signal flow:** Input -> Envelope Follower -> Compare to Threshold -> Calculate normalization factor -> Apply multiplication to bring signal to 0 dBFS -> Attack/Release Smoothing -> Output
 - **Key parameters:**
@@ -276,7 +276,7 @@
 ### RawDoomCompressor_v1.0.0
 
 - **Type:** M4L User (CLX_02) — by geoffreyday
-- **Load via:** `search_browser("RawDoomCompressor", category="Audio Effects")`
+- **Load via:** `search_browser(path="audio_effects", name_filter="RawDoomCompressor")`
 - **What it does:** Stripped-down DOOM compressor with hard-coded attack/release. Single-band extreme upward compressor designed as a building block for creating custom multiband doom compression chains. The raw, no-frills version.
 - **Signal flow:** Input -> Hard-coded Envelope Detection -> Upward Normalization -> Floor Gate -> Output Level
 - **Key parameters:**
@@ -293,7 +293,7 @@
 ### Carver 1.2
 
 - **Type:** M4L User (CLX_02) — by Noir Labs
-- **Load via:** `search_browser("Carver", category="Audio Effects")`
+- **Load via:** `search_browser(path="audio_effects", name_filter="Carver")`
 - **What it does:** Advanced transient shaper with the most accurate real-time transient detection on the market. Shapes attacks and sustain without changing perceived volume. Features three curve types, M/S processing, and the unique ability to apply distortion only to the transient or only to the body of the sound. Shows detected transient in real-time waveform display.
 - **Signal flow:** Input -> Transient Detection (with Sensitivity control) -> Attack/Sustain Shaping (with Curve selection) -> Distortion (routable to full/transient/body) -> Input/Output Clipping (anti-aliased) -> Output
 - **Key parameters:**
@@ -317,7 +317,7 @@
 ### Gain Rider
 
 - **Type:** M4L User (CLX_02) — by John Darque
-- **Load via:** `search_browser("Gain Rider", category="Audio Effects")`
+- **Load via:** `search_browser(path="audio_effects", name_filter="Gain Rider")`
 - **What it does:** Automatic gain riding plugin that continuously adjusts volume to maintain a target level. Like having an assistant moving the fader in real-time. Unlike compression, it uses slower, more natural-sounding level adjustment — no attack/release artifacts, no transient modification. Just smooth, consistent level.
 - **Signal flow:** Input -> Level Detection (LUFS or Peak) -> Calculate Compensation -> Apply Gain Adjustment -> Output
 - **Key parameters:**
@@ -337,7 +337,7 @@
 ### GMaudio Ducker 1.2
 
 - **Type:** M4L User (CLX_02) — by Groov Mekanik / Fixation Studios
-- **Load via:** `search_browser("GMaudio Ducker", category="Audio Effects")`
+- **Load via:** `search_browser(path="audio_effects", name_filter="GMaudio Ducker")`
 - **What it does:** Sample-accurate sidechain ducking tool specifically designed for bass/kick interaction. Uses transient detection (not traditional sidechain compression) to trigger an envelope that ducks bass during kick hits. Completely mutes bass during the kick transient for maximum clarity, then crossfades back. The precision tool for low-end management.
 - **Signal flow:** Input (Bass) -> Transient Detection (from Kick via sidechain or self) -> Envelope Generation -> Volume Duck with Adjustable Curve -> Release Crossfade -> Output
 - **Key parameters:**
@@ -358,7 +358,7 @@
 ### GMaudio PentaComp 1.0
 
 - **Type:** M4L User (CLX_02) — by Groov Mekanik / Fixation Studios
-- **Load via:** `search_browser("GMaudio PentaComp", category="Audio Effects")`
+- **Load via:** `search_browser(path="audio_effects", name_filter="GMaudio PentaComp")`
 - **What it does:** 5-band adaptive multiband compressor with 24 dB Linkwitz-Riley crossover network. Program-dependent algorithm automatically adjusts attack/release based on signal dynamics. Designed for transparent gain reduction across the full frequency spectrum. The precision multiband tool for mixing and mastering.
 - **Signal flow:** Input -> 5-Band Linkwitz-Riley Crossover (160 Hz, 800 Hz, 4 kHz, 11 kHz) -> Per-Band Program-Dependent Compression -> Per-Band Output Gain -> Sum -> Output
 - **Key parameters:**
@@ -380,7 +380,7 @@
 ### GMaudio Squeeze 1.1
 
 - **Type:** M4L User (CLX_02) — by Groov Mekanik / Fixation Studios
-- **Load via:** `search_browser("GMaudio Squeeze", category="Audio Effects")`
+- **Load via:** `search_browser(path="audio_effects", name_filter="GMaudio Squeeze")`
 - **What it does:** Multiband upward compressor/limiter. Normalizes audio by dividing incoming signals by detected peak levels. Ranges from subtle loudness enhancement to complete sonic destruction. Uses 6 dB dynamic phase crossovers for in-phase parallel processing. The "detail enhancer" — reveals hidden textures and micro-dynamics in any source.
 - **Signal flow:** Input -> 3-Band Split (6 dB crossovers at 300 Hz and 5 kHz) -> Per-Band Peak Detection -> Per-Band Upward Normalization (Floor to Ceiling) -> Style blending (single vs multiband) -> Mix (dry/wet) -> Output
 - **Key parameters:**
@@ -401,7 +401,7 @@
 ### jL3v3ll3r v1.2
 
 - **Type:** M4L User (CLX_02) — by jaspermarsalis (based on Dan Worrall's L3V3LL3R)
-- **Load via:** `search_browser("jL3v3ll3r", category="Audio Effects")`
+- **Load via:** `search_browser(path="audio_effects", name_filter="jL3v3ll3r")`
 - **What it does:** Recreation of a rare 1960s "Leveller" compressor. A leveling amplifier that works nearly all the time — not just when a threshold is reached. Offers two distinct response curves: logarithmic (standard) and opto/vactrol (photo-resistor simulation). Produces smooth, musical compression with vintage character. The "always-on, always-smoothing" compressor.
 - **Signal flow:** Input -> Highpass Filter (optional) -> Level Detection -> Response Curve (Log or Opto) -> Gain Reduction -> Output
 - **Key parameters:**
@@ -421,7 +421,7 @@
 ### LA2A
 
 - **Type:** M4L User (CLX_02) — by OspreyInstruments
-- **Load via:** `search_browser("LA2A", category="Audio Effects")`
+- **Load via:** `search_browser(path="audio_effects", name_filter="LA2A")`
 - **What it does:** M4L wrapper for the BPB Dirty LA optical compressor VST3 plugin. Emulates the classic Teletronix LA-2A leveling amplifier with its program-dependent opto compression behavior. Includes an approximate VU meter with realistic ballistics and deliberate harmonic distortion. Requires the free BPB Dirty LA plugin to be installed separately.
 - **Signal flow:** Input -> BPB Dirty LA VST3 (opto compression + tube saturation) -> Approximate VU Metering -> Output
 - **Key parameters:**
@@ -440,7 +440,7 @@
 ### N-CLIP
 
 - **Type:** M4L User (CLX_02) — by Nasko
-- **Load via:** `search_browser("N-CLIP", category="Audio Effects")`
+- **Load via:** `search_browser(path="audio_effects", name_filter="N-CLIP")`
 - **What it does:** Lightweight variable soft clipper with adjustable ceiling. Shaves off transient peaks using soft clipping rather than limiting — faster than a limiter, more transparent on transients, adds subtle harmonic content. The "invisible loudness" tool that lets you clip peaks before they hit a limiter, reducing the limiter's workload and preserving transient punch.
 - **Signal flow:** Input -> Drive -> Soft Clipping at Ceiling Threshold (variable knee) -> Output
 - **Key parameters:**
@@ -458,7 +458,7 @@
 ### Thomash Amplitude Receiver/Sender
 
 - **Type:** M4L User (CLX_02) — by voodoohop (thomash)
-- **Load via:** `search_browser("Thomash Amplitude", category="Audio Effects")` (load both Sender and Receiver)
+- **Load via:** `search_browser(path="audio_effects", name_filter="Thomash Amplitude")` (load both Sender and Receiver)
 - **What it does:** Two-device system that preserves the original amplitude envelope across an effects chain. The Sender captures the volume at one point; the Receiver (placed downstream after effects) adjusts gain to match the original level. Eliminates volume changes caused by effects — you can process audio through filters, delays, and EQs while maintaining the original dynamics. Like having an automatic "undo" for volume changes from effects.
 - **Signal flow:** [Sender captures level] -> Effects Chain (any number of effects) -> [Receiver restores original level with 512-sample latency]
 - **Key parameters:**

package/livepilot/skills/livepilot-core/references/device-atlas/eq-and-filtering.md

@@ -12,7 +12,7 @@
 ### EQ Eight
 
 - **Type:** Native
-- **Load via:** `find_and_load_device("EQ Eight")`
+- **Load via:** `find_and_load_device(track_index, "EQ Eight")`
 - **What it does:** Surgical 8-band parametric EQ with real-time spectrum analyzer. Clean, transparent, and precise. The workhorse EQ for mixing and sound design. Supports stereo, L/R, and Mid/Side processing modes.
 - **Signal flow:** Input -> 8 independent filter bands (series) -> Spectrum Analyzer -> Output. Each band has its own filter type, frequency, gain, and Q. In M/S mode the signal is encoded to mid+side, processed separately, then decoded back to stereo.
 - **Key parameters:**
@@ -37,7 +37,7 @@
 ### EQ Three
 
 - **Type:** Native
-- **Load via:** `find_and_load_device("EQ Three")`
+- **Load via:** `find_and_load_device(track_index, "EQ Three")`
 - **What it does:** Simple 3-band DJ-style EQ with kill switches. Modeled on mixer circuitry -- even at default settings it imparts a slight color. The gain knobs go to negative infinity (full kill). Designed for live performance, not surgical mixing.
 - **Signal flow:** Input -> 3-band crossover (split at FreqLow and FreqHi) -> independent gain per band -> sum -> Output. Each band has a kill switch that fully mutes that range.
 - **Key parameters:**
@@ -59,7 +59,7 @@
 ### Channel EQ
 
 - **Type:** Native
-- **Load via:** `find_and_load_device("Channel EQ")`
+- **Load via:** `find_and_load_device(track_index, "Channel EQ")`
 - **What it does:** Simple, musical 3-band EQ inspired by classic analog mixing consoles. Quick tonal shaping with minimal parameters. Built-in spectrum display. Very low CPU. Introduced in Live 10.
 - **Signal flow:** Input -> HP 80 Hz filter (optional) -> Low shelf (100 Hz) -> Mid peak (sweepable 120 Hz - 7.5 kHz) -> High shelf (with built-in LP rolloff when attenuating) -> Output gain -> Output.
 - **Key parameters:**
@@ -81,7 +81,7 @@
 ### Auto Filter
 
 - **Type:** Native
-- **Load via:** `find_and_load_device("Auto Filter")`
+- **Load via:** `find_and_load_device(track_index, "Auto Filter")`
 - **What it does:** Feature-rich resonant filter with envelope follower, LFO, and sidechain modulation. Models multiple analog circuit types. Massive sonic range from subtle warmth to aggressive screaming sweeps. Completely overhauled in Live 12.2 with new filter types and circuit models.
 - **Signal flow:** Input -> Drive/Saturation -> Filter (type + circuit model) -> Envelope Follower & LFO modulate cutoff -> Sidechain input (optional) -> Mix -> Output.
 
@@ -131,7 +131,7 @@
 ### Spectral Resonator
 
 - **Type:** Native (Live 11+ Suite only)
-- **Load via:** `find_and_load_device("Spectral Resonator")`
+- **Load via:** `find_and_load_device(track_index, "Spectral Resonator")`
 - **What it does:** Decomposes audio into spectral partials via FFT, then applies pitched resonance, stretching, and modulation in the frequency domain. Creates everything from shimmering harmonics to metallic drones to vocoder-like pitched effects. Can be played via MIDI sidechain for melodic control of the resonance.
 - **Signal flow:** Input -> FFT analysis -> Spectral processing (resonance at Freq/MIDI pitch, with Decay, Stretch, Shift applied to partials) -> Modulation (Chorus/Wander/Granular) -> IFFT resynthesis -> Dry/Wet mix -> Output.
 - **Key parameters:**
@@ -157,7 +157,7 @@
 ### Corpus
 
 - **Type:** Native
-- **Load via:** `find_and_load_device("Corpus")`
+- **Load via:** `find_and_load_device(track_index, "Corpus")`
 - **What it does:** Physical modeling resonator that simulates the acoustic behavior of resonant bodies. Excites a virtual physical object (beam, string, membrane, plate, pipe, tube, marimba bar) with the input signal. Adds tuned resonant character -- from subtle wooden warmth to full metallic ringing.
 - **Signal flow:** Input -> Band-pass filter (optional) -> Physical model resonator (left + right with independent listening positions) -> LFO modulation -> Bleed (dry signal mixed back) -> Gain/Limiter -> Dry/Wet -> Output.
 - **Key parameters:**
@@ -212,7 +212,7 @@
 ### Resonators
 
 - **Type:** Native
-- **Load via:** `find_and_load_device("Resonators")`
+- **Load via:** `find_and_load_device(track_index, "Resonators")`
 - **What it does:** Five parallel tuned delay lines that ring at set pitches, creating tonal resonance from any input. The input passes through a multi-mode filter first, then feeds all five resonators simultaneously. Each resonator is tuned relative to the first, making it easy to set up chord voicings. Turns noise, drums, and speech into pitched, ringing tones.
 - **Signal flow:** Input -> Multi-mode filter (LP/HP/BP/Notch) -> Resonator I (stereo) + Resonator II (left) + Resonator III (right) + Resonator IV (left) + Resonator V (right) in parallel -> Width control -> Output.
 - **Key parameters:**
@@ -248,7 +248,7 @@
 ### Vocoder
 
 - **Type:** Native
-- **Load via:** `find_and_load_device("Vocoder")`
+- **Load via:** `find_and_load_device(track_index, "Vocoder")`
 - **What it does:** Classic vocoder effect using parallel filter banks. Analyzes the modulator signal's spectral envelope and imposes it onto the carrier signal. The modulator provides the rhythm and articulation (typically voice or drums); the carrier provides the pitch and timbre (typically a synth). Creates robotic speech, harmonic rhythms, and spectral blending effects.
 - **Signal flow:** Modulator input -> Analysis filter bank (4-40 bands) -> Envelope followers extract amplitude per band -> Carrier input (Noise/External/Modulator/Pitch Tracking) -> Synthesis filter bank (same band count) -> Envelope followers control synthesis band levels -> Sum -> Formant shift -> Output.
 - **Key parameters:**
@@ -294,7 +294,7 @@
 ### 3-Band EQ (M4L by TheM)
 
 - **Type:** M4L User
-- **Load via:** `find_and_load_device("3-Band EQ")` (search user library)
+- **Load via:** `find_and_load_device(track_index, "3-Band EQ")` (search user library)
 - **What it does:** Zero-latency 3-band equalizer designed specifically for DJing. Fixes the phase distortion issues present in Ableton's native EQ Three (which can cause unwanted signal peaks at crossover points). Cleaner crossover behavior with adjustable frequency points.
 - **Signal flow:** Input -> 3-band crossover (adjustable FreqLow and FreqHi) -> independent gain per band -> Volume fader with adjustable curve -> Output.
 - **Key parameters:**
@@ -312,7 +312,7 @@
 ### GMaudio VSEQ 1.0 (M4L by groovmekanik)
 
 - **Type:** M4L User
-- **Load via:** `find_and_load_device("VSEQ")` or `find_and_load_device("GMaudio VSEQ")` (search user library)
+- **Load via:** `find_and_load_device(track_index, "VSEQ")` or `find_and_load_device(track_index, "GMaudio VSEQ")` (search user library)
 - **What it does:** Combines a dual-shelf EQ (the "V-Filter") with a 3-band multiband saturation engine. The V-Filter uses two first-order shelving filters centered at 700 Hz with automatic volume compensation. The saturation splits the signal into 3 bands, each feeding a separate wave-shaper to generate distinct overtones. Includes 4x oversampling to minimize aliasing. Designed as a "tone + harmonics" channel strip tool.
 - **Signal flow:** Input -> V-Filter (low shelf + high shelf at 700 Hz pivot, with auto-gain compensation) -> [EQ Mode switch: filter can apply to original signal OR to saturation input only] -> 3-band multiband saturation (3 independent wave-shapers) -> Colour control (harmonic balance) -> Output.
 - **Key parameters:**
@@ -330,7 +330,7 @@
 ### REW EQ by Iftah (M4L)
 
 - **Type:** M4L User
-- **Load via:** `find_and_load_device("REW EQ")` (search user library)
+- **Load via:** `find_and_load_device(track_index, "REW EQ")` (search user library)
 - **What it does:** Imports filter settings from Room EQ Wizard (.txt export files) and applies them as parametric EQ corrections inside Ableton. Visualizes the imported EQ curve. Designed for studio monitoring correction -- measure your room with REW, export the correction filters, import into this device on your master bus to hear a corrected response while mixing.
 - **Signal flow:** Import REW .txt filter file -> Parse PK (peak) filter parameters -> Apply as parametric EQ bands -> Output with corrected frequency response.
 - **Key parameters:**
@@ -347,7 +347,7 @@
 ### Cat Growl Filter (M4L by Nick Holiday)
 
 - **Type:** M4L User
-- **Load via:** `find_and_load_device("Cat Growl Filter")` (search user library)
+- **Load via:** `find_and_load_device(track_index, "Cat Growl Filter")` (search user library)
 - **What it does:** Multi-purpose FX rack designed for aggressive, characterful filter sweeps. Features a custom dual-channel filter (independent L/R) with 8 interchangeable filter types per channel. The channels can move in sync or independently. Built for bass music, dubstep growls, and aggressive sound design. Includes 10 pre-mapped macros for quick performance control.
 - **Signal flow:** Input -> Dual-channel filter (L and R processed independently or synced) -> FX modules (series of carefully tuned processors that enhance the "growl" character) -> Macro-controlled parameters -> Output.
 - **Key parameters:**
@@ -365,7 +365,7 @@
 ### Stretta Filter Sequencer (M4L by Matthew Davidson / stretta)
 
 - **Type:** M4L User
-- **Load via:** `find_and_load_device("Filter Sequencer")` or `find_and_load_device("Step Filter")` (search user library)
+- **Load via:** `find_and_load_device(track_index, "Filter Sequencer")` or `find_and_load_device(track_index, "Step Filter")` (search user library)
 - **What it does:** Eight independent step sequencers, each controlling a bandpass filter. Originally designed as a monome controller app for a Doepfer vocoder filter bank, now has the filter bank built-in. Each of the 8 bandpass filters can have a different loop length, creating polymetric rhythmic filtering patterns. Essentially a rhythmic vocoder-like effect driven by step sequencing rather than a modulator signal.
 - **Signal flow:** Input -> 8 parallel bandpass filters -> each filter's amplitude is sequenced by its own step sequencer (independent loop lengths) -> Sum of filtered outputs -> Output.
 - **Key parameters:**

package/livepilot/skills/livepilot-core/references/device-atlas/midi-tools.md

@@ -10,7 +10,7 @@
 
 ### Arpeggiator
 - **Type:** Native
-- **Load via:** `find_and_load_device("Arpeggiator")`
+- **Load via:** `find_and_load_device(track_index, "Arpeggiator")`
 - **What it does:** Takes held notes/chords and plays them as a rhythmic pattern, cycling through pitches in the chosen style at the set rate.
 - **Key parameters:**
   - **Style** — Up, Down, UpDown, DownUp, Converge, Diverge, Con+Diverge, PinkyUp, PinkyUpDown, ThumbUp, ThumbUpDown, Play Order, Chord Trigger, Random, Random Other, Random Once. Sweet spot: *Random Other* for melodies that don't repeat until all notes are used; *Converge* for cinematic builds.
@@ -32,7 +32,7 @@
 
 ### Chord
 - **Type:** Native
-- **Load via:** `find_and_load_device("Chord")`
+- **Load via:** `find_and_load_device(track_index, "Chord")`
 - **What it does:** Adds up to 6 parallel notes (intervals) to every incoming MIDI note, instantly building chords from single keys.
 - **Key parameters:**
   - **Shift 1-6** — Each adds a note at +/-36 semitones (or scale degrees with Use Current Scale). Set to +4, +7 for major triads; +3, +7 for minor.
@@ -51,7 +51,7 @@
 
 ### Note Echo
 - **Type:** Native
-- **Load via:** `find_and_load_device("Note Echo")`
+- **Load via:** `find_and_load_device(track_index, "Note Echo")`
 - **What it does:** Creates MIDI note echoes (delays) with pitch transposition and velocity decay per repeat. The MIDI equivalent of a delay effect.
 - **Key parameters:**
   - **Input** — Thru (original + echoes) or Mute (echoes only).
@@ -69,7 +69,7 @@
 
 ### Note Length
 - **Type:** Native
-- **Load via:** `find_and_load_device("Note Length")`
+- **Load via:** `find_and_load_device(track_index, "Note Length")`
 - **What it does:** Forces all MIDI notes to a specific duration regardless of how long keys are held, or triggers on note-off events.
 - **Key parameters:**
   - **Trigger** — Note On or Note Off. Note Off mode enables release-based triggering (useful for ghost notes, percussion).
@@ -89,7 +89,7 @@
 
 ### Pitch
 - **Type:** Native
-- **Load via:** `find_and_load_device("Pitch")`
+- **Load via:** `find_and_load_device(track_index, "Pitch")`
 - **What it does:** Transposes all incoming MIDI notes by a fixed interval. Simplest pitch-shifting tool.
 - **Key parameters:**
   - **Pitch** — +/-128 semitones (or +/-30 scale degrees with Use Current Scale). +12 = octave up, +7 = fifth up.
@@ -106,7 +106,7 @@
 
 ### Random
 - **Type:** Native
-- **Load via:** `find_and_load_device("Random")`
+- **Load via:** `find_and_load_device(track_index, "Random")`
 - **What it does:** Randomly alters pitch of incoming MIDI notes within a defined range and probability.
 - **Key parameters:**
   - **Chance** — 0-100% probability of randomization. 0% = pass-through, 100% = every note randomized. Sweet spot: 30-60% for subtle variation.
@@ -124,7 +124,7 @@
 
 ### Scale
 - **Type:** Native
-- **Load via:** `find_and_load_device("Scale")`
+- **Load via:** `find_and_load_device(track_index, "Scale")`
 - **What it does:** Forces all incoming MIDI notes into a specific musical scale by remapping out-of-scale notes to the nearest in-scale pitch.
 - **Key parameters:**
   - **Base** — Root note of the scale (C through B).
@@ -142,7 +142,7 @@
 
 ### Velocity
 - **Type:** Native
-- **Load via:** `find_and_load_device("Velocity")`
+- **Load via:** `find_and_load_device(track_index, "Velocity")`
 - **What it does:** Reshapes MIDI velocity values through curve manipulation, compression, expansion, randomization, and range limiting.
 - **Key parameters:**
   - **Operation** — Process Note On, Note Off, or both.
@@ -161,7 +161,7 @@
 
 ### CC Control
 - **Type:** Native (Live 12+)
-- **Load via:** `find_and_load_device("CC Control")`
+- **Load via:** `find_and_load_device(track_index, "CC Control")`
 - **What it does:** Sends and automates MIDI CC messages to hardware synths, software instruments, or other MIDI devices. A dedicated CC automation surface.
 - **Key parameters:**
   - **Mod Wheel** — CC 1 control.
@@ -181,7 +181,7 @@
 
 ### Expression Control
 - **Type:** Native (Live 12+)
-- **Load via:** `find_and_load_device("Expression Control")`
+- **Load via:** `find_and_load_device(track_index, "Expression Control")`
 - **What it does:** Maps incoming MIDI expression data (velocity, mod wheel, pitch bend, aftertouch, keytrack) to any parameter in your Live set with custom transformation curves.
 - **Key parameters:**
   - **Input Sources** — Velocity, Modwheel, Pitchbend, Pressure (aftertouch), Keytrack, Expression, Random, Increment, Slide, Sustain.
@@ -200,7 +200,7 @@
 
 ### Shaper MIDI
 - **Type:** Native (Live 12+)
-- **Load via:** `find_and_load_device("Shaper MIDI")`
+- **Load via:** `find_and_load_device(track_index, "Shaper MIDI")`
 - **What it does:** Generates custom multi-breakpoint modulation envelopes that can be mapped to up to 8 parameters. Triggered by MIDI notes or free-running.
 - **Key parameters:**
   - **Breakpoint display** — Click to add points, Shift-click to delete, Alt/Option-drag for curves.
@@ -221,7 +221,7 @@
 
 ### Envelope MIDI
 - **Type:** Native (Live 12+)
-- **Load via:** `find_and_load_device("Envelope MIDI")`
+- **Load via:** `find_and_load_device(track_index, "Envelope MIDI")`
 - **What it does:** Generates ADSR-style or custom envelopes triggered by MIDI notes, outputting modulation data to mapped parameters. Velocity-sensitive envelope shaping.
 - **Key parameters:**
   - **Attack / Decay / Sustain / Release** — Standard ADSR envelope controls.
@@ -239,7 +239,7 @@
 
 ### MIDI Monitor
 - **Type:** Native (M4L, included with Suite)
-- **Load via:** `find_and_load_device("MIDI Monitor")`
+- **Load via:** `find_and_load_device(track_index, "MIDI Monitor")`
 - **What it does:** Displays incoming MIDI data in real time for debugging. Shows notes, velocities, CCs, pitch bend, aftertouch, and MPE data.
 - **Key parameters:**
   - **Note Display** — Keyboard layout showing incoming notes, root note, and chord detection.