Stereo Rotary Speaker — User Guide

A Leslie-inspired single-rotor processor that couples directional amplitude modulation with continuous fractional-delay modulation, creating a rotating stereo motion from one shared virtual rotor trajectory.

Author: Shai Cohen Affiliation: Department of Music, Bar-Ilan University, Israel Version: 0.4 (2026) License: MIT License Repo: https://github.com/ShaiCohen-ops/Praat-plugin_AudioTools
Contents:

What this does

Stereo Rotary Speaker creates one virtual rotating-source trajectory and derives two synchronized effects from it: a directional amplitude trajectory and a continuously changing path delay. The changing delay produces Doppler-like pitch motion, while the amplitude trajectory makes the source strongest at the modeled closest approach and weaker on the opposite side of the rotation.

Odd-numbered channels follow the left trajectory. Even-numbered channels follow the same rotor motion with a user-defined phase offset, producing stereo or multichannel motion without cross-feeding audio between channels.

Model scope: v0.4 is a Leslie-inspired single-rotor creative model. It concentrates on coupled amplitude and path-delay motion. It does not attempt separate horn and bass-drum rotors, crossover filtering, cabinet radiation, acceleration constants, room acoustics, or a physical microphone-distance model.

Processing pipeline

Signal flow

1. Resolve the selected preset or Custom controls.

2. Clamp rotation, delay excursion, tremolo, stereo width, Dry/Wet, and Safety values.

3. Limit the delay excursion so the time warp remains causal and its local playback direction stays positive.

4. Build the rotor phase trajectory. Transition mode integrates a linear speed ramp instead of using a fixed rate.

5. Derive amplitude gain and path delay from the same rotor phase.

6. Read the source at the fractional delayed time and blend it with the direct signal according to Dry/Wet.

7. Apply attenuation-only Safety Peak if the active result exceeds the requested ceiling.

Exact bypass

If Dry/Wet = 0%, or both Doppler delay excursion and Tremolo Depth are zero, the script makes a direct copy of the source. In this bypass path there is no mono-to-stereo conversion and no Safety Peak gain change.

Rotor trajectory

Constant-speed modes

For Custom and all fixed-speed presets, the local rotor phase is:

local_time = x − Sound_start phase(t) = 2π × Rotation_speed × local_time + channel_phase channel_phase = 0 for odd channels channel_phase = Stereo_width_deg for even channels converted to radians

Using local Sound time means that moving an otherwise identical Sound to another xmin does not change the modulation trajectory.

Transition preset

The Transition preset accelerates continuously from 0.8 Hz to 6.8 Hz over the full Sound duration. Its phase is the integral of that linear speed ramp:

f(t) = f0 + (f1 − f0) × local_time / duration phase(t) = 2π × [ f0 × local_time + 0.5 × (f1 − f0) / duration × local_time² ] + channel_phase f0 = 0.8 Hz f1 = 6.8 Hz

This preserves phase continuity while the rotor accelerates. The Transition preset therefore performs a real speed ramp rather than selecting a single intermediate speed.

Directional amplitude trajectory

gain(t) = 1 − Tremolo_depth × 0.5 × [1 − cos(phase(t))]

The gain ranges from 1 at phase 0 to 1 − Tremolo Depth at the opposite side of the cycle. A Tremolo Depth of 1 can therefore reach zero gain at the rear of the modeled rotation.

Delay / Doppler mapping

Delay excursion in milliseconds

Doppler Delay Depth is an explicit path-delay excursion, not a normalized pitch-depth control. After conversion from milliseconds to seconds, the script creates the minimum causal baseline:

A = Doppler_delay_depth_ms / 1000 baseDelay = A + 1 / sample_rate delay(t) = baseDelay − A × cos(phase(t))

For a nonzero excursion, the delay therefore ranges from approximately one sample at closest approach to 2A + one sample on the opposite side. The audio is read with Praat's continuous time interpolation, so the delay is fractional rather than rounded to integer samples.

Why this creates pitch motion

Pitch change comes from the derivative of the moving delay. The script estimates the maximum time-warp slope as:

warpPeak = 2π × maximum_rotation_speed × A

The corresponding approximate peak pitch excursions reported in the Info window are:

pitch up = 1200 × log2(1 + warpPeak) cents pitch down = −1200 × log2(1 − warpPeak) cents

