skillfed

pyobjc-framework-FinderSync

Wrappers for the framework FinderSync on macOS

pyobjc-framework-findersync v12.2.2 650.5K downloads/30d#5,559 on PyPI803
Permissive license MIT Active released

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 on this page — 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

pyobjc-framework-findersync on PyPI

pip

pip install pyobjc-framework-findersync

uv

uv add pyobjc-framework-findersync

poetry

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 the current Python release (>=3.10)
Install friction low — pure-Python wheel
Runtime dependencies 2 — pyobjc-core, pyobjc-framework-Cocoa
Maintenance actively maintained — 3 days since the last release
Last repo commit
First released
Downloads 650,532/month — #5,559 on PyPI (30-day window, as of 2026-08-14)
Known vulnerabilities none known (OSV.dev, checked 2026-08-14)

Evidence: pyobjc_framework_findersync-12.2.2-py2.py3-none-any.whl

Keywords: PyObjC, FinderSync

Development Status :: 5 - Production/StableEnvironment :: ConsoleEnvironment :: MacOS X :: CocoaIntended Audience :: DevelopersNatural Language :: EnglishOperating System :: MacOS :: MacOS XProgramming Language :: Objective CProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: 3.15Programming Language :: Python :: Free Threading :: 3 - StableProgramming Language :: Python :: Implementation :: CPythonTopic :: Software Development :: Libraries :: Python ModulesTopic :: Software Development :: User Interfaces

Tags

macos finder sync integrationpyobjc finder frameworkmacos file synchronization pythonfinder extension python bindingscocoa finder sync wrapper
macos-onlyobjc-bindingsfinder-integration

More Python Modules packages

idna

Converts domain names between Unicode and…

permissive · top 100 on PyPI

setuptools

Setuptools is a Python build backend and…

permissive · top 100 on PyPI

PyYAML

PyYAML parses and emits YAML 1.1 data format,…

permissive · top 100 on PyPI

pydantic

Pydantic validates Python data structures…

permissive · top 100 on PyPI

annotated-types

Provides reusable metadata objects for use with…

permissive · top 100 on PyPI

typing-inspection

Provides runtime tools to inspect and…

permissive · top 100 on PyPI

pyobjc-framework-CloudKit

Provides Python bindings to Apple's CloudKit…

permissive · top 15,000 on PyPI

pyobjc-framework-SyncServices

Provides Python bindings to macOS's…

permissive · top 15,000 on PyPI

pyobjc-framework-DeviceDiscoveryExtension

Provides Python bindings for Apple's…

permissive · top 15,000 on PyPI

pyobjc-framework-MapKit

Provides Python bindings to Apple's MapKit…

permissive · top 15,000 on PyPI

pyobjc-framework-libdispatch

Provides Python bindings to macOS's libdispatch…

permissive · top 5,000 on PyPI

pyobjc-framework-FileProvider

Provides Python bindings to macOS's…

permissive · top 15,000 on PyPI

ds-store

Read and modify macOS Finder .DS_Store files…

permissive · top 15,000 on PyPI

pyobjc-framework-FSKit

Provides Python bindings to macOS's FSKit…

permissive · top 15,000 on PyPI

pyobjc-framework-BackgroundAssets

Provides Python bindings to Apple's…

permissive · top 15,000 on PyPI

pyobjc-framework-SystemExtensions

Provides Python bindings to macOS's…

permissive · top 15,000 on PyPI