Extract audio features
extract_audio_featuresExtract overall level and bass, mid, treble band energies from an audio source, outputting raw signals on a Null CHOP to drive any parameter in TouchDesigner.
Instructions
Build an audio-analysis chain that exposes ready-to-bind reactive channels — overall level plus bass/mid/treble band energies — on a Null CHOP. Unlike create_audio_reactive (which renders a spectrum visual), this produces the raw signals so you can drive ANY parameter: bind a node parameter to op('…/audio_features/features')['bass'] and it pulses with the music. A Sensitivity knob scales all channels. Source can be the live device (mic/line — may prompt for macOS permission), an audio file, a synthetic oscillator (for testing), or an existing CHOP. Use create_spectrum for N fine per-band channels instead of these four coarse bands, and pass this Null as the source_chop to bind_audio_reactive to make a whole COMP react.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mid_hz | No | Band-pass centre for the mid band. | |
| source | No | Audio source. 'device' = live microphone/line in (the real-world default; creating it may pop a one-time macOS microphone-permission dialog — click Allow). 'file' = an audio file. 'oscillator' = a synthetic tone, handy for testing without any device permission. 'existing_chop' = reuse a CHOP you already have. | device |
| bass_hz | No | Low-pass cutoff for the bass band. | |
| treble_hz | No | High-pass cutoff for the treble band. | |
| parent_path | No | Parent COMP path the self-contained 'audio_features' container is created inside. | /project1 |
| audio_file_path | No | Audio file path (source='file'). | |
| expose_controls | No | Expose a live 'Sensitivity' knob (a gain over every feature channel). | |
| existing_chop_path | No | Path of an existing audio CHOP to analyze (source='existing_chop'). |