Skip to main content

Crate framestrip

Crate framestrip 

Source
Expand description

Turn a video into a short, deduplicated, timestamped frame strip.

Decodes through the system ffmpeg binary (ffmpeg-sidecar), samples at a fixed rate, perceptually hashes each sampled frame, keeps a frame only when it differs from the last kept one, thins to a hard cap by dropping the smallest transitions, and returns each kept frame as JPEG with its source timestamp and hold duration.

let strip = framestrip::extract(std::path::Path::new("recording.mp4"), &framestrip::Options::default())?;
for frame in &strip.frames {
    println!("t={}ms held={}ms {} bytes", frame.ts_ms, frame.held_ms, frame.bytes.len());
}

See the spec (nous docs/spec/2026-09-22-video-evidence.md §2) for the normative contract this crate implements.

Structs§

Frame
One kept frame.
Options
Extraction parameters.
Probe
What ffprobe reported about the input.
Strip
The extraction result.
Tooling
The resolved decoder binaries.

Enums§

Error
Why extraction did not produce a strip.

Functions§

extract
Decode, sample, deduplicate, cap, and encode. Blocking; run it off any async executor.
probe
Probe a video without decoding it.
tooling
Locate and verify ffmpeg/ffprobe once; later calls return the cached result.