Fixed

• Fixed D-Bus connection leak on connection failure in BlueZ backend.
• Fixed characteristic's max write without response size using wrong characteristic's value. Fixes #1820.
• Fixed AttributeError in Python4Android backend when accessing is_connected before connecting. Fixes #1791.

Added

• Added support for Pythonista iOS app backend.
• Added BleakClient.name property for getting the peripheral's name. Fixes #1802.

Fixed

• Fixed BleakClient.connect() on Android when service characteristics have descriptors. Fixes #1803.
• Fixed disconnect callback not called on Windows when Bleak initiates disconnection.

Changed

• Added deprecation warnings for importing bleak.args.* types from bleak.backends.*.

Fixed

• Restored **kwargs in BLEDevice() constructor. Fixes #1783.
• Restored importing OrPattern from bleak.backends.bluezdbus.advertisement_monitor.

Added

• Added pair parameter to BleakClient() constructor to allow pairing before connecting. Fixes #309.
• Added notification_discriminator parameter to start_notify() on CoreBluetooth backend. Merged #1742.

Changed

• Enabled extended advertising scanning in the WinRT backend. Merged #1705.
• Made response argument of class BleakClient.write_gatt_char() explicitly optional. Fixes #1730.
• Updated Poetry build system version to >=2.0. Merged #1718.
• Log to stderr instead of stdout when BLEAK_LOGGING is enabled. Merged #1709.
• Updated winrt backend to use PyWinRT >= 3.1.
• Changed return type of connect(), disconnect(), pair() and unpair() methods to None.
• Moved backend-specific arg types to new bleak.args sub-package.
• BLEDevice.name will now return None instead of the address when the name is not available. Merged #1762.
• Deprecated protection_level kwarg for pairing in WinRT backend. Merged #1770.

Fixed

• Fixed resolvable private address not updated after connecting in BlueZ backend. Fixes #1737.
• Fixed possible KeyError when getting services in BlueZ backend. Fixes #1435.
• Fix D-Bus connection leak when connecting to a device fails in BlueZ backend. Fixes #1698.
• Fixed possible deadlock when connecting on WinRT backend when device is already connected. Fixes #1757.
• Fixed getting notifications from devices connected to BLE adapters with index >9 (hci10, hci11, ...). Merged #1744.
• Fixed ATT error code 15 description to "Insufficient Encryption". Merged #1746.

Removed

• Removed support for Python 3.8. The minimum supported version is now Python 3.9.
• Removed deprecated parameters, properties and methods.
• Removed support for macOS < 10.13.
• Removed support for BlueZ < 5.55.

Changed

• Don't change ctypes' global state bleak.backends.winrt.util.
• Improved performance of BlueZ backend when there are many adapters.
• Added support for Python 3.13.

Changed

• Retrieve the BLE address required by BleakClientWinRT from scan response if advertising is None (WinRT).
• Changed type hint for adv attribute of bleak.backends.winrt.scanner._RawAdvData.
• BleakGATTCharacteristic.max_write_without_response_size is now dynamic.

Fixed

• Fixed discovered_devices_and_advertisement_data returning devices that should
  be filtered out by service UUIDs. Fixes #1576.
• Fixed a Descriptor None was not found! exception occurring in start_notify() on Android. Fixes #823.
• Fixed exception raised when starting BleakScanner while running in a Windows GUI app.

Added

• Added bleak.backends.winrt.util.allow_sta() method to allow integration
  with graphical user interfaces on Windows. Fixes #1565.

Added

• Added BleakCharacteristicNotFoundError which is raised if a device does not support a characteristic.
• Added utility function to work around pywin32 setting threading model to STA on Windows.

Changed

• Updated PyObjC dependency on macOS to v10.x.
• Updated missing Bluetooth SIG characteristics and service UUIDs.
• Updated BlueZManager to remove empty interfaces from _properties during InterfacesRemoved message.
• Updated PyWinRT dependency to v2. Fixes #1529.
• Raise exception when trying to scan while in a single-treaded apartment (STA) on Windows. Fixes #1132.

Fixed

• Fixed BlueZ version in passive scanning error message. Fixes #1433.
• Fixed mypy requiring Unpack[ExtraArgs] that were intended to be optional. Fixes #1487.
• Fixed KeyError in BlueZ is_connected() and get_global_bluez_manager() when device is not present. Fixes #1507.
• Fixed BlueZ _wait_removed completion on invalid object path. Fixes #1489.
• Fixed rare unhandled exception when scanning on macOS when using use_bdaddr. Fixes #1523.
• Fixed scanning silently failing on Windows when Bluetooth is off. Fixes #1535.
• Fixed using wrong value for tx_power in Android backend. Fixes #1532.
• Fixed 4-character UUIDs not working on BleakClient.*_gatt_char methods. Fixes #1498.
• Fixed race condition with getting max PDU size on Windows. Fixes #1497.
• Fixed filtering advertisement data by service UUID when multiple apps are scanning. Fixes #1534.

Changed

• Changed dbus-fast dependency to include v2.x. Fixes #1412.

Added

• Added bleak.uuids.normalize_uuid_16() function.
• Added bleak.uuids.normalize_uuid_32() function.
• Added advertisement_data() async iterator method to BleakScanner. Merged #1361.
• Added type hints for kwargs on BleakScanner class methods.
• Added support for Python 3.12.

Changed

• Improved error messages when failing to get services in WinRT backend.
• Improved error messages with enum values in WinRT backend. Fixes #1284.
• Scanner backends modified to allow multiple advertisement callbacks. Merged #1367.
• Changed default handling of the response argument in BleakClient.write_gatt_char.
  Fixes #909.
• Bleak recipe now automatically installs bleak from GitHub release in Kivy example.
• Changed BlueZManager methods to raise BleakError when device is not in BlueZ.
• Optimized BlueZ backend device watchers and condition callbacks to avoid linear searches.
• Changed type hint for buffer protocol to collections.abc.Buffer.

Fixed

• Fixed handling all access denied errors when enumerating characteristics on Windows. Fixes #1291.
• Added support for 32bit UUIDs. Fixes #1314.
• Fixed typing for BaseBleakScanner detection callback.
• Fixed possible crash in _stopped_handler() in WinRT backend. Fixes #1330.
• Reduced expensive logging in the BlueZ backend. Merged #1376.
• Fixed race condition with "InterfaceRemoved" when getting services in BlueZ backend.
• Fixed missing permissions and requirements in android Kivy example. Fixes #1184.
• Fixed WinRT backend sometimes hanging forever when a device goes out of range during connection. Fixes #1359.