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

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

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

## What it is and what it does

This package wraps Apple's IOSurface framework for use in Python, allowing developers to interact with macOS's shared memory surface objects. IOSurface is a low-level framework used internally by macOS for efficient graphics and media buffer sharing between processes. The wrapper translates Objective-C APIs into Python, making framework classes and methods callable from Python code.

The package is part of the larger PyObjC project and provides no embedded documentation—users must consult Apple's IOSurface documentation and PyObjC's general translation guides. It is intended for developers building graphics-intensive applications, media tools, or system-level software on macOS that need direct access to IOSurface primitives.

Use it for:

- Building macOS graphics applications that need to share buffers between processes via IOSurface.
- Accessing low-level media or video processing pipelines that rely on IOSurface for efficient memory management.
- Integrating Python code with native macOS frameworks that use IOSurface internally.
- Developing system utilities or performance-critical tools on macOS that require direct surface memory access.

## Worth the install?

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

Provides Python bindings to macOS's IOSurface framework, enabling access to shared memory surfaces used for graphics and media operations on macOS.

Yes, if you are developing on macOS and need direct access to IOSurface for graphics or media work. The package is actively maintained, has no known vulnerabilities, and installs cleanly. No, if you are not on macOS or do not need IOSurface specifically—this is a narrow, platform-specific binding with no cross-platform value.

## Install

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

## Installing pyobjc-framework-IOSurface

Before you install: Low install friction with a pure-wheel distribution. Actively maintained with a release 3 days old and recent commits; depends on pyobjc-core and pyobjc-framework-Cocoa.

License in practice: MIT license permits unrestricted use, modification, and distribution with minimal legal constraints.

Quickstart:

pip install pyobjc-framework-iosurface

import IOSurface

# Access IOSurface framework classes and methods

macOS only; requires Python 3.10 or later.

Verify before relying:

- Whether IOSurface access is needed for typical graphics or media workflows versus specialized use cases.
- Performance characteristics and memory overhead of the Python wrapper layer.
- Specific IOSurface capabilities exposed by this wrapper beyond framework access.

## Package facts

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

## Tags

macos iosurface python bindings, pyobjc iosurface framework, shared memory surfaces macos, graphics buffer access macos, cocoa iosurface wrapper, macos-only, graphics-bindings, pyobjc

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