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

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

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

## What it is and what it does

This package wraps Apple's IOBluetooth framework for use from Python, allowing developers to interact with Bluetooth devices on macOS. It is part of the PyObjC project and provides low-level access to the native framework; the wrappers themselves do not include separate documentation, so you must refer to Apple's IOBluetooth documentation and PyObjC's general translation guides to understand how to use the framework's classes and methods.

The package is a thin binding layer that requires pyobjc-core and pyobjc-framework-Cocoa as runtime dependencies. It is actively maintained, supports Python 3.10 through 3.15 (including free-threading variants), and is distributed as pre-built wheels for macOS universal2 architecture. Installation is straightforward on macOS, but the package is not available on other operating systems.

Use it for:

- Discover and enumerate Bluetooth devices available on a macOS system.
- Establish connections to Bluetooth peripherals and manage their lifecycle.
- Send and receive data over Bluetooth serial or custom profiles from a macOS application.
- Build macOS utilities or daemons that interact with Bluetooth-enabled hardware.
- Integrate Bluetooth device control into cross-platform Python applications on macOS.

## Worth the install?

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

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

Yes, if you are developing on macOS and need to interact with Bluetooth devices from Python. The package is actively maintained, carries no known vulnerabilities, uses a permissive MIT license, and supports current Python versions. Install friction is moderate due to platform specificity and PyObjC dependencies, but both are expected for native framework bindings on macOS. Not applicable on non-macOS systems.

## Install

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

## Installing pyobjc-framework-IOBluetooth

Before you install: Medium install friction: platform-specific wheels for macOS only (universal2 binaries for multiple Python versions 3.10–3.15). Requires pyobjc-core and pyobjc-framework-Cocoa as dependencies. Active maintenance with a release 3 days old.

License in practice: MIT license permits commercial and private use with minimal restrictions; you may use, modify, and distribute this package freely provided you include the license notice.

Quickstart:

pip install pyobjc-framework-iobluetooth

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

macOS only; requires Python 3.10 or later; requires a macOS system with IOBluetooth framework support.

Verify before relying:

- Whether the package includes type hints or stubs for IDE autocompletion.
- What specific IOBluetooth classes and methods are exposed by the wrapper.
- Whether there are known limitations or unsupported IOBluetooth features.

## Package facts

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

## Tags

macOS Bluetooth device control, IOBluetooth Python bindings, Bluetooth communication macOS, PyObjC Bluetooth framework, macOS Bluetooth discovery, Bluetooth serial communication macOS, macOS wireless device access, macos-only, bluetooth, pyobjc

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