Pupil Labs Video
A high-level wrapper of PyAV providing an easy to use interface to video data.
The goal of this library is to provide a simple interface while maintaining good computational performance. At current, only MP4 and MJPEG videos are officially compatible.
Features include:
- Performant reading of video files (optionally including audio) utilizing multi-threading.
- Ability to arbitrarily index frames by their index or timestamp.
- Ability to slice the video by frame index or time. Large slices will be loaded lazily to avoidexcessive RAM consumption.
- A frame buffer is maintained to cache frames close to the current decoding position, which avoids repetitive seeking when going back and forth between frames in the same neighborhood or iterating backwards.
- Avoids demuxing and seeking operations as much as possible.
- Reading multi-part video files (e.g. how they are generated by Neon or Pupil Invisible).
Installation
pip install pupil-labs-video
or
pip install -e git+https://github.com/pupil-labs/pl-video.git
Quick Start
You can open a video file and read frames like this:
import pupil_labs.video as plv
with plv.Reader(video_path) as video:
# Iterate through video frames
for frame in video:
# Convert video frame to BGR array
img = frame.bgr
# Index individual frames or slices
first_frame = video[0]
last_frame = video[-1]
frames = video[10:20]
# Index frames by time
ts = video[10].time
frame = video.by_container_timestamps[ts]
frames = video.by_container_timestamps[ts : ts + 10]
You can write video files like this:
import pupil_labs.video as plv
with (plv.Writer(out_path) as writer):
for img in images:
writer.write_image(img)
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file pupil_labs_video-1.0.13.tar.gz.
File metadata
- Download URL: pupil_labs_video-1.0.13.tar.gz
- Upload date:
- Size: 323.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7fee344732baea2758325bc964f2cdc6ebd1a9a7c5feaedfac65b25b2280f305
|
|
| MD5 |
84736f6a5924502a1ad5c702418b6a08
|
|
| BLAKE2b-256 |
8b5e059dfef3a1a8cf22c01faa84cfaa9d895a195544749d0d8684a02e9f401b
|
Provenance
The following attestation bundles were made for pupil_labs_video-1.0.13.tar.gz:
Publisher:
on-release-main.yml on pupil-labs/pl-video
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pupil_labs_video-1.0.13.tar.gz -
Subject digest:
7fee344732baea2758325bc964f2cdc6ebd1a9a7c5feaedfac65b25b2280f305 - Sigstore transparency entry: 1935817398
- Sigstore integration time:
-
Permalink:
pupil-labs/pl-video@70972624dde6cc8b9e51d0091fbd098bcd98f0d3 -
Branch / Tag:
refs/tags/v1.0.13 - Owner: https://github.com/pupil-labs
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
on-release-main.yml@70972624dde6cc8b9e51d0091fbd098bcd98f0d3 -
Trigger Event:
release
-
Statement type:
File details
Details for the file pupil_labs_video-1.0.13-py3-none-any.whl.
File metadata
- Download URL: pupil_labs_video-1.0.13-py3-none-any.whl
- Upload date:
- Size: 21.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4e94fc1b30b6eba43eb8f858a07e18705e5d9e1609f374aaa1cdd779ec31e80d
|
|
| MD5 |
05319de981face1aa6c0fbca137294fc
|
|
| BLAKE2b-256 |
7c642226ba7c935b79a4052cdff4680d5d66bb90db1cdf7c81068179da10ddb8
|
Provenance
The following attestation bundles were made for pupil_labs_video-1.0.13-py3-none-any.whl:
Publisher:
on-release-main.yml on pupil-labs/pl-video
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
pupil_labs_video-1.0.13-py3-none-any.whl -
Subject digest:
4e94fc1b30b6eba43eb8f858a07e18705e5d9e1609f374aaa1cdd779ec31e80d - Sigstore transparency entry: 1935817436
- Sigstore integration time:
-
Permalink:
pupil-labs/pl-video@70972624dde6cc8b9e51d0091fbd098bcd98f0d3 -
Branch / Tag:
refs/tags/v1.0.13 - Owner: https://github.com/pupil-labs
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
on-release-main.yml@70972624dde6cc8b9e51d0091fbd098bcd98f0d3 -
Trigger Event:
release
-
Statement type:
