Skip to main content

silence_detection/
silence_detection.rs

1//! Detect silent intervals in an audio file and print their time ranges.
2//!
3//! Uses [`SilenceDetector`] to find audio segments where the amplitude stays
4//! below a configurable threshold for at least a minimum duration.
5//!
6//! # Usage
7//!
8//! ```bash
9//! cargo run --example silence_detection -- --input audio.mp3
10//! cargo run --example silence_detection -- \
11//!     --input audio.mp3 --threshold-db -50 --min-duration-ms 300
12//! ```
13
14use std::process;
15use std::time::Duration;
16
17use ff_analysis::{SilenceDetector, SilenceRange};
18
19fn fmt_duration(d: Duration) -> String {
20    let secs = d.as_secs_f64();
21    format!("{secs:.3}s")
22}
23
24fn main() {
25    let mut args = std::env::args().skip(1);
26    let mut input = None::<String>;
27    let mut threshold_db = -40.0_f32;
28    let mut min_duration_ms = 500u64;
29
30    while let Some(flag) = args.next() {
31        match flag.as_str() {
32            "--input" | "-i" => input = Some(args.next().unwrap_or_default()),
33            "--threshold-db" => {
34                let raw = args.next().unwrap_or_default();
35                threshold_db = raw.parse().unwrap_or_else(|_| {
36                    eprintln!("Invalid threshold-db: {raw}");
37                    process::exit(1);
38                });
39            }
40            "--min-duration-ms" => {
41                let raw = args.next().unwrap_or_default();
42                min_duration_ms = raw.parse().unwrap_or_else(|_| {
43                    eprintln!("Invalid min-duration-ms: {raw}");
44                    process::exit(1);
45                });
46            }
47            other => {
48                eprintln!("Unknown flag: {other}");
49                process::exit(1);
50            }
51        }
52    }
53
54    let input = input.unwrap_or_else(|| {
55        eprintln!(
56            "Usage: silence_detection --input <audio> \
57             [--threshold-db <dB>] [--min-duration-ms <ms>]"
58        );
59        process::exit(1);
60    });
61
62    println!("Detecting silence in: {input}");
63    println!("Threshold: {threshold_db:.1} dBFS");
64    println!("Minimum duration: {min_duration_ms} ms");
65    println!();
66
67    let ranges: Vec<SilenceRange> = SilenceDetector::new(&input)
68        .threshold_db(threshold_db)
69        .min_duration(Duration::from_millis(min_duration_ms))
70        .run()
71        .unwrap_or_else(|e| {
72            eprintln!("Error: {e}");
73            process::exit(1);
74        });
75
76    if ranges.is_empty() {
77        println!("No silence detected.");
78    } else {
79        println!("Detected {} silent interval(s):", ranges.len());
80        println!("{:<14}  {:<14}  {:<12}", "Start", "End", "Duration");
81        println!("{}", "-".repeat(44));
82        for r in &ranges {
83            let duration = r.end.saturating_sub(r.start);
84            println!(
85                "{:<14}  {:<14}  {:<12}",
86                fmt_duration(r.start),
87                fmt_duration(r.end),
88                fmt_duration(duration)
89            );
90        }
91    }
92}