Registry / serialization / pyobjc-framework-videotoolbox

pyobjc-framework-videotoolbox

library12.2pypypiunverified

This library provides Python wrappers for the macOS VideoToolbox framework, enabling access to its functionalities for video compression, decompression, and processing. It is part of the larger PyObjC project, which bridges Python and Objective-C, and typically sees releases aligned with macOS SDK updates.

serialization

pip install pyobjc-framework-videotoolbox

github ↗package ↗docs ↗

INSTALL

IMPORT

SIG · PYOBJC-FRAMEWORK-V

pyobjc-framework-videotoolbox

serializationpythonv12.2

Install

—

Import

—

Disk

—

Pass rate

0/ 10

Env Coverage0 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v? · pip install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.920 runs

build_error

glibc

py 3.10–3.920 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

VideoToolbox

✓ from VideoToolbox import VTCopyVideoEncoderList

This quickstart demonstrates how to import and use a basic function from the VideoToolbox framework to list available video encoders on the system.

import objc from VideoToolbox import VTCopyVideoEncoderList # Get a list of available video encoders # VTCopyVideoEncoderList takes a CFDictionaryRef as an argument, or None for default encoder_list = VTCopyVideoEncoderList(None) if encoder_list: print(f"Found {len(encoder_list)} video encoders:") for encoder in encoder_list: # encoder is an NSDictionary (bridged to Python dict) print(f" - {encoder.get('kVTVideoEncoderComponentDisplayName', 'Unknown Encoder')}") print(f" Type: {encoder.get('kVTVideoEncoderComponentType', 'Unknown')}") else: print("No video encoders found.")

Debug

Known issues

breakingPyObjC 12.0 and later dropped support for Python 3.9.

fix

Upgrade to Python 3.10 or newer. If you must use Python 3.9, pin pyobjc-framework-videotoolbox to `<12.0`.

affects: >=12.0

breakingPyObjC 11.0 and later dropped support for Python 3.8.

fix

Upgrade to Python 3.9 or newer. If you must use Python 3.8, pin pyobjc-framework-videotoolbox to `<11.0`.

affects: >=11.0

breakingPyObjC 11.1 changed how `init` methods in Python subclasses interact with Objective-C's Automatic Reference Counting (ARC). PyObjC now correctly models that methods in the 'init' family steal a reference to self and return a new reference.

fix

Review Python subclasses that implement `init` methods to ensure they correctly handle object ownership and ARC semantics, as incorrect handling can lead to memory leaks or premature deallocation.

affects: >=11.1

gotchaInteraction between `__new__` and `__init__` in Python subclasses changed in PyObjC 10.3 and 10.3.1. While 10.3 removed support for calling `__init__` in some cases, 10.3.1 re-enabled it for classes with user-implemented `__new__`. However, if relying on PyObjC's default `__new__`, `__init__` might not be called.

fix

If implementing custom `__new__` in an `objc.lookUpClass` or `objc.subclass` derived class, ensure `__init__` is explicitly called if needed. If using PyObjC's default `__new__`, be aware that `__init__` might be bypassed, requiring initialization logic to be handled elsewhere (e.g., in `__new__` or a class method).

affects: >=10.3

gotchaPyObjC's experimental support for free-threading (PEP 703) introduced in Python 3.13 is still evolving. Earlier PyObjC versions (e.g., 10.3) explicitly stated no support.

fix

Exercise caution when using PyObjC with free-threading in Python 3.13 or newer. Thoroughly test thread-safe operations, as the feature is experimental and may have unexpected interactions or stability issues.

affects: >=10.3 (experimental in >=11.0)

gotchaAs of PyObjC 10.1, `os.fspath(someURL)` will raise a `TypeError` for Cocoa `NSURL` (or `CFURLRef`) instances that do not refer to local filesystem paths.

fix

Before using `os.fspath` with an `NSURL` instance, ensure it represents a local filesystem path. For other types of URLs, explicitly convert to a string representation if needed (e.g., `url.absoluteString()`) or access `url.path` for local paths.

affects: >=10.1

Upgrade

Version history

12.2latest on PyPI · released May 30, 2026

Audit

Dependencies

pyobjc-corerequiredProvides the core bridge between Python and Objective-C, essential for all pyobjc-framework-* packages.

Agent activity

8 hits · last 30 days

node

Resources

githubhttps://github.com/ronaldoussoren/pyobjc ↗

packagehttps://pypi.org/project/pyobjc-framework-videotoolbox/ ↗

docshttps://pyobjc.readthedocs.io/en/latest/ ↗