Make a component react to audio
bind_audio_reactiveMake a COMP's custom parameters react to music by binding them to audio feature channels from a CHOP, with auto-mapping or explicit bindings and a master intensity knob.
Instructions
Make a whole COMP react to the music in one call — the core VJ move. Point target at a COMP with numeric custom-parameter knobs and source_chop at an audio-feature CHOP (e.g. an extract_audio_features Null carrying level/bass/mid/treble), and each knob is switched to expression mode tracking an audio band. Omit mappings to auto-map knobs by name heuristic (bright/level/opacity→level, scale/size/zoom→bass, hue/color→treble, speed/rate/rot→mid; unrecognized knobs are skipped), or pass explicit param→channel bindings with per-binding scale/offset. By default appends a master 'Reactivity' float knob (0–2, default = intensity) that scales every binding so the artist can dial the whole network's reactivity from one control. Fail-forward: a missing source CHOP, an absent channel, or an already-bound parameter are warnings, not failures — only a missing/non-COMP target is fatal. This tool only WIRES an existing COMP to an existing CHOP, building no nodes: produce the feature CHOP with extract_audio_features (or create_spectrum) first, use create_audio_reactive when you want a whole new reactive network with its own visual, and bind_to_channel for finer single-parameter control.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| target | Yes | COMP whose numeric custom parameters (knobs) should react to the music. | |
| mappings | No | Explicit param→channel bindings. Omit to auto-map the target COMP's numeric custom parameters by name heuristics. | |
| intensity | No | Master reactivity amount (0=off, 1=normal, 2=strong) — scales every binding. | |
| add_master | No | Append a 'Reactivity' master float knob (0-2, default = intensity) on the target COMP that scales every binding. | |
| source_chop | Yes | CHOP carrying audio feature channels (e.g. an extract_audio_features Null). Expected channels: level, bass, mid, treble. |