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

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

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

## What it is and what it does

This package wraps Apple's QuickLookThumbnailing framework for use in Python, enabling macOS applications to generate thumbnail images for files. It depends on pyobjc-core, pyobjc-framework-Cocoa, and pyobjc-framework-Quartz to function. The bindings are thin—they expose the underlying Objective-C API directly—so you'll need to consult Apple's official documentation alongside PyObjC's translation guide to use it effectively.

It's designed for developers building macOS tools, utilities, or applications that need to display or work with file thumbnails programmatically. Since it's a direct wrapper rather than a higher-level abstraction, it's most useful when you're already familiar with PyObjC patterns or when you need access to QuickLook's full feature set.

Use it for:

- Build a macOS file browser or media organizer that displays live thumbnail previews
- Generate batch thumbnail images for files in a folder for indexing or cataloging
- Integrate thumbnail generation into a macOS desktop application's file picker
- Create macOS utilities that work with file thumbnails programmatically

## Worth the install?

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

Provides Python bindings to macOS's QuickLookThumbnailing framework, allowing you to generate thumbnail images for files programmatically.

Yes, if you're building a macOS application in Python and need QuickLook thumbnail support. The package is actively maintained, has no known vulnerabilities, and uses a permissive license. Install friction is low. However, it is macOS-only and requires Python 3.10 or later and familiarity with PyObjC and Apple's framework documentation.

## Install

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

## Installing pyobjc-framework-QuickLookThumbnailing

Before you install: Low install friction; distributed as a pure-Python wheel. Actively maintained with recent releases and no known vulnerabilities.

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

Quickstart:

pip install pyobjc-framework-quicklookthumbnailing
import QuickLookThumbnailing

macOS only; requires Python 3.10 or later and the pyobjc-core and framework dependencies for Cocoa and Quartz

Verify before relying:

- Whether this package is usable on Apple Silicon (M1/M2/M3) Macs or only Intel-based systems
- Whether thumbnail generation supports all file types that macOS QuickLook itself supports
- Specific API surface and usage patterns beyond what Apple's documentation provides

## 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 quicklook thumbnails python, generate file thumbnails macos, pyobjc quicklook framework, macos thumbnail generation, quicklookthumbnailing bindings, macos-only, pyobjc-framework

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