High-performance video frame extraction for Apple Silicon
- Hardware-accelerated extraction using AVFoundation/VideoToolbox
- MLX native with direct BGRA frame copy to
mx.array - Lightweight bindings using
nanobindand GIL release - Pythonic interface with simple iterators and context managers
Getting started
import viteo
# Simple iteration with context manager
with viteo.open("video.mp4") as frames:
for frame in frames:
# frame is MLX array (height, width, 4) BGRA format
process(frame)
# Direct extraction
extractor = viteo.FrameExtractor("video.mp4")
for frame in extractor:
process(frame)
Installation
pip install viteo
From source
git clone https://github.com/codeSamuraii/viteo
cd viteo
pip install -v -e .
Rebuilding
rm -rf dist/
pip install -e . --force-reinstall --no-deps
Requirements
- macOS with Apple Silicon (M1/M2/M3/M4)
- Python 3.8+
- MLX framework
1 maintainer
Metadata
1 maintainer
Release files for viteo 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| viteo-0.1.1.tar.gz | 11.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| viteo-0.1.1-cp313-cp313-macosx_15_0_arm64.whl | CPython 3.13 | CPython 3.13 | macOS 15.0+ ARM64 | Details |
Total release size: 56.9 kB
Release files / viteo-0.1.1.tar.gz
| Download URL | viteo-0.1.1.tar.gz |
|---|---|
| Size | 11.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1cb93dc5f0ef37cc9ae1011d8b8e3894efa3655e3178dd6d51550d88c695bddb
|
|
BLAKE2b-256 checksum How to use checksums |
027c9c57642d14b7bea10be6422420991774549527b4b6a5e11594c8c238132e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.3
|
Release files / viteo-0.1.1-cp313-cp313-macosx_15_0_arm64.whl
| Download URL | viteo-0.1.1-cp313-cp313-macosx_15_0_arm64.whl |
|---|---|
| Size | 45.5 kB |
| Tags | CPython 3.13 macOS 15.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
709ea7495d831c2a32d316856ef3aa5e6d1b8224bbb4d5c9b7f680d668c88d2d
|
|
BLAKE2b-256 checksum How to use checksums |
856892df43472113e4ee840e93da1acd4d5ee1d87ce6b798fb4a792d7f126d63
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.3
|
