unbundle 5.2.0

Unbundle media files - extract still frames, audio tracks, and subtitles from video files
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

//! Search subtitles and display extended container metadata.
//!
//! Usage: `cargo run --example subtitle_search -- path/to/video_with_subs.mkv`

use std::time::Duration;

use unbundle::{MediaFile, UnbundleError};

fn main() -> Result<(), UnbundleError> {
    let path = std::env::args()
        .nth(1)
        .expect("Usage: subtitle_search <video_path>");

    let mut unbundler = MediaFile::open(&path)?;

    // Display container tags.
    let meta = unbundler.metadata();
    if let Some(tags) = &meta.tags {
        println!("Container tags:");
        for (key, value) in tags {
            println!("  {key}: {value}");
        }
    } else {
        println!("No container tags found.");
    }

    // Display colorspace info.
    if let Some(video) = &meta.video {
        println!("\nColorspace info:");
        println!("  Color space: {:?}", video.color_space);
        println!("  Color range: {:?}", video.color_range);
        println!("  Color primaries: {:?}", video.color_primaries);
        println!("  Color transfer: {:?}", video.color_transfer);
        println!("  Bits per raw sample: {:?}", video.bits_per_raw_sample);
        println!("  Pixel format: {:?}", video.pixel_format_name);
    }

    // Search subtitles.
    if meta.subtitle.is_some() {
        println!("\nSearching subtitles for 'hello'...");
        let results = unbundler.subtitle().search("hello")?;
        if results.is_empty() {
            println!("  No matches found.");
        } else {
            for event in &results {
                println!(
                    "  [{:?} – {:?}] {}",
                    event.start_time, event.end_time, event.text
                );
            }
        }

        // Time-range extraction.
        println!("\nSubtitles in first 3 seconds:");
        let range = unbundler
            .subtitle()
            .extract_range(Duration::ZERO, Duration::from_secs(3))?;
        for event in &range {
            println!(
                "  [{:?} – {:?}] {}",
                event.start_time, event.end_time, event.text
            );
        }
    } else {
        println!("\nNo subtitle stream found.");
    }

    Ok(())
}