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

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

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

## What it is and what it does

This package wraps Apple's CoreBluetooth framework for use from Python, allowing developers to write Bluetooth applications on macOS without leaving Python. It sits on top of PyObjC, which handles the translation between Python and Objective-C, and requires both pyobjc-core and pyobjc-framework-Cocoa as runtime dependencies.

The package provides direct access to CoreBluetooth's APIs for discovering Bluetooth devices, establishing connections, reading and writing characteristics, and handling peripheral events. Since it is a thin wrapper rather than a high-level abstraction, developers must understand both the CoreBluetooth framework itself and PyObjC's conventions for working with Objective-C objects. The package is actively maintained, supports modern Python versions including free-threading builds, and carries no known security vulnerabilities.

Use it for:

- Build macOS desktop applications that discover and connect to Bluetooth peripherals like fitness trackers or smart home devices.
- Write command-line tools on macOS to scan for Bluetooth devices and read their advertised services.
- Develop cross-platform Python applications that need Bluetooth support on macOS alongside other platforms.
- Create test harnesses or automation scripts that interact with Bluetooth hardware on macOS.
- Prototype Bluetooth-based features in Python before porting to native macOS applications.

## Worth the install?

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

Provides Python bindings to macOS's CoreBluetooth framework, enabling Bluetooth device discovery, connection, and communication from Python code.

Yes, if you are developing on macOS and need Bluetooth functionality from Python. The active maintenance, broad Python version support, permissive license, and zero known vulnerabilities make it a safe choice. Install friction is moderate due to platform specificity and compiled dependencies, but this is unavoidable for framework bindings. Not applicable outside macOS.

## Install

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

## Installing pyobjc-framework-CoreBluetooth

Before you install: Medium install friction due to platform-specific wheels and compiled dependencies. Active maintenance with a release 3 days old and recent commits, supporting Python 3.10 through 3.15 including free-threading variants.

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

Quickstart:

pip install pyobjc-framework-corebluetooth

import CoreBluetooth
# Use CoreBluetooth APIs through PyObjC bindings

macOS only; requires Python 3.10 or later; requires pyobjc-core and pyobjc-framework-Cocoa as runtime dependencies.

Verify before relying:

- Whether CoreBluetooth bindings support specific Bluetooth profiles or peripheral types beyond basic discovery and connection.
- Performance characteristics when handling multiple simultaneous device connections.
- Whether the package includes example code or reference implementations for common Bluetooth use cases.

## Package facts

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

## Tags

bluetooth mac python, corebluetooth bindings, macos bluetooth api, ble device communication, pyobjc bluetooth, mac wireless devices, objective-c bluetooth wrapper, macos-only, hardware-interface, pyobjc-framework

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