---
id: pyobjc-framework-videotoolbox
version: "12.2.2"
license: MIT
license_treatment: permissive
maintenance: active
---

# pyobjc-framework-VideoToolbox — Wrappers for the framework VideoToolbox on macOS

License: permissive · Maintenance: active · Downloads: 655.8K/mo

## What it is and what it does

This package wraps Apple's VideoToolbox framework for use in Python, allowing developers to access native macOS video encoding, decoding, and processing capabilities. It is part of the PyObjC project and provides low-level bindings to Objective-C APIs without bundled documentation—users must consult Apple's framework documentation and PyObjC's general translation guides.

The package is macOS-only and requires Python 3.10 or later. It depends on pyobjc-core and three other PyObjC framework wrappers (Cocoa, Quartz, CoreMedia). Installation is straightforward on supported macOS versions, but the platform restriction and compiled-wheel distribution mean it will not work on Linux or Windows.

Use it for:

- Build macOS video editing or transcoding tools that leverage hardware-accelerated codec support.
- Integrate native VideoToolbox compression sessions into Python media applications on macOS.
- Access low-level video frame processing APIs for real-time video capture or streaming on macOS.
- Develop macOS-specific video analysis or manipulation pipelines using native framework performance.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides Python bindings to macOS's VideoToolbox framework, enabling video encoding, decoding, and processing through native Objective-C APIs.

Yes, if you are developing on macOS and need direct access to VideoToolbox's video encoding/decoding capabilities. The package is actively maintained, has no known vulnerabilities, and offers a permissive license. Install friction is medium due to platform specificity and multiple framework dependencies, but this is unavoidable for native Objective-C bindings. Not suitable for cross-platform projects.

## Install

pip install pyobjc-framework-videotoolbox
uv add pyobjc-framework-videotoolbox
poetry add pyobjc-framework-videotoolbox

## Installing pyobjc-framework-VideoToolbox

Before you install: Medium install friction: macOS-only wheels with platform-specific requirements across Python 3.10–3.15. Active maintenance (last commit 2026-08-14, release 3 days old) and stable status mitigate friction. Requires pyobjc-core and three additional framework dependencies.

License in practice: MIT license is permissive; no restrictions on commercial or private use, modification, or redistribution.

Quickstart:

pip install pyobjc-framework-videotoolbox

from VideoToolbox import VTCompressionSessionCreate
# Use VideoToolbox APIs via the wrapper

macOS only; requires Python 3.10 or later and a compatible macOS version matching the wheel (10.9 or 10.13+).

Verify before relying:

- Specific VideoToolbox APIs exposed by this wrapper version (12.2.2) and their stability.
- Performance characteristics or overhead of the Python-to-Objective-C translation layer.
- Whether free-threading support (Python 3.13+) is fully tested with VideoToolbox operations.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 655.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

macos video encoding decoding, videotoolbox python bindings, pyobjc framework wrapper, native macos video processing, objective-c video framework, macos hardware video codec, macos-only, video-codec, objective-c-bindings

[View on SkillFed](https://skillfed.io/packages/pyobjc-framework-videotoolbox) · [View on PyPI](https://pypi.org/project/pyobjc-framework-videotoolbox/)