Voice Transformation — User Guide

Combined pitch, duration, formant and band-pass processing with channel-preserving resynthesis.

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

What this does

Voice Transformation runs up to four stages in a fixed order: source-relative pitch shift, duration scaling, formant transformation with Praat Change gender, and a Hann-band pass filter. Pitch and duration are handled through Manipulation/overlap-add; formant and filter processing follow the resynthesis.

The band-pass filter is always applied. Therefore neutral pitch, formant and duration values are not an identity path unless the chosen filter band itself is effectively transparent for the material.

Quick start

  1. Select exactly one Sound.
  2. Choose a preset or Custom.
  3. For Custom, set the pitch-analysis range, filter band, semitone shift, formant ratio and duration factor.
  4. Run the script. The result is named <source>_<presetName>.

Presets

PresetPitch rangeBandPitchFormantDuration
Vocal Harmonics75–500 Hz100–4000 Hz0 st1.0×1.0×
Reduce Breathiness75–500 Hz200–3000 Hz0 st1.0×1.0×
Deeper Voice50–400 Hz80–4000 Hz-4 st1.0×1.0×
Higher Voice100–800 Hz150–5000 Hz+5 st1.0×1.0×
Chipmunk Effect150–1000 Hz200–8000 Hz+7 st1.4×0.85×
Robot Voice50–300 Hz100–2500 Hz-6 st0.9×1.05×
Telephone Effect75–500 Hz300–3400 Hz0 st1.0×1.0×
Radio Voice60–400 Hz80–8000 Hz-2 st0.95×0.98×
Preset names describe intended character, not extra hidden algorithms. For example, Robot Voice does not flatten the F0 contour; it combines a -6 st source-relative shift with a 0.9 formant ratio, 1.05 duration factor and 100–2500 Hz band. Vocal Harmonics and Reduce Breathiness are filter-only presets because their pitch/formant/duration values are neutral.

Parameters

ControlDefaultValidation / role
Pitch_floor / Pitch_ceiling75 / 600 Hzceiling > floor and below 0.45×SR
Time_step0.01 s>0 and ≤0.1; Manipulation pitch analysis
Freq_cutoff_low / high120 / 3500 Hzhigh > low; high below 0.49×SR
Pitch_shift_semitones0-48 .. +48
Formant_shift_ratio1.0>0 .. 4
Duration_factor1.0>0 .. 4

Processing order

  1. Create a mono analysis reference. Pitch analysis itself is performed only when Pitch_shift_semitones is nonzero.
  2. If voiced pitch exists, build a shifted PitchTier with newF0 = originalF0 * 2^(ST/12), limited to 20 Hz .. 0.45*SR.
  3. If Duration_factor differs from 1, build a constant DurationTier over the true xmin/xmax domain.
  4. For each source channel, create a Manipulation object and replace the shared pitch/duration tiers as applicable.
  5. Resynthesize with overlap-add.
  6. If Formant_shift_ratio differs from 1, apply Change gender with the requested formant ratio, new pitch median=0, pitch-range factor=1.0 and duration factor=1.0.
  7. Apply Filter (pass Hann band) using the requested low/high cutoffs and 100 Hz smoothing.
  8. Rebuild the original channel count and apply attenuation-only peak safety at 0.95.

Pitch and channel behavior

Multichannel material is not collapsed for the final audio. A mono reference supplies one shared absolute shifted PitchTier, then every original channel is resynthesized independently and rebuilt into the original channel count. This means all channels receive the same pitch trajectory when pitch shifting is active, while their audio content otherwise remains separate through the channel processing chain.

If no voiced pitch points are detected, the requested pitch shift is skipped cleanly. Duration, formant and filter stages still run.

Visualization

Output