#h264 #video-stream #video-streaming #v4l2 #camera #capture

h264_webcam_stream

Capture h264 video from v4l2 cameras in Linux

1 unstable release

0.1.0 Dec 10, 2022

#431 in Video

MIT/Apache

12KB
186 lines

h264_webcam_stream

This crate provides h264 video streams from any v4l2 video device.

Video devices that only support mjpeg are re-encoded as h264 by the openh264 library (A C++ encoder which should work on any CPU architectures).

Capturing H264 Video

Streaming an h264 file to video is simple:

fn main() -> Result<()> {
    let device_path = Path::new("/dev/video0");
    let max_fps = 60;

    let mut device = h264_webcam_stream::get_device(&device_path)?;
    let mut stream = h264_webcam_stream::stream(&mut device, max_fps)?;

    let mut f = std::fs::File::create("./test.h264")?;

    for _ in 0..120 {
        let (h264_bytes, _) = stream.next(false)?;
        // Record the h264 video to a file
        f.write_all(&h264_bytes[..])?;
    }

    Ok(())
}

Listing Video Capture Devices

Getting a list of the video capture devices is also easy:

let devices: Vec<_> = h264_webcam_stream::list_devices()
    .into_iter()
    .collect();

println!("Video devices: {:?}", devices);

Capturing Still Images

h264_webcam_stream supports capturing YUV-encoded images at the same time as the H264 video stream.

The YUV image capture can be useful for capturing still images from the video feed or for creating a timelapse video by selectively re-encoding frames as h264 at a fixed interval or based on some external trigger.

To enable image capture along side video capture, pass true to stream.next:

let (h264_bytes, yuv_still_image) = stream.next(true)?;

Linux Only

This crate only supports Linux for the time being.

I have no plans to implement support for other operating systems myself but if you would like to implement h264 webcam streaming for another OS please feel welcome to submit a pull request!

Dependencies

~11MB
~169K SLoC