livepilot 1.4.2 → 1.4.4

package/plugin/skills/livepilot-core/references/device-atlas/utility-and-workflow.md

@@ -0,0 +1,843 @@
+# Utility & Workflow — Device Atlas
+
+> Deep reference for every utility, metering, mapping, routing, navigation, and workflow device available in this Ableton Live 12 installation.
+> Covers native devices and User M4L collections: CLX_01 QOL GUI, Robert Henke, Suzuki Kentaro, S8JFOU, and Alexkid.
+
+---
+
+## Native Ableton Devices
+
+---
+
+### Utility
+
+- **Type:** Native Audio Effect
+- **Load via:** `find_and_load_device("Utility")`
+- **What it does:** Swiss-army channel-strip tool for gain staging, stereo-width control, phase correction, channel routing, and bass mono summing. Does not color the signal -- purely transparent signal management.
+- **Key parameters:**
+  - **Gain** (-35 dB to +35 dB) -> volume offset independent of track fader -> use for gain staging between devices, A/B loudness matching
+  - **Width** (0% to 200%) -> stereo field control -> 0% = full mono, 100% = unchanged stereo, >100% exaggerates side content, 200% = side-only (L-R difference signal)
+  - **Phz-L / Phz-R** (on/off toggles) -> flip polarity of left/right channel independently -> use to fix phase issues from multi-mic recordings, or creative stereo widening by inverting one channel
+  - **Channel Mode** (Stereo / Left / Right / Swap) -> Stereo = passthrough, Left = left channel to both outputs, Right = right to both outputs, Swap = flip L/R. When Left or Right is selected, Width control is disabled.
+  - **Panorama** (full L to full R) -> stereo pan position -> use post-fader for final placement, or pre-effects for creative routing
+  - **Mute** (on/off) -> silences output entirely -> useful for automation-driven muting without touching track volume
+  - **DC Filter** (on/off) -> removes DC offset and sub-infrasonic content -> enable on tracks with analog gear or poorly recorded audio
+  - **Bass Mono** (on/off + frequency selector) -> sums everything below the chosen crossover frequency to mono -> use at 100-200 Hz on bass-heavy tracks or the master to ensure mono-compatible low end for club playback
+- **Reach for this when:** gain staging between effects, checking mono compatibility, collapsing bass to mono, fixing phase, isolating L/R channels, silent A/B comparisons (automate Mute), creative stereo manipulation
+- **Pairs well with:** EQ Eight (tonal shaping after gain staging), Compressor (level-match before/after), Spectrum (visual verification of width changes)
+
+---
+
+### Tuner
+
+- **Type:** Native Audio Effect
+- **Load via:** `find_and_load_device("Tuner")`
+- **What it does:** Chromatic pitch detector with real-time visual display. Shows detected note name, octave, and cents deviation. Zero processing -- purely a measurement tool that passes audio through unchanged.
+- **Key parameters:**
+  - **Reference Pitch** (adjustable Hz for concert A) -> default 440 Hz, adjustable for alternative tuning standards (e.g., 432 Hz, baroque 415 Hz)
+  - **Tuning System** (Live 12.1+) -> respects the project's selected tuning system for microtonal work
+  - **Display** -> shows note name, octave number, and deviation in cents from the nearest pitch
+- **Reach for this when:** tuning guitars/bass/vocals before recording, verifying sample pitch for key-matching, checking synthesizer calibration, identifying unknown notes in a sample
+- **Pairs well with:** Spectrum (frequency analysis alongside pitch detection), EQ Eight (corrective work after identifying problem notes)
+
+---
+
+### Spectrum
+
+- **Type:** Native Audio Effect (measurement only)
+- **Load via:** `find_and_load_device("Spectrum")`
+- **What it does:** Real-time FFT spectrum analyzer showing frequency content from 20 Hz to 20 kHz. Passes audio through unchanged. Essential visual reference for mixing decisions.
+- **Key parameters:**
+  - **Block Size** (adjustable) -> determines FFT resolution -> larger = smoother curves with better frequency resolution, smaller = faster response showing transient peaks
+  - **Channel** (L, R, L+R, Mid, Side) -> choose which signal component to analyze -> Mid/Side mode reveals stereo imaging issues, especially in the low end
+  - **Slope** (-3 dB/oct, -4.5 dB/oct, 0 dB) -> tilt the display curve -> use slope to approximate equal-loudness perception (pink noise reference)
+  - **Smoothing** -> averages the display over time for clearer trend reading
+  - **Range** (dB range of the display) -> adjust dynamic range visibility
+  - **Freeze** -> captures the current spectrum for static analysis
+  - **Peak Hold** -> retains peak values for identifying resonances
+  - **Average** -> shows averaged spectrum over time
+- **Reach for this when:** identifying frequency masking between elements, checking low-end balance, verifying EQ moves, analyzing stereo field distribution (Mid/Side mode), finding resonant peaks that need notching
+- **Pairs well with:** EQ Eight (visual verification of EQ moves), Utility (Width + Spectrum Mid/Side for stereo diagnostics)
+
+---
+
+## User M4L -- CLX_01 QOL GUI Collection
+
+---
+
+## Metering & Analysis
+
+---
+
+### Multi Analyser XL 1.4
+
+- **Type:** M4L Audio Effect (measurement)
+- **Load via:** `find_and_load_device("Multi Analyser XL 1.4")`
+- **What it does:** Multi-track spectrum analyzer that overlays frequency content from multiple tracks in a single large floating window. Leverages Live 10+ multichannel M4L audio routing to pull signals from across the session.
+- **Key features:**
+  - Large floating window that stays visible while selecting different tracks
+  - Per-track channel routing: Pre FX, Post FX, or Post Mixer tap point selection
+  - Per-track L/R/Summed output selection
+  - Overlay multiple track spectra simultaneously for comparison
+  - Color-coded per-track display
+- **Reach for this when:** you need to visually identify frequency clashes between kick and bass, compare spectral balance across multiple mix elements, or monitor overall frequency distribution during mixing without switching between tracks
+- **Pairs well with:** EQ Eight (make surgical cuts based on what the analyser reveals), Utility (check mono vs stereo content)
+
+---
+
+### Swiss Army Meter
+
+- **Type:** M4L Audio Effect (measurement)
+- **Load via:** `find_and_load_device("Swiss Army Meter")`
+- **What it does:** All-in-one metering device combining loudness, peak, phase, and tempo-conversion tools in a single compact interface. ITU-R BS.1770 and EBU R128 compliant.
+- **Key features:**
+  - **Short-Term LUFS** -> rolling 3-second loudness window
+  - **Integrated LUFS** -> long-term average loudness (the number streaming platforms use)
+  - **Momentary Max LUFS** -> peak loudness moment
+  - **LRA** (Loudness Range) -> dynamic range measurement
+  - **True Peak** -> inter-sample peak detection
+  - **RMS and Current Peak dB** -> traditional peak/RMS metering
+  - **Phase Correlation meter** -> stereo phase relationship (-1 to +1)
+  - **BPM to MS/Hz converter** -> calculate delay times and frequencies from tempo
+  - Fully customizable display layout -- choose which meters to show and their position
+  - MIDI/key-mappable pop-out window for viewing when the track is not selected
+- **Reach for this when:** mastering to streaming platform targets (Spotify -14 LUFS, YouTube -14 LUFS, Apple -16 LUFS), checking phase correlation on stereo buses, calculating tempo-synced delay times, quick loudness reference during mixing
+- **Pairs well with:** Limiter (meter before/after to verify loudness target), Utility (phase flip to test correlation), Compressor (verify gain reduction impact on LUFS)
+
+---
+
+### VU Meter
+
+- **Type:** M4L Audio Effect (measurement)
+- **Load via:** `find_and_load_device("VU Meter")`
+- **What it does:** RMS meter with slow attack/release emulating analog VU meter behavior. Calibrated to -18 dBFS = 0 VU (broadcast standard). Not a loudness meter -- a gain staging reference tool.
+- **Key features:**
+  - Split view for L/R or Mid/Side channels simultaneously
+  - Adjustable attack/release time and nominal reference level
+  - Phase correlation meter (L/R)
+  - Floating window mode
+  - Analog-modeled needle ballistics
+- **Reach for this when:** gain staging to a consistent -18 dBFS reference before mixing, monitoring average levels rather than peaks, establishing headroom before the master chain
+- **Pairs well with:** Utility (adjust gain to target the 0 VU sweet spot), Compressor (verify compression amount by watching VU needle movement)
+
+---
+
+### Meter2
+
+- **Type:** M4L Audio Effect (measurement)
+- **Load via:** `find_and_load_device("Meter2")`
+- **What it does:** Compact metering utility providing additional visual feedback for level monitoring. A lightweight alternative when Swiss Army Meter or VU Meter are overkill.
+- **Key features:**
+  - Peak and RMS level display
+  - Compact interface footprint
+- **Reach for this when:** quick visual level check on a track without the overhead of a full metering suite
+- **Pairs well with:** Utility (gain staging), Compressor (monitoring output levels)
+
+---
+
+### DIFF Devices Aspect II
+
+- **Type:** M4L Audio Effect (measurement + reference playback)
+- **Load via:** `find_and_load_device("DIFF Devices Aspect II")`
+- **What it does:** Mix reference and analysis workstation. Drag-and-drop reference tracks, A/B compare your mix against commercial releases with volume-matched switching, and analyze spectral/loudness differences.
+- **Key features:**
+  - Drag-and-drop reference track loading with loop and playlist support
+  - A/B volume gain matching for honest comparison
+  - Spectrum analysis with 11 genre-specific target curves
+  - Goniometer (stereo imaging display)
+  - LUFS and peak metering with up to 8 loudness target presets
+  - Correlation analysis for phase checking
+  - Filter isolation (LP, HP, BP) for frequency-band comparison
+  - Mono and Side listening modes
+  - Spectrum freeze for static comparison
+  - Resizable UI
+- **Reach for this when:** referencing your mix against commercial tracks, checking if your spectral balance matches genre expectations, verifying stereo imaging and loudness relative to a target, mastering sessions where A/B against references is critical
+- **Pairs well with:** EQ Eight (adjust tonal balance based on reference comparison), Limiter (loudness matching to reference), Utility (mono check alongside Aspect's analysis)
+
+---
+
+## Volume & Gain
+
+---
+
+### Volume Buddy 2.5.2
+
+- **Type:** M4L Audio Effect
+- **Load via:** `find_and_load_device("Volume Buddy 2.5.2")`
+- **What it does:** Auto-gain compensation plugin that matches pre-effect and post-effect perceived loudness using LUFS measurement. Eliminates the volume bias when evaluating effects -- louder always sounds "better" to untrained ears.
+- **Key features:**
+  - Automatic LUFS-based gain matching between pre/post effect chains
+  - All routing within a single plugin (no send/receive pair needed)
+  - **Target Mode** -> specify a LUFS level and Volume Buddy auto-adjusts to maintain it
+  - Works with VST, AU, and native Ableton effects
+- **Reach for this when:** A/B testing effects without volume bias, maintaining consistent perceived loudness while stacking plugins, gain staging to a target LUFS during mixing
+- **Pairs well with:** any effect chain where you need honest before/after comparison, Compressor and EQ chains where loudness differences mask quality judgment
+
+---
+
+### ClipGain
+
+- **Type:** M4L Audio Effect
+- **Load via:** `find_and_load_device("ClipGain")`
+- **What it does:** Floating popup window for adjusting clip gain, transpose, warp mode, launch mode, and other clip properties directly from the timeline without opening Clip Detail View. Triggered by keyboard shortcut or MIDI mapping.
+- **Key features:**
+  - Context-sensitive popup at mouse cursor position
+  - Clip gain adjustment with configurable increment/decrement shortcuts
+  - Pitch/transpose control
+  - Warp mode selection (Complex, Texture, Beats, Rex, etc.) for audio clips
+  - Launch mode, legato, quantization controls
+  - RAM mode toggling and clip muting
+  - MIDI clip cropping and length adjustment
+  - Works in both Arrangement and Session View
+  - Mira/MiraWeb support for tablet/phone control
+- **Reach for this when:** adjusting clip volumes across arrangement without opening each clip, batch-adjusting warp modes, quick transpose from the timeline, any workflow where opening Clip Detail View breaks your flow
+- **Pairs well with:** arrangement editing workflow, Utility (for track-level gain vs clip-level gain)
+
+---
+
+### 1000% Knob
+
+- **Type:** M4L MIDI Effect
+- **Load via:** `find_and_load_device("1000% Knob")`
+- **What it does:** Precision parameter mapper that controls any parameter in Ableton with 1/1000 increment resolution. Extends beyond the standard 0-127 MIDI resolution for ultra-fine parameter adjustments.
+- **Key features:**
+  - Map and control any parameter across any plugin, synth, or effect
+  - 1/1000 increment precision (far beyond 128-step MIDI resolution)
+  - Works on both MIDI and Audio tracks
+  - Zero latency, no audio degradation
+  - Expandable beyond 8 routing assignments via CV Utility or MultiMap_button
+- **Reach for this when:** you need extremely fine-grained control over a parameter (e.g., subtle filter sweeps, precise reverb decay tuning), standard MIDI mapping resolution is too coarse
+- **Pairs well with:** any synth or effect where parameter resolution matters, MIDI Shaper 2 for automated fine modulation
+
+---
+
+## Mapping & Control
+
+---
+
+### Live Mapper
+
+- **Type:** M4L MIDI Effect
+- **Load via:** `find_and_load_device("Live Mapper")`
+- **What it does:** Parameter mapping utility that extends Ableton's native mapping capabilities. Maps device parameters to controllable knobs with flexible routing options.
+- **Key features:**
+  - Map-and-control paradigm for any Live parameter
+  - Extended mapping targets beyond native MIDI Map mode
+  - Visual feedback of mapped parameter states
+- **Reach for this when:** native MIDI Map mode is too limited, you need more flexible parameter routing, building custom control surfaces
+- **Pairs well with:** Push controller, external MIDI hardware, MultiMapper devices for expanded mapping
+
+---
+
+### MultiMapper16 V2.0
+
+- **Type:** M4L MIDI Effect
+- **Load via:** `find_and_load_device("MultiMapper16 V2.0")`
+- **What it does:** 16-knob macro mapper that maps multiple Live parameters to 16 individually controllable dials. Parameter mapping uses min/max percentages rather than raw 0-127 values for more musical control.
+- **Key features:**
+  - 16 mappable knobs with 0-127 value display
+  - Min/max percentage mapping per parameter
+  - Preset recall (stores/recalls knob positions)
+  - Works with Push and other 8-knob controllers
+- **Limitations:** One parameter per knob (no multi-assign), only one instance per Set, preset swaps do not swap mappings
+- **Reach for this when:** you need more than 8 macro controls, building custom performance interfaces, mapping parameters across multiple devices to a single control surface
+- **Pairs well with:** Push 2/3, external MIDI controllers, Instrument/Effect Racks
+
+---
+
+### MultiMapper32Audio V2.7
+
+- **Type:** M4L Audio Effect
+- **Load via:** `find_and_load_device("MultiMapper32Audio V2.7")`
+- **What it does:** 32-knob audio-rate macro mapper with editable response curves. Audio version that can be nested inside racks alongside the effects it controls.
+- **Key features:**
+  - 32 mappable parameters (double the 16-knob version)
+  - Editable response curves per mapping for nonlinear control (exponential, logarithmic, S-curves)
+  - Audio Effect format -- can sit inside a rack with the effects it controls
+  - Compact interface despite 32 dials
+- **Reach for this when:** complex performance setups requiring 32+ parameter mappings, need custom response curves for musical control feel, building elaborate effect racks with deep macro control
+- **Pairs well with:** Instrument Racks, Audio Effect Racks, Push for tactile control
+
+---
+
+### The Poser
+
+- **Type:** M4L MIDI Effect
+- **Load via:** `find_and_load_device("The Poser")`
+- **What it does:** MIDI transposition tool with six adjustable pitch-shift presets for instant performance. Place before an arpeggiator to quickly shift pitch during live play via preset buttons.
+- **Key features:**
+  - Six transposition presets with adjustable values
+  - Hold functionality for sustained transpositions
+  - Designed for live performance -- instant pitch changes via button press
+  - Works best upstream of Live's Arpeggiator
+- **Reach for this when:** live performance requiring instant key/octave jumps, working with arpeggiators where you want rapid transposition changes, jamming and improvisation
+- **Pairs well with:** Arpeggiator (place before it), Scale MIDI effect, any synth instrument
+
+---
+
+### ButtonMacro
+
+- **Type:** M4L MIDI/Audio Effect
+- **Load via:** `find_and_load_device("ButtonMacro")`
+- **What it does:** Button-based macro controller that triggers parameter changes via discrete button presses rather than continuous knobs. Instant state switching for mapped parameters.
+- **Key features:**
+  - Button-triggered parameter control (on/off or multi-state)
+  - MIDI/key-mappable buttons
+  - Compact interface for dense control layouts
+- **Reach for this when:** you need discrete state switching (e.g., toggle effects, jump between parameter values), button-based performance setups, building custom control panels
+- **Pairs well with:** Effect Racks (toggle chain selections), FXbypass (complement with button-triggered bypasses)
+
+---
+
+## Routing & I/O
+
+---
+
+### Insist / Outist
+
+- **Type:** M4L Audio Effect (pair of devices)
+- **Load via:** `find_and_load_device("Insist")` / `find_and_load_device("Outist")`
+- **What it does:** Outist routes audio from its track to any internal or external destination. Insist receives audio from any source into its track. Together they break Live's normal routing restrictions, enabling pre/post send per return, cross-track audio routing, and feedback loops.
+- **Key features:**
+  - **Outist:** drop-down to select any destination (return tracks, physical outputs, other tracks)
+  - **Insist:** drop-down to select any audio source from anywhere in the Set
+  - Uses Live API routing (not Max audio objects) -- zero quality loss, bit-identical to source
+  - Pre and post send to return channels (bypasses Live's fixed return bus)
+  - Can create feedback routing loops (use with caution)
+  - Free to use
+- **Reach for this when:** routing audio to destinations Live's built-in routing cannot reach, creating pre-fader sends, building parallel processing chains without racks, sending audio to specific physical outputs, advanced feedback delay networks
+- **Pairs well with:** Return tracks, external hardware setups, creative delay/reverb feedback routing
+
+---
+
+### FXbypass
+
+- **Type:** M4L Audio Effect
+- **Load via:** `find_and_load_device("FXbypass")`
+- **What it does:** Bypasses all effects on a track without deactivating them. Avoids CPU spikes from toggling device states and preserves automation. Audition the dry signal while sends remain active.
+- **Key features:**
+  - FX ON button to toggle between processed and dry signal
+  - Bypasses without deactivating (no CPU spikes, no broken automations)
+  - Option to hear dry signal with or without sends
+  - Per-track control for granular A/B testing
+- **Reach for this when:** A/B testing your effect chain against the dry signal, comparing mix decisions without disrupting CPU or automation, quick reality checks during mixing
+- **Pairs well with:** FXGlobal (master controller), Volume Buddy (loudness-match the A/B comparison)
+
+---
+
+### FXGlobal
+
+- **Type:** M4L Audio Effect
+- **Load via:** `find_and_load_device("FXGlobal")`
+- **What it does:** Master controller for all FXbypass instances in the session. Place on the master track to simultaneously bypass/enable effects across all tracks that have FXbypass loaded.
+- **Key features:**
+  - Single-button control of all FXbypass instances
+  - Place on master track for global scope
+  - Automatable for arrangement-level A/B sections
+- **Reach for this when:** you want to hear your entire mix dry vs processed in one click, arrangement automation of global bypass states, mixing sessions where you need frequent full-chain A/B
+- **Pairs well with:** FXbypass (required on individual tracks), Utility on master (level-match the global A/B)
+
+---
+
+## Navigation & Workflow
+
+---
+
+### HYPERSPEED_3
+
+- **Type:** M4L MIDI/Audio Effect
+- **Load via:** `find_and_load_device("HYPERSPEED_3")`
+- **What it does:** Global pitch shifter that transposes every MIDI and audio clip in the session simultaneously with a single knob, adjusting tempo to match. Instant key change for the entire project.
+- **Key features:**
+  - One-knob global pitch shift across all clips (MIDI + audio)
+  - Automatic tempo adjustment to compensate for pitch change
+  - Semitone-based transposition
+- **Reach for this when:** you want to hear your entire session in a different key, creative exploration of key changes, matching a vocalist's range by shifting everything, live performance key changes
+- **Pairs well with:** any instrument or audio clip in the session, Tuner (verify resulting pitch)
+
+---
+
+### Shortcut Buddy 3.0.2
+
+- **Type:** M4L Audio Effect
+- **Load via:** `find_and_load_device("Shortcut Buddy 3.0.2")`
+- **What it does:** Quick-insert launcher for up to 64 plugins/effects/racks via keyboard shortcuts or MIDI mappings. Eliminates browser navigation for frequently used devices.
+- **Key features:**
+  - 64 assignable plugin slots
+  - Key command and MIDI mapping per slot
+  - Supports VST Presets, AU Presets, .adg, .adv, .amxd files
+  - Loads onto the currently selected track
+  - Low CPU usage
+  - Save with default template for always-on access
+- **Limitations:** Can be unreliable with some third-party plugins; VST preset loading consistency varies
+- **Reach for this when:** you have a core set of go-to plugins and want one-button insertion, speed up creative flow by avoiding browser browsing, building a personalized device palette
+- **Pairs well with:** LoadeR (complementary loader with different approach), any frequently used plugins
+
+---
+
+### LoadeR
+
+- **Type:** M4L Audio Effect
+- **Load via:** `find_and_load_device("LoadeR")`
+- **What it does:** 12-slot device loader triggered by keyboard shortcuts, MIDI, or touchscreen (Mira/MiraWeb). Unlike Shortcut Buddy, does not require pre-racking of AU/VST3 plugins.
+- **Key features:**
+  - 12 assignable slots for instruments, effects, VST/AU plugins
+  - Direct AU/VST3 loading without preset grouping (saves as .aupreset/.vstpreset)
+  - Configurable insertion position (left of, right of, or last in chain)
+  - Multiple simultaneous instances allowed
+  - Touchscreen support via Mira/MiraWeb
+  - Apple Silicon compatible
+- **Limitations:** VST2 still requires grouping/racking; mouse-clicking slots causes duplication (designed for shortcut triggers only)
+- **Reach for this when:** rapid device insertion during creative sessions, mobile/tablet-based studio control, you prefer a simpler 12-slot approach over Shortcut Buddy's 64 slots
+- **Pairs well with:** Shortcut Buddy (use both for different device tiers), any plugin workflow
+
+---
+
+### Folder V1
+
+- **Type:** M4L MIDI/Audio Effect
+- **Load via:** `find_and_load_device("Folder V1")`
+- **What it does:** Fold/unfold group tracks with a single button press. Streamlines navigation in complex sessions with many nested groups.
+- **Key features:**
+  - One-click group fold/unfold toggle
+  - Works with nested group tracks
+  - Compact interface -- minimal screen footprint
+  - Free
+- **Reach for this when:** orchestral templates or large sessions with many groups, you want mapped buttons to fold/unfold specific sections, keyboard/MIDI control of session layout visibility
+- **Pairs well with:** large session templates, Set Namer/Set Selector for project management
+
+---
+
+### open file
+
+- **Type:** M4L Audio Effect
+- **Load via:** `find_and_load_device("open file")`
+- **What it does:** Quick file opener utility that provides direct OS-level file access from within Live. Opens files or folders associated with the session or project.
+- **Key features:**
+  - Direct file/folder access from within Ableton
+  - Reduces context-switching to Finder/Explorer
+- **Reach for this when:** you need to quickly access project folders, stems, or reference files without leaving Ableton
+- **Pairs well with:** session organization workflow, Clip-Exporter (navigate to exported files)
+
+---
+
+### Advanced Toolbar Buttons
+
+- **Type:** M4L Audio Effect
+- **Load via:** `find_and_load_device("Advanced Toolbar Buttons")`
+- **What it does:** Adds a customizable floating button bar with additional controls not available in Live's standard interface. Position anywhere on screen with transparent background.
+- **Key features:**
+  - Customizable button configurations on a floating toolbar
+  - Clip parameter adjustment without opening Clip Detail (volume, transposition, groove)
+  - Global track activation/deactivation
+  - Alternative loop marker controls for arrangement
+  - One-button Live color theme switching
+  - Access to context-menu-only actions via single button
+  - Multiple toolbar configurations
+- **Limitations:** Windows-only for full functionality (v1.0 has limited Mac support)
+- **Reach for this when:** you want quick access to buried Live features, need floating controls for clip parameters, want to streamline repetitive menu actions into button presses
+- **Pairs well with:** any complex arrangement workflow, Shortcut Buddy (keyboard shortcuts + toolbar buttons = maximum speed)
+
+---
+
+## Track Management
+
+---
+
+### Set Namer / Set Selector
+
+- **Type:** M4L MIDI Effect (pair of devices, part of HELPERS collection)
+- **Load via:** `find_and_load_device("Set Namer")` / `find_and_load_device("Set Selector")`
+- **What it does:** Set Namer generates creative project names from thousands of word combinations drawn from real song titles. Set Selector randomly picks a recent project for you to work on. Both fight decision fatigue.
+- **Key features:**
+  - **Set Namer:** one-click random project name generation with thousands of combinations
+  - **Set Selector:** randomly selects from your recent projects to overcome choice paralysis
+  - Part of HELPERS -- a 5-tool workflow utility collection by ELPHNT
+- **Reach for this when:** starting new projects and you are stuck on naming, choosing which WIP to revisit, reducing creative friction at session start
+- **Pairs well with:** NotePad (document what the generated name means to you), session start rituals
+
+---
+
+### Renamer
+
+- **Type:** M4L Audio Effect
+- **Load via:** `find_and_load_device("Renamer")`
+- **What it does:** Batch clip renamer for quickly renaming multiple clips across tracks in both Session and Arrangement views. Eliminates tedious one-by-one renaming.
+- **Key features:**
+  - Batch rename multiple clips simultaneously
+  - Works in Session View and Arrangement View (v1.1+)
+  - Streamlined naming workflow
+- **Reach for this when:** organizing sessions after recording (rename all clips to meaningful names), preparing stems for export, cleaning up imported audio
+- **Pairs well with:** Clip-Renamer by Kentaro (more advanced batch rename), Clip-Exporter (rename then export)
+
+---
+
+### 8 Buttons / 8 Buttons R / 9B
+
+- **Type:** M4L MIDI/Audio Effect
+- **Load via:** `find_and_load_device("8 Buttons")` / `find_and_load_device("8 Buttons R")` / `find_and_load_device("9B")`
+- **What it does:** Button panels providing 8 or 9 mappable buttons for triggering parameter changes, device toggles, or state switches. Variants offer different layouts and routing options (R = return track variant).
+- **Key features:**
+  - 8 or 9 MIDI/key-mappable buttons per instance
+  - Instant state switching for mapped parameters
+  - Compact button-grid interface
+  - Multiple variants for different routing contexts
+- **Reach for this when:** building a custom button panel for live performance, toggling multiple effects simultaneously, creating scene-like parameter snapshots on buttons
+- **Pairs well with:** Effect Racks (toggle chains), FXbypass (pair with button triggers), Push controller
+
+---
+
+## Automation
+
+---
+
+### Smooth Automator Audio / Smooth Automator MIDI
+
+- **Type:** M4L Audio Effect / M4L MIDI Effect
+- **Load via:** `find_and_load_device("Smooth Automator Audio")` / `find_and_load_device("Smooth Automator MIDI")`
+- **What it does:** Enables smooth transitions and automation between Rack Macro Variations (Live 11+). Place to the left of an Instrument, Drum, or MIDI Effect Rack to crossfade between variation states.
+- **Key features:**
+  - Smooth crossfading between macro variations (up to 44 variations)
+  - Timed transitions (synced to tempo or free time)
+  - Manual crossfade slider for real-time morphing
+  - Automatable variation parameter for arrangement automation
+  - Audio and MIDI Effect versions included
+- **Limitations:** Can exhibit macro jumping/misbehavior in some cases (hotswap the device to fix); requires Rack with Variations to be useful
+- **Reach for this when:** you want smooth transitions between variation snapshots (e.g., verse to chorus parameter morphs), automating rack variation changes in arrangement, live performance morphing between effect states
+- **Pairs well with:** Instrument Racks and Audio/MIDI Effect Racks (required), any rack-based performance setup
+
+---
+
+## Sampler Enhancement
+
+---
+
+### Yraki Simpler Buddy V1/V2
+
+- **Type:** M4L Audio Effect
+- **Load via:** `find_and_load_device("Simpler Buddy")` (V1 or V2 variant)
+- **What it does:** Unlocks automation of Simpler's Warp and Slicing parameters that are not natively automatable. Place next to Simpler to gain external control over warp settings.
+- **Key features:**
+  - Automate Simpler's Warp mode, start/end points, and slicing parameters
+  - Real-time control of normally locked Simpler settings
+  - Best results in Slice Mode with random LFO automation for glitch/chop effects
+  - Free device
+- **Limitations:** Stops working when changing Simpler's sample (requires device reload)
+- **Reach for this when:** you want to automate warp settings for creative sample manipulation, glitch/chop effects using Simpler's slice mode with external modulation, unlocking hidden Simpler parameters for performance
+- **Pairs well with:** Simpler instrument, LFO devices (random automation of warp parameters), S8JFOU LFO Random
+
+---
+
+## Notes & Documentation
+
+---
+
+### NotePad
+
+- **Type:** M4L Audio/MIDI Effect
+- **Load via:** `find_and_load_device("NotePad")`
+- **What it does:** In-session text notepad that stores notes directly in your Live Set. Notes persist with the project file across saves and loads.
+- **Key features:**
+  - Text entry field stored with the Set
+  - Zero CPU when device is disabled (notes still visible)
+  - Can be placed on any track as a reminder or documentation tool
+  - Notes survive save/load cycles
+- **Reach for this when:** documenting mixing decisions on specific tracks, leaving TODO notes for future sessions, noting sample sources or processing intent, session journaling
+- **Pairs well with:** any track where you want persistent notes, Set Namer (document what the project name means)
+
+---
+
+## Scale & Theory
+
+---
+
+### InScale
+
+- **Type:** M4L MIDI Effect
+- **Load via:** `find_and_load_device("InScale")`
+- **What it does:** Forces all incoming MIDI notes into the selected scale in real time. Over 400 scale presets. White keys always play in scale, black keys switch presets, first octave changes root note.
+- **Key features:**
+  - 400+ scale presets sorted by category (major, minor, modes, exotic, chords)
+  - Up to 20 user presets with different scales/chords
+  - White keys = scale-locked playback
+  - Black keys = preset switching
+  - First octave = root note selection
+  - Remote control via Android/iOS app (tablet next to keyboard)
+  - Compatible with Live 10/11/12
+- **Reach for this when:** staying in key during live performance or improvisation, exploring unfamiliar scales, teaching/learning music theory, ensuring MIDI controllers always output in-key notes
+- **Pairs well with:** Arpeggiator (scale-lock before arpeggiation), any MIDI instrument, The Poser (transpose + scale-lock combo)
+
+---
+
+## Robert Henke Devices (User M4L)
+
+---
+
+### ControlChange8.5
+
+- **Type:** M4L MIDI Effect
+- **Load via:** `find_and_load_device("ControlChange8.5")`
+- **What it does:** MIDI CC message generator and router by Ableton co-founder Robert Henke. Sends arbitrary MIDI Control Change messages to control external hardware or internal parameters.
+- **Key features:**
+  - Generate and send custom MIDI CC messages
+  - Route CC data to external hardware or internal Live parameters
+  - Configurable CC number, channel, and value ranges
+  - Designed for hardware integration and custom MIDI routing
+- **Reach for this when:** controlling external MIDI hardware parameters from within Live, generating CC automation for hardware synths, custom MIDI routing scenarios that Live's native CC mapping cannot handle
+- **Pairs well with:** External MIDI hardware, External Instrument device, MIDI Effect Racks
+
+---
+
+### GrainFreeze
+
+- **Type:** M4L Audio Effect
+- **Load via:** `find_and_load_device("GrainFreeze")`
+- **What it does:** Granular audio freezer that captures incoming audio in real time and lets you scrub through it to create textural drones, pads, and atmospheric layers from any source material. Predecessor to Robert Henke's Granulator series.
+- **Key features:**
+  - Real-time audio capture buffer
+  - Scrub position control (manual or automated)
+  - Grain size adjustment for texture density
+  - Creates lush textures from any audio input
+  - Free and open to modification
+- **Reach for this when:** creating ambient textures from live audio, freezing a moment in a performance, sound design using granular techniques, building pads from found sounds or instrument recordings
+- **Pairs well with:** Reverb (expand the frozen texture), Delay (rhythmic granular layers), LFO_2.2 (automate scrub position and grain size)
+
+---
+
+### LFO_2.2
+
+- **Type:** M4L MIDI Effect
+- **Load via:** `find_and_load_device("LFO_2.2")`
+- **What it does:** Swiss-knife LFO modulator by Robert Henke with three output modes: direct engine modulation, GUI-style knob turning (records automation), or audio-rate CV output. Extremely wide frequency range from minutes-long cycles to audio rate.
+- **Key features:**
+  - **Waveforms:** Sine, Ramp Up, Ramp Down, Square, Stepped Random, Smooth Random, Binary Random
+  - **Three modulation modes:**
+    - **Direct:** via Live's engine, disables manual target control, ideal for fast modulations
+    - **GUI:** simulates turning the target knob, can record automation data
+    - **Audio:** outputs modulation as audio signal for CV/analog synth control
+  - **S&H (Sample & Hold):** samples the LFO at regular intervals, creates stepped waves, sync to beat time
+  - **Smooth:** softens hard waveform edges
+  - **Curve:** shifts waveform center for asymmetrical modulation
+  - Extremely wide frequency range (multi-minute cycles to audio rate)
+  - Map to any parameter in Live
+- **Reach for this when:** modulating any parameter with more control than Live's built-in LFO, generating CV for analog hardware, creating complex modulation patterns (S&H + Smooth + Curve), slow-evolving ambient modulation over minutes
+- **Pairs well with:** any synth parameter, GrainFreeze (automate scrub/grain), Utility Width (automate stereo width), any effect parameter
+
+---
+
+### NoteModulator_2
+
+- **Type:** M4L MIDI Effect
+- **Load via:** `find_and_load_device("NoteModulator_2")`
+- **What it does:** MIDI note transformation tool by Robert Henke. Processes incoming MIDI notes through modulation rules to generate altered output patterns. Transforms static note input into evolving melodic variations.
+- **Key features:**
+  - MIDI note modulation and transformation
+  - Configurable rules for pitch, velocity, and timing modification
+  - Generates variations from simple input patterns
+  - Free and modifiable
+- **Reach for this when:** generating melodic variations from simple patterns, adding humanization or algorithmic variation to MIDI sequences, experimental MIDI processing
+- **Pairs well with:** any MIDI instrument, Arpeggiator, InScale (constrain modulated output to a scale)
+
+---
+
+## Suzuki Kentaro Devices (User M4L)
+
+---
+
+### Clip-Exporter 4.0
+
+- **Type:** M4L Audio Effect
+- **Load via:** `find_and_load_device("Clip-Exporter 4.0")`
+- **What it does:** Batch exports audio clips from Session View with configurable format settings. Export multiple clips at once with consistent naming, format, and processing.
+- **Key features:**
+  - Batch export from Session View
+  - Configurable file format (WAV, AIFF, etc.)
+  - Mono/stereo selection
+  - Normalization volume setting
+  - Transition fade-in/fade-out
+  - Bit-depth selection
+  - Consistent naming across exports
+- **Reach for this when:** exporting sample packs or stems from a session, preparing audio clips for use in other DAWs or samplers, batch-processing session recordings into individual files
+- **Pairs well with:** Clip-Renamer (rename first, then export), Renamer, any session-based sample workflow
+
+---
+
+### Clip-Renamer 4.0
+
+- **Type:** M4L Audio Effect
+- **Load via:** `find_and_load_device("Clip-Renamer 4.0")`
+- **What it does:** Batch clip renamer for Session View inspired by Wwise's Butch Rename View. Multi-step rename pipeline with toggleable stages.
+- **Key features:**
+  - **Root:** set base name for all clips
+  - **Replace:** find-and-replace within clip names
+  - **Insert:** add text at specific positions
+  - **Index:** append sequential numbering
+  - **Remove:** strip characters from names
+  - Each rename step can be toggled on/off independently
+  - Batch processing across selected clips
+- **Reach for this when:** preparing samples with consistent naming conventions, cleaning up recorded clip names, creating indexed sample sets for export, game audio or post-production naming workflows
+- **Pairs well with:** Clip-Exporter (rename then export pipeline), session organization
+
+---
+
+### Helisert 5.0
+
+- **Type:** M4L Audio Effect (also available as VST3/AU)
+- **Load via:** `find_and_load_device("Helisert 5.0")`
+- **What it does:** Streaming looper that records and plays back audio simultaneously in a circular buffer. Does not require loading samples -- captures live input and loops it in real time with creative playback manipulation.
+- **Key features:**
+  - Circular buffer recording -- continuously captures incoming audio
+  - Simultaneous record and playback (stream-rec and circular-play)
+  - Real-time loop manipulation without file drops
+  - Creative playback position and speed control
+  - Available as M4L, VST3, and AU
+- **Reach for this when:** live looping with creative buffer manipulation, building ambient textures from live input, experimental performance with circular recording, creating evolving loop layers
+- **Pairs well with:** GrainFreeze (granular freeze of the looped content), Delay (rhythmic loop layers), reverb effects
+
+---
+
+## S8JFOU Devices (User M4L)
+
+---
+
+### LFO Random
+
+- **Type:** M4L MIDI Effect
+- **Load via:** `find_and_load_device("LFO Random")`
+- **What it does:** Stripped-down version of Ableton's built-in LFO with only the random waveform. A focused tool when you only need randomized modulation without the overhead of configuring other waveform options.
+- **Key features:**
+  - Random waveform LFO output
+  - Same parameter mapping as Ableton's built-in LFO
+  - Simplified interface -- only random mode
+- **Reach for this when:** you specifically want random modulation and want a cleaner interface than the full LFO, quick random parameter movement for sound design
+- **Pairs well with:** Simpler Buddy (random automation of warp), any parameter that benefits from randomized modulation
+
+---
+
+### Potee
+
+- **Type:** M4L MIDI Effect
+- **Load via:** `find_and_load_device("Potee")`
+- **What it does:** A single knob that generates MIDI notes as you turn it. Includes scale selection to keep output in key, with random and poly/mono modes.
+- **Key features:**
+  - Turn the knob -> generate notes
+  - Scale-locked note output (selectable scale)
+  - Random mode for autonomous note generation
+  - Adjustable range, velocity, probability
+  - Poly and mono modes
+- **Reach for this when:** generating melodies from a single knob gesture, exploring scales interactively, generative composition, live performance note generation
+- **Pairs well with:** InScale (additional scale filtering), any MIDI instrument, Arpeggiator
+
+---
+
+### Premo
+
+- **Type:** M4L MIDI Effect
+- **Load via:** `find_and_load_device("Premo")`
+- **What it does:** Instant preset save and recall system. Store parameter snapshots and switch between them immediately.
+- **Key features:**
+  - Save current parameter states as presets
+  - Instant recall of saved presets
+  - Simple button-based interface
+  - Free
+- **Reach for this when:** you need scene-like preset switching for a device, A/B comparing different parameter configurations, live performance preset changes
+- **Pairs well with:** any instrument or effect where you want quick preset switching, Smooth Automator (smooth transitions between states)
+
+---
+
+### Probee
+
+- **Type:** M4L MIDI Effect
+- **Load via:** `find_and_load_device("Probee")`
+- **What it does:** Random value generator triggered by incoming MIDI notes. Each note-on event produces a new random value that can modulate mapped parameters.
+- **Key features:**
+  - MIDI note-triggered random value generation
+  - Map output to any Live parameter
+  - Each note produces a fresh random value
+  - Free
+- **Reach for this when:** creating per-note random variations (random filter cutoff per note, random pan per note), generative sound design, adding unpredictability to sequences
+- **Pairs well with:** any synth parameter, Arpeggiator (arpeggiated notes trigger random changes), Potee (combined generative workflow)
+
+---
+
+## Alexkid Devices (User M4L)
+
+---
+
+### PEACH by Alexkid
+
+- **Type:** M4L MIDI Effect (also available as VST/AU)
+- **Load via:** `find_and_load_device("PEACH")`
+- **What it does:** Polymetric arpeggiator that transforms chords into evolving melodic sequences through independent cycle lengths per step sequencer lane. Each lane (Gate, Hold, Octave, Velocity, MIDI CC) can run at its own length, creating endlessly shifting polyrhythmic grooves.
+- **Key features:**
+  - Independent step sequencer lanes: Gate, Hold, Octave, Velocity, MIDI CC
+  - Each lane has its own cycle length -> polymetric interplay
+  - Forced scale mode to stay in key
+  - Generative randomization per lane
+  - Full Push 2 mapping
+  - Goes far beyond Ableton's native Arpeggiator
+- **Reach for this when:** creating evolving, non-repeating melodic patterns, polyrhythmic arpeggiations, generative melody writing, genres that thrive on shifting patterns (techno, progressive house, ambient, Italo disco)
+- **Pairs well with:** InScale (additional scale filtering), any polyphonic synth, POLYLLOP (use both for maximum generative complexity)
+
+---
+
+### POLYLLOP by Alexkid
+
+- **Type:** M4L MIDI Effect
+- **Load via:** `find_and_load_device("POLYLLOP")`
+- **What it does:** Polyphonic polymetric step sequencer with 4 independent voice layers. Each layer has its own cycle length (up to 8 steps) and play mode, creating four simultaneous melodies that phase against each other.
+- **Key features:**
+  - 4 voice layers, each fully independent
+  - Per-layer: rhythm, melody, duration, velocity lanes
+  - Per-layer cycle length (up to 8 steps) and play mode
+  - Forced scale mode
+  - Generative randomization
+  - Full Push 2 mapping
+  - Polyphonic output (up to 4 simultaneous notes)
+- **Reach for this when:** writing complex polyphonic sequences that evolve over time, Detroit techno / progressive house / ambient composition, generative music that never exactly repeats, layered melodic counterpoint
+- **Pairs well with:** PEACH (mono arp + poly sequencer combo), InScale, any polyphonic instrument
+
+---
+
+## Quick Decision Matrix
+
+| Need | Reach for | Why |
+|---|---|---|
+| Gain staging between effects | **Utility** | Transparent +/-35 dB gain, zero coloring |
+| Check mono compatibility | **Utility** (Width 0%) | One click to mono the signal |
+| Collapse bass to mono | **Utility** (Bass Mono) | Frequency-selective mono below crossover |
+| Fix phase issues | **Utility** (Phz-L/Phz-R) | Per-channel polarity flip |
+| Tune an instrument | **Tuner** | Real-time chromatic pitch display |
+| See frequency content | **Spectrum** | Native FFT analyzer, zero CPU |
+| Compare frequencies across tracks | **Multi Analyser XL** | Multi-track overlay in floating window |
+| Loudness metering (LUFS) | **Swiss Army Meter** | All-in-one LUFS/True Peak/Phase/BPM converter |
+| Gain staging to -18 dBFS | **VU Meter** | Analog-style RMS with proper calibration |
+| Reference against commercial mix | **DIFF Devices Aspect II** | A/B with drag-drop references + spectrum curves |
+| Level-match A/B testing | **Volume Buddy** | Auto LUFS gain compensation |
+| Adjust clip gain from timeline | **ClipGain** | Floating popup, no Clip Detail View needed |
+| Fine parameter control (>128 steps) | **1000% Knob** | 1/1000 increment precision mapping |
+| 16+ macro knobs | **MultiMapper16** | 16 dials with min/max % mapping |
+| 32+ macro knobs with curves | **MultiMapper32Audio** | 32 dials + custom response curves |
+| Route audio anywhere | **Outist / Insist** | Breaks Live's routing restrictions, zero loss |
+| A/B dry vs processed signal | **FXbypass + FXGlobal** | Bypass without deactivating, no CPU spikes |
+| Quick plugin insertion | **Shortcut Buddy** or **LoadeR** | Key-command device loading (64 or 12 slots) |
+| Fold/unfold groups | **Folder V1** | One-button group toggle |
+| Custom floating toolbar | **Advanced Toolbar Buttons** | Floating button bar (Windows) |
+| Batch rename clips | **Clip-Renamer 4.0** | Multi-step pipeline (Root/Replace/Insert/Index/Remove) |
+| Batch export clips | **Clip-Exporter 4.0** | Session View batch export with format control |
+| Smooth variation transitions | **Smooth Automator** | Crossfade between rack macro variations |
+| Automate Simpler warp | **Simpler Buddy** | Unlocks non-automatable Simpler params |
+| Session notes | **NotePad** | Text stored in the Set, zero CPU |
+| Stay in key (MIDI) | **InScale** | 400+ scales, keyboard-mapped |
+| Swiss-knife LFO | **LFO_2.2** (Henke) | 3 output modes, audio-rate to multi-minute |
+| Granular freeze effect | **GrainFreeze** | Real-time capture + granular scrub |
+| Polymetric arpeggiator | **PEACH** | Independent lane lengths, generative |
+| Polyphonic polymetric sequencer | **POLYLLOP** | 4-voice independent layers |
+| Live looping with circular buffer | **Helisert** | Stream-rec simultaneous record/play |
+| Global pitch shift entire session | **HYPERSPEED_3** | One knob, all clips, tempo-matched |
+| Random value per MIDI note | **Probee** | Note-triggered random generator |
+| Instant preset recall | **Premo** | Save/recall parameter snapshots |
+| Generate notes from a knob | **Potee** | Turn knob = notes, scale-locked |
+| Send MIDI CC to hardware | **ControlChange8.5** | Custom CC messages, full routing control |
+| Creative MIDI transformation | **NoteModulator_2** | Algorithmic note variation |
+| Project naming inspiration | **Set Namer** | Random name generator from real song titles |