Vidsrc is a Python library to read frames from video files as numpy arrays via the DirectShow IMediaDet interface.

Install the vidsrc package and all dependencies from the Python Package Index:

python -m pip install -U vidsrc

See Examples for using the programming interface.

Source code and support are available on GitHub.

This revision was tested with the following requirements and dependencies (other versions may work):

• CPython 3.9.13, 3.10.11, 3.11.7, 3.12.1
• Numpy 1.26.3
• Microsoft Visual Studio 2022 (build)
• DirectX 9.0c SDK (build)
• DirectShow BaseClasses include files (build)
• DirectShow STRMBASE.lib (build)

2024.1.6

• Support Python 3.12.
• Remove support for Python 3.8 and numpy 1.22 (NEP 29).

2022.9.28

• Update metadata.

2021.6.6

• Remove support for Python 3.6 (NEP 29).
• Fix compile error on PyPy3.

2020.1.1

• Remove support for Python 2.7 and 3.5.

The DirectShow IMediaDet interface is deprecated and may be removed from future releases of Windows (https://docs.microsoft.com/en-us/windows/desktop/directshow/imediadet).

To fix compile error C2146: syntax error: missing ';' before identifier 'PVOID64', change typedef void * POINTER_64 PVOID64; to typedef void * __ptr64 PVOID64; in winnt.h.

>>> from vidsrc import VideoSource
>>> video = VideoSource('test.avi', grayscale=False)
>>> len(video)  # number of frames in video
48
>>> video.duration  # length in s
1.6016
>>> video.framerate  # frames per second
29.970089850329373
>>> video.shape  # frames, height, width, color channels
(48, 64, 64, 3)
>>> frame = video[0]  # access first frame
>>> frame = video[-1]  # access last frame
>>> for frame in video:
...     pass  # do_something_with(frame)