ferraus guitar

Guitar amp chain: compressor, tone filter, distortion, cabinet

Synopsis

ferraus guitar <input> [options] [-o <output>]

A guitar-rig chain: optional compress for sustain, a pre-emphasis filter, drive into a 4x-oversampled waveshaper (clean, crunch, or lead voicing), a tone filter, and a speaker cabinet: your impulse response file with --cab (FFT convolution) or a built-in 4x12-style cabinet filter. The output level is matched to the input.

This command is also an fx stage and a pipeline op: ferraus fx in.wav -o out.wav --fx "guitar:key=value".

Examples

Crunch amp with the built-in cabinet

ferraus guitar di.wav -o amped.wav

Lead tone through your own cabinet impulse response

ferraus guitar di.wav --amp lead --cab 4x12.wav --drive 34dB --mix 80% -o lead.wav

Clean amp with no compressor, for open, dynamic chords

ferraus guitar di.wav --amp clean --compress off -o clean.wav

Crunch with a darker, mid-forward tone filter

ferraus guitar di.wav --amp crunch --filter lowpass:4kHz,peak:800Hz:+2dB -o mid.wav

Options

Flag	Type	Default	Meaning
`--amp`	clean \| crunch \| lead	`crunch`	Amp voicing
`--cab`	path	—	Cabinet impulse response (audio file); default is a built-in cabinet
`--filter`	list	`auto`	Tone filter(s) after the amp, e.g. lowpass:5kHz,peak:800Hz:+2dB, or 'auto' for the amp's voicing
`--drive`	text	`auto`	Drive into the amp in dB, or 'auto' (clean 6dB, crunch 18dB, lead 30dB)
`--compress`	on\|off	`on`	Compressor before the amp (on\|off)
`--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 --overwrite or a new -o path when re-running.

For models

MCP tool: ferraus_guitar
Schema: ferraus schema guitar
Pipeline: { op: guitar, args: { ... } } (flag names with _ instead of -)
fx stage: yes

{"command": "guitar", "defaults": {"amp": "crunch", "filter": "auto", "drive": "auto", "compress": "on", "mix": "100%"}}