ferraus analyze silence

List silent regions with start, end, and floor level

Synopsis

ferraus analyze silence <input> [options] [-o <output>]

What it does

List silent regions with start, end, and floor level

Examples

Pauses longer than a second

ferraus analyze silence podcast.wav --threshold -50dB --min 1s

Silent regions with the defaults (-40 dB, at least 300 ms)

ferraus analyze silence take.wav --json

Short gaps in a quiet field recording

ferraus analyze silence field.wav --threshold -60dB --min 100ms --json

Options

FlagTypeDefaultMeaning
--thresholdgain-40dBLevel below which audio counts as silence (RMS, loudest channel)
--mintime300msShortest region reported

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.
  • Beat-based times (4b, 1/4) need a tempo: pass --bpm or write 4b@120.
  • Gains need a unit when not in dB: 0.5x is a factor, -6 and -6dB are decibels.

For models

  • MCP tool: ferraus_analyze_silence
  • Schema: ferraus schema analyze silence
  • Pipeline: { op: analyze silence, args: { ... } } (flag names with _ instead of -)
  • fx stage: no
{"command": "analyze silence", "defaults": {"threshold": "-40dB", "min": "300ms"}}