ferraus analyze stats
Per-channel peak, true peak, RMS, DC, crest factor, dynamic range
Synopsis
ferraus analyze stats <input> [options] [-o <output>]
What it does
Per-channel peak, true peak, RMS, DC, crest factor, dynamic range
Examples
Amplitude statistics with histograms
ferraus analyze stats take.wav --histogram on --json
Peak, true peak, RMS, DC offset, and crest factor per channel
ferraus analyze stats mix.wav --json
Save the statistics of a master as JSON
ferraus analyze stats master.wav --json > stats.json
Options
| Flag | Type | Default | Meaning |
|---|---|---|---|
--histogram | on|off | off | Add a 61-bin dB histogram per channel (-60..0 dBFS) |
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_stats - Schema:
ferraus schema analyze stats - Pipeline:
{ op: analyze stats, args: { ... } }(flag names with_instead of-) - fx stage: no
{"command": "analyze stats", "defaults": {"histogram": "off"}}