Rhythmic LFO Wah-Wah — User Guide
A tempo-synchronised resonant wah whose centre frequency follows a sine LFO derived from BPM, musical note value, and straight, dotted, or triplet timing.
What this does
Rhythmic LFO Wah-Wah moves a resonant filter centre back and forth between a minimum and maximum frequency. The motion is a sine wave, but its speed is expressed musically: the script converts BPM, note value, and rhythmic feel into an exact LFO cycle duration.
The moving resonance is implemented with a one-formant FormantGrid. The grid is built in the Sound's absolute time domain, while the LFO phase is calculated from local time beginning at the start of the Sound. This keeps the modulation pattern unchanged if an otherwise identical Sound is moved to a different start time in Praat.
Tempo & rhythm
Manual BPM or fit a beat count to the whole Sound
The script does not detect tempo from audio content. BPM is obtained in one of two ways:
- If Beats in Sound is 0, the script uses Manual BPM.
- If Beats in Sound is positive, that number is interpreted as the number of beats spanning the entire selected Sound:
For example, declaring 8 beats over a 5-second Sound gives 96 BPM. The derived BPM must be greater than 0 and no higher than 1200.
Note values
| Note value | Base duration in beats |
|---|---|
| 1/1 | 4 beats |
| 1/2 | 2 beats |
| 1/4 | 1 beat |
| 1/8 | 0.5 beat |
| 1/16 | 0.25 beat |
| 1/32 | 0.125 beat |
Straight, dotted, and triplet
The rhythmic feel scales the cycle duration; it does not create a swing pattern or alternate long and short pulses.
| Feel | Duration multiplier | Effect |
|---|---|---|
| Straight | 1 | Uses the note value unchanged. |
| Dotted | 1.5 | Cycle is 50% longer than the straight value. |
| Triplet | 2/3 | Cycle is 2/3 as long as the straight value. |
At 120 BPM, for example, a straight quarter-note cycle is 0.5 s = 2 Hz; a dotted quarter is 0.75 s = 1.333... Hz; and a quarter-note triplet is 0.333... s = 3 Hz.
Wah filter
Sine-controlled resonance trajectory
The target therefore moves smoothly from the minimum to the maximum cutoff and back again. At local time 0 the sine is 0, so the first control point begins at the midpoint of the frequency range and initially moves upward.
Adaptive control resolution
The FormantGrid is not limited to a fixed 5 ms update interval. v0.4 chooses:
This keeps the original 5 ms ceiling for slower modulation while providing at least approximately 32 control positions per LFO cycle at faster rhythmic settings. The grid includes an exact point at the start of the Sound and a final point at its end.
Frequency and bandwidth limits
The requested minimum and maximum centre frequencies are each constrained to the range 20 Hz … 0.45 × sample rate. If the resolved minimum is above the maximum, the two values are swapped. Bandwidth is constrained to 1 Hz … 0.45 × sample rate.
FormantGrid filtering
The Sound and one-formant grid are processed with Praat's Filter (no scale). This avoids the automatic output scaling of the standard Filter command.
Centre-gain calibration
A raw all-pole formant resonator can have a very large gain at its centre frequency. After filtering, v0.4 applies a time-varying gain correction derived from the instantaneous centre frequency and the pole radius:
This is the steady-state centre-frequency gain correction for the resonator at each instantaneous centre setting. It is filter calibration, not peak normalization: it compensates the resonator's raw centre gain before the user-controlled Dry/Wet mix is applied.
Dry/Wet
0% Wet is an exact bypass. The script simply copies the original Sound, creates no FormantGrid control points, and does not apply Safety Peak scaling.
Safety Peak
For active processing, the script measures the output peak after filtering, calibration, and Dry/Wet mixing. If it exceeds Safety Peak, the result is scaled down to that ceiling. A result already below the ceiling is left unchanged.
Presets
| Preset | Tempo | Rhythm | Range | Bandwidth |
|---|---|---|---|---|
| Custom | Manual or Beats in Sound | User setting | User setting | User setting |
| Funky Quarter | 120 BPM | 1/4 straight | 400–2500 Hz | 150 Hz |
| Slow Half | 80 BPM | 1/2 straight | 300–2000 Hz | 150 Hz |
| Fast Eighth | 140 BPM | 1/8 straight | 500–3000 Hz | 150 Hz |
| Triplet Groove | 100 BPM | 1/4 triplet | 400–2200 Hz | 150 Hz |
| Dotted Eighth | 110 BPM | 1/8 dotted | 350–2800 Hz | 150 Hz |
| Fit 4 Beats to Sound | Derived from 4 beats spanning the whole Sound | 1/4 straight | 400–2500 Hz | 150 Hz |
Beats_in_sound = 4. With a straight quarter-note LFO, that produces four complete LFO cycles across the duration of the selected Sound.
Preset selection overrides the tempo/rhythm/filter values listed above. Dry/Wet, Safety Peak, visualization, and playback remain under direct user control.
Parameters
| Parameter | Default | Meaning | Runtime handling |
|---|---|---|---|
| Preset | Custom | Selects Custom or one of six stored rhythmic/filter settings. | Named presets override the relevant values. |
| Beats in Sound | 0 | Positive value = declared number of beats spanning the whole Sound. | 0 uses Manual BPM; resulting BPM must be ≤1200. |
| Manual BPM | 120 | Tempo used when Beats in Sound = 0. | Must produce BPM >0 and ≤1200. |
| Note value | 1/4 | Whole through 32nd note cycle base. | Converted to 4, 2, 1, .5, .25, or .125 beats. |
| Feel | Straight | Scales the selected note duration. | Straight ×1; dotted ×1.5; triplet ×2/3. |
| Min cutoff Hz | 400 | Lower centre-frequency limit. | Clamped to 20 … .45 × sample rate. |
| Max cutoff Hz | 2500 | Upper centre-frequency limit. | Clamped to 20 … .45 × sample rate; swapped with minimum if necessary. |
| Bandwidth Hz | 150 | Formant bandwidth of the moving resonator. | Clamped to 1 … .45 × sample rate. |
| Dry/Wet percent | 100 | Blend between original and calibrated filtered signal. | Clamped to 0…100%; 0 gives exact bypass. |
| Safety Peak | .99 | Maximum active-output peak. | Clamped to 0…1; 0 disables safety; attenuation only. |
| Draw visualization | yes | Creates the AudioTools picture. | Does not alter audio. |
| Play result | yes | Plays the result after processing. | Does not alter audio. |
Channels & output
| Property | Behavior |
|---|---|
| Channel count | Preserved, including arbitrary multichannel Sounds. |
| Filter trajectory | The same FormantGrid trajectory is applied to all channels. |
| Centre-gain calibration | A mono control Sound is generated on the original sample grid and the same calibration factor is applied to every channel. |
| Sample rate | Preserved. |
| Duration / sample count | Preserved. |
| Start time | Preserved; LFO phase uses local time. |
| Randomness | None. The same source and settings give the same result. |
| 0% Wet | Exact copied bypass; control-point generation and Safety Peak are skipped. |
The number reported as Control points is the number of time positions used for the FormantGrid trajectory. At each position the script adds both a formant-frequency point and a bandwidth point.
Visualization
When Draw visualization is enabled, v0.4 creates an AudioTools figure with:
Input
Original waveform.
Output
Final processed waveform after filtering, calibration, mix, and any required safety attenuation.
Resonance trajectory
The sine-controlled centre frequency across local source time, with the resolved minimum and maximum frequency range.
Summary
BPM source, note value, feel, LFO frequency, cycle duration, resonance range, bandwidth, Wet amount, safety setting, duration, sample rate, and channel count.
Beat grid
Vertical beat-reference lines are drawn only when the Sound contains at most 80 beats at the resolved BPM. This avoids an unreadably dense picture on long or very fast material.
Trajectory display resolution
The displayed resonance curve uses 400 line positions across the full Sound duration. This is a visualization-only sampling choice. The actual FormantGrid uses the adaptive control resolution described above, which can contain many more points.