ferraus vibrato
Vibrato (pitch modulation)
Synopsis
ferraus vibrato <input> [options] [-o <output>]
What it does
Modulates pitch with a sinusoidally swept delay; --depth is the peak deviation in cents. The constant delay is compensated so the output lines up with the input.
This command is also an fx stage and a pipeline op: ferraus fx in.wav -o out.wav --fx "vibrato:key=value".
Examples
Subtle vocal vibrato
ferraus vibrato vox.wav -o vox_vib.wav
Wider vibrato
ferraus vibrato synth.wav --rate 6.5Hz --depth 50cents -o wobble.wav
Slow, gentle vibrato on a held flute note
ferraus vibrato flute.wav --rate 4.5Hz --depth 15cents -o flute_vib.wav
Fast one-semitone wobble blended with the dry lead for a detuned effect
ferraus vibrato lead.wav --rate 7Hz --depth 100cents --mix 50% -o lead_detune.wav
Options
| Flag | Type | Default | Meaning |
|---|---|---|---|
--rate | frequency | 5Hz | LFO rate |
--depth | cents|semitones | 20cents | Peak pitch deviation (cents or semitones) |
--mix | percent | 100% | Dry/wet balance: 0% returns the input unchanged, 100% is fully processed |
Global options
Every command also accepts the global options (-o, --json, --dry-run, --overwrite, --progress, ...). See Global options.
Exit codes
| Code | Meaning |
|---|---|
| 0 | Success |
| 1 | Processing failed |
| 2 | Usage or parameter error |
| 3 | Input missing or unreadable |
| 4 | Unsupported format or codec |
| 8 | Cancelled |
| 70 | Internal error (bug) |
Common mistakes
- Forgetting that outputs are never overwritten: pass
--overwriteor a new-opath when re-running.
For models
- MCP tool:
ferraus_vibrato - Schema:
ferraus schema vibrato - Pipeline:
{ op: vibrato, args: { ... } }(flag names with_instead of-) - fx stage: yes
{"command": "vibrato", "defaults": {"rate": "5Hz", "depth": "20cents", "mix": "100%"}}