#video #gstreamer #audio-video #audio


Use video content as collection of images

2 releases

0.1.1 Apr 25, 2022
0.1.0 Mar 13, 2021

#156 in Multimedia

MIT license

210 lines

vid2img - Video to Image

vid2img is a Rust crate that allows the use of a video file as a collection of frame images. This crate exposes a FileSource type that accepts a video file path and the desired size of the frames, then you can convert the instance into a iterator (.into_iter()). On every iteration you will receive a video frame data encoded as PNG.

use std::path::Path;
use vid2img::FileSource;

fn main() {
    let file_path = Path::new("video.mp4");

    let frame_source = FileSource::new(file_path, (200, 200)).unwrap();
    for frame in frame_source.into_iter() {
        if let Ok(Some(png_img_data)) = frame {
            // do something with the image data here ...

We use GStreamer for processing the video and capturing the frames. We make use of the official Rust wrapper to the GStreamer API.


As we use GStreamer, the installation steps for the GStreamer-rs crate must be followed.

We make use of the following GStreamer plugins: uridecodebin, videoconvert, videoscale, capsfilter, pngenc, appsrc.


To use this library, add the following dependency to Cargo.toml:

vid2img = "0.1.0"


~226K SLoC