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
ffprobereported about the input. - Strip
- The extraction result.
- Tooling
- The resolved decoder binaries.
Enums§
- Error
- Why extraction did not produce a strip.