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

//! Extract video frames from a media file.
//!
//! Usage:
//!   cargo run --example extract_frames -- <input_file>

use std::error::Error;
use std::time::Duration;

use unbundle::{FrameRange, MediaFile};

fn main() -> Result<(), Box<dyn Error>> {
    let input_path = std::env::args()
        .nth(1)
        .unwrap_or_else(|| "input.mp4".to_string());

    println!("Opening {input_path}...");
    let mut unbundler = MediaFile::open(&input_path)?;

    // Print video metadata.
    let metadata = unbundler.metadata();
    if let Some(video_metadata) = &metadata.video {
        println!(
            "Video: {}x{}, {:.2} fps, {} frames",
            video_metadata.width,
            video_metadata.height,
            video_metadata.frames_per_second,
            video_metadata.frame_count,
        );
    }

    // Extract the first frame.
    println!("Extracting first frame...");
    let frame = unbundler.video().frame(0)?;
    frame.save("frame_first.png")?;
    println!("Saved frame_first.png");

    // Extract a frame at the 5-second mark.
    println!("Extracting frame at 5 seconds...");
    let frame = unbundler.video().frame_at(Duration::from_secs(5))?;
    frame.save("frame_5s.png")?;
    println!("Saved frame_5s.png");

    // Extract every 30th frame.
    println!("Extracting every 30th frame...");
    let frames = unbundler.video().frames(FrameRange::Interval(30))?;
    for (index, frame) in frames.iter().enumerate() {
        let filename = format!("frame_interval_{index}.png");
        frame.save(&filename)?;
    }
    println!("Saved {} interval frames", frames.len());

    // Extract specific frames.
    println!("Extracting specific frames [0, 50, 100]...");
    let frames = unbundler
        .video()
        .frames(FrameRange::Specific(vec![0, 50, 100]))?;
    for (index, frame) in frames.iter().enumerate() {
        let filename = format!("frame_specific_{index}.png");
        frame.save(&filename)?;
    }
    println!("Saved {} specific frames", frames.len());

    println!("Done!");
    Ok(())
}