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

FlagTypeDefaultMeaning
--histogramon|offoffAdd 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

CodeMeaning
0Success
1Processing failed
2Usage or parameter error
3Input missing or unreadable
4Unsupported format or codec
8Cancelled
70Internal 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_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"}}