Quite often I find myself writing scripts which need to load a few frames from a video file, process them and save the result to disk. It’s a pain to implement video opening, seeking and decoding over and over again and complex Python bindings are a little overkill for my needs.
Videosequence is a library which hides the complexity of simply opening a video file in Python as a sequence of images. It exposes a video file as just that: a Python sequence type containing PIL Image-s.
For example, suppose you want to dump every frame from a video stored in foo.mp4 starting from frame 100:
from contextlib import closing
from videosequence import VideoSequence
with closing(VideoSequence("foo.mp4")) as frames:
for idx, frame in enumerate(frames[100:]):
frame.save("frame{:04d}.jpg".format(idx))You can load a single frame from a sequence just as easily. Let’s dump the final frame to another JPEG:
from contextlib import closing
from videosequence import VideoSequence
with closing(VideoSequence("foo.mp4")) as frames:
frames[-1].save("final-frame.jpg")In general, the VideoSequence behaves as if it were a long list of each frame in the video.
What VideoSequence does
Frame-accurate seeking
Single frame indexing (vs[0], vs[-4], etc.)
Querying the length of the video (len(vs))
Slicing a sequence of frames (vs[100:], vs[-20:], vs[10:20], vs[::2], etc.)
Frames are represented as RGB PIL Image objects.
Can interoperate with numpy. E.g. np.asarray(vs[0]).
What VideoSequence does not
Handle files without exactly one (and only one) video stream
Audio
Caveats
Iterating forward one frame at a time is fast. Tricks such as iterating backwards or skipping n frames at a time work but is likely to be slow.
The implementation is based on GStreamer and so de facto only works on a modern Unix-alike such as Linux or FreeBSD.
The PyGObject introspection libraries must be installed. (See below.)
Installing
See the sections below for any OS-specific instructions. VideoSequence can be installed from the PyPI:
$ pip install --user videosequenceIt can also be installed directly from git:
$ pip install --user git+git://github.com/rjw57/videosequenceUbuntu and Debian
To install the Python GObject bindings:
$ sudo apt install gir1.2-gstreamer-1.0 gir1.2-gst-plugins-base-1.0 \
python-gi python3-giGStreamer is almost certainly already installed if you’ve got some modern desktop environment. If not:
$ sudo apt install libgstreamer1.0-dev gstreamer1.0-plugins-goodContributing
Bug fixes and ports to new backends welcome. Please make sure that the tests still pass via tox before opening a new pull request. New functionality should come with tests, please.
Copyright and licensing
Videosequence is © 2016 Rich Wareham. Full licence details can be found in the LICENCE.txt file.
1 maintainer
Metadata
1 maintainer
Release files for videosequence 1.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| videosequence-1.1.0.tar.gz | 5.6 kB | Without provenance | Details for videosequence-1.1.0.tar.gz |
Release files / videosequence-1.1.0.tar.gz
| Download URL | videosequence-1.1.0.tar.gz |
|---|---|
| Size | 5.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
062e4581f99ea70de42e1907ac87da49f419b91c6ce68e320901109578d3dd7b
|
|
BLAKE2b-256 checksum How to use checksums |
0de51888f72156e5d0625283c3d1586a72a58b7ddd715f29247ea10e63af7201
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Security for videosequence 1.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
