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

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

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

## What it is and what it does

pyobjc-framework-photosui is a thin wrapper layer that exposes Apple's PhotosUI framework to Python developers. It sits atop pyobjc-core and pyobjc-framework-Cocoa, translating Objective-C interfaces into Python-callable objects so you can integrate native macOS photo and media picker dialogs into Python applications.

The package provides direct access to PhotosUI classes and methods but does not include its own documentation—you rely on Apple's official PhotosUI docs and PyObjC's general translation guides. It's maintained actively and supports Python 3.10, 3.11, 3.12, 3.13, 3.14, and 3.15, with wheels built for both Intel and ARM macOS architectures.

Use it for:

- Build a macOS desktop app that lets users pick photos from their library using the native system picker
- Integrate photo selection into a Python automation script that needs to work with user-selected images
- Create a tool that accesses PhotosUI features for batch photo operations on macOS
- Develop a Cocoa-based GUI application in Python that requires native photo picker dialogs

## Worth the install?

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

Provides Python bindings to macOS's PhotosUI framework, enabling access to Apple's photo and media picker interfaces from Python code.

Yes, if you are building a macOS application in Python and need native photo picker or media selection UI. Install friction is moderate (macOS-only, requires specific Python versions and compiled dependencies), but maintenance is active and the license is permissive. Not applicable on Windows or Linux.

## Install

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

## Installing pyobjc-framework-PhotosUI

Before you install: Medium install friction due to platform-specific wheels (macOS only, requires Python 3.10 or later) and compiled dependencies on pyobjc-core and pyobjc-framework-Cocoa. Active maintenance with recent releases.

License in practice: MIT license permits commercial and private use with minimal restrictions; suitable for most projects.

Quickstart:

pip install pyobjc-framework-photosui

from PhotosUI import PHPickerViewController
# Use PhotosUI classes via pyobjc-framework-Cocoa integration

Requires macOS 10.9 or later (10.13 for Python 3.12, 10.15 for Python 3.14); Windows and Linux not supported.

Verify before relying:

- Whether PhotosUI bindings cover the full current PhotosUI API surface or a subset
- Performance characteristics when handling large photo libraries or batch operations
- Compatibility with non-Intel macOS architectures beyond the universal2 wheels provided

## Package facts

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

## Tags

macos photo picker, photosui framework python, pyobjc photosui, macos image selection, cocoa photo ui bindings, macos-native, objective-c-bindings, gui-framework

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