https://github.com/cgohlke/vidsrc

Video frameserver for NumPy.

https://github.com/cgohlke/vidsrc

Science Score: 36.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
    1 of 2 committers (50.0%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (10.7%) to scientific vocabulary

Keywords

format-reader python video windows
Last synced: 5 months ago · JSON representation

Repository

Video frameserver for NumPy.

Basic Info
Statistics
  • Stars: 2
  • Watchers: 2
  • Forks: 0
  • Open Issues: 0
  • Releases: 0
Topics
format-reader python video windows
Created almost 6 years ago · Last pushed 7 months ago
Metadata Files
Readme License

README.rst

..
  This file is generated by setup.py

Video Frameserver for Numpy
===========================

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

:Author: `Christoph Gohlke `_
:License: BSD-3-Clause
:Version: 2025.8.1

Quickstart
----------

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 `_.

Requirements
------------

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

- `CPython `_ 3.11.9, 3.12.10, 3.13.5, 3.14.0rc 64-bit
- `NumPy `_ 2.3.2
- Microsoft Visual Studio 2022 (build)
- DirectX 9.0c SDK (build)
- DirectShow BaseClasses include files (build)
- DirectShow STRMBASE.lib (build)

Revisions
---------

2025.8.1

- Drop support for Python 3.10, support Python 3.14.

2025.1.6

- Add type hints.
- Drop support for Python 3.9, support Python 3.13 and NumPy 2.

2024.1.6

- Support Python 3.12.
- Drop support for Python 3.8 and NumPy 1.22 (NEP 29).

2022.9.28

- Update metadata.

2021.6.6

- Drop support for Python 3.6 (NEP 29).
- Fix compile error on PyPy3.

2020.1.1

- Drop support for Python 2.7 and 3.5.

Notes
-----

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``.

Examples
--------

.. code-block:: python

    >>> 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)

Owner

  • Name: Christoph Gohlke
  • Login: cgohlke
  • Kind: user
  • Location: Irvine, California

GitHub Events

Total
  • Watch event: 1
  • Push event: 2
  • Create event: 2
Last Year
  • Watch event: 1
  • Push event: 2
  • Create event: 2

Committers

Last synced: over 1 year ago

All Time
  • Total Commits: 42
  • Total Committers: 2
  • Avg Commits per committer: 21.0
  • Development Distribution Score (DDS): 0.238
Past Year
  • Commits: 5
  • Committers: 1
  • Avg Commits per committer: 5.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Christoph Gohlke c****e@u****u 32
Christoph Gohlke c****e@c****m 10
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 7 months ago

All Time
  • Total issues: 1
  • Total pull requests: 0
  • Average time to close issues: about 12 hours
  • Average time to close pull requests: N/A
  • Total issue authors: 1
  • Total pull request authors: 0
  • Average comments per issue: 6.0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • e-d-n-a (1)
Pull Request Authors
Top Labels
Issue Labels
Pull Request Labels

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 341 last-month
  • Total dependent packages: 1
  • Total dependent repositories: 1
  • Total versions: 9
  • Total maintainers: 1
pypi.org: vidsrc

Video Frameserver for Numpy

  • Versions: 9
  • Dependent Packages: 1
  • Dependent Repositories: 1
  • Downloads: 341 Last month
Rankings
Dependent packages count: 10.1%
Downloads: 14.8%
Dependent repos count: 21.6%
Average: 21.6%
Forks count: 29.8%
Stargazers count: 31.9%
Maintainers (1)
Last synced: 7 months ago

Dependencies

setup.py pypi
  • numpy >=1.15.1
pyproject.toml pypi