acvr provides frame-accurate video access with an array-style interface. It is built on PyAV and focuses on reliable random access for variable-frame-rate assets.

Highlights

  • Array-style access (reader[100]) for frames
  • Iteration over frames (for frame in reader)
  • Context manager support (with VideoReader(path) as reader)
  • Accurate seeking using timestamps and keyframe indexes
  • Accurate, fast, and scrub read modes for latency/precision tradeoffs
  • Optional LRU caches for decoded frames and scrub keyframe buckets

Installation

pip install acvr

For development extras (OpenCV + pytest):

pip install acvr[dev]