ferraus analyze problems
Diagnose clipping, DC, clicks, hum, hiss, phase, silence, and more
Synopsis
ferraus analyze problems <input> [options] [-o <output>]
What it does
Each problem has a severity (low, medium, high), details, and a suggested fix that is a runnable command or fx stage, e.g. 'dc-remove', 'declip', 'highpass:freq=30Hz', or 'silence trim --edges'.
Examples
Diagnostics with suggested fixes
ferraus analyze problems take.wav --json
Apply two suggested fixes
ferraus fx take.wav -o fixed.wav --fx dc-remove --fx "highpass:freq=30Hz"
Only the medium and high severity problems
ferraus analyze problems interview.wav --min-severity medium --json
Options
| Flag | Type | Default | Meaning |
|---|---|---|---|
--min-severity | low | medium | high | low | Only list problems at or above this severity |
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_analyze_problems - Schema:
ferraus schema analyze problems - Pipeline:
{ op: analyze problems, args: { ... } }(flag names with_instead of-) - fx stage: no
{"command": "analyze problems", "defaults": {"min_severity": "low"}}