Causal / derivative-safe clamp

v0.4 constrains the requested delay excursion so that:

|d(delay)/dt| ≤ 0.45 A ≤ 0.45 / (2π × maximum_rotation_speed)

This keeps the source-read trajectory moving forward with a local rate of approximately 0.55…1.45 rather than approaching a reversal or an extreme time warp. If the user's requested Doppler depth is too large for the selected speed, the script reduces it automatically and reports the clamp in the Info window.

Wet-path startup

For nonzero delay modulation, the wet contribution is faded in over the maximum delay time so that the effect does not immediately request source history from before the beginning of the Sound.

ramp(t) = clamp(local_time / maximum_delay, 0, 1) output = source × [1 − Wet × ramp] + Wet × ramp × gain(t) × source(t − delay(t))

After the delay line has filled, this becomes the normal Dry/Wet blend between the direct source and the amplitude-modulated delayed source.

Tremolo-only case

If Doppler Delay Depth is zero but Tremolo Depth is nonzero, no delay is introduced:

output = (1 − Wet) × source + Wet × gain(t) × source

Presets

PresetRotationDoppler excursionTremolo depthStereo width
Custom6.8 Hz default0.60 ms default0.50 default140° default
Chorale (Slow / Hymn)0.8 Hz0.40 ms0.30120°
Tremolo (Fast / Rock)6.8 Hz0.60 ms0.50160°
Transition (Ramping Up)0.8 → 6.8 Hz across the Sound0.75 ms0.40180°
Wide Stereo Spin2.5 Hz0.50 ms0.70180°
Broken Cabinet (Wobbly)9.0 Hz1.25 ms0.6045°
Presets replace Rotation Speed, Doppler Delay Depth, Tremolo Depth, and Stereo Width. Dry/Wet, Safety Peak, visualization, and playback remain under the user's direct control.

Parameters

ParameterDefaultWhat it controlsRuntime handling
Rotation speed Hz6.8Rotor cycles per second in Custom and fixed-speed modes.Clamped to 0…20 Hz. Ignored by the Transition preset, which uses 0.8→6.8 Hz.
Doppler delay depth ms0.60Peak excursion of the variable path delay.Clamped to 0…10 ms, then reduced further if required by the derivative-safety rule.
Tremolo depth0.50Maximum directional attenuation of the wet trajectory.Clamped to 0…1.
Stereo width deg140Phase offset between odd- and even-channel rotor trajectories.Clamped to 0…180°.
Dry/Wet percent100Blend between direct source and rotating processed path.Clamped to 0…100%; 0 gives exact bypass.
Safety peak0.99Maximum active-output peak.Clamped to 0…1; 0 disables safety. Attenuation only.
Draw visualizationyesDraws the AudioTools figure.Does not change the audio.
Play resultyesPlays the completed result.Does not change the audio.

Channels & output

PropertyBehavior
Mono, active effectConverted to stereo before processing so the two rotor phases can diverge.
Mono, exact bypassRemains mono.
2+ channel inputChannel count is preserved.
Odd channelsUse the left / zero-phase rotor trajectory.
Even channelsUse the phase-offset trajectory defined by Stereo Width.
Cross-channel audioNone. Each output channel reads only the corresponding source channel.
Sample ratePreserved.
Sample count / durationPreserved.
Start timePreserved; modulation phase itself uses local Sound time.
RandomnessNone. Processing is deterministic for the same source and settings.

Safety Peak

After active processing, the script measures the absolute peak. Only if the result exceeds Safety Peak is the whole Sound scaled down. Quieter results are never amplified.

Visualization

When Draw visualization is enabled, v0.4 draws:

Input

The original waveform.

Output

The final processed waveform after optional Safety Peak attenuation.

Amplitude trajectory

Odd/L and even/R gain trajectories over the first up to 2 seconds.

Doppler path delay

The corresponding odd/L and even/R variable-delay trajectories in milliseconds over the first up to 2 seconds.

Summary strip

The summary reports rotation speed or transition range, effective Doppler delay excursion, tremolo depth, stereo width, Dry/Wet, duration, output channel count, and Safety Peak.

The two trajectory panels are control visualizations generated from the same equations used for the audio. They show the modeled rotor motion; they are not measurements extracted from the processed output.