ibeacon-ble

What it is and what it does

ibeacon-ble is a lightweight parser for iBeacon devices that decodes Bluetooth Low Energy advertisement packets. It sits at the intersection of BLE scanning and iBeacon protocol interpretation, relying on aiooui for OUI lookups, home-assistant-bluetooth for Bluetooth device abstraction, and mac-vendor-lookup for vendor identification. The package is in pre-alpha development but maintains active repository status.

The library is intended for developers building Bluetooth proximity applications, location-based services, or Home Assistant integrations that need to extract and interpret iBeacon advertisement data. It handles the low-level parsing of BLE packets to surface iBeacon-specific fields, making it useful in scenarios where raw Bluetooth scanning output needs semantic interpretation.

Use it for:

• Extract UUID, major, and minor identifiers from iBeacon advertisement packets in proximity-based applications
• Integrate iBeacon detection into Home Assistant automations via the home-assistant-bluetooth dependency
• Identify iBeacon device vendors and manufacturers using mac-vendor-lookup during BLE scanning
• Parse iBeacon signals for indoor location tracking or geofencing systems
• Build custom Bluetooth beacon monitoring tools that decode iBeacon protocol data

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Parses and decodes iBeacon BLE (Bluetooth Low Energy) advertisement packets to extract device information and proximity data.

Yes, with conditions. The package is actively maintained and has low install friction, making it suitable for iBeacon parsing tasks. However, it remains in pre-alpha status and has not shipped a release in over two years, so expect API instability and incomplete documentation. Install if you need iBeacon parsing and can tolerate pre-release maturity; avoid if you require production-grade stability.

Install

ibeacon-ble on PyPI

pip install ibeacon-ble

uv add ibeacon-ble

poetry add ibeacon-ble

Installing ibeacon-ble

Before you install

Low install friction with a pure Python wheel. Maintenance is active with a recent commit as of 2026-08-10, though the package remains in pre-alpha status and has not seen a release since 2024-02-24.

License in practice

MIT license is permissive and imposes no significant restrictions on use, modification, or distribution.

Quickstart

pip install ibeacon-ble

import ibeacon_ble
# Parse iBeacon advertisement data using aiooui, home-assistant-bluetooth, and mac-vendor-lookup for device resolution

Requires Python 3.9 or later; depends on aiooui, home-assistant-bluetooth, and mac-vendor-lookup at runtime.

Verify before relying

• What specific iBeacon advertisement formats and BLE packet structures are supported by version 1.2.0
• Whether the package handles UUID, major, and minor identifier extraction from iBeacon packets
• API surface and primary entry points for parsing iBeacon data
• Whether it integrates with Home Assistant's Bluetooth stack or is standalone

Package facts

Evidence: ibeacon_ble-1.2.0-py3-none-any.whl

Tags

More Libraries packages