Back to the overview

BTHome in Home Assistant

bthome part of Home Assistant since 2022.9

Local, push Set up in the user interface

BTHome is an official Home Assistant integration for Sensor. Talks to the device on your own network and is told about every change straight away.

Facts about this integration

Compatible with Home Assistant
yes, official integration
Connection
Local, push – Talks to the device on your own network and is told about every change straight away.
Setup
in the user interface
Kind
Integration
Installations
28,958 (4.2 % of the installations that share statistics)
Categories
Sensor
Provides
Binary sensor, Event, Sensor
Found automatically via
Bluetooth
Maintained by
@Ernst79, @thecode
Python packages
bthome-ble==3.23.4

Setup

  1. Home Assistant can find this integration on its own: if it is suggested under Settings → Devices & services, confirm it there.
  2. In Home Assistant open Settings → Devices & services.
  3. Click "Add integration" and search for BTHome.
  4. Follow the dialog – it asks for everything the integration needs.

Add to my Home Assistant

The link goes through my.home-assistant.io and opens the setup dialog in your own instance – no address of ours is involved.

Blueprints that use this integration

  • Automation Shelly BLU RC-4 Button Control (Short, Long, and Double Press) ♥ 10 · Import · Forum
  • Automation _Shelly BLU RC 4-Button bluetooth remote ULTRA by DJF3 ♥ 6 · Import · Forum
  • Automation Shelly BLU Button 1 seen as BTHome Device - 4 actions ♥ 1 · Import · Forum

All blueprints for it

Known issues and fixes

5 open issues and 2 bug fixes in the last twelve months are recorded for BTHome in the Home Assistant issue tracker. If something does not work, update first: the most recent fix shipped with Home Assistant 2026.6.3.

Open

  • open Reported problem #170086 since May 8, 2026 · 2 reactions · 3 comments · #170086
  • open Reported problem #123841 since August 13, 2024 · 0 reactions · 76 comments · #123841
  • open Reported problem #169567 since April 30, 2026 · 0 reactions · 4 comments · #169567
  • open Reported problem #173204 since June 7, 2026 · 0 reactions · 3 comments · #173204
  • open Reported problem #179236 since August 15, 2026 · 0 reactions · 1 comment · #179236

Fixed

Source: the issue tracker of Home Assistant, as of September 14, 2026. The sentences are written by a language model from the titles of the issues; the reports themselves are on GitHub.

Check a specific device for known problems in the product check →

Source of this entry: the official documentation of the integration

Scroll to Top