avio 0.13.1

Safe, high-level audio/video/image processing for Rust — backend-agnostic multimedia toolkit
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128

//! Print container and stream metadata from a media file without a separate probe call.
//!
//! Demonstrates [`VideoDecoder::container_info`] and [`AudioDecoder::container_info`]
//! alongside the existing [`VideoDecoder::stream_info`] / [`AudioDecoder::stream_info`]
//! APIs. Both are available immediately after `.build()` at no extra file-open cost.
//!
//! # Usage
//!
//! ```bash
//! # Video file
//! cargo run --example decode_metadata --features decode -- --input video.mp4
//!
//! # Audio-only file
//! cargo run --example decode_metadata --features decode -- --input audio.mp3
//! ```

use std::process;
use std::time::Duration;

use avio::{AudioDecoder, VideoDecoder};

fn fmt_duration(d: Duration) -> String {
    let s = d.as_secs();
    let h = s / 3600;
    let m = (s % 3600) / 60;
    let sec = s % 60;
    let ms = d.subsec_millis();
    format!("{h:02}:{m:02}:{sec:02}.{ms:03}")
}

fn fmt_bitrate(bps: u64) -> String {
    if bps >= 1_000_000 {
        // Integer arithmetic: round to one decimal place without f64 cast precision issues
        let whole = bps / 1_000_000;
        let frac = (bps % 1_000_000) / 100_000;
        format!("{whole}.{frac} Mbps")
    } else {
        format!("{} kbps", bps / 1_000)
    }
}

fn main() {
    let mut args = std::env::args().skip(1);
    let mut input = None::<String>;

    while let Some(flag) = args.next() {
        match flag.as_str() {
            "--input" | "-i" => input = Some(args.next().unwrap_or_default()),
            other => {
                eprintln!("Unknown flag: {other}");
                process::exit(1);
            }
        }
    }

    let input = input.unwrap_or_else(|| {
        eprintln!("Usage: decode_metadata --input <file>");
        process::exit(1);
    });

    // ── Try video decoder first ───────────────────────────────────────────────
    let video_result = VideoDecoder::open(&input).build();

    if let Ok(dec) = video_result {
        let ci = dec.container_info();
        let si = dec.stream_info();

        println!("Container");
        println!("  format:     {}", ci.format_name());
        match ci.bit_rate() {
            Some(br) => println!("  bit_rate:   {}", fmt_bitrate(br)),
            None => println!("  bit_rate:   (unknown)"),
        }
        println!("  nb_streams: {}", ci.nb_streams());
        println!();

        println!("Video stream");
        println!(
            "  codec:      {}  {}×{}  {:?}  {:.3} fps",
            si.codec_name(),
            si.width(),
            si.height(),
            si.pixel_format(),
            si.fps(),
        );
        match dec.duration_opt() {
            Some(d) => println!("  duration:   {}", fmt_duration(d)),
            None => println!("  duration:   (unknown — live stream or raw format)"),
        }
        return;
    }

    // ── Fall back to audio decoder ────────────────────────────────────────────
    let audio_result = AudioDecoder::open(&input).build();

    match audio_result {
        Ok(dec) => {
            let ci = dec.container_info();
            let si = dec.stream_info();

            println!("Container");
            println!("  format:     {}", ci.format_name());
            match ci.bit_rate() {
                Some(br) => println!("  bit_rate:   {}", fmt_bitrate(br)),
                None => println!("  bit_rate:   (unknown)"),
            }
            println!("  nb_streams: {}", ci.nb_streams());
            println!();

            println!("Audio stream");
            println!(
                "  codec:      {}  {} Hz  {}ch  {:?}",
                si.codec_name(),
                si.sample_rate(),
                si.channels(),
                si.sample_format(),
            );
            match dec.duration_opt() {
                Some(d) => println!("  duration:   {}", fmt_duration(d)),
                None => println!("  duration:   (unknown — live stream or raw format)"),
            }
        }
        Err(e) => {
            eprintln!("Error: could not open '{input}' as video or audio: {e}");
            process::exit(1);
        }
    }
}