Audio
Modulaser can react to live audio from any input device: a USB microphone, an audio interface, or a virtual loopback from your computer. The audio modulator turns incoming sound into a 0–100% signal you can route to any parameter, so shapes pulse with the kick, colors shift with the melody, or geometry physically deforms to match the waveform.
Multi-channel interfaces are supported, so different channels can drive different parts of your show.
Setting Up an Audio Device
Open Settings (the gear icon) and click the Devices tab. Select your audio input device from the Device dropdown. All available input devices are listed by name. Select "None" to disconnect.
The selected device is shared by all audio modulators and AudioInput nodes across all clips. Each modulator or node picks which channel to read from. Your device selection persists across sessions.
Gate & Limit
When a device is connected, each input channel shows a live level meter with two controls:
- Gate (0–100%, default 0%): signal below this threshold is silenced. Use it to cut background noise so quiet moments produce zero modulation.
- Limit (0–100%, default 100%): signal above this threshold is clipped. Use it to tame loud peaks and keep modulation in a controlled range.
Both appear as vertical markers on the level meter. These settings apply globally, so every modulator reading from that channel sees the gated and limited signal.
Adding an Audio Modulator
Click the + button on the modulator panel and select Audio. The modulator starts reading from the selected device immediately.
Channel
If your device has multiple inputs, use the channel selector to pick which one this modulator reads. With a multi-channel interface, you can have different modulators reacting to different signals: kick on channel 1, vocals on channel 2, hi-hats on channel 3.
Modes
The audio modulator has three output modes:
Loudness: Envelope-followed peak amplitude. Produces a single value per frame that rises with loud transients and decays smoothly. Best for beat-reactive effects like pulsing size, brightness, or scale.
Spectrum: FFT energy within a configurable frequency band. A live FFT sits below the mode selector with a draggable range selector. Drag the low and high handles to isolate a band (e.g. 20–200 Hz for bass, 5–15 kHz for hi-hats), or drag the range itself to slide both handles together. The output is the energy in that band, so you can target specific frequencies.
Waveform: Raw audio samples mapped across the shape's points. Each point on the laser shape samples a different moment from a rolling audio buffer, so the shape physically deforms to match the waveform. Creates oscilloscope-like effects and audio-driven geometry.
Controls
| Control | Range | Default | Available in | What it does |
|---|---|---|---|---|
| Gain | 0.0–4.0 | 1.0 | All modes | Signal multiplier. Boost quiet sources or attenuate loud ones. |
| Fall | 0.01–5.0s | 0.1s | Loudness, Spectrum | Envelope decay time. Low values = snappy response, high values = smooth and lazy. |
| Window | 5–3000ms | 20ms | Waveform | Duration of audio mapped across points. Short = fine detail, long = broader waveform. |
| Freq Low | 20–20,000 Hz | 20 Hz | Spectrum | Low cutoff of the frequency band. |
| Freq High | 20–20,000 Hz | 20,000 Hz | Spectrum | High cutoff of the frequency band. |
Spectrum Visualization
Every audio modulator shows a live spectrum display regardless of which mode you're using. The bars reflect that modulator's own gain and fall settings. In Spectrum mode, the interactive range selector appears below the bars: bars inside the selected range are highlighted, bars outside are dimmed.
Routing Audio to Parameters
Once you have an audio modulator, route it to any parameter by dragging the modulator's circle onto a parameter target. The routing amount controls how much the audio signal affects the parameter.
Some ideas to get started:
- Route a Loudness modulator to Scale for beat-pulsing shapes
- Route a Spectrum modulator (bass range) to Hue for color that shifts with the low end
- Route a Waveform modulator to an oscillator's Level for audio-shaped geometry
- Stack multiple audio modulators on different channels for frequency-split reactions
AudioInput Node
The same audio functionality is available as an AudioInput node in NodeGraph layers, with the same parameters (mode, channel, gain, fall, frequency range, window). The node outputs a scalar value of 0–100.
In Spectrum and Waveform modes, the output varies per point along the shape's position, so different parts of the shape respond to different frequencies or waveform positions. This enables spatially-varying audio response that isn't possible with the modulator alone.
Routing Computer Audio into Modulaser
If you're playing audio on the same computer running Modulaser, it's better to route the audio directly instead of picking it up through a microphone. Direct routing means zero distortion and no delay.
macOS
Use Loopback (paid) or Blackhole (free).
Blackhole works but takes some configuration. Follow the setup instructions including the Audio MIDI Setup step. Once configured, go to System Settings > Sound > Output and select "Multi-Output Device", then open Modulaser's device settings and select "Blackhole (2ch)".
Windows
Use VB-Cable (free). After installation, open Modulaser's device settings and select "CABLE Output".