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

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

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

## What it is and what it does

pyobjc-framework-cinematic is a thin wrapper layer that exposes Apple's Cinematic framework to Python developers on macOS. It is part of the PyObjC ecosystem, which bridges Objective-C frameworks to Python by providing direct bindings to native macOS APIs. This package specifically targets the Cinematic framework, which Apple uses for depth-based video effects and cinematic video processing.

The package does not include its own documentation; instead, it relies on Apple's official framework documentation and PyObjC's general translation guidelines. It supports modern Python versions (3.10 through 3.15) and is actively maintained. Use it when you need to integrate Apple's cinematic video capabilities into a Python application running on macOS.

Use it for:

- Building macOS desktop applications that apply cinematic depth effects to video content.
- Automating video processing workflows that leverage Apple's native Cinematic framework capabilities.
- Prototyping video effects in Python while accessing native macOS video processing APIs.
- Integrating cinematic video features into PyObjC-based macOS applications.

## Worth the install?

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

Provides Python bindings for Apple's Cinematic framework on macOS, enabling programmatic access to cinematic video features through PyObjC.

Yes, if you are developing on macOS and need programmatic access to the Cinematic framework from Python. The package is actively maintained, has no known vulnerabilities, and carries a permissive MIT license. Install friction is low. However, it is macOS-only and requires Python 3.10+; it is not useful outside that environment.

## Install

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

## Installing pyobjc-framework-Cinematic

Before you install: Low friction installation via wheel distribution. Actively maintained with a release 3 days old and recent commits. Depends on five PyObjC framework packages, all part of the same ecosystem.

License in practice: MIT license permits use, modification, and distribution with minimal restrictions—suitable for both open and proprietary projects.

Quickstart:

pip install pyobjc-framework-cinematic

import Cinematic
# Access Cinematic framework classes and methods through PyObjC bindings

Requires macOS; Python 3.10 or later; pyobjc-core and related framework packages must be installed.

Verify before relying:

- Specific Cinematic framework capabilities exposed (e.g., depth map access, video processing APIs) beyond the framework name itself.
- Whether this package is suitable for real-time video processing or primarily for static analysis.
- Performance characteristics or known limitations when working with large video files.

## Package facts

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

## Tags

macOS cinematic framework python, pyobjc cinematic video, apple cinematic depth effects python, macos video processing bindings, pyobjc framework wrappers, macos-native, video-processing, pyobjc

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