---
id: ibeacon-ble
version: "1.2.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# ibeacon-ble — Parser for iBeacon devices

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

## 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 above — 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

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

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

## Tags

ibeacon parser, ble ibeacon decoder, bluetooth ibeacon, ibeacon advertisement parsing, ble beacon detection, proximity beacon parser, ibeacon device scanner, bluetooth, ble-parsing, home-assistant

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