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

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

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

## What it is and what it does

This package wraps Apple's FinderSync framework for use in Python, enabling developers to build Finder extensions and integrate with macOS file synchronization features. It is part of the PyObjC project and provides low-level bindings to the Objective-C framework, allowing Python code to call FinderSync APIs directly.

The package itself contains only bindings and does not include framework documentation; users must consult Apple's FinderSync documentation alongside PyObjC's general translation guides. It depends on pyobjc-core and pyobjc-framework-Cocoa and runs on Python 3.10 through 3.15. The project is actively maintained and has been in use since 2016.

Use it for:

- Build a custom Finder extension in Python that monitors or syncs files in real time
- Integrate Python-based file management tools with macOS Finder's native UI and workflows
- Create a Finder sync client for a cloud storage or version-control service on macOS
- Extend Finder's context menu or file operations with Python-driven logic

## Worth the install?

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

Provides Python bindings to macOS's FinderSync framework, allowing Python code to integrate with Finder's file synchronization and extension APIs on macOS.

Yes, if you are developing a macOS Finder extension or file-sync tool in Python. The package is actively maintained, has no known vulnerabilities, and installs with low friction. The main caveat is that you must be comfortable reading Apple's framework documentation and PyObjC's translation patterns; the bindings themselves are not self-documenting.

## Install

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

## Installing pyobjc-framework-FinderSync

Before you install: Low friction installation with a pure-Python wheel. Actively maintained as of 3 days ago with recent commits and stable status. Requires pyobjc-core and pyobjc-framework-Cocoa as runtime dependencies.

License in practice: MIT license permits commercial and private use with minimal restrictions—suitable for most projects without licensing concerns.

Quickstart:

pip install pyobjc-framework-findersync

import FinderSync
# Access FinderSync framework classes and methods via PyObjC bindings

macOS only; requires Python 3.10 or later and a macOS system with the FinderSync framework available.

Verify before relying:

- Specific FinderSync API coverage and completeness compared to Apple's current framework version
- Whether documentation gaps beyond PyObjC general guidance significantly impact usability for new users

## Package facts

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

## Tags

macos finder sync integration, pyobjc finder framework, macos file synchronization python, finder extension python bindings, cocoa finder sync wrapper, macos-only, objc-bindings, finder-integration

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